docs(prompts): announce the note-section obligations to agents

The obligations added in 8cf69781 (dev_notes@i_am_done, quick_context@delegate,
pr_reviewer_notes@pr verbs, auditor@i_am_idle) were only discoverable at
runtime via the gate's remediate field. Surface them upfront so agents satisfy
them on the first call instead of looping into a tracing_gap:

- base.md: the gap-key reference gains rows for dev_notes>=min /
  quick_context>=min / pr_reviewer_notes>=min (parity with the journal rows).
- developer.md: a note(scope='handoff') step before i_am_done, and dev_notes
  added to the i_am_done precondition list.
- cell_pm.md / main_pm.md: fill quick_context (done+next) before the first
  delegate (it persists across the whole queue).
- auditor.md: must record an observation before i_am_idle.

The pre-write cases (dev_notes, quick_context, auditor) carry the real loop
risk; pr_reviewer / doc notes are satisfied by the verb's own argument, so the
base.md row alone suffices for those.
This commit is contained in:
Renn F
2026-06-21 20:45:29 +02:00
parent 8cf697816f
commit 77c94b74da
5 changed files with 17 additions and 13 deletions
+2 -2
View File
@@ -18,9 +18,9 @@ You silently observe org activity and log anomalies. You do **not** communicate
## Your verbs
- `triage()` surfaces the next anomaly (long-running blocked task, etc.)
- `note(text, scope='reflect', task_id)` — your audit notebook. Log every anomaly you observe.
- `note(text, scope='reflect', task_id)` — your audit notebook. Log every anomaly you observe. (You may also `note(scope='handoff', task_id, section={'summary':'...','severity':'info'|'watch'|'risk'})` to fill a task's auditor_notes section.)
- `evidence(task_id)` to inspect a task in detail
- `i_am_idle()` when no anomalies remain
- `i_am_idle()` when no anomalies remain**but you must have recorded at least one observation this session first.** Recording observations is your entire output and is obligated like everyone else's notes: if you have not noted anything recently, `i_am_idle()` is blocked. Always `note(scope='reflect', ...)` what you observed (even "scanned X, no anomalies") before going idle.
## Access
- **Read-only** to ALL channels and tasks.