claude-raid 0.2.7 → 0.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.md +84 -23
  2. package/bin/cli.js +4 -2
  3. package/package.json +1 -1
  4. package/src/descriptions.js +10 -7
  5. package/src/init.js +36 -5
  6. package/src/merge-settings.js +53 -2
  7. package/src/remove.js +1 -1
  8. package/src/setup.js +32 -0
  9. package/src/ui.js +1 -0
  10. package/src/update.js +26 -3
  11. package/template/.claude/agents/archer.md +18 -4
  12. package/template/.claude/agents/rogue.md +18 -4
  13. package/template/.claude/agents/warrior.md +18 -4
  14. package/template/.claude/agents/wizard.md +32 -5
  15. package/template/.claude/dungeon-master-rules.md +120 -31
  16. package/template/.claude/hooks/raid-lib.sh +45 -4
  17. package/template/.claude/hooks/raid-pre-compact.sh +8 -4
  18. package/template/.claude/hooks/raid-session-end.sh +2 -2
  19. package/template/.claude/hooks/raid-session-start.sh +2 -0
  20. package/template/.claude/hooks/rtk-bridge.sh +46 -0
  21. package/template/.claude/hooks/validate-dungeon.sh +11 -3
  22. package/template/.claude/hooks/validate-file-naming.sh +6 -1
  23. package/template/.claude/hooks/validate-no-placeholders.sh +13 -2
  24. package/template/.claude/hooks/validate-write-gate.sh +7 -2
  25. package/template/.claude/party-rules.md +91 -65
  26. package/template/.claude/skills/raid-browser/SKILL.md +3 -5
  27. package/template/.claude/skills/raid-browser-chrome/SKILL.md +1 -1
  28. package/template/.claude/skills/raid-canonical-design/SKILL.md +309 -162
  29. package/template/.claude/skills/raid-canonical-implementation/SKILL.md +157 -132
  30. package/template/.claude/skills/raid-canonical-implementation-plan/SKILL.md +196 -141
  31. package/template/.claude/skills/raid-canonical-prd/SKILL.md +92 -89
  32. package/template/.claude/skills/raid-canonical-protocol/SKILL.md +29 -123
  33. package/template/.claude/skills/raid-canonical-review/SKILL.md +292 -148
  34. package/template/.claude/skills/raid-debugging/SKILL.md +1 -7
  35. package/template/.claude/skills/raid-init/SKILL.md +7 -5
  36. package/template/.claude/skills/raid-tdd/SKILL.md +5 -5
  37. package/template/.claude/skills/raid-teambuff/SKILL.md +6 -24
  38. package/template/.claude/skills/raid-verification/SKILL.md +0 -6
  39. package/template/.claude/skills/raid-wrap-up/SKILL.md +30 -29
@@ -21,14 +21,6 @@ The output is a structured report with binding rulings that the human approves.
21
21
 
22
22
  **Only the human.** No agent, not even the Wizard, can call a teambuff. The human says "teambuff" or invokes `/raid-teambuff` and it happens immediately.
23
23
 
24
- ## Mode Behavior
25
-
26
- | Aspect | Full Raid | Skirmish | Scout |
27
- |--------|-----------|----------|-------|
28
- | Participants | Wizard + Warrior + Archer + Rogue | Wizard + 2 active agents | Wizard self-reflects alone |
29
- | Cross-criticism | All-vs-all, no one exempt | Between active agents + Wizard | N/A |
30
- | Rulings | Full synthesis from all reflections | Condensed synthesis | Wizard notes only |
31
-
32
24
  ## Process Flow
33
25
 
34
26
  ```dot
@@ -36,8 +28,8 @@ digraph teambuff {
36
28
  "Human triggers teambuff" -> "Wizard: HALT. Round table called.";
37
29
  "Wizard: HALT. Round table called." -> "Create teambuff-{NN}.md";
38
30
  "Create teambuff-{NN}.md" -> "Dispatch all agents: reflect";
39
- "Dispatch all agents: reflect" -> "Agents write reflections (parallel)";
40
- "Agents write reflections (parallel)" -> "Agents read each other's sections";
31
+ "Dispatch all agents: reflect" -> "Agents write reflections (sequential turns)";
32
+ "Agents write reflections (sequential turns)" -> "Agents read each other's sections";
41
33
  "Agents read each other's sections" -> "Agents write criticisms";
42
34
  "Agents write criticisms" -> "Wizard writes own reflection + criticism";
43
35
  "Wizard writes own reflection + criticism" -> "Wizard reads everything";
@@ -223,28 +215,18 @@ After any teambuff has occurred, the Wizard adds this to every round start:
223
215
  3. If current dispatch would violate a ruling, adjust before dispatching
224
216
  4. If an agent's work violates a ruling, flag it immediately
225
217
 
226
- ## Skirmish Mode
227
-
228
- Same process, fewer agents. Only the active 2 agents + Wizard participate. Cross-criticism happens between whoever is present.
229
-
230
- ## Scout Mode
231
-
232
- Wizard reflects alone. No dispatch, no cross-criticism. Wizard writes:
233
- - Own reflection (same structured sections)
234
- - Self-criticism
235
- - Proposed rulings (presented to human for approval)
236
218
 
237
219
  ## Known Dysfunction Patterns
238
220
 
239
221
  These are real patterns observed in production quests. When reflecting, look for these specifically — they are the most common sources of token waste and team friction.
240
222
 
241
- ### 1. Ghost Rounds — Working After ROUND_COMPLETE
223
+ ### 1. Ghost Turns — Working After TURN_COMPLETE
242
224
 
243
- An agent signals `ROUND_COMPLETE:` but keeps working — cross-verifying, building on findings, challenging teammates. This burns tokens on work the Wizard didn't dispatch and creates confusion about what's "official" output vs unsanctioned noise.
225
+ An agent signals `TURN_COMPLETE:` but keeps working — exploring tangents, building on findings, investigating further. This burns tokens on work the Wizard didn't dispatch and creates confusion about what's "official" output vs unsanctioned noise.
244
226
 
245
- **What to look for:** Did any agent produce work after their `ROUND_COMPLETE:` signal? Did agents treat ROUND_COMPLETE as "my initial research is done, now I'll cross-verify" instead of a full stop?
227
+ **What to look for:** Did any agent produce work after their `TURN_COMPLETE:` signal? Did agents treat TURN_COMPLETE as "my initial research is done, now I'll keep going" instead of a full stop?
246
228
 
247
- **The fix:** `ROUND_COMPLETE:` means stop. Period. No "while I wait" tasks. The Wizard controls when the next round begins.
229
+ **The fix:** `TURN_COMPLETE:` means stop. Period. No "while I wait" tasks. The Wizard controls when the next turn begins.
248
230
 
249
231
  ### 2. Wizard Presenting While Agents Are Active
250
232
 
@@ -19,12 +19,6 @@ NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE
19
19
 
20
20
  If you haven't run the verification command THIS turn, you cannot claim it passes.
21
21
 
22
- ## Mode Behavior
23
-
24
- - **Full Raid**: Triple verification — implementer + 2 challengers verify independently.
25
- - **Skirmish**: Double verification — implementer + 1 challenger.
26
- - **Scout**: Single verification + Wizard confirms.
27
-
28
22
  ## The Gate Function
29
23
 
30
24
  ```
@@ -11,12 +11,6 @@ The quest ends. The bard sings the tale. The treasure is committed. The party re
11
11
  Do NOT write new code. This phase is about reporting, cleanup, PR creation, and archival. Agents are dismissed, not dispatched.
12
12
  </HARD-GATE>
13
13
 
14
- ## Mode Behavior
15
-
16
- - **Full Raid**: Wizard writes full storyboard from all phase files. Full PR with narrative.
17
- - **Skirmish**: Wizard writes condensed storyboard. Standard PR.
18
- - **Scout**: Wizard writes brief summary. Quick PR.
19
-
20
14
  ## Process Flow
21
15
 
22
16
  ```dot
@@ -60,38 +54,45 @@ Create `{questDir}/phase-6-wrap-up.md` and write a phase-by-phase narrative:
60
54
 
61
55
  ```markdown
62
56
  # Phase 6: Wrap Up — Quest Storyboard
63
- ## Quest: <quest name>
64
- ## Mode: <mode>
57
+
58
+ ## Quest: [quest name]
59
+
60
+ ## References
61
+ - PRD: `{questDir}/spoils/prd.md` (if exists)
62
+ - Design: `{questDir}/spoils/design.md`
63
+ - Design Evolution: `{questDir}/phases/phase-2-design.md`
64
+ - Plan: `{questDir}/phases/phase-3-plan.md`
65
+ - Tasks: `{questDir}/spoils/tasks/phase-3-plan-task-*.md`
66
+ - Implementation: `{questDir}/phases/phase-4-implementation.md`
67
+ - Review: `{questDir}/spoils/review.md` (if exists)
68
+ - Review Evolution: `{questDir}/phases/phase-5-review.md` (if exists)
69
+
70
+ ---
65
71
 
66
72
  ### Phase 1: PRD — Forging the Scroll
67
- (if prd.md exists)
68
- - What requirements were established
69
- - Key decisions from research
73
+ <!-- If prd.md exists. Summarize: what requirements were established,
74
+ key decisions, any surprising findings from exploration. 2-5 bullets. -->
70
75
 
71
76
  ### Phase 2: Design — Charting the Map
72
- - Architecture chosen and why
73
- - Key trade-offs resolved
74
- - Alternatives considered and rejected
77
+ <!-- Who wrote the initial design (dice result). Key defend/concede moments.
78
+ Architecture chosen and main alternatives rejected.
79
+ Drift check result if PRD existed. 3-6 bullets. -->
75
80
 
76
- ### Phase 3: Implementation Plan — Marshaling the Forces
77
- - Number of tasks, dependency structure
78
- - Risk areas identified
81
+ ### Phase 3: Plan — Marshaling the Forces
82
+ <!-- Total task count, dependency structure highlights.
83
+ Key findings from plan review that changed the decomposition. 2-4 bullets. -->
79
84
 
80
85
  ### Phase 4: Implementation — Into the Fray
81
- - What was built
82
- - Challenges overcome
83
- - Test coverage highlights
86
+ <!-- How tasks were divided (which agent, which domain).
87
+ Notable challenges overcome. Test count / coverage highlights. 3-5 bullets. -->
84
88
 
85
89
  ### Phase 5: Review — Inspecting the Treasure
86
- (if phase-5-review.md exists)
87
- - Findings pinned and resolved
88
- - Black cards (if any)
89
- - Fixes applied
90
-
91
- ### Summary
92
- - Total phases completed
93
- - Key achievements
94
- - Known limitations
90
+ <!-- If review ran. Findings count by severity.
91
+ Key fixes applied. Black cards if any. 2-5 bullets. -->
92
+
93
+ ### Quest Summary
94
+ <!-- Total phases completed. Key achievements (what was built).
95
+ Known limitations (deferred items, accepted constraints). -->
95
96
  ```
96
97
 
97
98
  Read all prior phase files from the quest directory to build this narrative.