@codename_inc/spectre 5.2.2 → 5.3.0

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 (76) hide show
  1. package/package.json +1 -1
  2. package/plugins/spectre/.claude-plugin/plugin.json +1 -1
  3. package/plugins/spectre/hooks/scripts/load-knowledge.mjs +14 -3
  4. package/plugins/spectre/hooks/scripts/register_learning.mjs +8 -1
  5. package/plugins/spectre/hooks/scripts/test_load-knowledge.mjs +4 -4
  6. package/plugins/spectre/hooks/scripts/test_register-learning.mjs +2 -2
  7. package/plugins/spectre/skills/{apply → spectre-apply}/SKILL.md +3 -3
  8. package/plugins/spectre/skills/{architecture_review → spectre-architecture_review}/SKILL.md +1 -1
  9. package/plugins/spectre/skills/{clean → spectre-clean}/SKILL.md +1 -1
  10. package/plugins/spectre/skills/{code_review → spectre-code_review}/SKILL.md +1 -1
  11. package/plugins/spectre/skills/{create_plan → spectre-create_plan}/SKILL.md +1 -1
  12. package/plugins/spectre/skills/{create_tasks → spectre-create_tasks}/SKILL.md +1 -1
  13. package/plugins/spectre/skills/{create_test_guide → spectre-create_test_guide}/SKILL.md +1 -1
  14. package/plugins/spectre/skills/{evaluate → spectre-evaluate}/SKILL.md +3 -3
  15. package/plugins/spectre/skills/{execute → spectre-execute}/SKILL.md +3 -3
  16. package/plugins/spectre/skills/{fix → spectre-fix}/SKILL.md +1 -1
  17. package/plugins/spectre/skills/{forget → spectre-forget}/SKILL.md +1 -1
  18. package/plugins/spectre/skills/{guide → spectre-guide}/SKILL.md +1 -1
  19. package/plugins/spectre/skills/{handoff → spectre-handoff}/SKILL.md +1 -1
  20. package/plugins/spectre/skills/{kickoff → spectre-kickoff}/SKILL.md +1 -1
  21. package/plugins/spectre/skills/{learn → spectre-learn}/SKILL.md +2 -2
  22. package/plugins/spectre/skills/{plan → spectre-plan}/SKILL.md +2 -2
  23. package/plugins/spectre/skills/{plan_review → spectre-plan_review}/SKILL.md +1 -1
  24. package/plugins/spectre/skills/{prototype → spectre-prototype}/SKILL.md +1 -1
  25. package/plugins/spectre/skills/{quick_dev → spectre-quick_dev}/SKILL.md +1 -1
  26. package/plugins/spectre/skills/{rebase → spectre-rebase}/SKILL.md +1 -1
  27. package/plugins/spectre/skills/spectre-recall/SKILL.md +22 -0
  28. package/plugins/spectre/skills/{research → spectre-research}/SKILL.md +1 -1
  29. package/plugins/spectre/skills/{scope → spectre-scope}/SKILL.md +1 -1
  30. package/plugins/spectre/skills/{ship → spectre-ship}/SKILL.md +1 -1
  31. package/plugins/spectre/skills/{sweep → spectre-sweep}/SKILL.md +1 -1
  32. package/plugins/spectre/skills/{tdd → spectre-tdd}/SKILL.md +1 -1
  33. package/plugins/spectre/skills/{test → spectre-test}/SKILL.md +1 -1
  34. package/plugins/spectre/skills/{ux → spectre-ux}/SKILL.md +1 -1
  35. package/plugins/spectre/skills/{validate → spectre-validate}/SKILL.md +1 -1
  36. package/plugins/spectre-codex/hooks/scripts/load-knowledge.mjs +14 -3
  37. package/plugins/spectre-codex/hooks/scripts/register_learning.mjs +8 -1
  38. package/plugins/spectre-codex/skills/{apply → spectre-apply}/SKILL.md +3 -3
  39. package/plugins/spectre-codex/skills/{architecture_review → spectre-architecture_review}/SKILL.md +1 -1
  40. package/plugins/spectre-codex/skills/{clean → spectre-clean}/SKILL.md +1 -1
  41. package/plugins/spectre-codex/skills/{code_review → spectre-code_review}/SKILL.md +1 -1
  42. package/plugins/spectre-codex/skills/{create_plan → spectre-create_plan}/SKILL.md +1 -1
  43. package/plugins/spectre-codex/skills/{create_tasks → spectre-create_tasks}/SKILL.md +1 -1
  44. package/plugins/spectre-codex/skills/{create_test_guide → spectre-create_test_guide}/SKILL.md +1 -1
  45. package/plugins/spectre-codex/skills/{evaluate → spectre-evaluate}/SKILL.md +3 -3
  46. package/plugins/spectre-codex/skills/{execute → spectre-execute}/SKILL.md +3 -3
  47. package/plugins/spectre-codex/skills/{fix → spectre-fix}/SKILL.md +1 -1
  48. package/plugins/spectre-codex/skills/{forget → spectre-forget}/SKILL.md +1 -1
  49. package/plugins/spectre-codex/skills/{guide → spectre-guide}/SKILL.md +81 -81
  50. package/plugins/spectre-codex/skills/{handoff → spectre-handoff}/SKILL.md +1 -1
  51. package/plugins/spectre-codex/skills/{kickoff → spectre-kickoff}/SKILL.md +7 -7
  52. package/plugins/spectre-codex/skills/{learn → spectre-learn}/SKILL.md +2 -2
  53. package/plugins/spectre-codex/skills/{plan → spectre-plan}/SKILL.md +4 -4
  54. package/plugins/spectre-codex/skills/{plan_review → spectre-plan_review}/SKILL.md +3 -3
  55. package/plugins/spectre-codex/skills/{prototype → spectre-prototype}/SKILL.md +9 -9
  56. package/plugins/spectre-codex/skills/{quick_dev → spectre-quick_dev}/SKILL.md +2 -2
  57. package/plugins/spectre-codex/skills/{rebase → spectre-rebase}/SKILL.md +1 -1
  58. package/plugins/spectre-codex/skills/spectre-recall/SKILL.md +22 -0
  59. package/plugins/spectre-codex/skills/{research → spectre-research}/SKILL.md +1 -1
  60. package/plugins/spectre-codex/skills/{scope → spectre-scope}/SKILL.md +8 -8
  61. package/plugins/spectre-codex/skills/{ship → spectre-ship}/SKILL.md +4 -4
  62. package/plugins/spectre-codex/skills/{sweep → spectre-sweep}/SKILL.md +1 -1
  63. package/plugins/spectre-codex/skills/{tdd → spectre-tdd}/SKILL.md +1 -1
  64. package/plugins/spectre-codex/skills/{test → spectre-test}/SKILL.md +1 -1
  65. package/plugins/spectre-codex/skills/{ux → spectre-ux}/SKILL.md +6 -6
  66. package/plugins/spectre-codex/skills/{validate → spectre-validate}/SKILL.md +1 -1
  67. package/src/config.test.js +1 -1
  68. package/src/install.test.js +10 -6
  69. package/src/lib/constants.js +9 -9
  70. package/src/lib/install.js +29 -1
  71. package/src/lib/knowledge.js +7 -5
  72. package/src/pack.test.js +1 -1
  73. package/plugins/spectre/skills/recall/SKILL.md +0 -17
  74. package/plugins/spectre-codex/skills/recall/SKILL.md +0 -17
  75. /package/plugins/spectre/skills/{learn → spectre-learn}/references/recall-template.md +0 -0
  76. /package/plugins/spectre-codex/skills/{learn → spectre-learn}/references/recall-template.md +0 -0
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "execute"
2
+ name: "spectre-execute"
3
3
  description: "👻 | Adaptive Wave-Based Build with Per-Wave Verification Gate"
4
4
  user-invocable: true
5
5
  ---
@@ -118,7 +118,7 @@ $ARGUMENTS
118
118
 
119
119
  ## Step 2 - Cross-Wave Validate
120
120
 
121
- - **Action** — SpawnValidation: @analyst runs `Skill(validate)` (Claude slash route: `validate`) with **narrowed scope**:
121
+ - **Action** — SpawnValidation: @analyst runs `Skill(spectre-validate)` (Claude slash route: `spectre-validate`) with **narrowed scope**:
122
122
  - Focus: cross-wave integration audit (did later waves silently break earlier waves' wiring?) + scope-creep audit (anything implemented that is NOT in the acceptance criteria?) + dead-computation sweep across the full cumulative diff
123
123
  - Skip: per-area wiring verification (already done per-wave in Step 1.3b's wiring lens)
124
124
 
@@ -126,7 +126,7 @@ $ARGUMENTS
126
126
 
127
127
  ## Step 3 - Prepare for QA
128
128
 
129
- - **Action** — GenerateTestGuide: @dev runs `Skill(create_test_guide)` (Claude slash route: `create_test_guide`)
129
+ - **Action** — GenerateTestGuide: @dev runs `Skill(spectre-create_test_guide)` (Claude slash route: `spectre-create_test_guide`)
130
130
  - Save to `{OUT_DIR}/test_guide.md`
131
131
 
132
132
  ## Step 4 - Report
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "fix"
2
+ name: "spectre-fix"
3
3
  description: "Investigate bugs & implement fixes - primary agent"
4
4
  user-invocable: true
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "forget"
2
+ name: "spectre-forget"
3
3
  description: "Clear session memory - archive all session files so next session starts fresh"
4
4
  user-invocable: true
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "guide"
2
+ name: "spectre-guide"
3
3
  description: "Use when rendering the Next Steps footer after any spectre command, suggesting next actions, or when users need guidance on which SPECTRE command to run."
4
4
  user-invocable: false
5
5
  ---
@@ -53,7 +53,7 @@ AI agents are 10x better at working around *working* existing code. That's why t
53
53
  ### Your First Feature
54
54
 
55
55
  ```plaintext
56
- scope
56
+ spectre-scope
57
57
  ```
58
58
 
59
59
  That's it. Start with scope, follow the prompts, and SPECTRE will guide you through the rest. Every command ends with "Next Steps" suggestions — you never have to remember what to run next.
@@ -63,9 +63,9 @@ That's it. Start with scope, follow the prompts, and SPECTRE will guide you thro
63
63
  SPECTRE accumulates context across sessions:
64
64
 
65
65
  1. Turn off auto-compact in Claude Code `/config`
66
- 2. Run `handoff` before session ends or when context window is getting full
66
+ 2. Run `spectre-handoff` before session ends or when context window is getting full
67
67
  3. Run `/clear` — next session auto-loads your progress
68
- 4. `forget` when switching gears to start fresh
68
+ 4. `spectre-forget` when switching gears to start fresh
69
69
 
70
70
  ---
71
71
 
@@ -75,13 +75,13 @@ SPECTRE accumulates context across sessions:
75
75
 
76
76
  | Phase | Command | What It Does |
77
77
  |-------|---------|--------------|
78
- | **S**cope | `scope` | Define requirements, constraints, what's IN and OUT |
79
- | **P**lan | `plan` | Research codebase, create implementation plan + tasks |
80
- | **E**xecute | `execute` | Parallel subagent development in waves |
81
- | **C**lean | `clean` | Remove dead code, fix duplication, lint |
82
- | **T**est | `test` | Risk-aware test coverage (not brute-force 100%) |
83
- | **R**ebase | `rebase` | Safe merge preparation with conflict handling |
84
- | **E**valuate | `evaluate` | Architecture review + knowledge capture |
78
+ | **S**cope | `spectre-scope` | Define requirements, constraints, what's IN and OUT |
79
+ | **P**lan | `spectre-plan` | Research codebase, create implementation plan + tasks |
80
+ | **E**xecute | `spectre-execute` | Parallel subagent development in waves |
81
+ | **C**lean | `spectre-clean` | Remove dead code, fix duplication, lint |
82
+ | **T**est | `spectre-test` | Risk-aware test coverage (not brute-force 100%) |
83
+ | **R**ebase | `spectre-rebase` | Safe merge preparation with conflict handling |
84
+ | **E**valuate | `spectre-evaluate` | Architecture review + knowledge capture |
85
85
 
86
86
  You can use any command standalone — they don't require running in order.
87
87
 
@@ -93,30 +93,30 @@ This is how the creator of SPECTRE uses it daily:
93
93
 
94
94
  ### Building a Feature (the main loop)
95
95
 
96
- 1. **`scope`** — Get crisp on what's in/out. Non-negotiable unless it's a one-liner.
97
- - If UX is unclear: run `ux` first for user flows and components
96
+ 1. **`spectre-scope`** — Get crisp on what's in/out. Non-negotiable unless it's a one-liner.
97
+ - If UX is unclear: run `spectre-ux` first for user flows and components
98
98
 
99
- 2. **`plan`** — Build a well-researched technical design or task set
100
- - Once you have scope/plan/tasks, run `handoff` for a fresh context window
99
+ 2. **`spectre-plan`** — Build a well-researched technical design or task set
100
+ - Once you have scope/plan/tasks, run `spectre-handoff` for a fresh context window
101
101
 
102
- 3. **`execute`** — Parallel subagents work through the tasks
102
+ 3. **`spectre-execute`** — Parallel subagents work through the tasks
103
103
  - Execute also calls code review and validation automatically
104
- - When done, run `handoff` again for clean context
104
+ - When done, run `spectre-handoff` again for clean context
105
105
 
106
106
  4. **Manual testing + fixes** — Test the feature yourself
107
107
  - Use Claude Code's built-in `/plan` mode for small fixes
108
- - Use `fix` for structured debugging of tough bugs
109
- - New scope needed? Run another `scope` cycle
110
- - Use `handoff` liberally to keep context clean
108
+ - Use `spectre-fix` for structured debugging of tough bugs
109
+ - New scope needed? Run another `spectre-scope` cycle
110
+ - Use `spectre-handoff` liberally to keep context clean
111
111
 
112
- 5. **`sweep`** — Commit accumulated changes with lint + test
112
+ 5. **`spectre-sweep`** — Commit accumulated changes with lint + test
113
113
  - Groups changes logically with descriptive conventional commits
114
114
 
115
- 6. **`clean`** then **`test`** — Deep cleanup and risk-aware testing
115
+ 6. **`spectre-clean`** then **`spectre-test`** — Deep cleanup and risk-aware testing
116
116
 
117
- 7. **`rebase`** — Rebase onto parent branch, prepare for merge
117
+ 7. **`spectre-rebase`** — Rebase onto parent branch, prepare for merge
118
118
 
119
- 8. **`evaluate`** — Architecture review + capture knowledge for future sessions
119
+ 8. **`spectre-evaluate`** — Architecture review + capture knowledge for future sessions
120
120
 
121
121
  9. **Merge/PR** — Address PR comments, get it checked in
122
122
 
@@ -124,7 +124,7 @@ This is how the creator of SPECTRE uses it daily:
124
124
 
125
125
  For small/medium changes (1-5 tasks):
126
126
  ```plaintext
127
- quick_dev
127
+ spectre-quick_dev
128
128
  ```
129
129
  Lightweight scope + plan that gets you to execution fast.
130
130
 
@@ -132,7 +132,7 @@ Lightweight scope + plan that gets you to execution fast.
132
132
 
133
133
  For low-complexity features/fixes where you trust the agent:
134
134
  ```plaintext
135
- ship
135
+ spectre-ship
136
136
  ```
137
137
  Brain dump context, walk away, review the PR. Zero confirmation gates — scope, TDD, sweep, rebase, and PR creation happen autonomously.
138
138
 
@@ -144,118 +144,118 @@ Brain dump context, walk away, review the PR. Zero confirmation gates — scope,
144
144
 
145
145
  | Command | When to Use |
146
146
  |---------|-------------|
147
- | `scope` | Starting any new feature — interactive scoping with IN/OUT boundaries |
148
- | `kickoff` | High-ambiguity projects — includes web research for best practices |
149
- | `research` | Need deep codebase understanding before planning |
150
- | `ux` | UI-heavy features that need screen layouts, user flows, component states |
147
+ | `spectre-scope` | Starting any new feature — interactive scoping with IN/OUT boundaries |
148
+ | `spectre-kickoff` | High-ambiguity projects — includes web research for best practices |
149
+ | `spectre-research` | Need deep codebase understanding before planning |
150
+ | `spectre-ux` | UI-heavy features that need screen layouts, user flows, component states |
151
151
 
152
152
  ### Phase: Plan — Research & Task Breakdown
153
153
 
154
154
  | Command | When to Use |
155
155
  |---------|-------------|
156
- | `plan` | Unified entry — researches, assesses complexity, routes to right workflow |
157
- | `create_plan` | Complex work needing architectural design before tasking |
158
- | `create_tasks` | Requirements/plan ready to become concrete tasks |
159
- | `plan_review` | Sanity check a plan/task list for over-engineering |
156
+ | `spectre-plan` | Unified entry — researches, assesses complexity, routes to right workflow |
157
+ | `spectre-create_plan` | Complex work needing architectural design before tasking |
158
+ | `spectre-create_tasks` | Requirements/plan ready to become concrete tasks |
159
+ | `spectre-plan_review` | Sanity check a plan/task list for over-engineering |
160
160
 
161
161
  ### Phase: Execute — Development & Verification
162
162
 
163
163
  | Command | When to Use |
164
164
  |---------|-------------|
165
- | `execute` | Tasks exist, ready for coordinated multi-agent parallel execution |
166
- | `code_review` | Implementation complete, ready for in-depth review |
167
- | `validate` | Verify implementation against original scope requirement-by-requirement |
168
- | `create_test_guide` | Generate manual QA checklist based on features and risks |
165
+ | `spectre-execute` | Tasks exist, ready for coordinated multi-agent parallel execution |
166
+ | `spectre-code_review` | Implementation complete, ready for in-depth review |
167
+ | `spectre-validate` | Verify implementation against original scope requirement-by-requirement |
168
+ | `spectre-create_test_guide` | Generate manual QA checklist based on features and risks |
169
169
 
170
170
  ### Phase: Clean — Codebase Hygiene
171
171
 
172
172
  | Command | When to Use |
173
173
  |---------|-------------|
174
- | `clean` | Deep cleanup — dead code, duplication, artifacts |
175
- | `sweep` | Light pass — lint, test, descriptive commits for accumulated changes |
174
+ | `spectre-clean` | Deep cleanup — dead code, duplication, artifacts |
175
+ | `spectre-sweep` | Light pass — lint, test, descriptive commits for accumulated changes |
176
176
 
177
177
  ### Phase: Test — Risk-Aware Coverage
178
178
 
179
179
  | Command | When to Use |
180
180
  |---------|-------------|
181
- | `test` | After changes — analyzes risk tiers (P0-P3), writes behavioral tests |
181
+ | `spectre-test` | After changes — analyzes risk tiers (P0-P3), writes behavioral tests |
182
182
 
183
183
  ### Phase: Rebase — Merge Preparation
184
184
 
185
185
  | Command | When to Use |
186
186
  |---------|-------------|
187
- | `rebase` | Rebase working branch onto target with conflict handling |
187
+ | `spectre-rebase` | Rebase working branch onto target with conflict handling |
188
188
 
189
189
  ### Phase: Evaluate — Review & Learn
190
190
 
191
191
  | Command | When to Use |
192
192
  |---------|-------------|
193
- | `evaluate` | Full evaluate — architecture review (background) + knowledge capture |
194
- | `learn` | Just capture knowledge from this session |
195
- | `architecture_review` | Just run the architecture review |
196
- | `recall {query}` | Find and load existing knowledge |
193
+ | `spectre-evaluate` | Full evaluate — architecture review (background) + knowledge capture |
194
+ | `spectre-learn` | Just capture knowledge from this session |
195
+ | `spectre-architecture_review` | Just run the architecture review |
196
+ | `spectre-recall {query}` | Find and load existing knowledge |
197
197
 
198
198
  ### Session & Utilities
199
199
 
200
200
  | Command | When to Use |
201
201
  |---------|-------------|
202
- | `handoff` | Save session state — end of session, context full, switching gears |
203
- | `forget` | Clear memory, archive logs, start fresh |
204
- | `fix` | Structured debugging for tough bugs |
205
- | `quick_dev` | Lightweight scope + plan for small/medium tasks |
206
- | `ship` | Autonomous end-to-end: brain dump → scope → TDD → commit → rebase → PR |
202
+ | `spectre-handoff` | Save session state — end of session, context full, switching gears |
203
+ | `spectre-forget` | Clear memory, archive logs, start fresh |
204
+ | `spectre-fix` | Structured debugging for tough bugs |
205
+ | `spectre-quick_dev` | Lightweight scope + plan for small/medium tasks |
206
+ | `spectre-ship` | Autonomous end-to-end: brain dump → scope → TDD → commit → rebase → PR |
207
207
 
208
208
  ---
209
209
 
210
210
  ## Quick Decision Tree
211
211
 
212
212
  **Starting a feature?**
213
- -> `scope` (always start here unless it's trivial)
213
+ -> `spectre-scope` (always start here unless it's trivial)
214
214
 
215
215
  **Feature has complex UI?**
216
- -> `ux` after scope, before plan
216
+ -> `spectre-ux` after scope, before plan
217
217
 
218
218
  **High ambiguity / new project?**
219
- -> `kickoff` (includes web research)
219
+ -> `spectre-kickoff` (includes web research)
220
220
 
221
221
  **Need to understand code first?**
222
- -> `research`
222
+ -> `spectre-research`
223
223
 
224
224
  **Have scope, need plan?**
225
- -> `plan` (auto-routes based on complexity)
225
+ -> `spectre-plan` (auto-routes based on complexity)
226
226
 
227
227
  **Have tasks, ready to build?**
228
- -> `execute`
228
+ -> `spectre-execute`
229
229
 
230
230
  **Code complete, need review?**
231
- -> `code_review` then `validate`
231
+ -> `spectre-code_review` then `spectre-validate`
232
232
 
233
233
  **Accumulated uncommitted changes?**
234
- -> `sweep` (light) or `clean` (deep)
234
+ -> `spectre-sweep` (light) or `spectre-clean` (deep)
235
235
 
236
236
  **Need test coverage?**
237
- -> `test`
237
+ -> `spectre-test`
238
238
 
239
239
  **Ready to merge?**
240
- -> `rebase`
240
+ -> `spectre-rebase`
241
241
 
242
242
  **Feature done?**
243
- -> `evaluate` (review + learn)
243
+ -> `spectre-evaluate` (review + learn)
244
244
 
245
245
  **Ending session?**
246
- -> `handoff`
246
+ -> `spectre-handoff`
247
247
 
248
248
  **Switching contexts?**
249
- -> `forget`
249
+ -> `spectre-forget`
250
250
 
251
251
  **Bug to fix?**
252
- -> `fix`
252
+ -> `spectre-fix`
253
253
 
254
254
  **Small task, skip ceremony?**
255
- -> `quick_dev`
255
+ -> `spectre-quick_dev`
256
256
 
257
257
  **Low-complexity task, full autonomy?**
258
- -> `ship` (brain dump → PR, zero gates)
258
+ -> `spectre-ship` (brain dump → PR, zero gates)
259
259
 
260
260
  ---
261
261
 
@@ -282,14 +282,14 @@ SPECTRE generates these documents in `docs/tasks/{branch_name}/`:
282
282
 
283
283
  | Document | Generated By | Purpose |
284
284
  |----------|-------------|---------|
285
- | `concepts/scope.md` | `scope` | What's IN and OUT |
286
- | `specs/ux.md` | `ux` | User flows, components, interactions |
287
- | `specs/plan.md` | `create_plan` | Technical design and phasing |
288
- | `specs/tasks.md` | `create_tasks` | Concrete tasks with acceptance criteria |
289
- | `reviews/code_review.md` | `code_review` | Severity-based code review findings |
290
- | `validation/validation_gaps.md` | `validate` | Gaps between scope and implementation |
291
- | `testing/*_test_guide.md` | `create_test_guide` | Manual QA checklists |
292
- | `session_logs/*_handoff.json` | `handoff` | Session state snapshots |
285
+ | `concepts/scope.md` | `spectre-scope` | What's IN and OUT |
286
+ | `specs/ux.md` | `spectre-ux` | User flows, components, interactions |
287
+ | `specs/plan.md` | `spectre-create_plan` | Technical design and phasing |
288
+ | `specs/tasks.md` | `spectre-create_tasks` | Concrete tasks with acceptance criteria |
289
+ | `reviews/code_review.md` | `spectre-code_review` | Severity-based code review findings |
290
+ | `validation/validation_gaps.md` | `spectre-validate` | Gaps between scope and implementation |
291
+ | `testing/*_test_guide.md` | `spectre-create_test_guide` | Manual QA checklists |
292
+ | `session_logs/*_handoff.json` | `spectre-handoff` | Session state snapshots |
293
293
 
294
294
  Keep these checked into git — they're the context in context engineering.
295
295
 
@@ -310,9 +310,9 @@ Keep these checked into git — they're the context in context engineering.
310
310
  ║ Next — {concise recommendation; 1–2 lines max} ║
311
311
  ║ ║
312
312
  ║ Options: ║
313
- ║ - {command or action} — {why} ║
314
- ║ - {command or action} — {why} ║
315
- ║ - {command or action} — {why} ║
313
+ ║ - {spectre-command or action} — {why} ║
314
+ ║ - {spectre-command or action} — {why} ║
315
+ ║ - {spectre-command or action} — {why} ║
316
316
  ║ … up to 5 total; max 2 manual actions ║
317
317
  ║ ║
318
318
  ║ Reply — {only if textual reply expected} ║
@@ -340,14 +340,14 @@ Keep these checked into git — they're the context in context engineering.
340
340
 
341
341
  **CRITICAL:**
342
342
 
343
- 1. **All SPECTRE commands use `/spectre:` prefix** (e.g., `scope`, `execute`)
343
+ 1. **All SPECTRE commands use `/spectre:` prefix** (e.g., `spectre-scope`, `spectre-execute`)
344
344
  2. **Manual actions are NOT slash commands** (e.g., "Run tests", "Review PR feedback")
345
345
  3. **Never invent slash commands** — only suggest commands listed in this guide
346
346
 
347
347
  **Correct:**
348
348
  ```
349
- scope — Interactive feature scoping
350
- execute — Parallel agent execution
349
+ spectre-scope — Interactive feature scoping
350
+ spectre-execute — Parallel agent execution
351
351
  Run manual tests — Execute test guide checklist
352
352
  ```
353
353
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "handoff"
2
+ name: "spectre-handoff"
3
3
  description: "Save state snapshot to session_logs for session resume"
4
4
  user-invocable: true
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "kickoff"
2
+ name: "spectre-kickoff"
3
3
  description: "👻 | Project kickoff with deep research & MVP pathfinding - primary agent"
4
4
  user-invocable: true
5
5
  ---
@@ -114,11 +114,11 @@ $ARGUMENTS
114
114
  > **Established**: User problem, user value, key findings (file:line), decisions made, remaining ambiguities
115
115
  >
116
116
  > **Options**:
117
- > 1. "Proceed with scope" → `scope` with FROM_KICKOFF=true, SKIP_EXPLORATION=true
118
- > 2. "Skip to planning" → `plan` with kickoff doc context
119
- > 3. "Need to think" → `handoff`
117
+ > 1. "Proceed with scope" → `spectre-scope` with FROM_KICKOFF=true, SKIP_EXPLORATION=true
118
+ > 2. "Skip to planning" → `spectre-plan` with kickoff doc context
119
+ > 3. "Need to think" → `spectre-handoff`
120
120
 
121
121
  - **Action** — ExecuteChoice:
122
- - **If** scope → invoke `scope` with: FROM_KICKOFF=true, KICKOFF_DOC={path}, SKIP_EXPLORATION=true, context summary
123
- - **If** planning → suggest `plan`
124
- - **If** pause → run `handoff`
122
+ - **If** scope → invoke `spectre-scope` with: FROM_KICKOFF=true, KICKOFF_DOC={path}, SKIP_EXPLORATION=true, context summary
123
+ - **If** planning → suggest `spectre-plan`
124
+ - **If** pause → run `spectre-handoff`
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "learn"
2
+ name: "spectre-learn"
3
3
  description: "Use when user invokes /learn or wants to save patterns, decisions, gotchas, procedures, or feature knowledge from a conversation for later re-use. Look for user requests like \"please remember\" or \"what did we learn from this?\"."
4
4
  user-invocable: true
5
5
  ---
@@ -11,7 +11,7 @@ You capture durable project knowledge into Skills that Claude Code loads on-dema
11
11
  <CRITICAL>
12
12
  ## Exclusive Knowledge Handler
13
13
 
14
- When this skill is invoked (via `/learn`, `learn`, or `Skill(learn)`), it is the **exclusive handler** for knowledge capture. It supersedes ALL other memory systems.
14
+ When this skill is invoked (via `/learn`, `spectre-learn`, or `Skill(spectre-learn)`), it is the **exclusive handler** for knowledge capture. It supersedes ALL other memory systems.
15
15
 
16
16
  **Do NOT**:
17
17
  - Write to `MEMORY.md` or any auto-memory directory
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "plan"
2
+ name: "spectre-plan"
3
3
  description: "👻 | Unified planning entry point - researches, assesses complexity, routes to workflow - primary agent"
4
4
  user-invocable: true
5
5
  ---
@@ -23,7 +23,7 @@ Treat the current command arguments as this workflow's input. When invoked from
23
23
 
24
24
  ## MANDATORY COMPLIANCE RULES
25
25
 
26
- > **⚠️ NON-NEGOTIABLE**: After tier routing, this workflow MUST invoke nested workflows via the Skill tool. LIGHT must invoke `Skill(create_plan)` and `Skill(create_tasks)`; STANDARD/COMPREHENSIVE must invoke `Skill(create_plan)`, `Skill(create_tasks)`, and `Skill(plan_review)` (Claude slash route: `create_plan`, `create_tasks`, and `plan_review`). Failure to invoke the required skills is a critical error. Do NOT summarize, describe, or skip these workflows. INVOKE THEM.
26
+ > **⚠️ NON-NEGOTIABLE**: After tier routing, this workflow MUST invoke nested workflows via the Skill tool. LIGHT must invoke `Skill(spectre-create_plan)` and `Skill(spectre-create_tasks)`; STANDARD/COMPREHENSIVE must invoke `Skill(spectre-create_plan)`, `Skill(spectre-create_tasks)`, and `Skill(spectre-plan_review)` (Claude slash route: `spectre-create_plan`, `spectre-create_tasks`, and `spectre-plan_review`). Failure to invoke the required skills is a critical error. Do NOT summarize, describe, or skip these workflows. INVOKE THEM.
27
27
 
28
28
  **After ANY user conversation or questions:**
29
29
 
@@ -184,7 +184,7 @@ Goal: align on the *shape* of the solution before generating a full plan. This c
184
184
  │ YOU MUST USE THE SKILL TOOL TO INVOKE THESE COMMANDS │
185
185
  │ │
186
186
  │ ❌ WRONG: "I'll now create the plan..." │
187
- │ ❌ WRONG: "The next step would be to run create_plan" │
187
+ │ ❌ WRONG: "The next step would be to run spectre-create_plan" │
188
188
  │ ❌ WRONG: Ending turn without invoking Skill tool │
189
189
  │ │
190
190
  │ ✅ CORRECT: Skill tool with skill: "spectre-create_plan", args: "..." │
@@ -275,7 +275,7 @@ Only proceed past this checkpoint when the user confirms.
275
275
  - **Wait** — User final approval or feedback.
276
276
 
277
277
  - **If feedback preserves canonical scope** — apply the smallest edits to `plan.md`/`tasks.md`, re-run `plan_review {OUT_DIR} --auto-apply scope-safe` if the feedback changes implementation approach, verification, dependencies, task sequencing, or references, then present the Final Gate again.
278
- - **If feedback changes canonical scope** — stop and route back to `scope` (or explicitly update the canonical scope artifact if the user directs it). Do not silently update plan/tasks against stale scope.
278
+ - **If feedback changes canonical scope** — stop and route back to `spectre-scope` (or explicitly update the canonical scope artifact if the user directs it). Do not silently update plan/tasks against stale scope.
279
279
 
280
280
  ---
281
281
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "plan_review"
2
+ name: "spectre-plan_review"
3
3
  description: "👻 | Independent multi-lens review of plan.md and/or tasks.md — finds overengineering, missing verification, hallucinated deps, weak references"
4
4
  user-invocable: true
5
5
  ---
@@ -58,7 +58,7 @@ A single reviewer biases toward the issues it notices first. Published practice
58
58
  - `REVIEW_REPORT=${REVIEWS_DIR}/plan_review.md`; if that exists, use `plan_review_{YYYY-MM-DD_HHMMSS}.md` to avoid overwriting prior review evidence.
59
59
  - `plan.md` and `tasks.md` are independently reviewable. It is valid to review only `plan.md`, only `tasks.md`, or both.
60
60
  - `task_context.md` is helpful context but is not required. If it is missing, continue and note that requirements traceability is limited.
61
- - If both `plan.md` and `tasks.md` are missing, stop and suggest the user run `plan` or `create_tasks` first.
61
+ - If both `plan.md` and `tasks.md` are missing, stop and suggest the user run `spectre-plan` or `spectre-create_tasks` first.
62
62
  - If exactly one of `plan.md` or `tasks.md` is missing, list it as absent context and continue. Do not decline, stop, or ask the user to create the missing artifact.
63
63
 
64
64
  - **Action** — ReadAvailable: Read each available file completely into context before dispatching reviewers. Reviewers receive curated excerpts plus an artifact manifest that says which files are present and absent. Every reviewer must review the artifacts that exist and must not treat absent artifacts as a blocker. The manifest must label the canonical scope source and state that review findings may not remove or narrow scope.
@@ -213,6 +213,6 @@ Missing-artifact rule for every lens: review what exists. If a finding depends o
213
213
 
214
214
  ## Notes
215
215
 
216
- - This skill does NOT generate plans or tasks. It reviews available planning artifacts. If only one of `plan.md` or `tasks.md` exists, review that artifact. Only route the user to `plan` or `create_tasks` when neither reviewable artifact exists.
216
+ - This skill does NOT generate plans or tasks. It reviews available planning artifacts. If only one of `plan.md` or `tasks.md` exists, review that artifact. Only route the user to `spectre-plan` or `spectre-create_tasks` when neither reviewable artifact exists.
217
217
  - The four lenses are intentionally non-overlapping by design but will surface overlap in practice — dedupe at synthesis, don't ask reviewers to coordinate.
218
218
  - The "Must-Delete" nomination from Lens 1 is mandatory output — even on a tight plan, naming the single weakest element is a forcing function against under-review.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "prototype"
2
+ name: "spectre-prototype"
3
3
  description: "👻 | Generate a self-contained HTML prototype to validate a feature visually before planning - primary agent"
4
4
  user-invocable: true
5
5
  ---
@@ -22,10 +22,10 @@ Produce a self-contained, clickable HTML artifact that makes a feature visible
22
22
 
23
23
  Detect mode from environment markers, ARGUMENTS, and existing docs. **Order matters** — check from most context to least:
24
24
 
25
- - **Complete ux.md exists** (post-ux) — full Stage 2 spec is on disk. The prototype's job is to **render the spec**, not synthesize it. Default fidelity: **high-fi**. Skip all intake except visual anchor. Treat ux.md as authoritative — don't invent screens, don't contradict documented states or copy. On completion, recommend `plan` or `create_tasks`.
25
+ - **Complete ux.md exists** (post-ux) — full Stage 2 spec is on disk. The prototype's job is to **render the spec**, not synthesize it. Default fidelity: **high-fi**. Skip all intake except visual anchor. Treat ux.md as authoritative — don't invent screens, don't contradict documented states or copy. On completion, recommend `spectre-plan` or `spectre-create_tasks`.
26
26
  - **`FROM_UX=true`** — invoked mid-flow from `ux` Stage 1 → Stage 2 gate. Only approved flows exist (no detailed spec yet). Skip flow-discovery intake. Default fidelity: **mid-fi**. On completion, point user back to `ux` Stage 2.
27
- - **`--explore` flag in ARGUMENTS** — pre-scope discovery. Concept is unvalidated. Default fidelity: **low-fi**. On completion, recommend `scope` as next step.
28
- - **scope.md exists for this branch** (no ux.md) — post-scope validation. Default fidelity: **mid-fi**. On completion, recommend `ux` or `plan` based on feature complexity.
27
+ - **`--explore` flag in ARGUMENTS** — pre-scope discovery. Concept is unvalidated. Default fidelity: **low-fi**. On completion, recommend `spectre-scope` as next step.
28
+ - **scope.md exists for this branch** (no ux.md) — post-scope validation. Default fidelity: **mid-fi**. On completion, recommend `spectre-ux` or `spectre-plan` based on feature complexity.
29
29
  - **Standalone, no context** — ask the user what they're prototyping. Default fidelity: **mid-fi**.
30
30
 
31
31
  ---
@@ -50,7 +50,7 @@ Detect mode from environment markers, ARGUMENTS, and existing docs. **Order matt
50
50
  - Read whichever exist FULLY (no offset/limit)
51
51
 
52
52
  - **Action** — ClassifyUxDoc: If `ux.md` exists, classify its completeness — this drives fidelity AND how much intake to skip.
53
- - **Complete** — contains all of: Screens, Layouts, Components, Interactions, States, Content sections (the Stage 2 deliverables from `ux`). Treat as authoritative. Skip flow-discovery questions. Set mode = **post-ux**.
53
+ - **Complete** — contains all of: Screens, Layouts, Components, Interactions, States, Content sections (the Stage 2 deliverables from `spectre-ux`). Treat as authoritative. Skip flow-discovery questions. Set mode = **post-ux**.
54
54
  - **Flows-only** — contains user flows / journeys but missing Stage 2 sections. Treat flows as approved input but expect to make UI decisions. Set mode = **flows-only ux**.
55
55
  - **Absent** — fall back to scope.md / prd.md / standalone modes.
56
56
 
@@ -181,7 +181,7 @@ Wait for ALL subagents to complete. Synthesize their outputs, then generate a si
181
181
  Key assumptions: {bullet list of design decisions and content assumptions}
182
182
  Filled assumptions: {only in post-ux mode — items the spec was silent on that the prototype filled in; review these against the spec}
183
183
  NOT included: {explicit list of what was deliberately left out}
184
- Next step: plan OR resume ux Stage 2
184
+ Next step: spectre-plan OR resume spectre-ux Stage 2
185
185
  -->
186
186
  ```
187
187
  3. **Design tokens comment block** in `<head>`:
@@ -275,9 +275,9 @@ Surface any violations as caveats in the handoff. Don't silently ship a broken p
275
275
  - Re-present with a one-line diff per added item: `ux.md ← added: {item} (in {section})`.
276
276
 
277
277
  - **Action** — RenderFooter: Render Next Steps using `Skill(spectre-guide)` skill, with mode-specific recommendation:
278
- - **If `FROM_UX=true`** → recommend: "Resume `ux` Stage 2 with this prototype as input"
279
- - **If `--explore`** → recommend: `scope` with the prototype as anchor
280
- - **If post-scope** → recommend: `ux` (if flows still need detail) or `plan` (if ready to build)
278
+ - **If `FROM_UX=true`** → recommend: "Resume `spectre-ux` Stage 2 with this prototype as input"
279
+ - **If `--explore`** → recommend: `spectre-scope` with the prototype as anchor
280
+ - **If post-scope** → recommend: `spectre-ux` (if flows still need detail) or `spectre-plan` (if ready to build)
281
281
  - **Else** → standard Next Steps options
282
282
 
283
283
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "quick_dev"
2
+ name: "spectre-quick_dev"
3
3
  description: "👻 | Quickly scope, research, & plan s/m tasks - primary agent"
4
4
  user-invocable: true
5
5
  ---
@@ -97,7 +97,7 @@ $ARGUMENTS
97
97
  - Exclude: code snippets, line-by-line steps
98
98
  - 2-3 acceptance criteria per sub-task
99
99
 
100
- **Bounds**: ~3 phases, ~8 parent tasks max. If exceeds → suggest `create_tasks`
100
+ **Bounds**: ~3 phases, ~8 parent tasks max. If exceeds → suggest `spectre-create_tasks`
101
101
 
102
102
  - **Action** — ValidateCoverage: Verify all in-scope items have tasks; no out-of-scope tasks added
103
103
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "rebase"
2
+ name: "spectre-rebase"
3
3
  description: "👻 | Safe guided rebase w/conflict handling - primary agent"
4
4
  user-invocable: true
5
5
  ---
@@ -0,0 +1,22 @@
1
+ ---
2
+ name: "spectre-recall"
3
+ description: "👻 | Search Project Knowledge"
4
+ user-invocable: true
5
+ ---
6
+
7
+ # recall
8
+
9
+ ## Input Handling
10
+
11
+ Treat the current command arguments as this workflow's input. When invoked from a slash command, use the forwarded `$ARGUMENTS` value.
12
+
13
+ # /recall - Search Project Knowledge
14
+
15
+ Read the project knowledge recall skill directly, then follow its instructions for the query below:
16
+
17
+ - Claude Code path: `{{project_root}}/.agents/skills/spectre-recall/SKILL.md`
18
+ - Codex path: `{{project_root}}/.agents/skills/spectre-recall/SKILL.md`
19
+
20
+ If neither file exists, report that no project knowledge registry exists yet and suggest `spectre-learn` after the current work produces something worth preserving.
21
+
22
+ **Search query**: $ARGUMENTS
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: "research"
2
+ name: "spectre-research"
3
3
  description: "👻 | Research codebase with parallel agents - primary agent"
4
4
  user-invocable: true
5
5
  ---