gsd-opencode 1.22.1 → 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 (156) hide show
  1. package/agents/gsd-advisor-researcher.md +112 -0
  2. package/agents/gsd-assumptions-analyzer.md +110 -0
  3. package/agents/gsd-codebase-mapper.md +0 -2
  4. package/agents/gsd-debugger.md +118 -2
  5. package/agents/gsd-executor.md +24 -4
  6. package/agents/gsd-integration-checker.md +0 -2
  7. package/agents/gsd-nyquist-auditor.md +0 -2
  8. package/agents/gsd-phase-researcher.md +150 -5
  9. package/agents/gsd-plan-checker.md +70 -5
  10. package/agents/gsd-planner.md +49 -4
  11. package/agents/gsd-project-researcher.md +28 -3
  12. package/agents/gsd-research-synthesizer.md +0 -2
  13. package/agents/gsd-roadmapper.md +29 -2
  14. package/agents/gsd-ui-auditor.md +445 -0
  15. package/agents/gsd-ui-checker.md +305 -0
  16. package/agents/gsd-ui-researcher.md +368 -0
  17. package/agents/gsd-user-profiler.md +173 -0
  18. package/agents/gsd-verifier.md +123 -4
  19. package/commands/gsd/gsd-add-backlog.md +76 -0
  20. package/commands/gsd/gsd-audit-uat.md +24 -0
  21. package/commands/gsd/gsd-autonomous.md +41 -0
  22. package/commands/gsd/gsd-debug.md +5 -0
  23. package/commands/gsd/gsd-discuss-phase.md +10 -36
  24. package/commands/gsd/gsd-do.md +30 -0
  25. package/commands/gsd/gsd-execute-phase.md +20 -2
  26. package/commands/gsd/gsd-fast.md +30 -0
  27. package/commands/gsd/gsd-forensics.md +56 -0
  28. package/commands/gsd/gsd-list-workspaces.md +19 -0
  29. package/commands/gsd/gsd-manager.md +39 -0
  30. package/commands/gsd/gsd-milestone-summary.md +51 -0
  31. package/commands/gsd/gsd-new-workspace.md +44 -0
  32. package/commands/gsd/gsd-next.md +24 -0
  33. package/commands/gsd/gsd-note.md +34 -0
  34. package/commands/gsd/gsd-plan-phase.md +3 -1
  35. package/commands/gsd/gsd-plant-seed.md +28 -0
  36. package/commands/gsd/gsd-pr-branch.md +25 -0
  37. package/commands/gsd/gsd-profile-user.md +46 -0
  38. package/commands/gsd/gsd-quick.md +4 -2
  39. package/commands/gsd/gsd-reapply-patches.md +9 -8
  40. package/commands/gsd/gsd-remove-workspace.md +26 -0
  41. package/commands/gsd/gsd-research-phase.md +5 -0
  42. package/commands/gsd/gsd-review-backlog.md +61 -0
  43. package/commands/gsd/gsd-review.md +37 -0
  44. package/commands/gsd/gsd-session-report.md +19 -0
  45. package/commands/gsd/gsd-set-profile.md +24 -23
  46. package/commands/gsd/gsd-ship.md +23 -0
  47. package/commands/gsd/gsd-stats.md +18 -0
  48. package/commands/gsd/gsd-thread.md +127 -0
  49. package/commands/gsd/gsd-ui-phase.md +34 -0
  50. package/commands/gsd/gsd-ui-review.md +32 -0
  51. package/commands/gsd/gsd-workstreams.md +66 -0
  52. package/get-shit-done/bin/gsd-tools.cjs +410 -84
  53. package/get-shit-done/bin/lib/commands.cjs +429 -18
  54. package/get-shit-done/bin/lib/config.cjs +318 -45
  55. package/get-shit-done/bin/lib/core.cjs +822 -84
  56. package/get-shit-done/bin/lib/frontmatter.cjs +78 -41
  57. package/get-shit-done/bin/lib/init.cjs +836 -104
  58. package/get-shit-done/bin/lib/milestone.cjs +44 -33
  59. package/get-shit-done/bin/lib/model-profiles.cjs +68 -0
  60. package/get-shit-done/bin/lib/phase.cjs +293 -306
  61. package/get-shit-done/bin/lib/profile-output.cjs +952 -0
  62. package/get-shit-done/bin/lib/profile-pipeline.cjs +539 -0
  63. package/get-shit-done/bin/lib/roadmap.cjs +55 -24
  64. package/get-shit-done/bin/lib/security.cjs +382 -0
  65. package/get-shit-done/bin/lib/state.cjs +363 -53
  66. package/get-shit-done/bin/lib/template.cjs +2 -2
  67. package/get-shit-done/bin/lib/uat.cjs +282 -0
  68. package/get-shit-done/bin/lib/verify.cjs +104 -36
  69. package/get-shit-done/bin/lib/workstream.cjs +491 -0
  70. package/get-shit-done/references/checkpoints.md +12 -10
  71. package/get-shit-done/references/decimal-phase-calculation.md +2 -3
  72. package/get-shit-done/references/git-integration.md +47 -0
  73. package/get-shit-done/references/model-profile-resolution.md +2 -0
  74. package/get-shit-done/references/model-profiles.md +62 -16
  75. package/get-shit-done/references/phase-argument-parsing.md +2 -2
  76. package/get-shit-done/references/planning-config.md +3 -1
  77. package/get-shit-done/references/user-profiling.md +681 -0
  78. package/get-shit-done/references/workstream-flag.md +58 -0
  79. package/get-shit-done/templates/UAT.md +21 -3
  80. package/get-shit-done/templates/UI-SPEC.md +100 -0
  81. package/get-shit-done/templates/claude-md.md +122 -0
  82. package/get-shit-done/templates/config.json +10 -3
  83. package/get-shit-done/templates/context.md +61 -6
  84. package/get-shit-done/templates/dev-preferences.md +21 -0
  85. package/get-shit-done/templates/discussion-log.md +63 -0
  86. package/get-shit-done/templates/phase-prompt.md +46 -5
  87. package/get-shit-done/templates/project.md +2 -0
  88. package/get-shit-done/templates/state.md +2 -2
  89. package/get-shit-done/templates/user-profile.md +146 -0
  90. package/get-shit-done/workflows/add-phase.md +2 -2
  91. package/get-shit-done/workflows/add-tests.md +4 -4
  92. package/get-shit-done/workflows/add-todo.md +3 -3
  93. package/get-shit-done/workflows/audit-milestone.md +13 -5
  94. package/get-shit-done/workflows/audit-uat.md +109 -0
  95. package/get-shit-done/workflows/autonomous.md +891 -0
  96. package/get-shit-done/workflows/check-todos.md +2 -2
  97. package/get-shit-done/workflows/cleanup.md +4 -4
  98. package/get-shit-done/workflows/complete-milestone.md +9 -6
  99. package/get-shit-done/workflows/diagnose-issues.md +15 -3
  100. package/get-shit-done/workflows/discovery-phase.md +3 -3
  101. package/get-shit-done/workflows/discuss-phase-assumptions.md +653 -0
  102. package/get-shit-done/workflows/discuss-phase.md +411 -38
  103. package/get-shit-done/workflows/do.md +104 -0
  104. package/get-shit-done/workflows/execute-phase.md +405 -18
  105. package/get-shit-done/workflows/execute-plan.md +77 -12
  106. package/get-shit-done/workflows/fast.md +105 -0
  107. package/get-shit-done/workflows/forensics.md +265 -0
  108. package/get-shit-done/workflows/health.md +28 -6
  109. package/get-shit-done/workflows/help.md +124 -7
  110. package/get-shit-done/workflows/insert-phase.md +2 -2
  111. package/get-shit-done/workflows/list-phase-assumptions.md +2 -2
  112. package/get-shit-done/workflows/list-workspaces.md +56 -0
  113. package/get-shit-done/workflows/manager.md +362 -0
  114. package/get-shit-done/workflows/map-codebase.md +74 -13
  115. package/get-shit-done/workflows/milestone-summary.md +223 -0
  116. package/get-shit-done/workflows/new-milestone.md +120 -18
  117. package/get-shit-done/workflows/new-project.md +178 -39
  118. package/get-shit-done/workflows/new-workspace.md +237 -0
  119. package/get-shit-done/workflows/next.md +97 -0
  120. package/get-shit-done/workflows/node-repair.md +92 -0
  121. package/get-shit-done/workflows/note.md +156 -0
  122. package/get-shit-done/workflows/pause-work.md +62 -8
  123. package/get-shit-done/workflows/plan-milestone-gaps.md +4 -5
  124. package/get-shit-done/workflows/plan-phase.md +332 -33
  125. package/get-shit-done/workflows/plant-seed.md +169 -0
  126. package/get-shit-done/workflows/pr-branch.md +129 -0
  127. package/get-shit-done/workflows/profile-user.md +450 -0
  128. package/get-shit-done/workflows/progress.md +145 -20
  129. package/get-shit-done/workflows/quick.md +205 -49
  130. package/get-shit-done/workflows/remove-phase.md +2 -2
  131. package/get-shit-done/workflows/remove-workspace.md +90 -0
  132. package/get-shit-done/workflows/research-phase.md +11 -3
  133. package/get-shit-done/workflows/resume-project.md +35 -16
  134. package/get-shit-done/workflows/review.md +228 -0
  135. package/get-shit-done/workflows/session-report.md +146 -0
  136. package/get-shit-done/workflows/set-profile.md +2 -2
  137. package/get-shit-done/workflows/settings.md +79 -10
  138. package/get-shit-done/workflows/ship.md +228 -0
  139. package/get-shit-done/workflows/stats.md +60 -0
  140. package/get-shit-done/workflows/transition.md +147 -20
  141. package/get-shit-done/workflows/ui-phase.md +302 -0
  142. package/get-shit-done/workflows/ui-review.md +165 -0
  143. package/get-shit-done/workflows/update.md +108 -25
  144. package/get-shit-done/workflows/validate-phase.md +15 -8
  145. package/get-shit-done/workflows/verify-phase.md +16 -5
  146. package/get-shit-done/workflows/verify-work.md +72 -18
  147. package/package.json +1 -1
  148. package/skills/gsd-audit-milestone/SKILL.md +29 -0
  149. package/skills/gsd-cleanup/SKILL.md +19 -0
  150. package/skills/gsd-complete-milestone/SKILL.md +131 -0
  151. package/skills/gsd-discuss-phase/SKILL.md +54 -0
  152. package/skills/gsd-execute-phase/SKILL.md +49 -0
  153. package/skills/gsd-plan-phase/SKILL.md +37 -0
  154. package/skills/gsd-ui-phase/SKILL.md +24 -0
  155. package/skills/gsd-ui-review/SKILL.md +24 -0
  156. package/skills/gsd-verify-work/SKILL.md +30 -0
@@ -6,9 +6,9 @@ Use this workflow when:
6
6
  - User returns after time away from project
7
7
  </trigger>
8
8
 
9
- <purpose>
9
+ <objective>
10
10
  Instantly restore full project context so "Where were we?" has an immediate, complete answer.
11
- </purpose>
11
+ </objective>
12
12
 
13
13
  <required_reading>
14
14
  @$HOME/.config/opencode/get-shit-done/references/continuation-format.md
@@ -63,14 +63,18 @@ cat .planning/PROJECT.md
63
63
  Look for incomplete work that needs attention:
64
64
 
65
65
  ```bash
66
+ # Check for structured handoff (preferred — machine-readable)
67
+ cat .planning/HANDOFF.json 2>/dev/null || true
68
+
66
69
  # Check for continue-here files (mid-plan resumption)
67
- ls .planning/phases/*/.continue-here*.md 2>/dev/null
70
+ ls .planning/phases/*/.continue-here*.md 2>/dev/null || true
68
71
 
69
72
  # Check for plans without summaries (incomplete execution)
70
73
  for plan in .planning/phases/*/*-PLAN.md; do
74
+ [ -e "$plan" ] || continue
71
75
  summary="${plan/PLAN/SUMMARY}"
72
76
  [ ! -f "$summary" ] && echo "Incomplete: $plan"
73
- done 2>/dev/null
77
+ done 2>/dev/null || true
74
78
 
75
79
  # Check for interrupted agents (use has_interrupted_agent and interrupted_agent_id from init)
76
80
  if [ "$has_interrupted_agent" = "true" ]; then
@@ -78,7 +82,18 @@ if [ "$has_interrupted_agent" = "true" ]; then
78
82
  fi
79
83
  ```
80
84
 
81
- **If .continue-here file exists:**
85
+ **If HANDOFF.json exists:**
86
+
87
+ - This is the primary resumption source — structured data from `/gsd-pause-work`
88
+ - Parse `status`, `phase`, `plan`, `task`, `total_tasks`, `next_action`
89
+ - Check `blockers` and `human_actions_pending` — surface these immediately
90
+ - Check `completed_tasks` for `in_progress` items — these need attention first
91
+ - Validate `uncommitted_files` against `git status` — flag divergence
92
+ - Use `context_notes` to restore mental model
93
+ - Flag: "Found structured handoff — resuming from task {task}/{total_tasks}"
94
+ - **After successful resumption, delete HANDOFF.json** (it's a one-shot artifact)
95
+
96
+ **If .continue-here file exists (fallback):**
82
97
 
83
98
  - This is a mid-plan resumption point
84
99
  - read the file for specific resumption context
@@ -145,8 +160,12 @@ Based on project state, determine the most logical next action:
145
160
  → Primary: Resume interrupted agent (task tool with resume parameter)
146
161
  → Option: Start fresh (abandon agent work)
147
162
 
163
+ **If HANDOFF.json exists:**
164
+ → Primary: Resume from structured handoff (highest priority — specific task/blocker context)
165
+ → Option: Discard handoff and reassess from files
166
+
148
167
  **If .continue-here file exists:**
149
- Primary: Resume from checkpoint
168
+ Fallback: Resume from checkpoint
150
169
  → Option: Start fresh on current plan
151
170
 
152
171
  **If incomplete plan (PLAN without SUMMARY):**
@@ -154,7 +173,7 @@ Based on project state, determine the most logical next action:
154
173
  → Option: Abandon and move on
155
174
 
156
175
  **If phase in progress, all plans complete:**
157
- → Primary: Transition to next phase
176
+ → Primary: Advance to next phase (via internal transition workflow)
158
177
  → Option: Review completed work
159
178
 
160
179
  **If phase ready to plan:**
@@ -181,11 +200,11 @@ What would you like to do?
181
200
  [Primary action based on state - e.g.:]
182
201
  1. Resume interrupted agent [if interrupted agent found]
183
202
  OR
184
- 1. Execute phase (/gsd-execute-phase {phase})
203
+ 1. Execute phase (/gsd-execute-phase {phase} ${GSD_WS})
185
204
  OR
186
- 1. Discuss Phase 3 context (/gsd-discuss-phase 3) [if CONTEXT.md missing]
205
+ 1. Discuss Phase 3 context (/gsd-discuss-phase 3 ${GSD_WS}) [if CONTEXT.md missing]
187
206
  OR
188
- 1. Plan Phase 3 (/gsd-plan-phase 3) [if CONTEXT.md exists or discuss option declined]
207
+ 1. Plan Phase 3 (/gsd-plan-phase 3 ${GSD_WS}) [if CONTEXT.md exists or discuss option declined]
189
208
 
190
209
  [Secondary options:]
191
210
  2. Review current phase status
@@ -197,7 +216,7 @@ What would you like to do?
197
216
  **Note:** When offering phase planning, check for CONTEXT.md existence first:
198
217
 
199
218
  ```bash
200
- ls .planning/phases/XX-name/*-CONTEXT.md 2>/dev/null
219
+ ls .planning/phases/XX-name/*-CONTEXT.md 2>/dev/null || true
201
220
  ```
202
221
 
203
222
  If missing, suggest discuss-phase before plan. If exists, offer plan directly.
@@ -216,7 +235,7 @@ Based on user selection, route to appropriate workflow:
216
235
 
217
236
  **{phase}-{plan}: [Plan Name]** — [objective from PLAN.md]
218
237
 
219
- `/gsd-execute-phase {phase}`
238
+ `/gsd-execute-phase {phase} ${GSD_WS}`
220
239
 
221
240
  *`/new` first → fresh context window*
222
241
 
@@ -230,19 +249,19 @@ Based on user selection, route to appropriate workflow:
230
249
 
231
250
  **Phase [N]: [Name]** — [Goal from ROADMAP.md]
232
251
 
233
- `/gsd-plan-phase [phase-number]`
252
+ `/gsd-plan-phase [phase-number] ${GSD_WS}`
234
253
 
235
254
  *`/new` first → fresh context window*
236
255
 
237
256
  ---
238
257
 
239
258
  **Also available:**
240
- - `/gsd-discuss-phase [N]` — gather context first
241
- - `/gsd-research-phase [N]` — investigate unknowns
259
+ - `/gsd-discuss-phase [N] ${GSD_WS}` — gather context first
260
+ - `/gsd-research-phase [N] ${GSD_WS}` — investigate unknowns
242
261
 
243
262
  ---
244
263
  ```
245
- - **Transition** → ./transition.md
264
+ - **Advance to next phase** → ./transition.md (internal workflow, invoked inline — NOT a user command)
246
265
  - **Check todos** → read .planning/todos/pending/, present summary
247
266
  - **Review alignment** → read PROJECT.md, compare to current state
248
267
  - **Something else** → Ask what they need
@@ -0,0 +1,228 @@
1
+ <objective>
2
+ Cross-AI peer review — invoke external AI CLIs to independently review phase plans.
3
+ Each CLI gets the same prompt (PROJECT.md context, phase plans, requirements) and
4
+ produces structured feedback. Results are combined into REVIEWS.md for the planner
5
+ to incorporate via --reviews flag.
6
+
7
+ This implements adversarial review: different AI models catch different blind spots.
8
+ A plan that survives review from 2-3 independent AI systems is more robust.
9
+ </objective>
10
+
11
+ <process>
12
+
13
+ <step name="detect_clis">
14
+ Check which AI CLIs are available on the system:
15
+
16
+ ```bash
17
+ # Check each CLI
18
+ command -v gemini >/dev/null 2>&1 && echo "gemini:available" || echo "gemini:missing"
19
+ command -v OpenCode >/dev/null 2>&1 && echo "OpenCode:available" || echo "OpenCode:missing"
20
+ command -v codex >/dev/null 2>&1 && echo "codex:available" || echo "codex:missing"
21
+ ```
22
+
23
+ Parse flags from `$ARGUMENTS`:
24
+ - `--gemini` → include Gemini
25
+ - `--OpenCode` → include OpenCode
26
+ - `--codex` → include Codex
27
+ - `--all` → include all available
28
+ - No flags → include all available
29
+
30
+ If no CLIs are available:
31
+ ```
32
+ No external AI CLIs found. Install at least one:
33
+ - gemini: https://github.com/google-gemini/gemini-cli
34
+ - codex: https://github.com/openai/codex
35
+ - OpenCode: https://github.com/anthropics/OpenCode-code
36
+
37
+ Then run /gsd-review again.
38
+ ```
39
+ Exit.
40
+
41
+ If only one CLI is the current runtime (e.g. running inside OpenCode), skip it for the review
42
+ to ensure independence. At least one DIFFERENT CLI must be available.
43
+ </step>
44
+
45
+ <step name="gather_context">
46
+ Collect phase artifacts for the review prompt:
47
+
48
+ ```bash
49
+ INIT=$(node "$HOME/.config/opencode/get-shit-done/bin/gsd-tools.cjs" init phase-op "${PHASE_ARG}")
50
+ if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
51
+ ```
52
+
53
+ read from init: `phase_dir`, `phase_number`, `padded_phase`.
54
+
55
+ Then read:
56
+ 1. `.planning/PROJECT.md` (first 80 lines — project context)
57
+ 2. Phase section from `.planning/ROADMAP.md`
58
+ 3. All `*-PLAN.md` files in the phase directory
59
+ 4. `*-CONTEXT.md` if present (user decisions)
60
+ 5. `*-RESEARCH.md` if present (domain research)
61
+ 6. `.planning/REQUIREMENTS.md` (requirements this phase addresses)
62
+ </step>
63
+
64
+ <step name="build_prompt">
65
+ Build a structured review prompt:
66
+
67
+ ```markdown
68
+ # Cross-AI Plan Review Request
69
+
70
+ You are reviewing implementation plans for a software project phase.
71
+ Provide structured feedback on plan quality, completeness, and risks.
72
+
73
+ ## Project Context
74
+ {first 80 lines of PROJECT.md}
75
+
76
+ ## Phase {N}: {phase name}
77
+ ### Roadmap Section
78
+ {roadmap phase section}
79
+
80
+ ### Requirements Addressed
81
+ {requirements for this phase}
82
+
83
+ ### User Decisions (CONTEXT.md)
84
+ {context if present}
85
+
86
+ ### Research Findings
87
+ {research if present}
88
+
89
+ ### Plans to Review
90
+ {all PLAN.md contents}
91
+
92
+ ## Review Instructions
93
+
94
+ Analyze each plan and provide:
95
+
96
+ 1. **Summary** — One-paragraph assessment
97
+ 2. **Strengths** — What's well-designed (bullet points)
98
+ 3. **Concerns** — Potential issues, gaps, risks (bullet points with severity: HIGH/MEDIUM/LOW)
99
+ 4. **Suggestions** — Specific improvements (bullet points)
100
+ 5. **Risk Assessment** — Overall risk level (LOW/MEDIUM/HIGH) with justification
101
+
102
+ Focus on:
103
+ - Missing edge cases or error handling
104
+ - Dependency ordering issues
105
+ - Scope creep or over-engineering
106
+ - Security considerations
107
+ - Performance implications
108
+ - Whether the plans actually achieve the phase goals
109
+
110
+ Output your review in markdown format.
111
+ ```
112
+
113
+ write to a temp file: `/tmp/gsd-review-prompt-{phase}.md`
114
+ </step>
115
+
116
+ <step name="invoke_reviewers">
117
+ For each selected CLI, invoke in sequence (not parallel — avoid rate limits):
118
+
119
+ **Gemini:**
120
+ ```bash
121
+ gemini -p "$(cat /tmp/gsd-review-prompt-{phase}.md)" 2>/dev/null > /tmp/gsd-review-gemini-{phase}.md
122
+ ```
123
+
124
+ **OpenCode (separate session):**
125
+ ```bash
126
+ OpenCode -p "$(cat /tmp/gsd-review-prompt-{phase}.md)" --no-input 2>/dev/null > /tmp/gsd-review-OpenCode-{phase}.md
127
+ ```
128
+
129
+ **Codex:**
130
+ ```bash
131
+ codex exec --skip-git-repo-check "$(cat /tmp/gsd-review-prompt-{phase}.md)" 2>/dev/null > /tmp/gsd-review-codex-{phase}.md
132
+ ```
133
+
134
+ If a CLI fails, log the error and continue with remaining CLIs.
135
+
136
+ Display progress:
137
+ ```
138
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
139
+ GSD ► CROSS-AI REVIEW — Phase {N}
140
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
141
+
142
+ ◆ Reviewing with {CLI}... done ✓
143
+ ◆ Reviewing with {CLI}... done ✓
144
+ ```
145
+ </step>
146
+
147
+ <step name="write_reviews">
148
+ Combine all review responses into `{phase_dir}/{padded_phase}-REVIEWS.md`:
149
+
150
+ ```markdown
151
+ ---
152
+ phase: {N}
153
+ reviewers: [gemini, OpenCode, codex]
154
+ reviewed_at: {ISO timestamp}
155
+ plans_reviewed: [{list of PLAN.md files}]
156
+ ---
157
+
158
+ # Cross-AI Plan Review — Phase {N}
159
+
160
+ ## Gemini Review
161
+
162
+ {gemini review content}
163
+
164
+ ---
165
+
166
+ ## OpenCode Review
167
+
168
+ {OpenCode review content}
169
+
170
+ ---
171
+
172
+ ## Codex Review
173
+
174
+ {codex review content}
175
+
176
+ ---
177
+
178
+ ## Consensus Summary
179
+
180
+ {synthesize common concerns across all reviewers}
181
+
182
+ ### Agreed Strengths
183
+ {strengths mentioned by 2+ reviewers}
184
+
185
+ ### Agreed Concerns
186
+ {concerns raised by 2+ reviewers — highest priority}
187
+
188
+ ### Divergent Views
189
+ {where reviewers disagreed — worth investigating}
190
+ ```
191
+
192
+ Commit:
193
+ ```bash
194
+ node "$HOME/.config/opencode/get-shit-done/bin/gsd-tools.cjs" commit "docs: cross-AI review for phase {N}" --files {phase_dir}/{padded_phase}-REVIEWS.md
195
+ ```
196
+ </step>
197
+
198
+ <step name="present_results">
199
+ Display summary:
200
+
201
+ ```
202
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
203
+ GSD ► REVIEW COMPLETE
204
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
205
+
206
+ Phase {N} reviewed by {count} AI systems.
207
+
208
+ Consensus concerns:
209
+ {top 3 shared concerns}
210
+
211
+ Full review: {padded_phase}-REVIEWS.md
212
+
213
+ To incorporate feedback into planning:
214
+ /gsd-plan-phase {N} --reviews
215
+ ```
216
+
217
+ Clean up temp files.
218
+ </step>
219
+
220
+ </process>
221
+
222
+ <success_criteria>
223
+ - [ ] At least one external CLI invoked successfully
224
+ - [ ] REVIEWS.md written with structured feedback
225
+ - [ ] Consensus summary synthesized from multiple reviewers
226
+ - [ ] Temp files cleaned up
227
+ - [ ] User knows how to use feedback (/gsd-plan-phase --reviews)
228
+ </success_criteria>
@@ -0,0 +1,146 @@
1
+ <objective>
2
+ Generate a post-session summary document capturing work performed, outcomes achieved, and estimated resource usage. Writes SESSION_REPORT.md to .planning/reports/ for human review and stakeholder sharing.
3
+ </objective>
4
+
5
+ <required_reading>
6
+ read all files referenced by the invoking prompt's execution_context before starting.
7
+ </required_reading>
8
+
9
+ <process>
10
+
11
+ <step name="gather_session_data">
12
+ Collect session data from available sources:
13
+
14
+ 1. **STATE.md** — current phase, milestone, progress, blockers, decisions
15
+ 2. **Git log** — commits made during this session (last 24h or since last report)
16
+ 3. **Plan/Summary files** — plans executed, summaries written
17
+ 4. **ROADMAP.md** — milestone context and phase goals
18
+
19
+ ```bash
20
+ # Get recent commits (last 24 hours)
21
+ git log --oneline --since="24 hours ago" --no-merges 2>/dev/null || echo "No recent commits"
22
+
23
+ # Count files changed
24
+ git diff --stat HEAD~10 HEAD 2>/dev/null | tail -1 || echo "No diff available"
25
+ ```
26
+
27
+ read `.planning/STATE.md` to get:
28
+ - Current milestone and phase
29
+ - Progress percentage
30
+ - Active blockers
31
+ - Recent decisions
32
+
33
+ read `.planning/ROADMAP.md` to get milestone name and goals.
34
+
35
+ Check for existing reports:
36
+ ```bash
37
+ ls -la .planning/reports/SESSION_REPORT*.md 2>/dev/null || echo "No previous reports"
38
+ ```
39
+ </step>
40
+
41
+ <step name="estimate_usage">
42
+ Estimate token usage from observable signals:
43
+
44
+ - Count of tool calls is not directly available, so estimate from git activity and file operations
45
+ - Note: This is an **estimate** — exact token counts require API-level instrumentation not available to hooks
46
+
47
+ Estimation heuristics:
48
+ - Each commit ≈ 1 plan cycle (research + plan + execute + verify)
49
+ - Each plan file ≈ 2,000-5,000 tokens of agent context
50
+ - Each summary file ≈ 1,000-2,000 tokens generated
51
+ - Subagent spawns multiply by ~1.5x per agent type used
52
+ </step>
53
+
54
+ <step name="generate_report">
55
+ Create the report directory and file:
56
+
57
+ ```bash
58
+ mkdir -p .planning/reports
59
+ ```
60
+
61
+ write `.planning/reports/SESSION_REPORT.md` (or `.planning/reports/YYYYMMDD-session-report.md` if previous reports exist):
62
+
63
+ ```markdown
64
+ # GSD Session Report
65
+
66
+ **Generated:** [timestamp]
67
+ **Project:** [from PROJECT.md title or directory name]
68
+ **Milestone:** [N] — [milestone name from ROADMAP.md]
69
+
70
+ ---
71
+
72
+ ## Session Summary
73
+
74
+ **Duration:** [estimated from first to last commit timestamp, or "Single session"]
75
+ **Phase Progress:** [from STATE.md]
76
+ **Plans Executed:** [count of summaries written this session]
77
+ **Commits Made:** [count from git log]
78
+
79
+ ## Work Performed
80
+
81
+ ### Phases Touched
82
+ [List phases worked on with brief description of what was done]
83
+
84
+ ### Key Outcomes
85
+ [Bullet list of concrete deliverables: files created, features implemented, bugs fixed]
86
+
87
+ ### Decisions Made
88
+ [From STATE.md decisions table, if any were added this session]
89
+
90
+ ## Files Changed
91
+
92
+ [Summary of files modified, created, deleted — from git diff stat]
93
+
94
+ ## Blockers & Open Items
95
+
96
+ [Active blockers from STATE.md]
97
+ [Any TODO items created during session]
98
+
99
+ ## Estimated Resource Usage
100
+
101
+ | Metric | Estimate |
102
+ |--------|----------|
103
+ | Commits | [N] |
104
+ | Files changed | [N] |
105
+ | Plans executed | [N] |
106
+ | Subagents spawned | [estimated] |
107
+
108
+ > **Note:** Token and cost estimates require API-level instrumentation.
109
+ > These metrics reflect observable session activity only.
110
+
111
+ ---
112
+
113
+ *Generated by `/gsd-session-report`*
114
+ ```
115
+ </step>
116
+
117
+ <step name="display_result">
118
+ Show the user:
119
+
120
+ ```
121
+ ## Session Report Generated
122
+
123
+ 📄 `.planning/reports/[filename].md`
124
+
125
+ ### Highlights
126
+ - **Commits:** [N]
127
+ - **Files changed:** [N]
128
+ - **Phase progress:** [X]%
129
+ - **Plans executed:** [N]
130
+ ```
131
+
132
+ If this is the first report, mention:
133
+ ```
134
+ 💡 Run `/gsd-session-report` at the end of each session to build a history of project activity.
135
+ ```
136
+ </step>
137
+
138
+ </process>
139
+
140
+ <success_criteria>
141
+ - [ ] Session data gathered from STATE.md, git log, and plan files
142
+ - [ ] Report written to .planning/reports/
143
+ - [ ] Report includes work summary, outcomes, and file changes
144
+ - [ ] Filename includes date to prevent overwrites
145
+ - [ ] Result summary displayed to user
146
+ </success_criteria>
@@ -1,6 +1,6 @@
1
- <purpose>
1
+ <objective>
2
2
  Switch the model profile used by GSD agents. Controls which OpenCode model each agent uses, balancing quality vs token spend.
3
- </purpose>
3
+ </objective>
4
4
 
5
5
  <required_reading>
6
6
  read all files referenced by the invoking prompt's execution_context before starting.
@@ -1,6 +1,6 @@
1
- <purpose>
1
+ <objective>
2
2
  Interactive configuration of GSD workflow agents (research, plan_check, verifier) and model profile selection via multi-question prompt. Updates .planning/config.json with user preferences. Optionally saves settings as global defaults (~/.gsd/defaults.json) for future projects.
3
- </purpose>
3
+ </objective>
4
4
 
5
5
  <required_reading>
6
6
  read all files referenced by the invoking prompt's execution_context before starting.
@@ -30,6 +30,8 @@ Parse current values (default to `true` if not present):
30
30
  - `workflow.plan_check` — spawn plan checker during plan-phase
31
31
  - `workflow.verifier` — spawn verifier during execute-phase
32
32
  - `workflow.nyquist_validation` — validation architecture research during plan-phase (default: true if absent)
33
+ - `workflow.ui_phase` — generate UI-SPEC.md design contracts for frontend phases (default: true if absent)
34
+ - `workflow.ui_safety_gate` — prompt to run /gsd-ui-phase before planning frontend phases (default: true if absent)
33
35
  - `model_profile` — which model each agent uses (default: `simple`)
34
36
  - `git.branching_strategy` — branching approach (default: `"none"`)
35
37
  </step>
@@ -45,8 +47,9 @@ question([
45
47
  multiSelect: false,
46
48
  options: [
47
49
  { label: "Simple", description: "One model for all agents (not flexible)" },
48
- { label: "Smart (Recommended)", description: "Two models: one for reseach and planing, other for execution and verification" },
49
- { label: "Genius (most flexible)", description: "Three models: different for every stage" }
50
+ { label: "Smart (Recommended)", description: "Opus for planning, Sonnet for research/execution/verification" },
51
+ { label: "Genius (most flexible)", description: "Three models: different for every stage" },
52
+ { label: "Inherit", description: "Use current session model for all agents (best for OpenRouter, local models, or runtime model switching)" }
50
53
  ]
51
54
  },
52
55
  {
@@ -94,6 +97,26 @@ question([
94
97
  { label: "No", description: "Skip validation research. Good for rapid prototyping or no-test phases." }
95
98
  ]
96
99
  },
100
+ // Note: Nyquist validation depends on research output. If research is disabled,
101
+ // plan-phase automatically skips Nyquist steps (no RESEARCH.md to extract from).
102
+ {
103
+ question: "Enable UI Phase? (generates UI-SPEC.md design contracts for frontend phases)",
104
+ header: "UI Phase",
105
+ multiSelect: false,
106
+ options: [
107
+ { label: "Yes (Recommended)", description: "Generate UI design contracts before planning frontend phases. Locks spacing, typography, color, and copywriting." },
108
+ { label: "No", description: "Skip UI-SPEC generation. Good for backend-only projects or API phases." }
109
+ ]
110
+ },
111
+ {
112
+ question: "Enable UI Safety Gate? (prompts to run /gsd-ui-phase before planning frontend phases)",
113
+ header: "UI Gate",
114
+ multiSelect: false,
115
+ options: [
116
+ { label: "Yes (Recommended)", description: "plan-phase asks to run /gsd-ui-phase first when frontend indicators detected." },
117
+ { label: "No", description: "No prompt — plan-phase proceeds without UI-SPEC check." }
118
+ ]
119
+ },
97
120
  {
98
121
  question: "Git branching strategy?",
99
122
  header: "Branching",
@@ -103,6 +126,33 @@ question([
103
126
  { label: "Per Phase", description: "Create branch for each phase (gsd/phase-{N}-{name})" },
104
127
  { label: "Per Milestone", description: "Create branch for entire milestone (gsd/{version}-{name})" }
105
128
  ]
129
+ },
130
+ {
131
+ question: "Enable context window warnings? (injects advisory messages when context is getting full)",
132
+ header: "Ctx Warnings",
133
+ multiSelect: false,
134
+ options: [
135
+ { label: "Yes (Recommended)", description: "Warn when context usage exceeds 65%. Helps avoid losing work." },
136
+ { label: "No", description: "Disable warnings. Allows OpenCode to reach auto-compact naturally. Good for long unattended runs." }
137
+ ]
138
+ },
139
+ {
140
+ question: "Research best practices before asking questions? (web search during new-project and discuss-phase)",
141
+ header: "Research Qs",
142
+ multiSelect: false,
143
+ options: [
144
+ { label: "No (Recommended)", description: "Ask questions directly. Faster, uses fewer tokens." },
145
+ { label: "Yes", description: "Search web for best practices before each question group. More informed questions but uses more tokens." }
146
+ ]
147
+ },
148
+ {
149
+ question: "Skip discuss-phase in autonomous mode? (use ROADMAP phase goals as spec)",
150
+ header: "Skip Discuss",
151
+ multiSelect: false,
152
+ options: [
153
+ { label: "No (Recommended)", description: "Run smart discuss before each phase — surfaces gray areas and captures decisions." },
154
+ { label: "Yes", description: "Skip discuss in /gsd-autonomous — chain directly to plan. Best for backend/pipeline work where phase descriptions are the spec." }
155
+ ]
106
156
  }
107
157
  ])
108
158
  ```
@@ -114,16 +164,27 @@ Merge new settings into existing config.json:
114
164
  ```json
115
165
  {
116
166
  ...existing_config,
117
- "model_profile": "simple" | "smart" | "genius",
167
+ "model_profile": "simple" | "smart" | "genius" | "inherit",
118
168
  "workflow": {
119
169
  "research": true/false,
120
170
  "plan_check": true/false,
121
171
  "verifier": true/false,
122
172
  "auto_advance": true/false,
123
- "nyquist_validation": true/false
173
+ "nyquist_validation": true/false,
174
+ "ui_phase": true/false,
175
+ "ui_safety_gate": true/false,
176
+ "text_mode": true/false,
177
+ "research_before_questions": true/false,
178
+ "discuss_mode": "discuss" | "assumptions",
179
+ "skip_discuss": true/false
124
180
  },
125
181
  "git": {
126
- "branching_strategy": "none" | "phase" | "milestone"
182
+ "branching_strategy": "none" | "phase" | "milestone",
183
+ "quick_branch_template": <string|null>
184
+ },
185
+ "hooks": {
186
+ "context_warnings": true/false,
187
+ "workflow_guard": true/false
127
188
  }
128
189
  }
129
190
  ```
@@ -163,12 +224,16 @@ write `~/.gsd/defaults.json` with:
163
224
  "commit_docs": <current>,
164
225
  "parallelization": <current>,
165
226
  "branching_strategy": <current>,
227
+ "quick_branch_template": <current>,
166
228
  "workflow": {
167
229
  "research": <current>,
168
230
  "plan_check": <current>,
169
231
  "verifier": <current>,
170
232
  "auto_advance": <current>,
171
- "nyquist_validation": <current>
233
+ "nyquist_validation": <current>,
234
+ "ui_phase": <current>,
235
+ "ui_safety_gate": <current>,
236
+ "skip_discuss": <current>
172
237
  }
173
238
  }
174
239
  ```
@@ -184,13 +249,17 @@ Display:
184
249
 
185
250
  | Setting | Value |
186
251
  |----------------------|-------|
187
- | Model Profile | {simple/smart/genius} |
252
+ | Model Profile | {simple/smart/genius/inherit} |
188
253
  | Plan Researcher | {On/Off} |
189
254
  | Plan Checker | {On/Off} |
190
255
  | Execution Verifier | {On/Off} |
191
256
  | Auto-Advance | {On/Off} |
192
257
  | Nyquist Validation | {On/Off} |
258
+ | UI Phase | {On/Off} |
259
+ | UI Safety Gate | {On/Off} |
193
260
  | Git Branching | {None/Per Phase/Per Milestone} |
261
+ | Skip Discuss | {On/Off} |
262
+ | Context Warnings | {On/Off} |
194
263
  | Saved as Defaults | {Yes/No} |
195
264
 
196
265
  These settings apply to future /gsd-plan-phase and /gsd-execute-phase runs.
@@ -207,7 +276,7 @@ Quick commands:
207
276
 
208
277
  <success_criteria>
209
278
  - [ ] Current config read
210
- - [ ] User presented with 7 settings (profile + 5 workflow toggles + git branching)
279
+ - [ ] User presented with 10 settings (profile + 8 workflow toggles + git branching)
211
280
  - [ ] Config updated with model_profile, workflow, and git sections
212
281
  - [ ] User offered to save as global defaults (~/.gsd/defaults.json)
213
282
  - [ ] Changes confirmed to user