From 594a0871dd11cbdac281bdd0b6c508a09e3d62d7 Mon Sep 17 00:00:00 2001 From: jochen Date: Mon, 2 Nov 2026 19:41:34 +0100 Subject: [PATCH 1/3] Playbook 07: a role started more than once is an agent definition in the repository it serves; hq's words test reads .claude/ --- 00-META/checks/words_test.go | 2 +- 00-META/process/07-feature-branches.md | 7 +++++++ 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/00-META/checks/words_test.go b/00-META/checks/words_test.go index 3887ba4f..7af87b3c 100644 --- a/00-META/checks/words_test.go +++ b/00-META/checks/words_test.go @@ -52,7 +52,7 @@ const ( linesFrom = "2026-10-09" ) -var wordsAlways = []string{"00-META/", "03-DESIGN/", "AGENTS.md", "README.md"} +var wordsAlways = []string{"00-META/", "03-DESIGN/", ".claude/", "AGENTS.md", "README.md"} // daemonLines are the daemons' lines (ADR 0272): each daemon's commands. "alone" is a command that is a line by // itself; "with an argument" one that is a line only when written as one ("the mesh-controller module" is prose; diff --git a/00-META/process/07-feature-branches.md b/00-META/process/07-feature-branches.md index fe15ed7a..b4f9f972 100644 --- a/00-META/process/07-feature-branches.md +++ b/00-META/process/07-feature-branches.md @@ -553,6 +553,13 @@ Every agent the mesh runs draws on one weekly allowance shared by every session, spends it many times faster. Up to five agents on the smaller model at once, at most two subagents on the larger one (the lead not counted). +**A role started more than once has a definition.** When a role in the table above, or any other agent a +playbook starts (a reviewer, a watcher, a survey), is started a second time, it is taken from a definition in +the `.claude/agents/` of the repository whose work it serves, named in that repository's AGENTS.md and in the +playbook step that starts it; the lead writes the definition the second time it writes such a prompt, in the +same turn. Only what every session on a node or across the mesh needs is registered through the claude-code +module (the operator, 2026-11-02). hq's words test reads `.claude/`, so a definition uses the glossary's words. + ## Following and reporting Most lost time is waiting nobody saw. The lead therefore keeps a **wait list**: everything the feature waits From 6c395cc206674d44ee4d836362e6bbd86a2c7e2c Mon Sep 17 00:00:00 2001 From: jochen Date: Mon, 2 Nov 2026 19:42:08 +0100 Subject: [PATCH 2/3] Playbook 07: say how the agent-definition rule is checked --- 00-META/process/07-feature-branches.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/00-META/process/07-feature-branches.md b/00-META/process/07-feature-branches.md index b4f9f972..785a2bdf 100644 --- a/00-META/process/07-feature-branches.md +++ b/00-META/process/07-feature-branches.md @@ -558,7 +558,8 @@ playbook starts (a reviewer, a watcher, a survey), is started a second time, it the `.claude/agents/` of the repository whose work it serves, named in that repository's AGENTS.md and in the playbook step that starts it; the lead writes the definition the second time it writes such a prompt, in the same turn. Only what every session on a node or across the mesh needs is registered through the claude-code -module (the operator, 2026-11-02). hq's words test reads `.claude/`, so a definition uses the glossary's words. +module (the operator, 2026-11-02). hq's words test reads `.claude/`, so a definition uses the glossary's words. Whether a definition exists is the +reviewer's to check: a prompt for a role written by hand a second time, where none was made, is a finding of the review. ## Following and reporting From 7470927a07a005ef0f73e109b1eb4fc100f75ee7 Mon Sep 17 00:00:00 2001 From: jochen Date: Mon, 2 Nov 2026 19:45:17 +0100 Subject: [PATCH 3/3] Playbook 07 keeps to feature work: the rule on agent definitions goes to an instruction section for every session (the operator, 2026-11-02) --- 00-META/process/07-feature-branches.md | 8 -------- 1 file changed, 8 deletions(-) diff --git a/00-META/process/07-feature-branches.md b/00-META/process/07-feature-branches.md index 785a2bdf..fe15ed7a 100644 --- a/00-META/process/07-feature-branches.md +++ b/00-META/process/07-feature-branches.md @@ -553,14 +553,6 @@ Every agent the mesh runs draws on one weekly allowance shared by every session, spends it many times faster. Up to five agents on the smaller model at once, at most two subagents on the larger one (the lead not counted). -**A role started more than once has a definition.** When a role in the table above, or any other agent a -playbook starts (a reviewer, a watcher, a survey), is started a second time, it is taken from a definition in -the `.claude/agents/` of the repository whose work it serves, named in that repository's AGENTS.md and in the -playbook step that starts it; the lead writes the definition the second time it writes such a prompt, in the -same turn. Only what every session on a node or across the mesh needs is registered through the claude-code -module (the operator, 2026-11-02). hq's words test reads `.claude/`, so a definition uses the glossary's words. Whether a definition exists is the -reviewer's to check: a prompt for a role written by hand a second time, where none was made, is a finding of the review. - ## Following and reporting Most lost time is waiting nobody saw. The lead therefore keeps a **wait list**: everything the feature waits