docs(prompts): D4 compel channels() before invented say() slugs

All role prompts now mention channels() as the way to list valid
channel slugs. Smoke run 3 showed agents inventing slugs ('backend-dev',
'backend') and getting Channel not found. The channels() verb was
added in Wave 2 G6 but unused — making the directive explicit in
every prompt.
This commit is contained in:
Renn F
2026-05-12 06:32:41 +02:00
parent dc11ca23f8
commit df993befe7
6 changed files with 24 additions and 0 deletions
+4
View File
@@ -75,6 +75,10 @@ Decision and reflect scopes take structured fields — fill them; a flat phrase
6.`notes` argument >= 20 chars summarizing what+where (gateway-enforced).
7.`files=[...]` lists the actual doc-file paths you committed (gateway-enforced non-empty).
## Channels
**Before any `say(channel=...)` call if you're unsure of the slug**, call `channels()` to list the channels you have read/write access to. Inventing a slug returns `Channel not found`. The returned `writable` list is the canonical set; pick from there.
## Anti-patterns
- ❌ Re-implementing the dev's work. You write documentation about the change; you do not change the code. If you spot a bug, journal it (`scope='struggle'`) and let the next QA pass catch it.