@bhargavvc/sdd-cc 1.30.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 (227) hide show
  1. package/LICENSE +21 -0
  2. package/README.ja-JP.md +834 -0
  3. package/README.ko-KR.md +823 -0
  4. package/README.md +846 -0
  5. package/README.pt-BR.md +452 -0
  6. package/README.zh-CN.md +800 -0
  7. package/agents/sdd-advisor-researcher.md +104 -0
  8. package/agents/sdd-assumptions-analyzer.md +105 -0
  9. package/agents/sdd-codebase-mapper.md +770 -0
  10. package/agents/sdd-debugger.md +1373 -0
  11. package/agents/sdd-executor.md +509 -0
  12. package/agents/sdd-integration-checker.md +443 -0
  13. package/agents/sdd-nyquist-auditor.md +176 -0
  14. package/agents/sdd-phase-researcher.md +698 -0
  15. package/agents/sdd-plan-checker.md +773 -0
  16. package/agents/sdd-planner.md +1354 -0
  17. package/agents/sdd-project-researcher.md +654 -0
  18. package/agents/sdd-research-synthesizer.md +247 -0
  19. package/agents/sdd-roadmapper.md +679 -0
  20. package/agents/sdd-ui-auditor.md +439 -0
  21. package/agents/sdd-ui-checker.md +300 -0
  22. package/agents/sdd-ui-researcher.md +357 -0
  23. package/agents/sdd-user-profiler.md +171 -0
  24. package/agents/sdd-verifier.md +700 -0
  25. package/bin/install.js +5009 -0
  26. package/commands/sdd/add-backlog.md +76 -0
  27. package/commands/sdd/add-phase.md +43 -0
  28. package/commands/sdd/add-tests.md +41 -0
  29. package/commands/sdd/add-todo.md +47 -0
  30. package/commands/sdd/audit-milestone.md +36 -0
  31. package/commands/sdd/audit-uat.md +24 -0
  32. package/commands/sdd/autonomous.md +41 -0
  33. package/commands/sdd/check-todos.md +45 -0
  34. package/commands/sdd/cleanup.md +18 -0
  35. package/commands/sdd/complete-milestone.md +136 -0
  36. package/commands/sdd/debug.md +173 -0
  37. package/commands/sdd/discuss-phase.md +64 -0
  38. package/commands/sdd/do.md +30 -0
  39. package/commands/sdd/execute-phase.md +59 -0
  40. package/commands/sdd/fast.md +30 -0
  41. package/commands/sdd/forensics.md +56 -0
  42. package/commands/sdd/health.md +22 -0
  43. package/commands/sdd/help.md +22 -0
  44. package/commands/sdd/insert-phase.md +32 -0
  45. package/commands/sdd/join-discord.md +18 -0
  46. package/commands/sdd/list-phase-assumptions.md +46 -0
  47. package/commands/sdd/list-workspaces.md +19 -0
  48. package/commands/sdd/manager.md +39 -0
  49. package/commands/sdd/map-codebase.md +71 -0
  50. package/commands/sdd/milestone-summary.md +51 -0
  51. package/commands/sdd/new-milestone.md +44 -0
  52. package/commands/sdd/new-project.md +42 -0
  53. package/commands/sdd/new-workspace.md +44 -0
  54. package/commands/sdd/next.md +24 -0
  55. package/commands/sdd/note.md +34 -0
  56. package/commands/sdd/pause-work.md +38 -0
  57. package/commands/sdd/plan-milestone-gaps.md +34 -0
  58. package/commands/sdd/plan-phase.md +47 -0
  59. package/commands/sdd/plant-seed.md +28 -0
  60. package/commands/sdd/pr-branch.md +25 -0
  61. package/commands/sdd/profile-user.md +46 -0
  62. package/commands/sdd/progress.md +24 -0
  63. package/commands/sdd/quick.md +47 -0
  64. package/commands/sdd/reapply-patches.md +123 -0
  65. package/commands/sdd/remove-phase.md +31 -0
  66. package/commands/sdd/remove-workspace.md +26 -0
  67. package/commands/sdd/research-phase.md +195 -0
  68. package/commands/sdd/resume-work.md +40 -0
  69. package/commands/sdd/review-backlog.md +61 -0
  70. package/commands/sdd/review.md +37 -0
  71. package/commands/sdd/session-report.md +19 -0
  72. package/commands/sdd/set-profile.md +12 -0
  73. package/commands/sdd/settings.md +36 -0
  74. package/commands/sdd/ship.md +23 -0
  75. package/commands/sdd/stats.md +18 -0
  76. package/commands/sdd/thread.md +127 -0
  77. package/commands/sdd/ui-phase.md +34 -0
  78. package/commands/sdd/ui-review.md +32 -0
  79. package/commands/sdd/update.md +37 -0
  80. package/commands/sdd/validate-phase.md +35 -0
  81. package/commands/sdd/verify-work.md +38 -0
  82. package/commands/sdd/workstreams.md +63 -0
  83. package/hooks/dist/sdd-check-update.js +114 -0
  84. package/hooks/dist/sdd-context-monitor.js +156 -0
  85. package/hooks/dist/sdd-prompt-guard.js +96 -0
  86. package/hooks/dist/sdd-statusline.js +119 -0
  87. package/hooks/dist/sdd-workflow-guard.js +94 -0
  88. package/package.json +55 -0
  89. package/scripts/base64-scan.sh +262 -0
  90. package/scripts/build-hooks.js +82 -0
  91. package/scripts/prompt-injection-scan.sh +198 -0
  92. package/scripts/rebrand-gsd-to-sdd.sh +220 -0
  93. package/scripts/run-tests.cjs +29 -0
  94. package/scripts/secret-scan.sh +227 -0
  95. package/scripts/sync-upstream.sh +56 -0
  96. package/sdd/bin/lib/commands.cjs +959 -0
  97. package/sdd/bin/lib/config.cjs +442 -0
  98. package/sdd/bin/lib/core.cjs +1230 -0
  99. package/sdd/bin/lib/frontmatter.cjs +336 -0
  100. package/sdd/bin/lib/init.cjs +1442 -0
  101. package/sdd/bin/lib/milestone.cjs +252 -0
  102. package/sdd/bin/lib/model-profiles.cjs +68 -0
  103. package/sdd/bin/lib/phase.cjs +888 -0
  104. package/sdd/bin/lib/profile-output.cjs +952 -0
  105. package/sdd/bin/lib/profile-pipeline.cjs +539 -0
  106. package/sdd/bin/lib/roadmap.cjs +329 -0
  107. package/sdd/bin/lib/security.cjs +382 -0
  108. package/sdd/bin/lib/state.cjs +1031 -0
  109. package/sdd/bin/lib/template.cjs +222 -0
  110. package/sdd/bin/lib/uat.cjs +282 -0
  111. package/sdd/bin/lib/verify.cjs +888 -0
  112. package/sdd/bin/lib/workstream.cjs +491 -0
  113. package/sdd/bin/sdd-tools.cjs +918 -0
  114. package/sdd/commands/sdd/workstreams.md +63 -0
  115. package/sdd/references/checkpoints.md +778 -0
  116. package/sdd/references/continuation-format.md +249 -0
  117. package/sdd/references/decimal-phase-calculation.md +64 -0
  118. package/sdd/references/git-integration.md +295 -0
  119. package/sdd/references/git-planning-commit.md +38 -0
  120. package/sdd/references/model-profile-resolution.md +36 -0
  121. package/sdd/references/model-profiles.md +139 -0
  122. package/sdd/references/phase-argument-parsing.md +61 -0
  123. package/sdd/references/planning-config.md +202 -0
  124. package/sdd/references/questioning.md +162 -0
  125. package/sdd/references/tdd.md +263 -0
  126. package/sdd/references/ui-brand.md +160 -0
  127. package/sdd/references/user-profiling.md +681 -0
  128. package/sdd/references/verification-patterns.md +612 -0
  129. package/sdd/references/workstream-flag.md +58 -0
  130. package/sdd/templates/DEBUG.md +164 -0
  131. package/sdd/templates/UAT.md +265 -0
  132. package/sdd/templates/UI-SPEC.md +100 -0
  133. package/sdd/templates/VALIDATION.md +76 -0
  134. package/sdd/templates/claude-md.md +122 -0
  135. package/sdd/templates/codebase/architecture.md +255 -0
  136. package/sdd/templates/codebase/concerns.md +310 -0
  137. package/sdd/templates/codebase/conventions.md +307 -0
  138. package/sdd/templates/codebase/integrations.md +280 -0
  139. package/sdd/templates/codebase/stack.md +186 -0
  140. package/sdd/templates/codebase/structure.md +285 -0
  141. package/sdd/templates/codebase/testing.md +480 -0
  142. package/sdd/templates/config.json +44 -0
  143. package/sdd/templates/context.md +352 -0
  144. package/sdd/templates/continue-here.md +78 -0
  145. package/sdd/templates/copilot-instructions.md +7 -0
  146. package/sdd/templates/debug-subagent-prompt.md +91 -0
  147. package/sdd/templates/dev-preferences.md +21 -0
  148. package/sdd/templates/discovery.md +146 -0
  149. package/sdd/templates/discussion-log.md +63 -0
  150. package/sdd/templates/milestone-archive.md +123 -0
  151. package/sdd/templates/milestone.md +115 -0
  152. package/sdd/templates/phase-prompt.md +610 -0
  153. package/sdd/templates/planner-subagent-prompt.md +117 -0
  154. package/sdd/templates/project.md +186 -0
  155. package/sdd/templates/requirements.md +231 -0
  156. package/sdd/templates/research-project/ARCHITECTURE.md +204 -0
  157. package/sdd/templates/research-project/FEATURES.md +147 -0
  158. package/sdd/templates/research-project/PITFALLS.md +200 -0
  159. package/sdd/templates/research-project/STACK.md +120 -0
  160. package/sdd/templates/research-project/SUMMARY.md +170 -0
  161. package/sdd/templates/research.md +552 -0
  162. package/sdd/templates/retrospective.md +54 -0
  163. package/sdd/templates/roadmap.md +202 -0
  164. package/sdd/templates/state.md +176 -0
  165. package/sdd/templates/summary-complex.md +59 -0
  166. package/sdd/templates/summary-minimal.md +41 -0
  167. package/sdd/templates/summary-standard.md +48 -0
  168. package/sdd/templates/summary.md +248 -0
  169. package/sdd/templates/user-profile.md +146 -0
  170. package/sdd/templates/user-setup.md +311 -0
  171. package/sdd/templates/verification-report.md +322 -0
  172. package/sdd/workflows/add-phase.md +112 -0
  173. package/sdd/workflows/add-tests.md +351 -0
  174. package/sdd/workflows/add-todo.md +158 -0
  175. package/sdd/workflows/audit-milestone.md +340 -0
  176. package/sdd/workflows/audit-uat.md +109 -0
  177. package/sdd/workflows/autonomous.md +891 -0
  178. package/sdd/workflows/check-todos.md +177 -0
  179. package/sdd/workflows/cleanup.md +152 -0
  180. package/sdd/workflows/complete-milestone.md +767 -0
  181. package/sdd/workflows/diagnose-issues.md +231 -0
  182. package/sdd/workflows/discovery-phase.md +289 -0
  183. package/sdd/workflows/discuss-phase-assumptions.md +653 -0
  184. package/sdd/workflows/discuss-phase.md +1049 -0
  185. package/sdd/workflows/do.md +104 -0
  186. package/sdd/workflows/execute-phase.md +846 -0
  187. package/sdd/workflows/execute-plan.md +514 -0
  188. package/sdd/workflows/fast.md +105 -0
  189. package/sdd/workflows/forensics.md +265 -0
  190. package/sdd/workflows/health.md +181 -0
  191. package/sdd/workflows/help.md +606 -0
  192. package/sdd/workflows/insert-phase.md +130 -0
  193. package/sdd/workflows/list-phase-assumptions.md +178 -0
  194. package/sdd/workflows/list-workspaces.md +56 -0
  195. package/sdd/workflows/manager.md +362 -0
  196. package/sdd/workflows/map-codebase.md +377 -0
  197. package/sdd/workflows/milestone-summary.md +223 -0
  198. package/sdd/workflows/new-milestone.md +486 -0
  199. package/sdd/workflows/new-project.md +1250 -0
  200. package/sdd/workflows/new-workspace.md +237 -0
  201. package/sdd/workflows/next.md +97 -0
  202. package/sdd/workflows/node-repair.md +92 -0
  203. package/sdd/workflows/note.md +156 -0
  204. package/sdd/workflows/pause-work.md +176 -0
  205. package/sdd/workflows/plan-milestone-gaps.md +273 -0
  206. package/sdd/workflows/plan-phase.md +859 -0
  207. package/sdd/workflows/plant-seed.md +169 -0
  208. package/sdd/workflows/pr-branch.md +129 -0
  209. package/sdd/workflows/profile-user.md +450 -0
  210. package/sdd/workflows/progress.md +507 -0
  211. package/sdd/workflows/quick.md +757 -0
  212. package/sdd/workflows/remove-phase.md +155 -0
  213. package/sdd/workflows/remove-workspace.md +90 -0
  214. package/sdd/workflows/research-phase.md +82 -0
  215. package/sdd/workflows/resume-project.md +326 -0
  216. package/sdd/workflows/review.md +228 -0
  217. package/sdd/workflows/session-report.md +146 -0
  218. package/sdd/workflows/settings.md +283 -0
  219. package/sdd/workflows/ship.md +228 -0
  220. package/sdd/workflows/stats.md +60 -0
  221. package/sdd/workflows/transition.md +671 -0
  222. package/sdd/workflows/ui-phase.md +302 -0
  223. package/sdd/workflows/ui-review.md +165 -0
  224. package/sdd/workflows/update.md +323 -0
  225. package/sdd/workflows/validate-phase.md +174 -0
  226. package/sdd/workflows/verify-phase.md +254 -0
  227. package/sdd/workflows/verify-work.md +637 -0
@@ -0,0 +1,64 @@
1
+ ---
2
+ name: sdd:discuss-phase
3
+ description: Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (Claude picks recommended defaults).
4
+ argument-hint: "<phase> [--auto] [--batch] [--analyze] [--text]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Bash
9
+ - Glob
10
+ - Grep
11
+ - AskUserQuestion
12
+ - Task
13
+ - mcp__context7__resolve-library-id
14
+ - mcp__context7__query-docs
15
+ ---
16
+
17
+ <objective>
18
+ Extract implementation decisions that downstream agents need — researcher and planner will use CONTEXT.md to know what to investigate and what choices are locked.
19
+
20
+ **How it works:**
21
+ 1. Load prior context (PROJECT.md, REQUIREMENTS.md, STATE.md, prior CONTEXT.md files)
22
+ 2. Scout codebase for reusable assets and patterns
23
+ 3. Analyze phase — skip gray areas already decided in prior phases
24
+ 4. Present remaining gray areas — user selects which to discuss
25
+ 5. Deep-dive each selected area until satisfied
26
+ 6. Create CONTEXT.md with decisions that guide research and planning
27
+
28
+ **Output:** `{phase_num}-CONTEXT.md` — decisions clear enough that downstream agents can act without asking the user again
29
+ </objective>
30
+
31
+ <execution_context>
32
+ @~/.claude/sdd/workflows/discuss-phase.md
33
+ @~/.claude/sdd/workflows/discuss-phase-assumptions.md
34
+ @~/.claude/sdd/templates/context.md
35
+ </execution_context>
36
+
37
+ <context>
38
+ Phase number: $ARGUMENTS (required)
39
+
40
+ Context files are resolved in-workflow using `init phase-op` and roadmap/state tool calls.
41
+ </context>
42
+
43
+ <process>
44
+ **Mode routing:**
45
+ ```bash
46
+ DISCUSS_MODE=$(node "$HOME/.claude/sdd/bin/sdd-tools.cjs" config-get workflow.discuss_mode 2>/dev/null || echo "discuss")
47
+ ```
48
+
49
+ If `DISCUSS_MODE` is `"assumptions"`: Read and execute @~/.claude/sdd/workflows/discuss-phase-assumptions.md end-to-end.
50
+
51
+ If `DISCUSS_MODE` is `"discuss"` (or unset, or any other value): Read and execute @~/.claude/sdd/workflows/discuss-phase.md end-to-end.
52
+
53
+ **MANDATORY:** The execution_context files listed above ARE the instructions. Read the workflow file BEFORE taking any action. The objective and success_criteria sections in this command file are summaries — the workflow file contains the complete step-by-step process with all required behaviors, config checks, and interaction patterns. Do not improvise from the summary.
54
+ </process>
55
+
56
+ <success_criteria>
57
+ - Prior context loaded and applied (no re-asking decided questions)
58
+ - Gray areas identified through intelligent analysis
59
+ - User chose which areas to discuss
60
+ - Each selected area explored until satisfied
61
+ - Scope creep redirected to deferred ideas
62
+ - CONTEXT.md captures decisions, not vague vision
63
+ - User knows next steps
64
+ </success_criteria>
@@ -0,0 +1,30 @@
1
+ ---
2
+ name: sdd:do
3
+ description: Route freeform text to the right SDD command automatically
4
+ argument-hint: "<description of what you want to do>"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - AskUserQuestion
9
+ ---
10
+ <objective>
11
+ Analyze freeform natural language input and dispatch to the most appropriate SDD command.
12
+
13
+ Acts as a smart dispatcher — never does the work itself. Matches intent to the best SDD command using routing rules, confirms the match, then hands off.
14
+
15
+ Use when you know what you want but don't know which `/sdd:*` command to run.
16
+ </objective>
17
+
18
+ <execution_context>
19
+ @~/.claude/sdd/workflows/do.md
20
+ @~/.claude/sdd/references/ui-brand.md
21
+ </execution_context>
22
+
23
+ <context>
24
+ $ARGUMENTS
25
+ </context>
26
+
27
+ <process>
28
+ Execute the do workflow from @~/.claude/sdd/workflows/do.md end-to-end.
29
+ Route user intent to the best SDD command and invoke it.
30
+ </process>
@@ -0,0 +1,59 @@
1
+ ---
2
+ name: sdd:execute-phase
3
+ description: Execute all plans in a phase with wave-based parallelization
4
+ argument-hint: "<phase-number> [--wave N] [--gaps-only] [--interactive]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Edit
9
+ - Glob
10
+ - Grep
11
+ - Bash
12
+ - Task
13
+ - TodoWrite
14
+ - AskUserQuestion
15
+ ---
16
+ <objective>
17
+ Execute all plans in a phase using wave-based parallel execution.
18
+
19
+ Orchestrator stays lean: discover plans, analyze dependencies, group into waves, spawn subagents, collect results. Each subagent loads the full execute-plan context and handles its own plan.
20
+
21
+ Optional wave filter:
22
+ - `--wave N` executes only Wave `N` for pacing, quota management, or staged rollout
23
+ - phase verification/completion still only happens when no incomplete plans remain after the selected wave finishes
24
+
25
+ Flag handling rule:
26
+ - The optional flags documented below are available behaviors, not implied active behaviors
27
+ - A flag is active only when its literal token appears in `$ARGUMENTS`
28
+ - If a documented flag is absent from `$ARGUMENTS`, treat it as inactive
29
+
30
+ Context budget: ~15% orchestrator, 100% fresh per subagent.
31
+ </objective>
32
+
33
+ <execution_context>
34
+ @~/.claude/sdd/workflows/execute-phase.md
35
+ @~/.claude/sdd/references/ui-brand.md
36
+ </execution_context>
37
+
38
+ <context>
39
+ Phase: $ARGUMENTS
40
+
41
+ **Available optional flags (documentation only — not automatically active):**
42
+ - `--wave N` — Execute only Wave `N` in the phase. Use when you want to pace execution or stay inside usage limits.
43
+ - `--gaps-only` — Execute only gap closure plans (plans with `gap_closure: true` in frontmatter). Use after verify-work creates fix plans.
44
+ - `--interactive` — Execute plans sequentially inline (no subagents) with user checkpoints between tasks. Lower token usage, pair-programming style. Best for small phases, bug fixes, and verification gaps.
45
+
46
+ **Active flags must be derived from `$ARGUMENTS`:**
47
+ - `--wave N` is active only if the literal `--wave` token is present in `$ARGUMENTS`
48
+ - `--gaps-only` is active only if the literal `--gaps-only` token is present in `$ARGUMENTS`
49
+ - `--interactive` is active only if the literal `--interactive` token is present in `$ARGUMENTS`
50
+ - If none of these tokens appear, run the standard full-phase execution flow with no flag-specific filtering
51
+ - Do not infer that a flag is active just because it is documented in this prompt
52
+
53
+ Context files are resolved inside the workflow via `sdd-tools init execute-phase` and per-subagent `<files_to_read>` blocks.
54
+ </context>
55
+
56
+ <process>
57
+ Execute the execute-phase workflow from @~/.claude/sdd/workflows/execute-phase.md end-to-end.
58
+ Preserve all workflow gates (wave execution, checkpoint handling, verification, state updates, routing).
59
+ </process>
@@ -0,0 +1,30 @@
1
+ ---
2
+ name: sdd:fast
3
+ description: Execute a trivial task inline — no subagents, no planning overhead
4
+ argument-hint: "[task description]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Edit
9
+ - Bash
10
+ - Grep
11
+ - Glob
12
+ ---
13
+
14
+ <objective>
15
+ Execute a trivial task directly in the current context without spawning subagents
16
+ or generating PLAN.md files. For tasks too small to justify planning overhead:
17
+ typo fixes, config changes, small refactors, forgotten commits, simple additions.
18
+
19
+ This is NOT a replacement for /sdd:quick — use /sdd:quick for anything that
20
+ needs research, multi-step planning, or verification. /sdd:fast is for tasks
21
+ you could describe in one sentence and execute in under 2 minutes.
22
+ </objective>
23
+
24
+ <execution_context>
25
+ @~/.claude/sdd/workflows/fast.md
26
+ </execution_context>
27
+
28
+ <process>
29
+ Execute the fast workflow from @~/.claude/sdd/workflows/fast.md end-to-end.
30
+ </process>
@@ -0,0 +1,56 @@
1
+ ---
2
+ type: prompt
3
+ name: sdd:forensics
4
+ description: Post-mortem investigation for failed SDD workflows — analyzes git history, artifacts, and state to diagnose what went wrong
5
+ argument-hint: "[problem description]"
6
+ allowed-tools:
7
+ - Read
8
+ - Write
9
+ - Bash
10
+ - Grep
11
+ - Glob
12
+ ---
13
+
14
+ <objective>
15
+ Investigate what went wrong during a SDD workflow execution. Analyzes git history, `.planning/` artifacts, and file system state to detect anomalies and generate a structured diagnostic report.
16
+
17
+ Purpose: Diagnose failed or stuck workflows so the user can understand root cause and take corrective action.
18
+ Output: Forensic report saved to `.planning/forensics/`, presented inline, with optional issue creation.
19
+ </objective>
20
+
21
+ <execution_context>
22
+ @~/.claude/sdd/workflows/forensics.md
23
+ </execution_context>
24
+
25
+ <context>
26
+ **Data sources:**
27
+ - `git log` (recent commits, patterns, time gaps)
28
+ - `git status` / `git diff` (uncommitted work, conflicts)
29
+ - `.planning/STATE.md` (current position, session history)
30
+ - `.planning/ROADMAP.md` (phase scope and progress)
31
+ - `.planning/phases/*/` (PLAN.md, SUMMARY.md, VERIFICATION.md, CONTEXT.md)
32
+ - `.planning/reports/SESSION_REPORT.md` (last session outcomes)
33
+
34
+ **User input:**
35
+ - Problem description: $ARGUMENTS (optional — will ask if not provided)
36
+ </context>
37
+
38
+ <process>
39
+ Read and execute the forensics workflow from @~/.claude/sdd/workflows/forensics.md end-to-end.
40
+ </process>
41
+
42
+ <success_criteria>
43
+ - Evidence gathered from all available data sources
44
+ - At least 4 anomaly types checked (stuck loop, missing artifacts, abandoned work, crash/interruption)
45
+ - Structured forensic report written to `.planning/forensics/report-{timestamp}.md`
46
+ - Report presented inline with findings, anomalies, and recommendations
47
+ - Interactive investigation offered for deeper analysis
48
+ - GitHub issue creation offered if actionable findings exist
49
+ </success_criteria>
50
+
51
+ <critical_rules>
52
+ - **Read-only investigation:** Do not modify project source files during forensics. Only write the forensic report and update STATE.md session tracking.
53
+ - **Redact sensitive data:** Strip absolute paths, API keys, tokens from reports and issues.
54
+ - **Ground findings in evidence:** Every anomaly must cite specific commits, files, or state data.
55
+ - **No speculation without evidence:** If data is insufficient, say so — do not fabricate root causes.
56
+ </critical_rules>
@@ -0,0 +1,22 @@
1
+ ---
2
+ name: sdd:health
3
+ description: Diagnose planning directory health and optionally repair issues
4
+ argument-hint: [--repair]
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Write
9
+ - AskUserQuestion
10
+ ---
11
+ <objective>
12
+ Validate `.planning/` directory integrity and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans.
13
+ </objective>
14
+
15
+ <execution_context>
16
+ @~/.claude/sdd/workflows/health.md
17
+ </execution_context>
18
+
19
+ <process>
20
+ Execute the health workflow from @~/.claude/sdd/workflows/health.md end-to-end.
21
+ Parse --repair flag from arguments and pass to workflow.
22
+ </process>
@@ -0,0 +1,22 @@
1
+ ---
2
+ name: sdd:help
3
+ description: Show available SDD commands and usage guide
4
+ ---
5
+ <objective>
6
+ Display the complete SDD command reference.
7
+
8
+ Output ONLY the reference content below. Do NOT add:
9
+ - Project-specific analysis
10
+ - Git status or file context
11
+ - Next-step suggestions
12
+ - Any commentary beyond the reference
13
+ </objective>
14
+
15
+ <execution_context>
16
+ @~/.claude/sdd/workflows/help.md
17
+ </execution_context>
18
+
19
+ <process>
20
+ Output the complete SDD command reference from @~/.claude/sdd/workflows/help.md.
21
+ Display the reference content directly — no additions or modifications.
22
+ </process>
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: sdd:insert-phase
3
+ description: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
4
+ argument-hint: <after> <description>
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Bash
9
+ ---
10
+
11
+ <objective>
12
+ Insert a decimal phase for urgent work discovered mid-milestone that must be completed between existing integer phases.
13
+
14
+ Uses decimal numbering (72.1, 72.2, etc.) to preserve the logical sequence of planned phases while accommodating urgent insertions.
15
+
16
+ Purpose: Handle urgent work discovered during execution without renumbering entire roadmap.
17
+ </objective>
18
+
19
+ <execution_context>
20
+ @~/.claude/sdd/workflows/insert-phase.md
21
+ </execution_context>
22
+
23
+ <context>
24
+ Arguments: $ARGUMENTS (format: <after-phase-number> <description>)
25
+
26
+ Roadmap and state are resolved in-workflow via `init phase-op` and targeted tool calls.
27
+ </context>
28
+
29
+ <process>
30
+ Execute the insert-phase workflow from @~/.claude/sdd/workflows/insert-phase.md end-to-end.
31
+ Preserve all validation gates (argument parsing, phase verification, decimal calculation, roadmap updates).
32
+ </process>
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: sdd:join-discord
3
+ description: Join the SDD Discord community
4
+ ---
5
+
6
+ <objective>
7
+ Display the Discord invite link for the SDD community server.
8
+ </objective>
9
+
10
+ <output>
11
+ # Join the SDD Discord
12
+
13
+ Connect with other SDD users, get help, share what you're building, and stay updated.
14
+
15
+ **Invite link:** https://discord.gg/sdd
16
+
17
+ Click the link or paste it into your browser to join.
18
+ </output>
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: sdd:list-phase-assumptions
3
+ description: Surface Claude's assumptions about a phase approach before planning
4
+ argument-hint: "[phase]"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Grep
9
+ - Glob
10
+ ---
11
+
12
+ <objective>
13
+ Analyze a phase and present Claude's assumptions about technical approach, implementation order, scope boundaries, risk areas, and dependencies.
14
+
15
+ Purpose: Help users see what Claude thinks BEFORE planning begins - enabling course correction early when assumptions are wrong.
16
+ Output: Conversational output only (no file creation) - ends with "What do you think?" prompt
17
+ </objective>
18
+
19
+ <execution_context>
20
+ @~/.claude/sdd/workflows/list-phase-assumptions.md
21
+ </execution_context>
22
+
23
+ <context>
24
+ Phase number: $ARGUMENTS (required)
25
+
26
+ Project state and roadmap are loaded in-workflow using targeted reads.
27
+ </context>
28
+
29
+ <process>
30
+ 1. Validate phase number argument (error if missing or invalid)
31
+ 2. Check if phase exists in roadmap
32
+ 3. Follow list-phase-assumptions.md workflow:
33
+ - Analyze roadmap description
34
+ - Surface assumptions about: technical approach, implementation order, scope, risks, dependencies
35
+ - Present assumptions clearly
36
+ - Prompt "What do you think?"
37
+ 4. Gather feedback and offer next steps
38
+ </process>
39
+
40
+ <success_criteria>
41
+
42
+ - Phase validated against roadmap
43
+ - Assumptions surfaced across five areas
44
+ - User prompted for feedback
45
+ - User knows next steps (discuss context, plan phase, or correct assumptions)
46
+ </success_criteria>
@@ -0,0 +1,19 @@
1
+ ---
2
+ name: sdd:list-workspaces
3
+ description: List active SDD workspaces and their status
4
+ allowed-tools:
5
+ - Bash
6
+ - Read
7
+ ---
8
+ <objective>
9
+ Scan `~/sdd-workspaces/` for workspace directories containing `WORKSPACE.md` manifests. Display a summary table with name, path, repo count, strategy, and SDD project status.
10
+ </objective>
11
+
12
+ <execution_context>
13
+ @~/.claude/sdd/workflows/list-workspaces.md
14
+ @~/.claude/sdd/references/ui-brand.md
15
+ </execution_context>
16
+
17
+ <process>
18
+ Execute the list-workspaces workflow from @~/.claude/sdd/workflows/list-workspaces.md end-to-end.
19
+ </process>
@@ -0,0 +1,39 @@
1
+ ---
2
+ name: sdd:manager
3
+ description: Interactive command center for managing multiple phases from one terminal
4
+ allowed-tools:
5
+ - Read
6
+ - Write
7
+ - Bash
8
+ - Glob
9
+ - Grep
10
+ - AskUserQuestion
11
+ - Task
12
+ ---
13
+ <objective>
14
+ Single-terminal command center for managing a milestone. Shows a dashboard of all phases with visual status indicators, recommends optimal next actions, and dispatches work — discuss runs inline, plan/execute run as background agents.
15
+
16
+ Designed for power users who want to parallelize work across phases from one terminal: discuss a phase while another plans or executes in the background.
17
+
18
+ **Creates/Updates:**
19
+ - No files created directly — dispatches to existing SDD commands via Skill() and background Task agents.
20
+ - Reads `.planning/STATE.md`, `.planning/ROADMAP.md`, phase directories for status.
21
+
22
+ **After:** User exits when done managing, or all phases complete and milestone lifecycle is suggested.
23
+ </objective>
24
+
25
+ <execution_context>
26
+ @~/.claude/sdd/workflows/manager.md
27
+ @~/.claude/sdd/references/ui-brand.md
28
+ </execution_context>
29
+
30
+ <context>
31
+ No arguments required. Requires an active milestone with ROADMAP.md and STATE.md.
32
+
33
+ Project context, phase list, dependencies, and recommendations are resolved inside the workflow using `sdd-tools.cjs init manager`. No upfront context loading needed.
34
+ </context>
35
+
36
+ <process>
37
+ Execute the manager workflow from @~/.claude/sdd/workflows/manager.md end-to-end.
38
+ Maintain the dashboard refresh loop until the user exits or all phases complete.
39
+ </process>
@@ -0,0 +1,71 @@
1
+ ---
2
+ name: sdd:map-codebase
3
+ description: Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
4
+ argument-hint: "[optional: specific area to map, e.g., 'api' or 'auth']"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Glob
9
+ - Grep
10
+ - Write
11
+ - Task
12
+ ---
13
+
14
+ <objective>
15
+ Analyze existing codebase using parallel sdd-codebase-mapper agents to produce structured codebase documents.
16
+
17
+ Each mapper agent explores a focus area and **writes documents directly** to `.planning/codebase/`. The orchestrator only receives confirmations, keeping context usage minimal.
18
+
19
+ Output: .planning/codebase/ folder with 7 structured documents about the codebase state.
20
+ </objective>
21
+
22
+ <execution_context>
23
+ @~/.claude/sdd/workflows/map-codebase.md
24
+ </execution_context>
25
+
26
+ <context>
27
+ Focus area: $ARGUMENTS (optional - if provided, tells agents to focus on specific subsystem)
28
+
29
+ **Load project state if exists:**
30
+ Check for .planning/STATE.md - loads context if project already initialized
31
+
32
+ **This command can run:**
33
+ - Before /sdd:new-project (brownfield codebases) - creates codebase map first
34
+ - After /sdd:new-project (greenfield codebases) - updates codebase map as code evolves
35
+ - Anytime to refresh codebase understanding
36
+ </context>
37
+
38
+ <when_to_use>
39
+ **Use map-codebase for:**
40
+ - Brownfield projects before initialization (understand existing code first)
41
+ - Refreshing codebase map after significant changes
42
+ - Onboarding to an unfamiliar codebase
43
+ - Before major refactoring (understand current state)
44
+ - When STATE.md references outdated codebase info
45
+
46
+ **Skip map-codebase for:**
47
+ - Greenfield projects with no code yet (nothing to map)
48
+ - Trivial codebases (<5 files)
49
+ </when_to_use>
50
+
51
+ <process>
52
+ 1. Check if .planning/codebase/ already exists (offer to refresh or skip)
53
+ 2. Create .planning/codebase/ directory structure
54
+ 3. Spawn 4 parallel sdd-codebase-mapper agents:
55
+ - Agent 1: tech focus → writes STACK.md, INTEGRATIONS.md
56
+ - Agent 2: arch focus → writes ARCHITECTURE.md, STRUCTURE.md
57
+ - Agent 3: quality focus → writes CONVENTIONS.md, TESTING.md
58
+ - Agent 4: concerns focus → writes CONCERNS.md
59
+ 4. Wait for agents to complete, collect confirmations (NOT document contents)
60
+ 5. Verify all 7 documents exist with line counts
61
+ 6. Commit codebase map
62
+ 7. Offer next steps (typically: /sdd:new-project or /sdd:plan-phase)
63
+ </process>
64
+
65
+ <success_criteria>
66
+ - [ ] .planning/codebase/ directory created
67
+ - [ ] All 7 codebase documents written by mapper agents
68
+ - [ ] Documents follow template structure
69
+ - [ ] Parallel agents completed without errors
70
+ - [ ] User knows next steps
71
+ </success_criteria>
@@ -0,0 +1,51 @@
1
+ ---
2
+ type: prompt
3
+ name: sdd:milestone-summary
4
+ description: Generate a comprehensive project summary from milestone artifacts for team onboarding and review
5
+ argument-hint: "[version]"
6
+ allowed-tools:
7
+ - Read
8
+ - Write
9
+ - Bash
10
+ - Grep
11
+ - Glob
12
+ ---
13
+
14
+ <objective>
15
+ Generate a structured milestone summary for team onboarding and project review. Reads completed milestone artifacts (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION files) and produces a human-friendly overview of what was built, how, and why.
16
+
17
+ Purpose: Enable new team members to understand a completed project by reading one document and asking follow-up questions.
18
+ Output: MILESTONE_SUMMARY written to `.planning/reports/`, presented inline, optional interactive Q&A.
19
+ </objective>
20
+
21
+ <execution_context>
22
+ @~/.claude/sdd/workflows/milestone-summary.md
23
+ </execution_context>
24
+
25
+ <context>
26
+ **Project files:**
27
+ - `.planning/ROADMAP.md`
28
+ - `.planning/PROJECT.md`
29
+ - `.planning/STATE.md`
30
+ - `.planning/RETROSPECTIVE.md`
31
+ - `.planning/milestones/v{version}-ROADMAP.md` (if archived)
32
+ - `.planning/milestones/v{version}-REQUIREMENTS.md` (if archived)
33
+ - `.planning/phases/*-*/` (SUMMARY.md, VERIFICATION.md, CONTEXT.md, RESEARCH.md)
34
+
35
+ **User input:**
36
+ - Version: $ARGUMENTS (optional — defaults to current/latest milestone)
37
+ </context>
38
+
39
+ <process>
40
+ Read and execute the milestone-summary workflow from @~/.claude/sdd/workflows/milestone-summary.md end-to-end.
41
+ </process>
42
+
43
+ <success_criteria>
44
+ - Milestone version resolved (from args, STATE.md, or archive scan)
45
+ - All available artifacts read (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, RESEARCH, RETROSPECTIVE)
46
+ - Summary document written to `.planning/reports/MILESTONE_SUMMARY-v{version}.md`
47
+ - All 7 sections generated (Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, Getting Started)
48
+ - Summary presented inline to user
49
+ - Interactive Q&A offered
50
+ - STATE.md updated
51
+ </success_criteria>
@@ -0,0 +1,44 @@
1
+ ---
2
+ name: sdd:new-milestone
3
+ description: Start a new milestone cycle — update PROJECT.md and route to requirements
4
+ argument-hint: "[milestone name, e.g., 'v1.1 Notifications']"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Bash
9
+ - Task
10
+ - AskUserQuestion
11
+ ---
12
+ <objective>
13
+ Start a new milestone: questioning → research (optional) → requirements → roadmap.
14
+
15
+ Brownfield equivalent of new-project. Project exists, PROJECT.md has history. Gathers "what's next", updates PROJECT.md, then runs requirements → roadmap cycle.
16
+
17
+ **Creates/Updates:**
18
+ - `.planning/PROJECT.md` — updated with new milestone goals
19
+ - `.planning/research/` — domain research (optional, NEW features only)
20
+ - `.planning/REQUIREMENTS.md` — scoped requirements for this milestone
21
+ - `.planning/ROADMAP.md` — phase structure (continues numbering)
22
+ - `.planning/STATE.md` — reset for new milestone
23
+
24
+ **After:** `/sdd:plan-phase [N]` to start execution.
25
+ </objective>
26
+
27
+ <execution_context>
28
+ @~/.claude/sdd/workflows/new-milestone.md
29
+ @~/.claude/sdd/references/questioning.md
30
+ @~/.claude/sdd/references/ui-brand.md
31
+ @~/.claude/sdd/templates/project.md
32
+ @~/.claude/sdd/templates/requirements.md
33
+ </execution_context>
34
+
35
+ <context>
36
+ Milestone name: $ARGUMENTS (optional - will prompt if not provided)
37
+
38
+ Project and milestone context files are resolved inside the workflow (`init new-milestone`) and delegated via `<files_to_read>` blocks where subagents are used.
39
+ </context>
40
+
41
+ <process>
42
+ Execute the new-milestone workflow from @~/.claude/sdd/workflows/new-milestone.md end-to-end.
43
+ Preserve all workflow gates (validation, questioning, research, requirements, roadmap approval, commits).
44
+ </process>
@@ -0,0 +1,42 @@
1
+ ---
2
+ name: sdd:new-project
3
+ description: Initialize a new project with deep context gathering and PROJECT.md
4
+ argument-hint: "[--auto]"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Write
9
+ - Task
10
+ - AskUserQuestion
11
+ ---
12
+ <context>
13
+ **Flags:**
14
+ - `--auto` — Automatic mode. After config questions, runs research → requirements → roadmap without further interaction. Expects idea document via @ reference.
15
+ </context>
16
+
17
+ <objective>
18
+ Initialize a new project through unified flow: questioning → research (optional) → requirements → roadmap.
19
+
20
+ **Creates:**
21
+ - `.planning/PROJECT.md` — project context
22
+ - `.planning/config.json` — workflow preferences
23
+ - `.planning/research/` — domain research (optional)
24
+ - `.planning/REQUIREMENTS.md` — scoped requirements
25
+ - `.planning/ROADMAP.md` — phase structure
26
+ - `.planning/STATE.md` — project memory
27
+
28
+ **After this command:** Run `/sdd:plan-phase 1` to start execution.
29
+ </objective>
30
+
31
+ <execution_context>
32
+ @~/.claude/sdd/workflows/new-project.md
33
+ @~/.claude/sdd/references/questioning.md
34
+ @~/.claude/sdd/references/ui-brand.md
35
+ @~/.claude/sdd/templates/project.md
36
+ @~/.claude/sdd/templates/requirements.md
37
+ </execution_context>
38
+
39
+ <process>
40
+ Execute the new-project workflow from @~/.claude/sdd/workflows/new-project.md end-to-end.
41
+ Preserve all workflow gates (validation, approvals, commits, routing).
42
+ </process>