Writing SOPs and Articles
๐ฏ Purpose
Turn a note you already wrote into a reusable procedure of your own, or into an article โ and know which of those can ever leave your vault.
GENERATE SOP and CREATE ARTICLE need a paid plan. Both ask a model to do the writing, so both are part of the assistant. Everything about publishing, submitting and reviewing below is unchanged once you have one.
๐ Prerequisites
- A note with something real in it. Both buttons work from the note you have open.
- GENERATE SOP and CREATE ARTICLE need a paid plan; publishing is the owner's.
๐ช Steps โ generate an SOP
- Open the note the procedure should come from.
- Press GENERATE SOP. It types a sentence into the prompt box and submits it, so you can see exactly what was asked โ and type it yourself next time.
- AIOS writes a new note in your SOPs category. Your source note is never rewritten; it only gains one System Log line saying an SOP was drafted from it.
- Edit the result. It is your note.
The SOP is asked for by section: purpose, prerequisites, ordered steps, how to verify, and what to do when it fails. Verification is required โ a procedure you cannot tell has failed is not one.
Your SOPs are yours. Nothing in your vault becomes public because it exists โ it becomes public only if you send it in and the owner publishes it.
๐งพ If you have nothing to write up yet
Press the button anyway. If the note you have open is not a source โ your daily note, an SOP AIOS already wrote, an empty note, or no note at all โ AIOS opens an intake form instead of drafting something about nothing:
sop-intakeโ what the procedure is for, who runs it, what they need first, the steps in order, how to tell it worked, and what goes wrong.article-intakeโ the problem, what you tried that did not work, what did, and why it worked.
Both leave places to paste screenshots: drop an image into the note and AIOS writes the image token where your cursor is. Fill in what you can โ blank sections are fine โ then press the same button again with the form open. What AIOS will not do is invent the part you left out, because an invented step in a procedure is somebody running a wrong command on a live system.
The form is an ordinary note in your Notes. Edit it, keep it, or delete it.
You always get a blank one. If the form you have is untouched, that is the one you get back. The moment you type into it, it is your draft โ it stays in Notes exactly as you left it, and the next time you press the button without a source you get a fresh form beside it. Your half-finished one is never overwritten and you are never dropped into last week's.
Finish a form and press the button again with it open: that is when the procedure is written, into your SOPs. An article goes to Articles.
๐ช Steps โ write an article
- Press CREATE ARTICLE on a note.
- AIOS drafts one into a new note. Your source note is not rewritten.
- Edit it. It is your note.
๐ช Steps โ submit for review
Press SUBMIT FOR REVIEW on an article, or SUBMIT TO COMMUNITY on an SOP. Both do the same thing: they put a copy of what the note says into the owner's review queue. (On a phone, SUBMIT TO COMMUNITY appears on the row with the note's name rather than in the header, so it never crowds out the Notebook menu.)
It asks first. A dialog says what sending it in means, how much of today's allowance is left, and where to write if you send something by mistake. Nothing leaves your notebook until you press the button in that dialog.
What the limits are. One article and one SOP a day. The count is by NOTE, not by press, so fixing a typo and sending the same note again is free. A submission needs at least 50 words, so there is something to read.
You can take it back. While it is still waiting, pressing the same button offers TAKE IT BACK instead โ it leaves the queue, your note is untouched, and it cannot be published afterwards. It does not give you back the day's allowance, but you can send that same note in again once it is ready. If something has already been published, email the address in the dialog and it will be removed.
- It saves first, so what is sent is what you can see.
- It is a copy. Editing the note afterwards does not change what was sent โ what the owner reads is the version you agreed to. Submit again to replace it; that replaces your pending entry rather than queueing a second one.
- Every failure path tells you your note is safe in your notebook. The whole point of the feature is not to lose your words.
- A private note cannot be submitted, and neither can one that merely mentions a private note by name. You are told, so you can reword the line โ nothing is quietly removed for you.
If the owner publishes it, it appears in the Developer's Notebook under Community Submitted, with your name on it.
๐ Who can publish
Only the owner. If you are an administrator you see PUBLISH; everyone else sees SUBMIT FOR REVIEW in the same place, because a button that is drawn for you and then refused is worse than no button.
Two human gates in series either way: somebody reads the draft and decides, and the owner reads the diff and pushes. Nothing reaches the internet without both.
๐ How to verify
- Press GENERATE SOP on a note with a few steps in it.
- A new note appears under SOPs โ and your original is byte-for-byte the same apart from one System Log line.
- The new note's frontmatter says
sop: true. An article is flagged with the article key instead, which is what makes the two impossible to confuse. - Press SUBMIT FOR REVIEW on an article. The message says it was sent, and the note gains one System Log line recording it.
- Press GENERATE SOP with your daily note open. No SOP is drafted โ
sop-intakeopens instead, and the message says why. - Fill one line into that form and press GENERATE SOP again with it open. This time an SOP is drafted from it.
๐จ When it does not work
| What you see | What it means | What to do |
|---|---|---|
| "That came back too thin to be an SOP" | The draft was refused rather than saved | Add more detail to the source note and try again |
| The button does nothing | A private note is open โ the AI input is disabled | Open a non-private note |
| No new note appeared | The turn was refused; the message says so | Read the notebook message; nothing was written either way |
| "SUBMIT FAILED" | The queue could not be reached | Your note is untouched. Try again; nothing was lost |
| Submitting is refused as private | The note is private, or it names a private note | Move it out of Private, or reword the line that names one |
| An intake form opens instead of an SOP | The open note is not a source โ a daily note, an SOP, an empty note, or none | Fill in the form and press the button again with it open |
| The intake form opens again from itself | Nothing has been typed into it yet | Answer at least one section; blank ones are fine |
๐ Related
Notes, the Notebook and Search, What AIOS Can See, sop-intake, article-intake