@opengsd/gsd-core 1.2.0-rc.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 (503) hide show
  1. package/LICENSE +21 -0
  2. package/README.ja-JP.md +870 -0
  3. package/README.ko-KR.md +861 -0
  4. package/README.md +301 -0
  5. package/README.pt-BR.md +492 -0
  6. package/README.zh-CN.md +842 -0
  7. package/agents/gsd-advisor-researcher.md +127 -0
  8. package/agents/gsd-ai-researcher.md +133 -0
  9. package/agents/gsd-assumptions-analyzer.md +105 -0
  10. package/agents/gsd-code-fixer.md +668 -0
  11. package/agents/gsd-code-reviewer.md +387 -0
  12. package/agents/gsd-codebase-mapper.md +853 -0
  13. package/agents/gsd-debug-session-manager.md +314 -0
  14. package/agents/gsd-debugger.md +1452 -0
  15. package/agents/gsd-doc-classifier.md +168 -0
  16. package/agents/gsd-doc-synthesizer.md +204 -0
  17. package/agents/gsd-doc-verifier.md +217 -0
  18. package/agents/gsd-doc-writer.md +615 -0
  19. package/agents/gsd-domain-researcher.md +153 -0
  20. package/agents/gsd-eval-auditor.md +191 -0
  21. package/agents/gsd-eval-planner.md +154 -0
  22. package/agents/gsd-executor.md +772 -0
  23. package/agents/gsd-framework-selector.md +160 -0
  24. package/agents/gsd-integration-checker.md +470 -0
  25. package/agents/gsd-intel-updater.md +342 -0
  26. package/agents/gsd-nyquist-auditor.md +203 -0
  27. package/agents/gsd-pattern-mapper.md +335 -0
  28. package/agents/gsd-phase-researcher.md +928 -0
  29. package/agents/gsd-plan-checker.md +978 -0
  30. package/agents/gsd-planner.md +1218 -0
  31. package/agents/gsd-project-researcher.md +677 -0
  32. package/agents/gsd-research-synthesizer.md +255 -0
  33. package/agents/gsd-roadmapper.md +688 -0
  34. package/agents/gsd-security-auditor.md +155 -0
  35. package/agents/gsd-ui-auditor.md +495 -0
  36. package/agents/gsd-ui-checker.md +309 -0
  37. package/agents/gsd-ui-researcher.md +380 -0
  38. package/agents/gsd-user-profiler.md +171 -0
  39. package/agents/gsd-verifier.md +917 -0
  40. package/bin/install.js +10936 -0
  41. package/bin/lib/ui-safety-gate.cjs +107 -0
  42. package/commands/gsd/add-tests.md +42 -0
  43. package/commands/gsd/ai-integration-phase.md +37 -0
  44. package/commands/gsd/audit-fix.md +34 -0
  45. package/commands/gsd/audit-milestone.md +37 -0
  46. package/commands/gsd/audit-uat.md +24 -0
  47. package/commands/gsd/autonomous.md +46 -0
  48. package/commands/gsd/capture.md +62 -0
  49. package/commands/gsd/cleanup.md +24 -0
  50. package/commands/gsd/code-review.md +59 -0
  51. package/commands/gsd/complete-milestone.md +143 -0
  52. package/commands/gsd/config.md +56 -0
  53. package/commands/gsd/debug.md +52 -0
  54. package/commands/gsd/discuss-phase.md +76 -0
  55. package/commands/gsd/docs-update.md +49 -0
  56. package/commands/gsd/eval-review.md +33 -0
  57. package/commands/gsd/execute-phase.md +64 -0
  58. package/commands/gsd/explore.md +27 -0
  59. package/commands/gsd/extract-learnings.md +23 -0
  60. package/commands/gsd/fast.md +31 -0
  61. package/commands/gsd/forensics.md +57 -0
  62. package/commands/gsd/graphify.md +199 -0
  63. package/commands/gsd/health.md +31 -0
  64. package/commands/gsd/help.md +28 -0
  65. package/commands/gsd/import.md +41 -0
  66. package/commands/gsd/inbox.md +39 -0
  67. package/commands/gsd/ingest-docs.md +42 -0
  68. package/commands/gsd/manager.md +45 -0
  69. package/commands/gsd/map-codebase.md +83 -0
  70. package/commands/gsd/milestone-summary.md +51 -0
  71. package/commands/gsd/mvp-phase.md +45 -0
  72. package/commands/gsd/new-milestone.md +45 -0
  73. package/commands/gsd/new-project.md +47 -0
  74. package/commands/gsd/ns-context.md +23 -0
  75. package/commands/gsd/ns-ideate.md +24 -0
  76. package/commands/gsd/ns-manage.md +29 -0
  77. package/commands/gsd/ns-project.md +22 -0
  78. package/commands/gsd/ns-review.md +26 -0
  79. package/commands/gsd/ns-workflow.md +28 -0
  80. package/commands/gsd/pause-work.md +43 -0
  81. package/commands/gsd/phase.md +56 -0
  82. package/commands/gsd/plan-phase.md +62 -0
  83. package/commands/gsd/plan-review-convergence.md +59 -0
  84. package/commands/gsd/pr-branch.md +26 -0
  85. package/commands/gsd/profile-user.md +46 -0
  86. package/commands/gsd/progress.md +47 -0
  87. package/commands/gsd/quick.md +174 -0
  88. package/commands/gsd/resume-work.md +30 -0
  89. package/commands/gsd/review-backlog.md +63 -0
  90. package/commands/gsd/review.md +41 -0
  91. package/commands/gsd/secure-phase.md +36 -0
  92. package/commands/gsd/settings.md +29 -0
  93. package/commands/gsd/ship.md +24 -0
  94. package/commands/gsd/sketch.md +60 -0
  95. package/commands/gsd/spec-phase.md +63 -0
  96. package/commands/gsd/spike.md +57 -0
  97. package/commands/gsd/stats.md +19 -0
  98. package/commands/gsd/surface.md +155 -0
  99. package/commands/gsd/thread.md +24 -0
  100. package/commands/gsd/ui-phase.md +35 -0
  101. package/commands/gsd/ui-review.md +33 -0
  102. package/commands/gsd/ultraplan-phase.md +34 -0
  103. package/commands/gsd/undo.md +35 -0
  104. package/commands/gsd/update.md +48 -0
  105. package/commands/gsd/validate-phase.md +36 -0
  106. package/commands/gsd/verify-work.md +39 -0
  107. package/commands/gsd/workspace.md +52 -0
  108. package/commands/gsd/workstreams.md +70 -0
  109. package/get-shit-done/bin/check-latest-version.cjs +106 -0
  110. package/get-shit-done/bin/gsd-tools.cjs +1676 -0
  111. package/get-shit-done/bin/lib/active-workstream-store.cjs +302 -0
  112. package/get-shit-done/bin/lib/adr-parser.cjs +394 -0
  113. package/get-shit-done/bin/lib/agent-command-router.cjs +65 -0
  114. package/get-shit-done/bin/lib/artifacts.cjs +53 -0
  115. package/get-shit-done/bin/lib/audit.cjs +755 -0
  116. package/get-shit-done/bin/lib/check-command-router.cjs +333 -0
  117. package/get-shit-done/bin/lib/cjs-command-router-adapter.cjs +118 -0
  118. package/get-shit-done/bin/lib/clock.cjs +96 -0
  119. package/get-shit-done/bin/lib/clusters.cjs +135 -0
  120. package/get-shit-done/bin/lib/code-review-flags.cjs +74 -0
  121. package/get-shit-done/bin/lib/command-aliases.cjs +815 -0
  122. package/get-shit-done/bin/lib/command-arg-projection.cjs +62 -0
  123. package/get-shit-done/bin/lib/command-routing-hub.cjs +388 -0
  124. package/get-shit-done/bin/lib/commands.cjs +1188 -0
  125. package/get-shit-done/bin/lib/config-schema.cjs +31 -0
  126. package/get-shit-done/bin/lib/config.cjs +728 -0
  127. package/get-shit-done/bin/lib/configuration.cjs +248 -0
  128. package/get-shit-done/bin/lib/context-utilization.cjs +47 -0
  129. package/get-shit-done/bin/lib/core.cjs +2121 -0
  130. package/get-shit-done/bin/lib/decisions.cjs +116 -0
  131. package/get-shit-done/bin/lib/docs.cjs +270 -0
  132. package/get-shit-done/bin/lib/drift.cjs +388 -0
  133. package/get-shit-done/bin/lib/fallow-runner.cjs +109 -0
  134. package/get-shit-done/bin/lib/frontmatter.cjs +389 -0
  135. package/get-shit-done/bin/lib/gap-checker.cjs +205 -0
  136. package/get-shit-done/bin/lib/graphify.cjs +592 -0
  137. package/get-shit-done/bin/lib/gsd2-import.cjs +514 -0
  138. package/get-shit-done/bin/lib/init-command-router.cjs +58 -0
  139. package/get-shit-done/bin/lib/init.cjs +2112 -0
  140. package/get-shit-done/bin/lib/install-profiles.cjs +603 -0
  141. package/get-shit-done/bin/lib/installer-migration-authoring.cjs +117 -0
  142. package/get-shit-done/bin/lib/installer-migration-report.cjs +354 -0
  143. package/get-shit-done/bin/lib/installer-migrations/000-first-time-baseline.cjs +220 -0
  144. package/get-shit-done/bin/lib/installer-migrations/001-legacy-orphan-files.cjs +41 -0
  145. package/get-shit-done/bin/lib/installer-migrations/002-codex-legacy-hooks-json.cjs +80 -0
  146. package/get-shit-done/bin/lib/installer-migrations.cjs +778 -0
  147. package/get-shit-done/bin/lib/intel.cjs +708 -0
  148. package/get-shit-done/bin/lib/learnings.cjs +421 -0
  149. package/get-shit-done/bin/lib/milestone.cjs +314 -0
  150. package/get-shit-done/bin/lib/model-catalog.cjs +212 -0
  151. package/get-shit-done/bin/lib/model-profiles.cjs +31 -0
  152. package/get-shit-done/bin/lib/observability/event.cjs +82 -0
  153. package/get-shit-done/bin/lib/observability/logger.cjs +174 -0
  154. package/get-shit-done/bin/lib/observability/redaction.cjs +50 -0
  155. package/get-shit-done/bin/lib/package-identity.cjs +31 -0
  156. package/get-shit-done/bin/lib/phase-command-router.cjs +191 -0
  157. package/get-shit-done/bin/lib/phase-lifecycle.cjs +80 -0
  158. package/get-shit-done/bin/lib/phase.cjs +1607 -0
  159. package/get-shit-done/bin/lib/phases-command-router.cjs +39 -0
  160. package/get-shit-done/bin/lib/plan-scan.cjs +97 -0
  161. package/get-shit-done/bin/lib/planning-workspace.cjs +238 -0
  162. package/get-shit-done/bin/lib/profile-output.cjs +1141 -0
  163. package/get-shit-done/bin/lib/profile-pipeline.cjs +539 -0
  164. package/get-shit-done/bin/lib/project-root.cjs +112 -0
  165. package/get-shit-done/bin/lib/prompt-budget.cjs +399 -0
  166. package/get-shit-done/bin/lib/review-reviewer-selection.cjs +125 -0
  167. package/get-shit-done/bin/lib/roadmap-command-router.cjs +28 -0
  168. package/get-shit-done/bin/lib/roadmap.cjs +650 -0
  169. package/get-shit-done/bin/lib/runtime-artifact-layout.cjs +301 -0
  170. package/get-shit-done/bin/lib/runtime-homes.cjs +222 -0
  171. package/get-shit-done/bin/lib/runtime-name-policy.cjs +83 -0
  172. package/get-shit-done/bin/lib/runtime-slash.cjs +112 -0
  173. package/get-shit-done/bin/lib/schema-detect.cjs +165 -0
  174. package/get-shit-done/bin/lib/secrets.cjs +32 -0
  175. package/get-shit-done/bin/lib/security.cjs +600 -0
  176. package/get-shit-done/bin/lib/semver-compare.cjs +35 -0
  177. package/get-shit-done/bin/lib/shell-command-projection.cjs +500 -0
  178. package/get-shit-done/bin/lib/state-command-router.cjs +252 -0
  179. package/get-shit-done/bin/lib/state-document.cjs +263 -0
  180. package/get-shit-done/bin/lib/state.cjs +2038 -0
  181. package/get-shit-done/bin/lib/surface.cjs +470 -0
  182. package/get-shit-done/bin/lib/task-command-router.cjs +81 -0
  183. package/get-shit-done/bin/lib/template.cjs +228 -0
  184. package/get-shit-done/bin/lib/uat.cjs +289 -0
  185. package/get-shit-done/bin/lib/update-context.cjs +209 -0
  186. package/get-shit-done/bin/lib/validate-command-router.cjs +83 -0
  187. package/get-shit-done/bin/lib/validate.cjs +92 -0
  188. package/get-shit-done/bin/lib/verify-command-router.cjs +40 -0
  189. package/get-shit-done/bin/lib/verify.cjs +1511 -0
  190. package/get-shit-done/bin/lib/workstream-inventory-builder.cjs +74 -0
  191. package/get-shit-done/bin/lib/workstream-inventory.cjs +146 -0
  192. package/get-shit-done/bin/lib/workstream-name-policy.cjs +94 -0
  193. package/get-shit-done/bin/lib/workstream.cjs +389 -0
  194. package/get-shit-done/bin/lib/worktree-safety.cjs +985 -0
  195. package/get-shit-done/bin/shared/config-defaults.manifest.json +97 -0
  196. package/get-shit-done/bin/shared/config-schema.manifest.json +175 -0
  197. package/get-shit-done/bin/shared/model-catalog.json +122 -0
  198. package/get-shit-done/bin/shared/runtime-aliases.manifest.json +75 -0
  199. package/get-shit-done/bin/verify-reapply-patches.cjs +352 -0
  200. package/get-shit-done/contexts/dev.md +21 -0
  201. package/get-shit-done/contexts/research.md +22 -0
  202. package/get-shit-done/contexts/review.md +23 -0
  203. package/get-shit-done/references/agent-contracts.md +79 -0
  204. package/get-shit-done/references/ai-evals.md +156 -0
  205. package/get-shit-done/references/ai-frameworks.md +186 -0
  206. package/get-shit-done/references/artifact-types.md +131 -0
  207. package/get-shit-done/references/autonomous-smart-discuss.md +277 -0
  208. package/get-shit-done/references/checkpoints.md +814 -0
  209. package/get-shit-done/references/common-bug-patterns.md +114 -0
  210. package/get-shit-done/references/context-budget.md +85 -0
  211. package/get-shit-done/references/continuation-format.md +253 -0
  212. package/get-shit-done/references/debugger-philosophy.md +76 -0
  213. package/get-shit-done/references/decimal-phase-calculation.md +64 -0
  214. package/get-shit-done/references/doc-conflict-engine.md +91 -0
  215. package/get-shit-done/references/domain-probes.md +125 -0
  216. package/get-shit-done/references/execute-mvp-tdd.md +81 -0
  217. package/get-shit-done/references/executor-examples.md +110 -0
  218. package/get-shit-done/references/few-shot-examples/plan-checker.md +73 -0
  219. package/get-shit-done/references/few-shot-examples/verifier.md +109 -0
  220. package/get-shit-done/references/gate-prompts.md +100 -0
  221. package/get-shit-done/references/gates.md +70 -0
  222. package/get-shit-done/references/git-integration.md +298 -0
  223. package/get-shit-done/references/git-planning-commit.md +40 -0
  224. package/get-shit-done/references/ios-scaffold.md +123 -0
  225. package/get-shit-done/references/mandatory-initial-read.md +2 -0
  226. package/get-shit-done/references/model-profile-resolution.md +38 -0
  227. package/get-shit-done/references/model-profiles.md +245 -0
  228. package/get-shit-done/references/mvp-concepts.md +49 -0
  229. package/get-shit-done/references/phase-argument-parsing.md +61 -0
  230. package/get-shit-done/references/planner-antipatterns.md +89 -0
  231. package/get-shit-done/references/planner-chunked.md +49 -0
  232. package/get-shit-done/references/planner-gap-closure.md +62 -0
  233. package/get-shit-done/references/planner-graphify-auto-update.md +67 -0
  234. package/get-shit-done/references/planner-human-verify-mode.md +57 -0
  235. package/get-shit-done/references/planner-interface-context.md +62 -0
  236. package/get-shit-done/references/planner-mvp-mode.md +53 -0
  237. package/get-shit-done/references/planner-reviews.md +39 -0
  238. package/get-shit-done/references/planner-revision.md +87 -0
  239. package/get-shit-done/references/planner-source-audit.md +73 -0
  240. package/get-shit-done/references/planning-config.md +471 -0
  241. package/get-shit-done/references/project-skills-discovery.md +19 -0
  242. package/get-shit-done/references/questioning.md +162 -0
  243. package/get-shit-done/references/revision-loop.md +97 -0
  244. package/get-shit-done/references/scout-codebase.md +51 -0
  245. package/get-shit-done/references/skeleton-template.md +48 -0
  246. package/get-shit-done/references/sketch-interactivity.md +41 -0
  247. package/get-shit-done/references/sketch-theme-system.md +94 -0
  248. package/get-shit-done/references/sketch-tooling.md +45 -0
  249. package/get-shit-done/references/sketch-variant-patterns.md +81 -0
  250. package/get-shit-done/references/spidr-splitting.md +69 -0
  251. package/get-shit-done/references/tdd.md +330 -0
  252. package/get-shit-done/references/thinking-models-debug.md +44 -0
  253. package/get-shit-done/references/thinking-models-execution.md +50 -0
  254. package/get-shit-done/references/thinking-models-planning.md +62 -0
  255. package/get-shit-done/references/thinking-models-research.md +50 -0
  256. package/get-shit-done/references/thinking-models-verification.md +55 -0
  257. package/get-shit-done/references/thinking-partner.md +96 -0
  258. package/get-shit-done/references/ui-brand.md +160 -0
  259. package/get-shit-done/references/universal-anti-patterns.md +63 -0
  260. package/get-shit-done/references/user-profiling.md +681 -0
  261. package/get-shit-done/references/user-story-template.md +58 -0
  262. package/get-shit-done/references/verification-overrides.md +227 -0
  263. package/get-shit-done/references/verification-patterns.md +612 -0
  264. package/get-shit-done/references/verify-mvp-mode.md +85 -0
  265. package/get-shit-done/references/workstream-flag.md +111 -0
  266. package/get-shit-done/references/worktree-path-safety.md +89 -0
  267. package/get-shit-done/templates/AI-SPEC.md +246 -0
  268. package/get-shit-done/templates/DEBUG.md +169 -0
  269. package/get-shit-done/templates/README.md +77 -0
  270. package/get-shit-done/templates/SECURITY.md +61 -0
  271. package/get-shit-done/templates/UAT.md +265 -0
  272. package/get-shit-done/templates/UI-SPEC.md +100 -0
  273. package/get-shit-done/templates/VALIDATION.md +76 -0
  274. package/get-shit-done/templates/claude-md.md +145 -0
  275. package/get-shit-done/templates/codebase/architecture.md +255 -0
  276. package/get-shit-done/templates/codebase/concerns.md +310 -0
  277. package/get-shit-done/templates/codebase/conventions.md +307 -0
  278. package/get-shit-done/templates/codebase/integrations.md +280 -0
  279. package/get-shit-done/templates/codebase/stack.md +186 -0
  280. package/get-shit-done/templates/codebase/structure.md +285 -0
  281. package/get-shit-done/templates/codebase/testing.md +480 -0
  282. package/get-shit-done/templates/config.json +62 -0
  283. package/get-shit-done/templates/context.md +352 -0
  284. package/get-shit-done/templates/continue-here.md +78 -0
  285. package/get-shit-done/templates/copilot-instructions.md +7 -0
  286. package/get-shit-done/templates/debug-subagent-prompt.md +91 -0
  287. package/get-shit-done/templates/dev-preferences.md +21 -0
  288. package/get-shit-done/templates/discovery.md +146 -0
  289. package/get-shit-done/templates/discussion-log.md +63 -0
  290. package/get-shit-done/templates/milestone-archive.md +123 -0
  291. package/get-shit-done/templates/milestone.md +115 -0
  292. package/get-shit-done/templates/phase-prompt.md +610 -0
  293. package/get-shit-done/templates/planner-subagent-prompt.md +117 -0
  294. package/get-shit-done/templates/project.md +186 -0
  295. package/get-shit-done/templates/requirements.md +231 -0
  296. package/get-shit-done/templates/research-project/ARCHITECTURE.md +204 -0
  297. package/get-shit-done/templates/research-project/FEATURES.md +147 -0
  298. package/get-shit-done/templates/research-project/PITFALLS.md +200 -0
  299. package/get-shit-done/templates/research-project/STACK.md +120 -0
  300. package/get-shit-done/templates/research-project/SUMMARY.md +170 -0
  301. package/get-shit-done/templates/research.md +592 -0
  302. package/get-shit-done/templates/retrospective.md +54 -0
  303. package/get-shit-done/templates/roadmap.md +202 -0
  304. package/get-shit-done/templates/spec.md +307 -0
  305. package/get-shit-done/templates/state.md +195 -0
  306. package/get-shit-done/templates/summary-complex.md +59 -0
  307. package/get-shit-done/templates/summary-minimal.md +41 -0
  308. package/get-shit-done/templates/summary-standard.md +48 -0
  309. package/get-shit-done/templates/summary.md +248 -0
  310. package/get-shit-done/templates/user-profile.md +146 -0
  311. package/get-shit-done/templates/user-setup.md +311 -0
  312. package/get-shit-done/templates/verification-report.md +322 -0
  313. package/get-shit-done/workflows/_runtime-launcher.snippet.sh +1 -0
  314. package/get-shit-done/workflows/add-backlog.md +91 -0
  315. package/get-shit-done/workflows/add-phase.md +113 -0
  316. package/get-shit-done/workflows/add-tests.md +355 -0
  317. package/get-shit-done/workflows/add-todo.md +161 -0
  318. package/get-shit-done/workflows/ai-integration-phase.md +295 -0
  319. package/get-shit-done/workflows/analyze-dependencies.md +96 -0
  320. package/get-shit-done/workflows/audit-fix.md +178 -0
  321. package/get-shit-done/workflows/audit-milestone.md +358 -0
  322. package/get-shit-done/workflows/audit-uat.md +110 -0
  323. package/get-shit-done/workflows/autonomous.md +795 -0
  324. package/get-shit-done/workflows/check-todos.md +180 -0
  325. package/get-shit-done/workflows/cleanup.md +155 -0
  326. package/get-shit-done/workflows/code-review-fix.md +502 -0
  327. package/get-shit-done/workflows/code-review.md +656 -0
  328. package/get-shit-done/workflows/complete-milestone.md +855 -0
  329. package/get-shit-done/workflows/debug.md +232 -0
  330. package/get-shit-done/workflows/diagnose-issues.md +241 -0
  331. package/get-shit-done/workflows/discovery-phase.md +291 -0
  332. package/get-shit-done/workflows/discuss-phase/modes/advisor.md +176 -0
  333. package/get-shit-done/workflows/discuss-phase/modes/all.md +28 -0
  334. package/get-shit-done/workflows/discuss-phase/modes/analyze.md +44 -0
  335. package/get-shit-done/workflows/discuss-phase/modes/auto.md +57 -0
  336. package/get-shit-done/workflows/discuss-phase/modes/batch.md +52 -0
  337. package/get-shit-done/workflows/discuss-phase/modes/chain.md +98 -0
  338. package/get-shit-done/workflows/discuss-phase/modes/default.md +141 -0
  339. package/get-shit-done/workflows/discuss-phase/modes/power.md +44 -0
  340. package/get-shit-done/workflows/discuss-phase/modes/text.md +55 -0
  341. package/get-shit-done/workflows/discuss-phase/templates/checkpoint.json +18 -0
  342. package/get-shit-done/workflows/discuss-phase/templates/context.md +136 -0
  343. package/get-shit-done/workflows/discuss-phase/templates/discussion-log.md +50 -0
  344. package/get-shit-done/workflows/discuss-phase-assumptions.md +675 -0
  345. package/get-shit-done/workflows/discuss-phase-power.md +291 -0
  346. package/get-shit-done/workflows/discuss-phase.md +499 -0
  347. package/get-shit-done/workflows/do.md +111 -0
  348. package/get-shit-done/workflows/docs-update.md +1162 -0
  349. package/get-shit-done/workflows/edit-phase.md +295 -0
  350. package/get-shit-done/workflows/eval-review.md +156 -0
  351. package/get-shit-done/workflows/execute-phase/steps/codebase-drift-gate.md +82 -0
  352. package/get-shit-done/workflows/execute-phase/steps/per-plan-worktree-gate.md +94 -0
  353. package/get-shit-done/workflows/execute-phase/steps/post-merge-gate.md +117 -0
  354. package/get-shit-done/workflows/execute-phase.md +1709 -0
  355. package/get-shit-done/workflows/execute-plan.md +526 -0
  356. package/get-shit-done/workflows/explore.md +144 -0
  357. package/get-shit-done/workflows/extract-learnings.md +243 -0
  358. package/get-shit-done/workflows/fast.md +124 -0
  359. package/get-shit-done/workflows/forensics.md +279 -0
  360. package/get-shit-done/workflows/graduation.md +196 -0
  361. package/get-shit-done/workflows/health.md +224 -0
  362. package/get-shit-done/workflows/help/modes/brief.md +22 -0
  363. package/get-shit-done/workflows/help/modes/default.md +50 -0
  364. package/get-shit-done/workflows/help/modes/full.md +784 -0
  365. package/get-shit-done/workflows/help/modes/topic.md +74 -0
  366. package/get-shit-done/workflows/help.md +24 -0
  367. package/get-shit-done/workflows/import.md +254 -0
  368. package/get-shit-done/workflows/inbox.md +387 -0
  369. package/get-shit-done/workflows/ingest-docs.md +339 -0
  370. package/get-shit-done/workflows/insert-phase.md +152 -0
  371. package/get-shit-done/workflows/list-phase-assumptions.md +178 -0
  372. package/get-shit-done/workflows/list-workspaces.md +57 -0
  373. package/get-shit-done/workflows/manager.md +393 -0
  374. package/get-shit-done/workflows/map-codebase.md +444 -0
  375. package/get-shit-done/workflows/milestone-summary.md +224 -0
  376. package/get-shit-done/workflows/mvp-phase.md +222 -0
  377. package/get-shit-done/workflows/new-milestone.md +635 -0
  378. package/get-shit-done/workflows/new-project.md +1555 -0
  379. package/get-shit-done/workflows/new-workspace.md +240 -0
  380. package/get-shit-done/workflows/next.md +299 -0
  381. package/get-shit-done/workflows/node-repair.md +92 -0
  382. package/get-shit-done/workflows/note.md +158 -0
  383. package/get-shit-done/workflows/pause-work.md +244 -0
  384. package/get-shit-done/workflows/plan-milestone-gaps.md +281 -0
  385. package/get-shit-done/workflows/plan-phase.md +1809 -0
  386. package/get-shit-done/workflows/plan-review-convergence.md +346 -0
  387. package/get-shit-done/workflows/plant-seed.md +230 -0
  388. package/get-shit-done/workflows/pr-branch.md +157 -0
  389. package/get-shit-done/workflows/profile-user.md +453 -0
  390. package/get-shit-done/workflows/progress.md +699 -0
  391. package/get-shit-done/workflows/quick.md +1039 -0
  392. package/get-shit-done/workflows/reapply-patches.md +426 -0
  393. package/get-shit-done/workflows/remove-phase.md +156 -0
  394. package/get-shit-done/workflows/remove-workspace.md +108 -0
  395. package/get-shit-done/workflows/resume-project.md +332 -0
  396. package/get-shit-done/workflows/review.md +623 -0
  397. package/get-shit-done/workflows/scan.md +105 -0
  398. package/get-shit-done/workflows/secure-phase.md +180 -0
  399. package/get-shit-done/workflows/session-report.md +146 -0
  400. package/get-shit-done/workflows/settings-advanced.md +620 -0
  401. package/get-shit-done/workflows/settings-integrations.md +312 -0
  402. package/get-shit-done/workflows/settings.md +552 -0
  403. package/get-shit-done/workflows/ship.md +356 -0
  404. package/get-shit-done/workflows/sketch-wrap-up.md +286 -0
  405. package/get-shit-done/workflows/sketch.md +361 -0
  406. package/get-shit-done/workflows/spec-phase.md +262 -0
  407. package/get-shit-done/workflows/spike-wrap-up.md +307 -0
  408. package/get-shit-done/workflows/spike.md +453 -0
  409. package/get-shit-done/workflows/stats.md +80 -0
  410. package/get-shit-done/workflows/sync-skills.md +182 -0
  411. package/get-shit-done/workflows/thread.md +222 -0
  412. package/get-shit-done/workflows/transition.md +694 -0
  413. package/get-shit-done/workflows/ui-phase.md +328 -0
  414. package/get-shit-done/workflows/ui-review.md +193 -0
  415. package/get-shit-done/workflows/ultraplan-phase.md +199 -0
  416. package/get-shit-done/workflows/undo.md +314 -0
  417. package/get-shit-done/workflows/update.md +443 -0
  418. package/get-shit-done/workflows/validate-phase.md +179 -0
  419. package/get-shit-done/workflows/verify-phase.md +544 -0
  420. package/get-shit-done/workflows/verify-work.md +781 -0
  421. package/hooks/dist/gsd-check-update-worker.js +95 -0
  422. package/hooks/dist/gsd-check-update.js +64 -0
  423. package/hooks/dist/gsd-context-monitor.js +195 -0
  424. package/hooks/dist/gsd-graphify-update.sh +158 -0
  425. package/hooks/dist/gsd-phase-boundary.sh +47 -0
  426. package/hooks/dist/gsd-prompt-guard.js +97 -0
  427. package/hooks/dist/gsd-read-guard.js +101 -0
  428. package/hooks/dist/gsd-read-injection-scanner.js +203 -0
  429. package/hooks/dist/gsd-session-state.sh +59 -0
  430. package/hooks/dist/gsd-statusline.js +548 -0
  431. package/hooks/dist/gsd-update-banner.js +134 -0
  432. package/hooks/dist/gsd-validate-commit.sh +57 -0
  433. package/hooks/dist/gsd-workflow-guard.js +166 -0
  434. package/hooks/dist/lib/git-cmd.js +150 -0
  435. package/hooks/dist/lib/gsd-graphify-rebuild.sh +65 -0
  436. package/hooks/gsd-check-update-worker.js +95 -0
  437. package/hooks/gsd-check-update.js +64 -0
  438. package/hooks/gsd-context-monitor.js +195 -0
  439. package/hooks/gsd-graphify-update.sh +158 -0
  440. package/hooks/gsd-phase-boundary.sh +47 -0
  441. package/hooks/gsd-prompt-guard.js +97 -0
  442. package/hooks/gsd-read-guard.js +101 -0
  443. package/hooks/gsd-read-injection-scanner.js +203 -0
  444. package/hooks/gsd-session-state.sh +59 -0
  445. package/hooks/gsd-statusline.js +548 -0
  446. package/hooks/gsd-update-banner.js +134 -0
  447. package/hooks/gsd-validate-commit.sh +57 -0
  448. package/hooks/gsd-workflow-guard.js +166 -0
  449. package/hooks/lib/git-cmd.js +150 -0
  450. package/hooks/lib/gsd-graphify-rebuild.sh +65 -0
  451. package/hooks/managed-hooks-registry.cjs +34 -0
  452. package/package.json +102 -0
  453. package/scripts/affected-tests-lib.cjs +541 -0
  454. package/scripts/audit-workflow-script-paths.cjs +73 -0
  455. package/scripts/base64-scan.sh +339 -0
  456. package/scripts/build-hooks.js +236 -0
  457. package/scripts/changeset/README.md +129 -0
  458. package/scripts/changeset/cli.cjs +392 -0
  459. package/scripts/changeset/github-release-notes.cjs +199 -0
  460. package/scripts/changeset/lint.cjs +110 -0
  461. package/scripts/changeset/new.cjs +137 -0
  462. package/scripts/changeset/parse.cjs +114 -0
  463. package/scripts/changeset/render.cjs +34 -0
  464. package/scripts/changeset/serialize.cjs +130 -0
  465. package/scripts/check-alias-drift.cjs +108 -0
  466. package/scripts/check-env.cjs +302 -0
  467. package/scripts/check-npm-integrity.cjs +209 -0
  468. package/scripts/ci-guard-runner.cjs +16 -0
  469. package/scripts/ci-prepare-test-scope.cjs +46 -0
  470. package/scripts/ci-rebase-check.cjs +85 -0
  471. package/scripts/ci-test-scope.cjs +302 -0
  472. package/scripts/command-contract-helpers.cjs +64 -0
  473. package/scripts/diff-touches-shipped-paths.cjs +147 -0
  474. package/scripts/fix-slash-commands.cjs +147 -0
  475. package/scripts/gen-inventory-manifest.cjs +109 -0
  476. package/scripts/generate-package-identity.cjs +104 -0
  477. package/scripts/lint-command-contract.cjs +108 -0
  478. package/scripts/lint-descriptions.cjs +83 -0
  479. package/scripts/lint-docs-required.cjs +222 -0
  480. package/scripts/lint-no-source-grep-extras.cjs +81 -0
  481. package/scripts/lint-no-source-grep.cjs +174 -0
  482. package/scripts/lint-package-identity-drift.cjs +141 -0
  483. package/scripts/lint-pr-check-project-dir.cjs +98 -0
  484. package/scripts/lint-shared-module-handsync.cjs +388 -0
  485. package/scripts/lint-shell-command-projection-drift.cjs +57 -0
  486. package/scripts/lint-skill-deps.cjs +180 -0
  487. package/scripts/lint-test-file-count.allowlist.json +36 -0
  488. package/scripts/lint-test-file-count.cjs +190 -0
  489. package/scripts/pr-template-policy.cjs +268 -0
  490. package/scripts/prompt-injection-scan.sh +203 -0
  491. package/scripts/release-tarball-smoke.cjs +627 -0
  492. package/scripts/run-affected-tests.cjs +6 -0
  493. package/scripts/run-cross-platform-tests.cjs +63 -0
  494. package/scripts/run-tests.cjs +282 -0
  495. package/scripts/secret-scan-lint.sh +231 -0
  496. package/scripts/secret-scan.sh +358 -0
  497. package/scripts/setup-branch-protection.sh +236 -0
  498. package/scripts/shared-module-handsync-allowlist.json +183 -0
  499. package/scripts/strip-prose-atrefs.cjs +106 -0
  500. package/scripts/sync-rulesets.sh +34 -0
  501. package/scripts/sync-runtime-launcher.cjs +402 -0
  502. package/scripts/test-failure-reasons.cjs +34 -0
  503. package/scripts/workflow-policy.cjs +450 -0
package/get-shit-done/workflows/map-codebase.md ADDED
@@ -0,0 +1,444 @@
1
+ <purpose>
2
+ Orchestrate parallel codebase mapper agents to analyze codebase and produce structured documents in .planning/codebase/
3
+
4
+ Each agent has fresh context, explores a specific focus area, and **writes documents directly**. The orchestrator only receives confirmation + line counts, then writes a summary.
5
+
6
+ Output: .planning/codebase/ folder with 7 structured documents about the codebase state.
7
+ </purpose>
8
+
9
+ <available_agent_types>
10
+ Valid GSD subagent types (use exact names — do not fall back to 'general-purpose'):
11
+ - gsd-codebase-mapper — Maps project structure and dependencies
12
+ </available_agent_types>
13
+
14
+ <philosophy>
15
+ **Why dedicated mapper agents:**
16
+ - Fresh context per domain (no token contamination)
17
+ - Agents write documents directly (no context transfer back to orchestrator)
18
+ - Orchestrator only summarizes what was created (minimal context usage)
19
+ - Faster execution (agents run simultaneously)
20
+
21
+ **Document quality over length:**
22
+ Include enough detail to be useful as reference. Prioritize practical examples (especially code patterns) over arbitrary brevity.
23
+
24
+ **Always include file paths:**
25
+ Documents are reference material for Claude when planning/executing. Always include actual file paths formatted with backticks: `src/services/user.ts`.
26
+ </philosophy>
27
+
28
+ <process>
29
+
30
+ <step name="parse_paths_flag" priority="first">
31
+ Parse an optional `--paths <p1,p2,...>` argument. When supplied (by the
32
+ post-execute codebase-drift gate in `/gsd:execute-phase` or by a user running
33
+ `/gsd:map-codebase --paths apps/accounting,packages/ui`), the workflow
34
+ operates in **incremental-remap mode**:
35
+
36
+ - Pass `--paths <p1>,<p2>,...` through to each spawned `gsd-codebase-mapper`
37
+ agent's prompt. Agents scope their Glob/Grep/Bash exploration to the listed
38
+ repo-relative prefixes only — no whole-repo scan.
39
+ - Reject path values that contain `..`, start with `/`, or include shell
40
+ metacharacters (`;`, `` ` ``, `$`, `&`, `|`, `<`, `>`). If all provided
41
+ paths are invalid, fall back to a normal whole-repo run.
42
+ - On write, each mapper stamps `last_mapped_commit: <HEAD sha>` into the YAML
43
+ frontmatter of every document it produces (see `bin/lib/drift.cjs:writeMappedCommit`).
44
+
45
+ **Explicit contract — propagate `--paths` through a single normalized
46
+ variable.** Downstream steps (`spawn_agents`, `sequential_mapping`, and any
47
+ Agent-mode prompt construction) MUST use `${PATH_SCOPE_HINT}` to ensure every
48
+ mapper receives the same deterministic scope. Without this contract
49
+ incremental-remap can silently regress to a whole-repo scan.
50
+
51
+ ```bash
52
+ # Validated, comma-separated paths (empty if --paths absent or all rejected):
53
+ SCOPED_PATHS="<validated paths or empty>"
54
+ if [ -n "$SCOPED_PATHS" ]; then
55
+ PATH_SCOPE_HINT="--paths $SCOPED_PATHS"
56
+ else
57
+ PATH_SCOPE_HINT=""
58
+ fi
59
+ ```
60
+
61
+ All mapper prompts built later in this workflow MUST include
62
+ `${PATH_SCOPE_HINT}` (expanded to empty when full-repo mode is in effect).
63
+
64
+ When `--paths` is absent, behave exactly as before: full-repo scan, all 7
65
+ documents refreshed.
66
+ </step>
67
+
68
+ <step name="init_context" priority="first">
69
+ Load codebase mapping context:
70
+
71
+ ```bash
72
+ _GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/get-shit-done/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${_GSD_RUNTIME_ROOT}/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${_GSD_RUNTIME_ROOT}/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/gsd-core@latest --claude --local" >&2; exit 1; fi
73
+ INIT=$(gsd_run query init.map-codebase)
74
+ if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
75
+ AGENT_SKILLS_MAPPER=$(gsd_run query agent-skills gsd-codebase-mapper)
76
+ ```
77
+
78
+ Extract from init JSON: `mapper_model`, `commit_docs`, `codebase_dir`, `existing_maps`, `has_maps`, `codebase_dir_exists`, `subagent_timeout`, `date`.
79
+ </step>
80
+
81
+ <step name="check_existing">
82
+ Check if .planning/codebase/ already exists using `has_maps` from init context.
83
+
84
+ If `codebase_dir_exists` is true:
85
+ ```bash
86
+ ls -la .planning/codebase/
87
+ ```
88
+
89
+ **If exists:**
90
+
91
+ ```
92
+ .planning/codebase/ already exists with these documents:
93
+ [List files found]
94
+
95
+ What's next?
96
+ 1. Refresh - Delete existing and remap codebase
97
+ 2. Update - Keep existing, only update specific documents
98
+ 3. Skip - Use existing codebase map as-is
99
+ ```
100
+
101
+ Wait for user response.
102
+
103
+ If "Refresh": Delete .planning/codebase/, continue to create_structure
104
+ If "Update": Ask which documents to update, continue to spawn_agents (filtered)
105
+ If "Skip": Exit workflow
106
+
107
+ **If doesn't exist:**
108
+ Continue to create_structure.
109
+ </step>
110
+
111
+ <step name="create_structure">
112
+ Create .planning/codebase/ directory:
113
+
114
+ ```bash
115
+ mkdir -p .planning/codebase
116
+ ```
117
+
118
+ **Expected output files:**
119
+ - STACK.md (from tech mapper)
120
+ - INTEGRATIONS.md (from tech mapper)
121
+ - ARCHITECTURE.md (from arch mapper)
122
+ - STRUCTURE.md (from arch mapper)
123
+ - CONVENTIONS.md (from quality mapper)
124
+ - TESTING.md (from quality mapper)
125
+ - CONCERNS.md (from concerns mapper)
126
+
127
+ Continue to spawn_agents.
128
+ </step>
129
+
130
+ <step name="detect_runtime_capabilities">
131
+ Before spawning agents, detect whether the current runtime supports the `Agent` tool for subagent delegation.
132
+
133
+ **How to detect:** Check if you have access to an `Agent` tool (may be capitalized as `Agent` or lowercase as `agent` depending on runtime). If you do NOT have an `Agent`/`agent` tool (or only have tools like `browser_subagent` which is for web browsing, NOT code analysis):
134
+
135
+ → **Skip `spawn_agents` and `collect_confirmations`** — go directly to `sequential_mapping` instead.
136
+
137
+ **CRITICAL:** Never use `browser_subagent` or `Explore` as a substitute for `Agent`. The `browser_subagent` tool is exclusively for web page interaction and will fail for codebase analysis. If `Agent` is unavailable, perform the mapping sequentially in-context.
138
+ </step>
139
+
140
+ <step name="spawn_agents" condition="Agent tool is available">
141
+ Spawn 4 parallel gsd-codebase-mapper agents.
142
+
143
+ Use Agent tool with `subagent_type="gsd-codebase-mapper"`, `model="{mapper_model}"`, and `run_in_background=true` for parallel execution.
144
+
145
+ **CRITICAL:** Use the dedicated `gsd-codebase-mapper` agent, NOT `Explore` or `browser_subagent`. The mapper agent writes documents directly.
146
+
147
+ **Agent 1: Tech Focus**
148
+
149
+ ```text
150
+ Agent(
151
+ subagent_type="gsd-codebase-mapper",
152
+ model="{mapper_model}",
153
+ run_in_background=true,
154
+ description="Map codebase tech stack",
155
+ prompt="Focus: tech
156
+ Today's date: {date}
157
+
158
+ Analyze this codebase for technology stack and external integrations.
159
+
160
+ Write these documents to .planning/codebase/:
161
+ - STACK.md - Languages, runtime, frameworks, dependencies, configuration
162
+ - INTEGRATIONS.md - External APIs, databases, auth providers, webhooks
163
+
164
+ IMPORTANT: Use {date} for all [YYYY-MM-DD] date placeholders in documents.
165
+
166
+ Scope: ${PATH_SCOPE_HINT:-(full repo)} — when --paths is supplied, restrict exploration to those prefixes only.
167
+
168
+ Explore thoroughly. Write documents directly using templates. Return confirmation only.
169
+ ${AGENT_SKILLS_MAPPER}"
170
+ )
171
+ ```
172
+
173
+ **Agent 2: Architecture Focus**
174
+
175
+ ```text
176
+ Agent(
177
+ subagent_type="gsd-codebase-mapper",
178
+ model="{mapper_model}",
179
+ run_in_background=true,
180
+ description="Map codebase architecture",
181
+ prompt="Focus: arch
182
+ Today's date: {date}
183
+
184
+ Analyze this codebase architecture and directory structure.
185
+
186
+ Write these documents to .planning/codebase/:
187
+ - ARCHITECTURE.md - Pattern, layers, data flow, abstractions, entry points
188
+ - STRUCTURE.md - Directory layout, key locations, naming conventions
189
+
190
+ IMPORTANT: Use {date} for all [YYYY-MM-DD] date placeholders in documents.
191
+
192
+ Scope: ${PATH_SCOPE_HINT:-(full repo)} — when --paths is supplied, restrict exploration to those prefixes only.
193
+
194
+ Explore thoroughly. Write documents directly using templates. Return confirmation only.
195
+ ${AGENT_SKILLS_MAPPER}"
196
+ )
197
+ ```
198
+
199
+ **Agent 3: Quality Focus**
200
+
201
+ ```text
202
+ Agent(
203
+ subagent_type="gsd-codebase-mapper",
204
+ model="{mapper_model}",
205
+ run_in_background=true,
206
+ description="Map codebase conventions",
207
+ prompt="Focus: quality
208
+ Today's date: {date}
209
+
210
+ Analyze this codebase for coding conventions and testing patterns.
211
+
212
+ Write these documents to .planning/codebase/:
213
+ - CONVENTIONS.md - Code style, naming, patterns, error handling
214
+ - TESTING.md - Framework, structure, mocking, coverage
215
+
216
+ IMPORTANT: Use {date} for all [YYYY-MM-DD] date placeholders in documents.
217
+
218
+ Scope: ${PATH_SCOPE_HINT:-(full repo)} — when --paths is supplied, restrict exploration to those prefixes only.
219
+
220
+ Explore thoroughly. Write documents directly using templates. Return confirmation only.
221
+ ${AGENT_SKILLS_MAPPER}"
222
+ )
223
+ ```
224
+
225
+ **Agent 4: Concerns Focus**
226
+
227
+ ```
228
+ Agent(
229
+ subagent_type="gsd-codebase-mapper",
230
+ model="{mapper_model}",
231
+ run_in_background=true,
232
+ description="Map codebase concerns",
233
+ prompt="Focus: concerns
234
+ Today's date: {date}
235
+
236
+ Analyze this codebase for technical debt, known issues, and areas of concern.
237
+
238
+ Write this document to .planning/codebase/:
239
+ - CONCERNS.md - Tech debt, bugs, security, performance, fragile areas
240
+
241
+ IMPORTANT: Use {date} for all [YYYY-MM-DD] date placeholders in documents.
242
+
243
+ Scope: ${PATH_SCOPE_HINT:-(full repo)} — when --paths is supplied, restrict exploration to those prefixes only.
244
+
245
+ Explore thoroughly. Write document directly using template. Return confirmation only.
246
+ ${AGENT_SKILLS_MAPPER}"
247
+ )
248
+ ```
249
+
250
+ > **ORCHESTRATOR RULE — CODEX RUNTIME**: After calling all 4 Agent() calls above with `run_in_background=true`, do NOT read any source files, analyze the codebase, or write any mapping documents independently while the subagents are active. Wait for all 4 agents to complete before proceeding to collect_confirmations. This prevents duplicate work and wasted context.
251
+
252
+ Continue to collect_confirmations.
253
+ </step>
254
+
255
+ <step name="collect_confirmations">
256
+ Wait for all 4 agents to complete using TaskOutput tool.
257
+
258
+ **For each agent task_id returned by the Agent tool calls above:**
259
+ ```
260
+ TaskOutput tool:
261
+ task_id: "{task_id from Agent result}"
262
+ block: true
263
+ timeout: {subagent_timeout from init context, default 300000}
264
+ ```
265
+
266
+ > The timeout is configurable via `workflow.subagent_timeout` in `.planning/config.json` (milliseconds). Default: 300000 (5 minutes). Increase for large codebases or slower models.
267
+
268
+ Call TaskOutput for all 4 agents in parallel (single message with 4 TaskOutput calls).
269
+
270
+ Once all TaskOutput calls return, read each agent's output file to collect confirmations.
271
+
272
+ **Expected confirmation format from each agent:**
273
+ ```
274
+ ## Mapping Complete
275
+
276
+ **Focus:** {focus}
277
+ **Documents written:**
278
+ - `.planning/codebase/{DOC1}.md` ({N} lines)
279
+ - `.planning/codebase/{DOC2}.md` ({N} lines)
280
+
281
+ Ready for orchestrator summary.
282
+ ```
283
+
284
+ **What you receive:** Just file paths and line counts. NOT document contents.
285
+
286
+ If any agent failed, note the failure and continue with successful documents.
287
+
288
+ Continue to verify_output.
289
+ </step>
290
+
291
+ <step name="sequential_mapping" condition="Agent tool is NOT available (e.g. Antigravity, Gemini CLI, Codex)">
292
+ When the `Agent` tool is unavailable, perform codebase mapping sequentially in the current context. This replaces `spawn_agents` and `collect_confirmations`.
293
+
294
+ **IMPORTANT:** Do NOT use `browser_subagent`, `Explore`, or any browser-based tool. Use only file system tools (Read, Bash, Write, Grep, Glob, list_dir, view_file, grep_search, or equivalent tools available in your runtime).
295
+
296
+ **IMPORTANT:** Use `{date}` from init context for all `[YYYY-MM-DD]` date placeholders in documents. NEVER guess the date.
297
+
298
+ **SCOPE:** When `${PATH_SCOPE_HINT}` is non-empty (i.e. `--paths` was supplied), restrict every pass below to the validated path prefixes in `${SCOPED_PATHS}`. Do NOT scan files outside those prefixes. When `${PATH_SCOPE_HINT}` is empty, perform a full-repo scan.
299
+
300
+ Perform all 4 mapping passes sequentially:
301
+
302
+ **Pass 1: Tech Focus**
303
+ - Explore package.json/Cargo.toml/go.mod/requirements.txt, config files, dependency trees
304
+ - Write `.planning/codebase/STACK.md` — Languages, runtime, frameworks, dependencies, configuration
305
+ - Write `.planning/codebase/INTEGRATIONS.md` — External APIs, databases, auth providers, webhooks
306
+
307
+ **Pass 2: Architecture Focus**
308
+ - Explore directory structure, entry points, module boundaries, data flow
309
+ - Write `.planning/codebase/ARCHITECTURE.md` — Pattern, layers, data flow, abstractions, entry points
310
+ - Write `.planning/codebase/STRUCTURE.md` — Directory layout, key locations, naming conventions
311
+
312
+ **Pass 3: Quality Focus**
313
+ - Explore code style, error handling patterns, test files, CI config
314
+ - Write `.planning/codebase/CONVENTIONS.md` — Code style, naming, patterns, error handling
315
+ - Write `.planning/codebase/TESTING.md` — Framework, structure, mocking, coverage
316
+
317
+ **Pass 4: Concerns Focus**
318
+ - Explore TODOs, known issues, fragile areas, security patterns
319
+ - Write `.planning/codebase/CONCERNS.md` — Tech debt, bugs, security, performance, fragile areas
320
+
321
+ Use the same document templates as the `gsd-codebase-mapper` agent. Include actual file paths formatted with backticks.
322
+
323
+ Continue to verify_output.
324
+ </step>
325
+
326
+ <step name="verify_output">
327
+ Verify all documents created successfully:
328
+
329
+ ```bash
330
+ ls -la .planning/codebase/
331
+ wc -l .planning/codebase/*.md
332
+ ```
333
+
334
+ **Verification checklist:**
335
+ - All 7 documents exist
336
+ - No empty documents (each should have >20 lines)
337
+
338
+ If any documents missing or empty, note which agents may have failed.
339
+
340
+ Continue to scan_for_secrets.
341
+ </step>
342
+
343
+ <step name="scan_for_secrets">
344
+ **CRITICAL SECURITY CHECK:** Scan output files for accidentally leaked secrets before committing.
345
+
346
+ Run secret pattern detection:
347
+
348
+ ```bash
349
+ # Check for common API key patterns in generated docs
350
+ grep -E '(sk-[a-zA-Z0-9]{20,}|sk_live_[a-zA-Z0-9]+|sk_test_[a-zA-Z0-9]+|ghp_[a-zA-Z0-9]{36}|gho_[a-zA-Z0-9]{36}|glpat-[a-zA-Z0-9_-]+|AKIA[A-Z0-9]{16}|xox[baprs]-[a-zA-Z0-9-]+|-----BEGIN.*PRIVATE KEY|eyJ[a-zA-Z0-9_-]+\.eyJ[a-zA-Z0-9_-]+\.)' .planning/codebase/*.md 2>/dev/null && SECRETS_FOUND=true || SECRETS_FOUND=false
351
+ ```
352
+
353
+ **If SECRETS_FOUND=true:**
354
+
355
+ ```
356
+ ⚠️ SECURITY ALERT: Potential secrets detected in codebase documents!
357
+
358
+ Found patterns that look like API keys or tokens in:
359
+ [show grep output]
360
+
361
+ This would expose credentials if committed.
362
+
363
+ **Action required:**
364
+ 1. Review the flagged content above
365
+ 2. If these are real secrets, they must be removed before committing
366
+ 3. Consider adding sensitive files to Claude Code "Deny" permissions
367
+
368
+ Pausing before commit. Reply "safe to proceed" if the flagged content is not actually sensitive, or edit the files first.
369
+ ```
370
+
371
+ Wait for user confirmation before continuing to commit_codebase_map.
372
+
373
+ **If SECRETS_FOUND=false:**
374
+
375
+ Continue to commit_codebase_map.
376
+ </step>
377
+
378
+ <step name="commit_codebase_map">
379
+ Commit the codebase map:
380
+
381
+ ```bash
382
+ gsd_run query commit "docs: map existing codebase" --files .planning/codebase/*.md
383
+ ```
384
+
385
+ Continue to offer_next.
386
+ </step>
387
+
388
+ <step name="offer_next">
389
+ Present completion summary and next steps.
390
+
391
+ **Get line counts:**
392
+ ```bash
393
+ wc -l .planning/codebase/*.md
394
+ ```
395
+
396
+ **Output format:**
397
+
398
+ ```
399
+ Codebase mapping complete.
400
+
401
+ Created .planning/codebase/:
402
+ - STACK.md ([N] lines) - Technologies and dependencies
403
+ - ARCHITECTURE.md ([N] lines) - System design and patterns
404
+ - STRUCTURE.md ([N] lines) - Directory layout and organization
405
+ - CONVENTIONS.md ([N] lines) - Code style and patterns
406
+ - TESTING.md ([N] lines) - Test structure and practices
407
+ - INTEGRATIONS.md ([N] lines) - External services and APIs
408
+ - CONCERNS.md ([N] lines) - Technical debt and issues
409
+
410
+
411
+ ---
412
+
413
+ ## ▶ Next Up — [${PROJECT_CODE}] ${PROJECT_TITLE}
414
+
415
+ **Initialize project** — use codebase context for planning
416
+
417
+ `/clear` then:
418
+
419
+ `/gsd:new-project`
420
+
421
+ ---
422
+
423
+ **Also available:**
424
+ - Re-run mapping: `/gsd:map-codebase`
425
+ - Review specific file: `cat .planning/codebase/STACK.md`
426
+ - Edit any document before proceeding
427
+
428
+ ---
429
+ ```
430
+
431
+ End workflow.
432
+ </step>
433
+
434
+ </process>
435
+
436
+ <success_criteria>
437
+ - .planning/codebase/ directory created
438
+ - If Agent tool available: 4 parallel gsd-codebase-mapper agents spawned with run_in_background=true
439
+ - If Agent tool NOT available: 4 sequential mapping passes performed inline (never using browser_subagent)
440
+ - All 7 codebase documents exist
441
+ - No empty documents (each should have >20 lines)
442
+ - Clear completion summary with line counts
443
+ - User offered clear next steps in GSD style
444
+ </success_criteria>
package/get-shit-done/workflows/milestone-summary.md ADDED
@@ -0,0 +1,224 @@
1
+ # Milestone Summary Workflow
2
+
3
+ Generate a comprehensive, human-friendly project summary from completed milestone artifacts.
4
+ Designed for team onboarding — a new contributor can read the output and understand the entire project.
5
+
6
+ ---
7
+
8
+ ## Step 1: Resolve Version
9
+
10
+ ```bash
11
+ VERSION="$ARGUMENTS"
12
+ ```
13
+
14
+ If `$ARGUMENTS` is empty:
15
+ 1. Check `.planning/STATE.md` for current milestone version
16
+ 2. Check `.planning/milestones/` for the latest archived version
17
+ 3. If neither found, check if `.planning/ROADMAP.md` exists (project may be mid-milestone)
18
+ 4. If nothing found: error "No milestone found. Run /gsd:new-project or /gsd:new-milestone first."
19
+
20
+ Set `VERSION` to the resolved version (e.g., "1.0").
21
+
22
+ ## Step 2: Locate Artifacts
23
+
24
+ Determine whether the milestone is **archived** or **current**:
25
+
26
+ **Archived milestone** (`.planning/milestones/v{VERSION}-ROADMAP.md` exists):
27
+ ```
28
+ ROADMAP_PATH=".planning/milestones/v${VERSION}-ROADMAP.md"
29
+ REQUIREMENTS_PATH=".planning/milestones/v${VERSION}-REQUIREMENTS.md"
30
+ AUDIT_PATH=".planning/milestones/v${VERSION}-MILESTONE-AUDIT.md"
31
+ ```
32
+
33
+ **Current/in-progress milestone** (no archive yet):
34
+ ```
35
+ ROADMAP_PATH=".planning/ROADMAP.md"
36
+ REQUIREMENTS_PATH=".planning/REQUIREMENTS.md"
37
+ AUDIT_PATH=".planning/v${VERSION}-MILESTONE-AUDIT.md"
38
+ ```
39
+
40
+ Note: The audit file moves to `.planning/milestones/` on archive (per `complete-milestone` workflow). Check both locations as a fallback.
41
+
42
+ **Always available:**
43
+ ```
44
+ PROJECT_PATH=".planning/PROJECT.md"
45
+ RETRO_PATH=".planning/RETROSPECTIVE.md"
46
+ STATE_PATH=".planning/STATE.md"
47
+ ```
48
+
49
+ Read all files that exist. Missing files are fine — the summary adapts to what's available.
50
+
51
+ ## Step 3: Discover Phase Artifacts
52
+
53
+ Find all phase directories:
54
+
55
+ ```bash
56
+ _GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/get-shit-done/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${_GSD_RUNTIME_ROOT}/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${_GSD_RUNTIME_ROOT}/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/gsd-core@latest --claude --local" >&2; exit 1; fi
57
+ gsd_run query init.progress
58
+ ```
59
+
60
+ This returns phase metadata. For each phase in the milestone scope:
61
+
62
+ - Read `{phase_dir}/{padded}-SUMMARY.md` if it exists — extract `one_liner`, `accomplishments`, `decisions`
63
+ - Read `{phase_dir}/{padded}-VERIFICATION.md` if it exists — extract status, gaps, deferred items
64
+ - Read `{phase_dir}/{padded}-CONTEXT.md` if it exists — extract key decisions from `<decisions>` section
65
+ - Read `{phase_dir}/{padded}-RESEARCH.md` if it exists — note what was researched
66
+
67
+ Track which phases have which artifacts.
68
+
69
+ **If no phase directories exist** (empty milestone or pre-build state): skip to Step 5 and generate a minimal summary noting "No phases have been executed yet." Do not error — the summary should still capture PROJECT.md and ROADMAP.md content.
70
+
71
+ ## Step 4: Gather Git Statistics
72
+
73
+ Try each method in order until one succeeds:
74
+
75
+ **Method 1 — Tagged milestone** (check first):
76
+ ```bash
77
+ git tag -l "v${VERSION}" | head -1
78
+ ```
79
+ If the tag exists:
80
+ ```bash
81
+ git log v${VERSION} --oneline | wc -l
82
+ git diff --stat $(git log --format=%H --reverse v${VERSION} | head -1)..v${VERSION}
83
+ ```
84
+
85
+ **Method 2 — STATE.md date range** (if no tag):
86
+ Read STATE.md and extract the `started_at` or earliest session date. Use it as the `--since` boundary:
87
+ ```bash
88
+ git log --oneline --since="<started_at_date>" | wc -l
89
+ ```
90
+
91
+ **Method 3 — Earliest phase commit** (if STATE.md has no date):
92
+ Find the earliest `.planning/phases/` commit:
93
+ ```bash
94
+ git log --oneline --diff-filter=A -- ".planning/phases/" | tail -1
95
+ ```
96
+ Use that commit's date as the start boundary.
97
+
98
+ **Method 4 — Skip stats** (if none of the above work):
99
+ Report "Git statistics unavailable — no tag or date range could be determined." This is not an error — the summary continues without the Stats section.
100
+
101
+ Extract (when available):
102
+ - Total commits in milestone
103
+ - Files changed, insertions, deletions
104
+ - Timeline (start date → end date)
105
+ - Contributors (from git log authors)
106
+
107
+ ## Step 5: Generate Summary Document
108
+
109
+ Write to `.planning/reports/MILESTONE_SUMMARY-v${VERSION}.md`:
110
+
111
+ ```markdown
112
+ # Milestone v{VERSION} — Project Summary
113
+
114
+ **Generated:** {date}
115
+ **Purpose:** Team onboarding and project review
116
+
117
+ ---
118
+
119
+ ## 1. Project Overview
120
+
121
+ {From PROJECT.md: "What This Is", core value proposition, target users}
122
+ {If mid-milestone: note which phases are complete vs in-progress}
123
+
124
+ ## 2. Architecture & Technical Decisions
125
+
126
+ {From CONTEXT.md files across phases: key technical choices}
127
+ {From SUMMARY.md decisions: patterns, libraries, frameworks chosen}
128
+ {From PROJECT.md: tech stack if documented}
129
+
130
+ Present as a bulleted list of decisions with brief rationale:
131
+ - **Decision:** {what was chosen}
132
+ - **Why:** {rationale from CONTEXT.md}
133
+ - **Phase:** {which phase made this decision}
134
+
135
+ ## 3. Phases Delivered
136
+
137
+ | Phase | Name | Status | One-Liner |
138
+ |-------|------|--------|-----------|
139
+ {For each phase: number, name, status (complete/in-progress/planned), one_liner from SUMMARY.md}
140
+
141
+ ## 4. Requirements Coverage
142
+
143
+ {From REQUIREMENTS.md: list each requirement with status}
144
+ - ✅ {Requirement met}
145
+ - ⚠️ {Requirement partially met — note gap}
146
+ - ❌ {Requirement not met — note reason}
147
+
148
+ {If MILESTONE-AUDIT.md exists: include audit verdict}
149
+
150
+ ## 5. Key Decisions Log
151
+
152
+ {Aggregate from all CONTEXT.md <decisions> sections}
153
+ {Each decision with: ID, description, phase, rationale}
154
+
155
+ ## 6. Tech Debt & Deferred Items
156
+
157
+ {From VERIFICATION.md files: gaps found, anti-patterns noted}
158
+ {From RETROSPECTIVE.md: lessons learned, what to improve}
159
+ {From CONTEXT.md <deferred> sections: ideas parked for later}
160
+
161
+ ## 7. Getting Started
162
+
163
+ {Entry points for new contributors:}
164
+ - **Run the project:** {from PROJECT.md or SUMMARY.md}
165
+ - **Key directories:** {from codebase structure}
166
+ - **Tests:** {test command from PROJECT.md or CLAUDE.md}
167
+ - **Where to look first:** {main entry points, core modules}
168
+
169
+ ---
170
+
171
+ ## Stats
172
+
173
+ - **Timeline:** {start} → {end} ({duration})
174
+ - **Phases:** {count complete} / {count total}
175
+ - **Commits:** {count}
176
+ - **Files changed:** {count} (+{insertions} / -{deletions})
177
+ - **Contributors:** {list}
178
+ ```
179
+
180
+ ## Step 6: Write and Commit
181
+
182
+ **Overwrite guard:** If `.planning/reports/MILESTONE_SUMMARY-v${VERSION}.md` already exists, ask the user:
183
+ > "A milestone summary for v{VERSION} already exists. Overwrite it, or view the existing one?"
184
+ If "view": display existing file and skip to Step 8 (interactive mode). If "overwrite": proceed.
185
+
186
+ Create the reports directory if needed:
187
+ ```bash
188
+ mkdir -p .planning/reports
189
+ ```
190
+
191
+ Write the summary, then commit:
192
+ ```bash
193
+ gsd_run query commit "docs(v${VERSION}): generate milestone summary for onboarding" --files \
194
+ ".planning/reports/MILESTONE_SUMMARY-v${VERSION}.md"
195
+ ```
196
+
197
+ ## Step 7: Present Summary
198
+
199
+ Display the full summary document inline.
200
+
201
+ ## Step 8: Offer Interactive Mode
202
+
203
+ After presenting the summary:
204
+
205
+ > "Summary written to `.planning/reports/MILESTONE_SUMMARY-v{VERSION}.md`.
206
+ >
207
+ > I have full context from the build artifacts. Want to ask anything about the project?
208
+ > Architecture decisions, specific phases, requirements, tech debt — ask away."
209
+
210
+ If the user asks questions:
211
+ - Answer from the artifacts already loaded (CONTEXT.md, SUMMARY.md, VERIFICATION.md, etc.)
212
+ - Reference specific files and decisions
213
+ - Stay grounded in what was actually built (not speculation)
214
+
215
+ If the user is done:
216
+ - Suggest next steps: `/gsd:new-milestone`, `/gsd:progress`, or sharing the summary with the team
217
+
218
+ ## Step 9: Update STATE.md
219
+
220
+ ```bash
221
+ gsd_run query state.record-session "" \
222
+ "Milestone v${VERSION} summary generated" \
223
+ ".planning/reports/MILESTONE_SUMMARY-v${VERSION}.md"
224
+ ```