gsd-opencode 1.22.0 → 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.
- package/agents/gsd-advisor-researcher.md +112 -0
- package/agents/gsd-assumptions-analyzer.md +110 -0
- package/agents/gsd-codebase-mapper.md +1 -2
- package/agents/gsd-debugger.md +119 -2
- package/agents/gsd-executor.md +25 -4
- package/agents/gsd-integration-checker.md +1 -2
- package/agents/gsd-nyquist-auditor.md +1 -2
- package/agents/gsd-phase-researcher.md +151 -5
- package/agents/gsd-plan-checker.md +71 -5
- package/agents/gsd-planner.md +50 -4
- package/agents/gsd-project-researcher.md +29 -3
- package/agents/gsd-research-synthesizer.md +1 -2
- package/agents/gsd-roadmapper.md +30 -2
- package/agents/gsd-ui-auditor.md +445 -0
- package/agents/gsd-ui-checker.md +305 -0
- package/agents/gsd-ui-researcher.md +368 -0
- package/agents/gsd-user-profiler.md +173 -0
- package/agents/gsd-verifier.md +124 -4
- package/commands/gsd/gsd-add-backlog.md +76 -0
- package/commands/gsd/gsd-audit-uat.md +24 -0
- package/commands/gsd/gsd-autonomous.md +41 -0
- package/commands/gsd/gsd-debug.md +5 -0
- package/commands/gsd/gsd-discuss-phase.md +10 -36
- package/commands/gsd/gsd-do.md +30 -0
- package/commands/gsd/gsd-execute-phase.md +20 -2
- package/commands/gsd/gsd-fast.md +30 -0
- package/commands/gsd/gsd-forensics.md +56 -0
- package/commands/gsd/gsd-list-workspaces.md +19 -0
- package/commands/gsd/gsd-manager.md +39 -0
- package/commands/gsd/gsd-milestone-summary.md +51 -0
- package/commands/gsd/gsd-new-workspace.md +44 -0
- package/commands/gsd/gsd-next.md +24 -0
- package/commands/gsd/gsd-note.md +34 -0
- package/commands/gsd/gsd-plan-phase.md +3 -1
- package/commands/gsd/gsd-plant-seed.md +28 -0
- package/commands/gsd/gsd-pr-branch.md +25 -0
- package/commands/gsd/gsd-profile-user.md +46 -0
- package/commands/gsd/gsd-quick.md +4 -2
- package/commands/gsd/gsd-reapply-patches.md +10 -6
- package/commands/gsd/gsd-remove-workspace.md +26 -0
- package/commands/gsd/gsd-research-phase.md +5 -0
- package/commands/gsd/gsd-resume-work.md +1 -1
- package/commands/gsd/gsd-review-backlog.md +61 -0
- package/commands/gsd/gsd-review.md +37 -0
- package/commands/gsd/gsd-session-report.md +19 -0
- package/commands/gsd/gsd-set-profile.md +24 -23
- package/commands/gsd/gsd-ship.md +23 -0
- package/commands/gsd/gsd-stats.md +18 -0
- package/commands/gsd/gsd-thread.md +127 -0
- package/commands/gsd/gsd-ui-phase.md +34 -0
- package/commands/gsd/gsd-ui-review.md +32 -0
- package/commands/gsd/gsd-workstreams.md +66 -0
- package/get-shit-done/bin/gsd-tools.cjs +410 -84
- package/get-shit-done/bin/lib/commands.cjs +429 -18
- package/get-shit-done/bin/lib/config.cjs +318 -45
- package/get-shit-done/bin/lib/core.cjs +822 -84
- package/get-shit-done/bin/lib/frontmatter.cjs +78 -41
- package/get-shit-done/bin/lib/init.cjs +836 -104
- package/get-shit-done/bin/lib/milestone.cjs +44 -33
- package/get-shit-done/bin/lib/model-profiles.cjs +68 -0
- package/get-shit-done/bin/lib/phase.cjs +293 -306
- package/get-shit-done/bin/lib/profile-output.cjs +952 -0
- package/get-shit-done/bin/lib/profile-pipeline.cjs +539 -0
- package/get-shit-done/bin/lib/roadmap.cjs +55 -24
- package/get-shit-done/bin/lib/security.cjs +382 -0
- package/get-shit-done/bin/lib/state.cjs +363 -53
- package/get-shit-done/bin/lib/template.cjs +2 -2
- package/get-shit-done/bin/lib/uat.cjs +282 -0
- package/get-shit-done/bin/lib/verify.cjs +104 -36
- package/get-shit-done/bin/lib/workstream.cjs +491 -0
- package/get-shit-done/references/checkpoints.md +12 -10
- package/get-shit-done/references/decimal-phase-calculation.md +2 -3
- package/get-shit-done/references/git-integration.md +47 -0
- package/get-shit-done/references/model-profile-resolution.md +2 -0
- package/get-shit-done/references/model-profiles.md +62 -16
- package/get-shit-done/references/phase-argument-parsing.md +2 -2
- package/get-shit-done/references/planning-config.md +3 -1
- package/get-shit-done/references/user-profiling.md +681 -0
- package/get-shit-done/references/workstream-flag.md +58 -0
- package/get-shit-done/templates/UAT.md +21 -3
- package/get-shit-done/templates/UI-SPEC.md +100 -0
- package/get-shit-done/templates/claude-md.md +122 -0
- package/get-shit-done/templates/config.json +10 -3
- package/get-shit-done/templates/context.md +61 -6
- package/get-shit-done/templates/dev-preferences.md +21 -0
- package/get-shit-done/templates/discussion-log.md +63 -0
- package/get-shit-done/templates/phase-prompt.md +46 -5
- package/get-shit-done/templates/project.md +2 -0
- package/get-shit-done/templates/state.md +2 -2
- package/get-shit-done/templates/user-profile.md +146 -0
- package/get-shit-done/workflows/add-phase.md +2 -2
- package/get-shit-done/workflows/add-tests.md +4 -4
- package/get-shit-done/workflows/add-todo.md +3 -3
- package/get-shit-done/workflows/audit-milestone.md +13 -5
- package/get-shit-done/workflows/audit-uat.md +109 -0
- package/get-shit-done/workflows/autonomous.md +891 -0
- package/get-shit-done/workflows/check-todos.md +2 -2
- package/get-shit-done/workflows/cleanup.md +4 -4
- package/get-shit-done/workflows/complete-milestone.md +9 -6
- package/get-shit-done/workflows/diagnose-issues.md +15 -3
- package/get-shit-done/workflows/discovery-phase.md +2 -2
- package/get-shit-done/workflows/discuss-phase-assumptions.md +653 -0
- package/get-shit-done/workflows/discuss-phase.md +411 -38
- package/get-shit-done/workflows/do.md +104 -0
- package/get-shit-done/workflows/execute-phase.md +405 -18
- package/get-shit-done/workflows/execute-plan.md +77 -12
- package/get-shit-done/workflows/fast.md +105 -0
- package/get-shit-done/workflows/forensics.md +265 -0
- package/get-shit-done/workflows/health.md +28 -6
- package/get-shit-done/workflows/help.md +124 -7
- package/get-shit-done/workflows/insert-phase.md +2 -2
- package/get-shit-done/workflows/list-phase-assumptions.md +2 -2
- package/get-shit-done/workflows/list-workspaces.md +56 -0
- package/get-shit-done/workflows/manager.md +362 -0
- package/get-shit-done/workflows/map-codebase.md +74 -13
- package/get-shit-done/workflows/milestone-summary.md +223 -0
- package/get-shit-done/workflows/new-milestone.md +120 -18
- package/get-shit-done/workflows/new-project.md +178 -39
- package/get-shit-done/workflows/new-workspace.md +237 -0
- package/get-shit-done/workflows/next.md +97 -0
- package/get-shit-done/workflows/node-repair.md +92 -0
- package/get-shit-done/workflows/note.md +156 -0
- package/get-shit-done/workflows/pause-work.md +62 -8
- package/get-shit-done/workflows/plan-milestone-gaps.md +4 -5
- package/get-shit-done/workflows/plan-phase.md +332 -33
- package/get-shit-done/workflows/plant-seed.md +169 -0
- package/get-shit-done/workflows/pr-branch.md +129 -0
- package/get-shit-done/workflows/profile-user.md +450 -0
- package/get-shit-done/workflows/progress.md +145 -20
- package/get-shit-done/workflows/quick.md +205 -49
- package/get-shit-done/workflows/remove-phase.md +2 -2
- package/get-shit-done/workflows/remove-workspace.md +90 -0
- package/get-shit-done/workflows/research-phase.md +11 -3
- package/get-shit-done/workflows/resume-project.md +35 -16
- package/get-shit-done/workflows/review.md +228 -0
- package/get-shit-done/workflows/session-report.md +146 -0
- package/get-shit-done/workflows/set-profile.md +2 -2
- package/get-shit-done/workflows/settings.md +80 -11
- package/get-shit-done/workflows/ship.md +228 -0
- package/get-shit-done/workflows/stats.md +60 -0
- package/get-shit-done/workflows/transition.md +147 -20
- package/get-shit-done/workflows/ui-phase.md +302 -0
- package/get-shit-done/workflows/ui-review.md +165 -0
- package/get-shit-done/workflows/update.md +108 -25
- package/get-shit-done/workflows/validate-phase.md +15 -8
- package/get-shit-done/workflows/verify-phase.md +16 -5
- package/get-shit-done/workflows/verify-work.md +72 -18
- package/package.json +1 -1
- package/skills/gsd-audit-milestone/SKILL.md +29 -0
- package/skills/gsd-cleanup/SKILL.md +19 -0
- package/skills/gsd-complete-milestone/SKILL.md +131 -0
- package/skills/gsd-discuss-phase/SKILL.md +54 -0
- package/skills/gsd-execute-phase/SKILL.md +49 -0
- package/skills/gsd-plan-phase/SKILL.md +37 -0
- package/skills/gsd-ui-phase/SKILL.md +24 -0
- package/skills/gsd-ui-review/SKILL.md +24 -0
- 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
|
-
<
|
|
9
|
+
<objective>
|
|
10
10
|
Instantly restore full project context so "Where were we?" has an immediate, complete answer.
|
|
11
|
-
</
|
|
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 .
|
|
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
|
-
→
|
|
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:
|
|
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
|
-
- **
|
|
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
|
-
<
|
|
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
|
-
</
|
|
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
|
-
<
|
|
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
|
-
</
|
|
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: "
|
|
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,19 +249,23 @@ 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.
|
|
197
266
|
|
|
198
267
|
Quick commands:
|
|
199
|
-
- /gsd-set-profile <profile> — switch model profile/choose models
|
|
268
|
+
- /gsd-set-profile <profile> — switch model profile/choose models
|
|
200
269
|
- /gsd-plan-phase --research — force research
|
|
201
270
|
- /gsd-plan-phase --skip-research — skip research
|
|
202
271
|
- /gsd-plan-phase --skip-verify — skip plan check
|
|
@@ -207,7 +276,7 @@ Quick commands:
|
|
|
207
276
|
|
|
208
277
|
<success_criteria>
|
|
209
278
|
- [ ] Current config read
|
|
210
|
-
- [ ] User presented with
|
|
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
|