@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.
- package/package.json +1 -1
- package/plugins/spectre/.claude-plugin/plugin.json +1 -1
- package/plugins/spectre/hooks/scripts/load-knowledge.mjs +14 -3
- package/plugins/spectre/hooks/scripts/register_learning.mjs +8 -1
- package/plugins/spectre/hooks/scripts/test_load-knowledge.mjs +4 -4
- package/plugins/spectre/hooks/scripts/test_register-learning.mjs +2 -2
- package/plugins/spectre/skills/{apply → spectre-apply}/SKILL.md +3 -3
- package/plugins/spectre/skills/{architecture_review → spectre-architecture_review}/SKILL.md +1 -1
- package/plugins/spectre/skills/{clean → spectre-clean}/SKILL.md +1 -1
- package/plugins/spectre/skills/{code_review → spectre-code_review}/SKILL.md +1 -1
- package/plugins/spectre/skills/{create_plan → spectre-create_plan}/SKILL.md +1 -1
- package/plugins/spectre/skills/{create_tasks → spectre-create_tasks}/SKILL.md +1 -1
- package/plugins/spectre/skills/{create_test_guide → spectre-create_test_guide}/SKILL.md +1 -1
- package/plugins/spectre/skills/{evaluate → spectre-evaluate}/SKILL.md +3 -3
- package/plugins/spectre/skills/{execute → spectre-execute}/SKILL.md +3 -3
- package/plugins/spectre/skills/{fix → spectre-fix}/SKILL.md +1 -1
- package/plugins/spectre/skills/{forget → spectre-forget}/SKILL.md +1 -1
- package/plugins/spectre/skills/{guide → spectre-guide}/SKILL.md +1 -1
- package/plugins/spectre/skills/{handoff → spectre-handoff}/SKILL.md +1 -1
- package/plugins/spectre/skills/{kickoff → spectre-kickoff}/SKILL.md +1 -1
- package/plugins/spectre/skills/{learn → spectre-learn}/SKILL.md +2 -2
- package/plugins/spectre/skills/{plan → spectre-plan}/SKILL.md +2 -2
- package/plugins/spectre/skills/{plan_review → spectre-plan_review}/SKILL.md +1 -1
- package/plugins/spectre/skills/{prototype → spectre-prototype}/SKILL.md +1 -1
- package/plugins/spectre/skills/{quick_dev → spectre-quick_dev}/SKILL.md +1 -1
- package/plugins/spectre/skills/{rebase → spectre-rebase}/SKILL.md +1 -1
- package/plugins/spectre/skills/spectre-recall/SKILL.md +22 -0
- package/plugins/spectre/skills/{research → spectre-research}/SKILL.md +1 -1
- package/plugins/spectre/skills/{scope → spectre-scope}/SKILL.md +1 -1
- package/plugins/spectre/skills/{ship → spectre-ship}/SKILL.md +1 -1
- package/plugins/spectre/skills/{sweep → spectre-sweep}/SKILL.md +1 -1
- package/plugins/spectre/skills/{tdd → spectre-tdd}/SKILL.md +1 -1
- package/plugins/spectre/skills/{test → spectre-test}/SKILL.md +1 -1
- package/plugins/spectre/skills/{ux → spectre-ux}/SKILL.md +1 -1
- package/plugins/spectre/skills/{validate → spectre-validate}/SKILL.md +1 -1
- package/plugins/spectre-codex/hooks/scripts/load-knowledge.mjs +14 -3
- package/plugins/spectre-codex/hooks/scripts/register_learning.mjs +8 -1
- package/plugins/spectre-codex/skills/{apply → spectre-apply}/SKILL.md +3 -3
- package/plugins/spectre-codex/skills/{architecture_review → spectre-architecture_review}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{clean → spectre-clean}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{code_review → spectre-code_review}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{create_plan → spectre-create_plan}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{create_tasks → spectre-create_tasks}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{create_test_guide → spectre-create_test_guide}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{evaluate → spectre-evaluate}/SKILL.md +3 -3
- package/plugins/spectre-codex/skills/{execute → spectre-execute}/SKILL.md +3 -3
- package/plugins/spectre-codex/skills/{fix → spectre-fix}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{forget → spectre-forget}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{guide → spectre-guide}/SKILL.md +81 -81
- package/plugins/spectre-codex/skills/{handoff → spectre-handoff}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{kickoff → spectre-kickoff}/SKILL.md +7 -7
- package/plugins/spectre-codex/skills/{learn → spectre-learn}/SKILL.md +2 -2
- package/plugins/spectre-codex/skills/{plan → spectre-plan}/SKILL.md +4 -4
- package/plugins/spectre-codex/skills/{plan_review → spectre-plan_review}/SKILL.md +3 -3
- package/plugins/spectre-codex/skills/{prototype → spectre-prototype}/SKILL.md +9 -9
- package/plugins/spectre-codex/skills/{quick_dev → spectre-quick_dev}/SKILL.md +2 -2
- package/plugins/spectre-codex/skills/{rebase → spectre-rebase}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/spectre-recall/SKILL.md +22 -0
- package/plugins/spectre-codex/skills/{research → spectre-research}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{scope → spectre-scope}/SKILL.md +8 -8
- package/plugins/spectre-codex/skills/{ship → spectre-ship}/SKILL.md +4 -4
- package/plugins/spectre-codex/skills/{sweep → spectre-sweep}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{tdd → spectre-tdd}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{test → spectre-test}/SKILL.md +1 -1
- package/plugins/spectre-codex/skills/{ux → spectre-ux}/SKILL.md +6 -6
- package/plugins/spectre-codex/skills/{validate → spectre-validate}/SKILL.md +1 -1
- package/src/config.test.js +1 -1
- package/src/install.test.js +10 -6
- package/src/lib/constants.js +9 -9
- package/src/lib/install.js +29 -1
- package/src/lib/knowledge.js +7 -5
- package/src/pack.test.js +1 -1
- package/plugins/spectre/skills/recall/SKILL.md +0 -17
- package/plugins/spectre-codex/skills/recall/SKILL.md +0 -17
- /package/plugins/spectre/skills/{learn → spectre-learn}/references/recall-template.md +0 -0
- /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: "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: "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
|
|
|
@@ -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
|