specdacular 0.9.2 → 0.10.1
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 +40 -36
- package/agents/specd-codebase-mapper.md +1 -1
- package/bin/install.js +46 -12
- package/commands/{specd/map-codebase.md → specd.codebase.map.md} +1 -1
- package/commands/specd.codebase.review.md +39 -0
- package/commands/{specd/config.md → specd.config.md} +1 -1
- package/commands/{specd/continue.md → specd.continue.md} +1 -1
- package/commands/{specd/help.md → specd.help.md} +1 -1
- package/commands/specd.new-project.md +58 -0
- package/commands/{specd/new.md → specd.new.md} +4 -4
- package/commands/{specd/status.md → specd.status.md} +1 -1
- package/commands/specd.toolbox.md +63 -0
- package/commands/{specd/update.md → specd.update.md} +1 -1
- package/hooks/specd-statusline.js +1 -1
- package/package.json +1 -1
- package/specdacular/HELP.md +24 -20
- package/specdacular/agents/feature-researcher.md +4 -4
- package/specdacular/agents/project-researcher.md +409 -0
- package/specdacular/references/execute-hooks.md +1 -1
- package/specdacular/references/select-feature.md +1 -1
- package/specdacular/references/select-phase.md +1 -1
- package/specdacular/references/validate-task.md +3 -3
- package/specdacular/templates/tasks/PROJECT.md +52 -0
- package/specdacular/templates/tasks/REQUIREMENTS.md +75 -0
- package/specdacular/templates/tasks/STATE.md +1 -1
- package/specdacular/workflows/brain.md +2 -2
- package/specdacular/workflows/config.md +1 -1
- package/specdacular/workflows/context-add.md +1 -1
- package/specdacular/workflows/context-manual-review.md +1 -1
- package/specdacular/workflows/new-project.md +799 -0
- package/specdacular/workflows/new.md +6 -6
- package/specdacular/workflows/orchestrator/new.md +3 -3
- package/specdacular/workflows/orchestrator/plan.md +1 -1
- package/specdacular/workflows/plan.md +3 -3
- package/specdacular/workflows/status.md +3 -3
- package/commands/specd/toolbox.md +0 -103
|
@@ -31,7 +31,7 @@ Keep asking until you understand:
|
|
|
31
31
|
2. What it integrates with (existing code)
|
|
32
32
|
3. Key constraints (technical, timeline, scope)
|
|
33
33
|
|
|
34
|
-
You don't need to resolve everything — that's what `/specd
|
|
34
|
+
You don't need to resolve everything — that's what `/specd.discuss` is for.
|
|
35
35
|
|
|
36
36
|
## Decisions Get Recorded
|
|
37
37
|
|
|
@@ -63,7 +63,7 @@ Use AskUserQuestion:
|
|
|
63
63
|
- header: "Task Exists"
|
|
64
64
|
- question: "Task '{name}' already exists. What would you like to do?"
|
|
65
65
|
- options:
|
|
66
|
-
- "Resume" — Continue with existing task (suggest /specd
|
|
66
|
+
- "Resume" — Continue with existing task (suggest /specd.continue)
|
|
67
67
|
- "Reset" — Delete and start fresh
|
|
68
68
|
- "Different name" — Use a different name
|
|
69
69
|
|
|
@@ -150,7 +150,7 @@ Does that capture it, or should we dig into anything more?
|
|
|
150
150
|
**When to move on:**
|
|
151
151
|
- User confirms understanding is correct
|
|
152
152
|
- You have enough for initial FEATURE.md
|
|
153
|
-
- Further details can be discussed later with /specd
|
|
153
|
+
- Further details can be discussed later with /specd.discuss
|
|
154
154
|
|
|
155
155
|
Continue to write_feature.
|
|
156
156
|
</step>
|
|
@@ -252,7 +252,7 @@ Use AskUserQuestion:
|
|
|
252
252
|
- question: "Want to keep discussing the open areas, or come back later?"
|
|
253
253
|
- options:
|
|
254
254
|
- "Keep discussing" — Dive into the gray areas now
|
|
255
|
-
- "Stop for now" — Come back with /specd
|
|
255
|
+
- "Stop for now" — Come back with /specd.continue {task-name}
|
|
256
256
|
|
|
257
257
|
**If Keep discussing:**
|
|
258
258
|
Execute the discuss workflow logic:
|
|
@@ -266,7 +266,7 @@ Use AskUserQuestion:
|
|
|
266
266
|
- question: "Discussion looks solid. Want to keep going or come back later?"
|
|
267
267
|
- options:
|
|
268
268
|
- "Continue" — Move to the next step (research or planning)
|
|
269
|
-
- "Stop for now" — Come back with /specd
|
|
269
|
+
- "Stop for now" — Come back with /specd.continue {task-name}
|
|
270
270
|
|
|
271
271
|
**If Continue:**
|
|
272
272
|
Hand off to continue workflow:
|
|
@@ -278,7 +278,7 @@ Hand off to continue workflow:
|
|
|
278
278
|
|
|
279
279
|
Progress saved. Pick up where you left off anytime:
|
|
280
280
|
|
|
281
|
-
/specd
|
|
281
|
+
/specd.continue {task-name}
|
|
282
282
|
```
|
|
283
283
|
|
|
284
284
|
End workflow.
|
|
@@ -234,7 +234,7 @@ Use AskUserQuestion:
|
|
|
234
234
|
- question: "Want to keep discussing the open areas, or come back later?"
|
|
235
235
|
- options:
|
|
236
236
|
- "Keep discussing" — Dive into the gray areas now
|
|
237
|
-
- "Stop for now" — Come back with `/specd
|
|
237
|
+
- "Stop for now" — Come back with `/specd.continue {task-name}`
|
|
238
238
|
|
|
239
239
|
**If Keep discussing:**
|
|
240
240
|
Execute the discuss workflow:
|
|
@@ -248,7 +248,7 @@ Use AskUserQuestion:
|
|
|
248
248
|
- question: "Discussion looks solid. Want to keep going or come back later?"
|
|
249
249
|
- options:
|
|
250
250
|
- "Continue" — Move to next step
|
|
251
|
-
- "Stop for now" — Come back with `/specd
|
|
251
|
+
- "Stop for now" — Come back with `/specd.continue {task-name}`
|
|
252
252
|
|
|
253
253
|
**If Continue:**
|
|
254
254
|
Hand off to continue workflow:
|
|
@@ -258,7 +258,7 @@ Hand off to continue workflow:
|
|
|
258
258
|
```
|
|
259
259
|
Progress saved. Pick up where you left off anytime:
|
|
260
260
|
|
|
261
|
-
/specd
|
|
261
|
+
/specd.continue {task-name}
|
|
262
262
|
```
|
|
263
263
|
|
|
264
264
|
End workflow.
|
|
@@ -63,15 +63,15 @@ Missing:
|
|
|
63
63
|
- {what's missing}
|
|
64
64
|
|
|
65
65
|
Recommended next:
|
|
66
|
-
- /specd
|
|
67
|
-
- /specd
|
|
66
|
+
- /specd.discuss {task-name} — Resolve gray areas
|
|
67
|
+
- /specd.research {task-name} — Research implementation patterns
|
|
68
68
|
```
|
|
69
69
|
End workflow.
|
|
70
70
|
|
|
71
71
|
**If ready but RESEARCH.md missing:**
|
|
72
72
|
```
|
|
73
73
|
Note: No research findings available. Plans will be based on discussion context only.
|
|
74
|
-
Consider running /specd
|
|
74
|
+
Consider running /specd.research {task-name} first for better plans.
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
Continue to derive_phases.
|
|
@@ -37,7 +37,7 @@ Also check sub-project features — scan each project path for `{project-path}/.
|
|
|
37
37
|
**If no features found anywhere:** output the following and stop:
|
|
38
38
|
|
|
39
39
|
```
|
|
40
|
-
No tasks found. Start one with `/specd
|
|
40
|
+
No tasks found. Start one with `/specd.new [name]`.
|
|
41
41
|
```
|
|
42
42
|
|
|
43
43
|
### 4. Gather feature data
|
|
@@ -119,7 +119,7 @@ _{total} features, {in_progress} in progress_
|
|
|
119
119
|
**If `--all` flag is NOT set and there are completed tasks:**
|
|
120
120
|
|
|
121
121
|
```
|
|
122
|
-
Run `/specd
|
|
122
|
+
Run `/specd.status --all` to include completed tasks.
|
|
123
123
|
```
|
|
124
124
|
|
|
125
125
|
**If `--all` flag IS set and there are completed tasks, add:**
|
|
@@ -190,7 +190,7 @@ Only show active standalone features (not complete/abandoned, unless `--all`).
|
|
|
190
190
|
**If `--all` flag is NOT set and there are completed/abandoned features (root or sub-project):**
|
|
191
191
|
|
|
192
192
|
```
|
|
193
|
-
Run `/specd
|
|
193
|
+
Run `/specd.status --all` to include completed tasks.
|
|
194
194
|
```
|
|
195
195
|
|
|
196
196
|
**If `--all` flag IS set and there are completed/abandoned features, add:**
|
|
@@ -1,103 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: specd:toolbox
|
|
3
|
-
description: "Advanced task operations and context management"
|
|
4
|
-
argument-hint: "[tasks <task-name>|context]"
|
|
5
|
-
allowed-tools:
|
|
6
|
-
- Read
|
|
7
|
-
- Write
|
|
8
|
-
- Edit
|
|
9
|
-
- Bash
|
|
10
|
-
- Glob
|
|
11
|
-
- Grep
|
|
12
|
-
- Task
|
|
13
|
-
- AskUserQuestion
|
|
14
|
-
- WebSearch
|
|
15
|
-
- WebFetch
|
|
16
|
-
---
|
|
17
|
-
|
|
18
|
-
<objective>
|
|
19
|
-
Toolbox with two subdomains:
|
|
20
|
-
|
|
21
|
-
1. **tasks** — Task lifecycle operations (requires task name): discuss, research, plan, execute, review
|
|
22
|
-
2. **context** — Codebase context management (no task name): review, add
|
|
23
|
-
</objective>
|
|
24
|
-
|
|
25
|
-
<execution_context>
|
|
26
|
-
**Parse $ARGUMENTS to determine subdomain:**
|
|
27
|
-
|
|
28
|
-
- If starts with "tasks" → extract remaining words as task name, go to Tasks flow
|
|
29
|
-
- If starts with "context" → go to Context flow
|
|
30
|
-
- If a bare word that matches a directory in `.specd/tasks/` or `.specd/features/` → treat as `tasks {name}`
|
|
31
|
-
- If empty or unrecognized → ask user which subdomain
|
|
32
|
-
|
|
33
|
-
**If subdomain unclear, ask:**
|
|
34
|
-
Use AskUserQuestion:
|
|
35
|
-
- header: "Toolbox"
|
|
36
|
-
- question: "Which toolbox?"
|
|
37
|
-
- options:
|
|
38
|
-
- "Tasks" — Discuss, research, plan, execute, or review a task
|
|
39
|
-
- "Context" — Review or add to codebase context
|
|
40
|
-
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
## Tasks Flow
|
|
44
|
-
|
|
45
|
-
Requires a task name. If not provided after "tasks", check `.specd/tasks/` for available tasks. If only one task exists, use it automatically. If multiple, ask.
|
|
46
|
-
|
|
47
|
-
Validate using:
|
|
48
|
-
@~/.claude/specdacular/references/validate-task.md
|
|
49
|
-
|
|
50
|
-
Then present the menu using AskUserQuestion:
|
|
51
|
-
- header: "Operation"
|
|
52
|
-
- question: "What would you like to do with {task-name}?"
|
|
53
|
-
- options:
|
|
54
|
-
- "Discuss" — Explore gray areas and record decisions
|
|
55
|
-
- "Research" — Spawn parallel agents for patterns/pitfalls
|
|
56
|
-
- "Plan" — Create execution phases
|
|
57
|
-
- "Execute" — Execute the next phase
|
|
58
|
-
- "Review" — Review executed phase
|
|
59
|
-
|
|
60
|
-
Based on selection, delegate to the appropriate workflow:
|
|
61
|
-
- Discuss → @~/.claude/specdacular/workflows/discuss.md
|
|
62
|
-
- Research → @~/.claude/specdacular/workflows/research.md
|
|
63
|
-
- Plan → @~/.claude/specdacular/workflows/plan.md
|
|
64
|
-
- Execute → @~/.claude/specdacular/workflows/execute.md
|
|
65
|
-
- Review → @~/.claude/specdacular/workflows/review.md
|
|
66
|
-
|
|
67
|
-
---
|
|
68
|
-
|
|
69
|
-
## Context Flow
|
|
70
|
-
|
|
71
|
-
No task name needed. Present the menu using AskUserQuestion:
|
|
72
|
-
- header: "Context"
|
|
73
|
-
- question: "What would you like to do with codebase context?"
|
|
74
|
-
- options:
|
|
75
|
-
- "Review" — Walk through and review a context file section by section
|
|
76
|
-
- "Add" — Add new content to a context file
|
|
77
|
-
|
|
78
|
-
Based on selection, delegate to the appropriate workflow:
|
|
79
|
-
- Review → follow the context-manual-review.md workflow
|
|
80
|
-
- Add → follow the context-add.md workflow
|
|
81
|
-
</execution_context>
|
|
82
|
-
|
|
83
|
-
<context>
|
|
84
|
-
Arguments: $ARGUMENTS
|
|
85
|
-
|
|
86
|
-
**Task workflows:**
|
|
87
|
-
@~/.claude/specdacular/workflows/discuss.md
|
|
88
|
-
@~/.claude/specdacular/workflows/research.md
|
|
89
|
-
@~/.claude/specdacular/workflows/plan.md
|
|
90
|
-
@~/.claude/specdacular/workflows/execute.md
|
|
91
|
-
@~/.claude/specdacular/workflows/review.md
|
|
92
|
-
|
|
93
|
-
**Context workflows:**
|
|
94
|
-
@~/.claude/specdacular/workflows/context-manual-review.md
|
|
95
|
-
@~/.claude/specdacular/workflows/context-add.md
|
|
96
|
-
</context>
|
|
97
|
-
|
|
98
|
-
<success_criteria>
|
|
99
|
-
- [ ] Subdomain selected (tasks or context) — from argument or prompt
|
|
100
|
-
- [ ] For tasks: task validated and operation menu shown
|
|
101
|
-
- [ ] For context: context operation menu shown
|
|
102
|
-
- [ ] Selected operation executed via correct workflow
|
|
103
|
-
</success_criteria>
|