one directory layout for every commander

classification/ with a directory per category and an unclassified/ that
always exists, plus procedures/, reports/ and state/.

named for the SHAPE, not the payload. the voice-memos commander called it
transcripts/, which bakes one job into the layout — the same structure has
to hold for a commander over email or photos, and none of those produce
transcripts.

and the distinction that makes the two records make sense together: the
ledger says whether an item was HANDLED, the directory says where it
BELONGS. unclassified/ is finished work waiting on a person rather than a
failure, so nothing re-runs the action on it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Officer-Session: 656f5c85-e49a-4f1f-b9f3-042a04b4d043

src/servers/api/command-hq/directory.ts

@@ -206,6 +206,31 @@ export function commanderClaudeMd(params: CommanderClaudeMdParams): string {
     '**Leave the ambiguous alone and name it.** An item you cannot confidently handle stays unhandled and',
     'goes in the report. Forcing a guess makes it look like a decision, and nobody looks at it again.',
     '',
+    '## Where things go',
+    '',
+    'One layout for every commander, whatever it handles:',
+    '',
+    '```',
+    'classification/          what this commander has produced, filed',
+    '  <category>/            one directory per category, named by you as they are agreed',
+    '  unclassified/          handled and recorded, placement still open',
+    'procedures/              what a spawned agent follows, one file per job',
+    'reports/                 per-run output — what happened, what was skipped, what needs a person',
+    'state/                   the loop pid and spawned session ids. The platform reads these.',
+    '```',
+    '',
+    '`classification/` is named for the SHAPE, not the payload. Transcripts, extracted invoices, photos —',
+    'they are all just items being filed, and a commander that calls it `transcripts/` has baked one job',
+    'into its own directory layout.',
+    '',
+    "**A file's directory is its state.** In a category, it is filed. In `unclassified/`, it is finished",
+    'work waiting on a person — not a failure, and nothing should re-run the action on it. The ledger says',
+    'whether an item was handled; the directory says where it belongs. They answer different questions and',
+    'you need both.',
+    '',
+    '`unclassified/` always exists, even when empty. A commander that creates it only when it first needs',
+    'one gives you nowhere to look before that, and no hint that looking is a thing you do.',
+    '',
     '## Before arming anything',
     '',
     'Never arm a watcher on the first turn. The first turn is for settling what to watch and what to do',