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.
Files changed (36) hide show
  1. package/README.md +40 -36
  2. package/agents/specd-codebase-mapper.md +1 -1
  3. package/bin/install.js +46 -12
  4. package/commands/{specd/map-codebase.md → specd.codebase.map.md} +1 -1
  5. package/commands/specd.codebase.review.md +39 -0
  6. package/commands/{specd/config.md → specd.config.md} +1 -1
  7. package/commands/{specd/continue.md → specd.continue.md} +1 -1
  8. package/commands/{specd/help.md → specd.help.md} +1 -1
  9. package/commands/specd.new-project.md +58 -0
  10. package/commands/{specd/new.md → specd.new.md} +4 -4
  11. package/commands/{specd/status.md → specd.status.md} +1 -1
  12. package/commands/specd.toolbox.md +63 -0
  13. package/commands/{specd/update.md → specd.update.md} +1 -1
  14. package/hooks/specd-statusline.js +1 -1
  15. package/package.json +1 -1
  16. package/specdacular/HELP.md +24 -20
  17. package/specdacular/agents/feature-researcher.md +4 -4
  18. package/specdacular/agents/project-researcher.md +409 -0
  19. package/specdacular/references/execute-hooks.md +1 -1
  20. package/specdacular/references/select-feature.md +1 -1
  21. package/specdacular/references/select-phase.md +1 -1
  22. package/specdacular/references/validate-task.md +3 -3
  23. package/specdacular/templates/tasks/PROJECT.md +52 -0
  24. package/specdacular/templates/tasks/REQUIREMENTS.md +75 -0
  25. package/specdacular/templates/tasks/STATE.md +1 -1
  26. package/specdacular/workflows/brain.md +2 -2
  27. package/specdacular/workflows/config.md +1 -1
  28. package/specdacular/workflows/context-add.md +1 -1
  29. package/specdacular/workflows/context-manual-review.md +1 -1
  30. package/specdacular/workflows/new-project.md +799 -0
  31. package/specdacular/workflows/new.md +6 -6
  32. package/specdacular/workflows/orchestrator/new.md +3 -3
  33. package/specdacular/workflows/orchestrator/plan.md +1 -1
  34. package/specdacular/workflows/plan.md +3 -3
  35. package/specdacular/workflows/status.md +3 -3
  36. 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:discuss` is for.
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:continue)
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:discuss
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:continue {task-name}
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:continue {task-name}
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:continue {task-name}
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:continue {task-name}`
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:continue {task-name}`
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:continue {task-name}
261
+ /specd.continue {task-name}
262
262
  ```
263
263
 
264
264
  End workflow.
@@ -162,7 +162,7 @@ Present multi-project roadmap summary.
162
162
 
163
163
  ## What's Next
164
164
 
165
- /specd:continue {task-name} — Start executing phases
165
+ /specd.continue {task-name} — Start executing phases
166
166
  ```
167
167
 
168
168
  End workflow.
@@ -63,15 +63,15 @@ Missing:
63
63
  - {what's missing}
64
64
 
65
65
  Recommended next:
66
- - /specd:discuss {task-name} — Resolve gray areas
67
- - /specd:research {task-name} — Research implementation patterns
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:research {task-name} first for better plans.
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:new [name]`.
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:status --all` to include completed tasks.
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:status --all` to include completed tasks.
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>