claude-raid 0.2.7 → 0.2.8
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.
- package/README.md +84 -23
- package/bin/cli.js +4 -2
- package/package.json +1 -1
- package/src/descriptions.js +10 -7
- package/src/init.js +36 -5
- package/src/merge-settings.js +43 -1
- package/src/remove.js +1 -1
- package/src/setup.js +32 -0
- package/src/ui.js +1 -0
- package/src/update.js +26 -3
- package/template/.claude/agents/archer.md +18 -4
- package/template/.claude/agents/rogue.md +18 -4
- package/template/.claude/agents/warrior.md +18 -4
- package/template/.claude/agents/wizard.md +32 -5
- package/template/.claude/dungeon-master-rules.md +120 -31
- package/template/.claude/hooks/raid-lib.sh +45 -4
- package/template/.claude/hooks/raid-pre-compact.sh +8 -4
- package/template/.claude/hooks/raid-session-end.sh +2 -2
- package/template/.claude/hooks/raid-session-start.sh +2 -0
- package/template/.claude/hooks/rtk-bridge.sh +46 -0
- package/template/.claude/hooks/validate-dungeon.sh +11 -3
- package/template/.claude/hooks/validate-file-naming.sh +6 -1
- package/template/.claude/hooks/validate-no-placeholders.sh +13 -2
- package/template/.claude/hooks/validate-write-gate.sh +7 -2
- package/template/.claude/party-rules.md +91 -65
- package/template/.claude/skills/raid-browser/SKILL.md +3 -5
- package/template/.claude/skills/raid-browser-chrome/SKILL.md +1 -1
- package/template/.claude/skills/raid-canonical-design/SKILL.md +309 -162
- package/template/.claude/skills/raid-canonical-implementation/SKILL.md +157 -132
- package/template/.claude/skills/raid-canonical-implementation-plan/SKILL.md +196 -141
- package/template/.claude/skills/raid-canonical-prd/SKILL.md +92 -89
- package/template/.claude/skills/raid-canonical-protocol/SKILL.md +29 -123
- package/template/.claude/skills/raid-canonical-review/SKILL.md +292 -148
- package/template/.claude/skills/raid-debugging/SKILL.md +1 -7
- package/template/.claude/skills/raid-init/SKILL.md +7 -5
- package/template/.claude/skills/raid-tdd/SKILL.md +5 -5
- package/template/.claude/skills/raid-teambuff/SKILL.md +6 -24
- package/template/.claude/skills/raid-verification/SKILL.md +0 -6
- 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 (
|
|
40
|
-
"Agents write reflections (
|
|
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
|
|
223
|
+
### 1. Ghost Turns — Working After TURN_COMPLETE
|
|
242
224
|
|
|
243
|
-
An agent signals `
|
|
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 `
|
|
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:** `
|
|
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
|
-
|
|
64
|
-
##
|
|
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
|
-
|
|
68
|
-
|
|
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
|
-
|
|
73
|
-
|
|
74
|
-
|
|
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:
|
|
77
|
-
|
|
78
|
-
-
|
|
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
|
-
|
|
82
|
-
-
|
|
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
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
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.
|