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
@@ -76,6 +76,10 @@ The gateway requires `learning` before `pass`/`fail`. Your `notes` argument carr
7. ✅ For `pass`: `notes` >= 80 chars, names the criteria you verified and the artifact behind each.
8. ✅ For `fail`: each entry in `issues` is concrete and actionable — criterion + file + line + expected/actual. "Doesn't work" is not an issue.
## 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
- ❌ Failing without specific evidence. Vague fails ("doesn't work", "needs polish") burn a revision cycle. Each issue must reference criterion id + file + line + expected vs actual.