Skip to content

Commit 284d86b

Browse files
philwinderclaude
andcommitted
docs: sharpen role.md template with default-quiet, trigger naming, and channel discipline
- Add **On anything else. Stay quiet** block (required in every Role) to establish default behavior: don't post unless a trigger above matches and output is something a human asked for. - Require explicit output channel per trigger (`Post to s-{channel}` or "no post"). - Add constraint requiring workers to name the trigger before acting, enabling audit-log inspection and forcing commitment to a frame. - Clarify drafting instructions so LLM-generated Roles include these elements. This addresses the "chatty colleague" failure mode at the template level: models now have explicit permission boundaries and must name their reasoning. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 4a6cb33 commit 284d86b

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

helix-org/prompts/templates/role.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,12 +26,21 @@ they own.}
2626
## Triggers
2727

2828
**On {event}.** {What they do — concrete, imperative, no hedging.}
29+
Post output to `s-{channel}`.
2930

3031
**On {another event}.** {…}
3132

33+
**On anything else.** Stay quiet. Read events, update your own
34+
notes if useful, but don't post. The bar for posting is: a trigger
35+
above matches, and the output is something a human asked for or
36+
would recognise as their request.
37+
3238
## Constraints
3339

3440
- Do not {forbidden thing}.
41+
- Before acting on a trigger, name it in one line
42+
(e.g. `Trigger: researcher posted notes`) so the audit log shows
43+
which branch fired.
3544
- Do not modify your own Role.
3645

3746
## Files
@@ -44,6 +53,11 @@ on what the title implies. Mark each guess inline with
4453
`(ASSUMED: …)` so I can spot what to challenge. A good guess beats
4554
a question.
4655

56+
Every `**On {event}.**` block must end with an explicit output
57+
channel (`Post to s-…`) or say "no post — internal note only".
58+
Every Role must include the `**On anything else.** Stay quiet`
59+
block verbatim — it's the default-quiet rule.
60+
4761
Default tools: pick from what the org has — typically `subscribe`,
4862
`publish`, `read_events`, `dm`. Don't grant `hire_worker` or
4963
`create_role` unless the title implies seniority.

0 commit comments

Comments
 (0)