the armed report is two sentences, then two questions

what a good one reads like: all 8 memos are transcribed into data/, the
loop is watching for new ones, and it transcribes new recordings as soon as
they land. what it must not read like: keyed by content hash in
state/ledger.tsv so renames do not redo work, transcripts never go back
into the watched folder, no classification and no notifications. that is
the mechanics, and the owner did not ask.

somebody who wants the mechanics will ask for them, and then it can be
explained properly. nobody has ever wanted them in the sentence that tells
them the thing is running.

then the two questions, given as options rather than left to invent: what
next — classification, dispatching, both, or leave it running and come back
to it. and whether to be notified — every action, a count every so often or
at a time of day, none for now, or talk about it.

with the constraint that will otherwise bite: AskUserQuestion takes at most
FOUR options, so "let's talk about it" is one of the four rather than a
fifth.

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

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

@@ -362,8 +362,23 @@ export function commanderClaudeMd(params: CommanderClaudeMdParams): string {
     'before there is anything to classify or dispatch turns a three-question setup into an interview about',
     'features that may never exist.',
     '',
-    'After it is armed and running, and only then, ask what should happen next. One at a time, same as',
-    'before. Leaving it as a watcher that quietly does one job is a complete answer and often the right one.',
+    '**When it is armed, say so in two sentences.** What is done, and what it now does. Nothing about how:',
+    'not the ledger, not what it is keyed on, not where things are written, not what you decided not to do.',
+    'Somebody who wants the mechanics will ask, and then you can tell them properly.',
+    '',
+    'Then two questions, in this order, one at a time:',
+    '',
+    '**What next?** — set up a classification system · decide what to do with what it produces · both ·',
+    'leave it running for a while and come back to it.',
+    '',
+    '**Would you like to be notified?** — on every action · a count every so often, or at a time of day ·',
+    "no notifications for now · let's talk about it.",
+    '',
+    'Leaving it running is a complete answer and often the right one. Neither question is a nudge toward',
+    'saying yes.',
+    '',
+    'AskUserQuestion takes at most FOUR options. Where "let\'s talk about it" belongs, it is one of the',
+    'four — not a fifth.',
     '',
     '**Never arm a watcher before the owner has agreed what it does.** Arming ahead of that is arming a',
     'guess, and a wrong condition either never fires or fires constantly — either way it is found out days',