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
@@ -1,34 +1,35 @@
1
1
  ---
2
2
  name: gsd-set-profile
3
- description: Switch model profile for GSD agents (simple/smart/genius)
4
- argument-hint: <profile>
3
+ description: Switch model profile for GSD agents (simple/smart/genius/inherit)
4
+ argument-hint: <profile (simple|smart|genius|inherit)>
5
+ model: haiku
5
6
  permissions:
6
- read: true
7
- write: true
8
7
  bash: true
9
8
  ---
10
9
 
10
+
11
+
11
12
  <objective>
12
- Switch the model profile used by GSD agents. Controls which OpenCode model each agent uses, balancing quality vs token spend.
13
+ Switch the model profile used by GSD agents. Controls which OpenCode model each agent uses, balancing quality vs token spend.
13
14
 
14
- Routes to the set-profile workflow which handles:
15
- - Argument validation (simple/smart/genius)
16
- - Config file creation if missing
17
- - Profile update in config.json
18
- - Confirmation with model table display
19
- </objective>
15
+ Routes to the set-profile workflow which handles:
16
+ - Argument validation (simple/smart/genius)
17
+ - Config file creation if missing
18
+ - Profile update in config.json
19
+ - Confirmation with model table display
20
+ </objective>
20
21
 
21
- <execution_context>
22
- @$HOME/.config/opencode/get-shit-done/workflows/oc-set-profile.md
23
- </execution_context>
22
+ <execution_context>
23
+ @$HOME/.config/opencode/get-shit-done/workflows/oc-set-profile.md
24
+ </execution_context>
24
25
 
25
- <process>
26
- **Follow the set-profile workflow** from `@$HOME/.config/opencode/get-shit-done/workflows/oc-set-profile.md`.
26
+ <process>
27
+ **Follow the set-profile workflow** from `@$HOME/.config/opencode/get-shit-done/workflows/oc-set-profile.md`.
27
28
 
28
- The workflow handles all logic including:
29
- 1. Profile argument validation
30
- 2. Config file ensuring
31
- 3. Config reading and updating
32
- 4. Model table generation from MODEL_PROFILES
33
- 5. Confirmation display
34
- </process>
29
+ The workflow handles all logic including:
30
+ 1. Profile argument validation
31
+ 2. Config file ensuring
32
+ 3. Config reading and updating
33
+ 4. Model table generation from MODEL_PROFILES
34
+ 5. Confirmation display
35
+ </process>
@@ -0,0 +1,23 @@
1
+ ---
2
+ name: gsd-ship
3
+ description: Create PR, run review, and prepare for merge after verification passes
4
+ argument-hint: "[phase number or milestone, e.g., '4' or 'v1.0']"
5
+ permissions:
6
+ read: true
7
+ bash: true
8
+ grep: true
9
+ glob: true
10
+ write: true
11
+ question: true
12
+ ---
13
+ <objective>
14
+ Bridge local completion → merged PR. After /gsd-verify-work passes, ship the work: push branch, create PR with auto-generated body, optionally trigger review, and track the merge.
15
+
16
+ Closes the plan → execute → verify → ship loop.
17
+ </objective>
18
+
19
+ <execution_context>
20
+ @$HOME/.config/opencode/get-shit-done/workflows/ship.md
21
+ </execution_context>
22
+
23
+ Execute the ship workflow from @$HOME/.config/opencode/get-shit-done/workflows/ship.md end-to-end.
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: gsd-stats
3
+ description: Display project statistics — phases, plans, requirements, git metrics, and timeline
4
+ permissions:
5
+ read: true
6
+ bash: true
7
+ ---
8
+ <objective>
9
+ Display comprehensive project statistics including phase progress, plan execution metrics, requirements completion, git history stats, and project timeline.
10
+ </objective>
11
+
12
+ <execution_context>
13
+ @$HOME/.config/opencode/get-shit-done/workflows/stats.md
14
+ </execution_context>
15
+
16
+ <process>
17
+ Execute the stats workflow from @$HOME/.config/opencode/get-shit-done/workflows/stats.md end-to-end.
18
+ </process>
@@ -0,0 +1,127 @@
1
+ ---
2
+ name: gsd-thread
3
+ description: Manage persistent context threads for cross-session work
4
+ argument-hint: [name | description]
5
+ permissions:
6
+ read: true
7
+ write: true
8
+ bash: true
9
+ ---
10
+
11
+ <objective>
12
+ Create, list, or resume persistent context threads. Threads are lightweight
13
+ cross-session knowledge stores for work that spans multiple sessions but
14
+ doesn't belong to any specific phase.
15
+ </objective>
16
+
17
+ <process>
18
+
19
+ **Parse $ARGUMENTS to determine mode:**
20
+
21
+ <mode_list>
22
+ **If no arguments or $ARGUMENTS is empty:**
23
+
24
+ List all threads:
25
+ ```bash
26
+ ls .planning/threads/*.md 2>/dev/null
27
+ ```
28
+
29
+ For each thread, read the first few lines to show title and status:
30
+ ```
31
+ ## Active Threads
32
+
33
+ | Thread | Status | Last Updated |
34
+ |--------|--------|-------------|
35
+ | fix-deploy-key-auth | OPEN | 2026-03-15 |
36
+ | pasta-tcp-timeout | RESOLVED | 2026-03-12 |
37
+ | perf-investigation | IN PROGRESS | 2026-03-17 |
38
+ ```
39
+
40
+ If no threads exist, show:
41
+ ```
42
+ No threads found. Create one with: /gsd-thread <description>
43
+ ```
44
+ </mode_list>
45
+
46
+ <mode_resume>
47
+ **If $ARGUMENTS matches an existing thread name (file exists):**
48
+
49
+ Resume the thread — load its context into the current session:
50
+ ```bash
51
+ cat ".planning/threads/${THREAD_NAME}.md"
52
+ ```
53
+
54
+ Display the thread content and ask what the user wants to work on next.
55
+ Update the thread's status to `IN PROGRESS` if it was `OPEN`.
56
+ </mode_resume>
57
+
58
+ <mode_create>
59
+ **If $ARGUMENTS is a new description (no matching thread file):**
60
+
61
+ Create a new thread:
62
+
63
+ 1. Generate slug from description:
64
+ ```bash
65
+ SLUG=$(node "$HOME/.config/opencode/get-shit-done/bin/gsd-tools.cjs" generate-slug "$ARGUMENTS")
66
+ ```
67
+
68
+ 2. Create the threads directory if needed:
69
+ ```bash
70
+ mkdir -p .planning/threads
71
+ ```
72
+
73
+ 3. write the thread file:
74
+ ```bash
75
+ cat > ".planning/threads/${SLUG}.md" << 'EOF'
76
+ # Thread: {description}
77
+
78
+ ## Status: OPEN
79
+
80
+ ## Goal
81
+
82
+ {description}
83
+
84
+ ## Context
85
+
86
+ *Created from conversation on {today's date}.*
87
+
88
+ ## References
89
+
90
+ - *(add links, file paths, or issue numbers)*
91
+
92
+ ## Next Steps
93
+
94
+ - *(what the next session should do first)*
95
+ EOF
96
+ ```
97
+
98
+ 4. If there's relevant context in the current conversation (code snippets,
99
+ error messages, investigation results), extract and add it to the Context
100
+ section.
101
+
102
+ 5. Commit:
103
+ ```bash
104
+ node "$HOME/.config/opencode/get-shit-done/bin/gsd-tools.cjs" commit "docs: create thread — ${ARGUMENTS}" --files ".planning/threads/${SLUG}.md"
105
+ ```
106
+
107
+ 6. Report:
108
+ ```
109
+ ## 🧵 Thread Created
110
+
111
+ Thread: {slug}
112
+ File: .planning/threads/{slug}.md
113
+
114
+ Resume anytime with: /gsd-thread {slug}
115
+ ```
116
+ </mode_create>
117
+
118
+ </process>
119
+
120
+ <notes>
121
+ - Threads are NOT phase-scoped — they exist independently of the roadmap
122
+ - Lighter weight than /gsd-pause-work — no phase state, no plan context
123
+ - The value is in Context and Next Steps — a cold-start session can pick up immediately
124
+ - Threads can be promoted to phases or backlog items when they mature:
125
+ /gsd-add-phase or /gsd-add-backlog with context from the thread
126
+ - Thread files live in .planning/threads/ — no collision with phases or other GSD structures
127
+ </notes>
@@ -0,0 +1,34 @@
1
+ ---
2
+ name: gsd-ui-phase
3
+ description: Generate UI design contract (UI-SPEC.md) for frontend phases
4
+ argument-hint: "[phase]"
5
+ permissions:
6
+ read: true
7
+ write: true
8
+ bash: true
9
+ glob: true
10
+ grep: true
11
+ task: true
12
+ webfetch: true
13
+ question: true
14
+ mcp__context7__*: true
15
+ ---
16
+ <objective>
17
+ Create a UI design contract (UI-SPEC.md) for a frontend phase.
18
+ Orchestrates gsd-ui-researcher and gsd-ui-checker.
19
+ Flow: Validate → Research UI → Verify UI-SPEC → Done
20
+ </objective>
21
+
22
+ <execution_context>
23
+ @$HOME/.config/opencode/get-shit-done/workflows/ui-phase.md
24
+ @$HOME/.config/opencode/get-shit-done/references/ui-brand.md
25
+ </execution_context>
26
+
27
+ <context>
28
+ Phase number: $ARGUMENTS — optional, auto-detects next unplanned phase if omitted.
29
+ </context>
30
+
31
+ <process>
32
+ Execute @$HOME/.config/opencode/get-shit-done/workflows/ui-phase.md end-to-end.
33
+ Preserve all workflow gates.
34
+ </process>
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: gsd-ui-review
3
+ description: Retroactive 6-pillar visual audit of implemented frontend code
4
+ argument-hint: "[phase]"
5
+ permissions:
6
+ read: true
7
+ write: true
8
+ bash: true
9
+ glob: true
10
+ grep: true
11
+ task: true
12
+ question: true
13
+ ---
14
+ <objective>
15
+ Conduct a retroactive 6-pillar visual audit. Produces UI-REVIEW.md with
16
+ graded assessment (1-4 per pillar). Works on any project.
17
+ Output: {phase_num}-UI-REVIEW.md
18
+ </objective>
19
+
20
+ <execution_context>
21
+ @$HOME/.config/opencode/get-shit-done/workflows/ui-review.md
22
+ @$HOME/.config/opencode/get-shit-done/references/ui-brand.md
23
+ </execution_context>
24
+
25
+ <context>
26
+ Phase: $ARGUMENTS — optional, defaults to last completed phase.
27
+ </context>
28
+
29
+ <process>
30
+ Execute @$HOME/.config/opencode/get-shit-done/workflows/ui-review.md end-to-end.
31
+ Preserve all workflow gates.
32
+ </process>
@@ -0,0 +1,66 @@
1
+ ---
2
+ name: gsd-workstreams
3
+ description: Manage parallel workstreams — list, create, switch, status, progress, complete, and resume
4
+ ---
5
+
6
+ # /gsd-workstreams
7
+
8
+ <objective>
9
+ Manage parallel workstreams for concurrent milestone work.
10
+ </objective>
11
+
12
+ ## Usage
13
+
14
+ `/gsd-workstreams [subcommand] [args]`
15
+
16
+ ### Subcommands
17
+
18
+ | Command | Description |
19
+ |---------|-------------|
20
+ | `list` | List all workstreams with status |
21
+ | `create <name>` | Create a new workstream |
22
+ | `status <name>` | Detailed status for one workstream |
23
+ | `switch <name>` | Set active workstream |
24
+ | `progress` | Progress summary across all workstreams |
25
+ | `complete <name>` | Archive a completed workstream |
26
+ | `resume <name>` | Resume work in a workstream |
27
+
28
+ ## Step 1: Parse Subcommand
29
+
30
+ Parse the user's input to determine which workstream operation to perform.
31
+ If no subcommand given, default to `list`.
32
+
33
+ ## Step 2: Execute Operation
34
+
35
+ ### list
36
+ Run: `node "$GSD_TOOLS" workstream list --raw --cwd "$CWD"`
37
+ Display the workstreams in a table format showing name, status, current phase, and progress.
38
+
39
+ ### create
40
+ Run: `node "$GSD_TOOLS" workstream create <name> --raw --cwd "$CWD"`
41
+ After creation, display the new workstream path and suggest next steps:
42
+ - `/gsd-new-milestone --ws <name>` to set up the milestone
43
+
44
+ ### status
45
+ Run: `node "$GSD_TOOLS" workstream status <name> --raw --cwd "$CWD"`
46
+ Display detailed phase breakdown and state information.
47
+
48
+ ### switch
49
+ Run: `node "$GSD_TOOLS" workstream set <name> --raw --cwd "$CWD"`
50
+ Also set `GSD_WORKSTREAM` env var for the current session.
51
+
52
+ ### progress
53
+ Run: `node "$GSD_TOOLS" workstream progress --raw --cwd "$CWD"`
54
+ Display a progress overview across all workstreams.
55
+
56
+ ### complete
57
+ Run: `node "$GSD_TOOLS" workstream complete <name> --raw --cwd "$CWD"`
58
+ Archive the workstream to milestones/.
59
+
60
+ ### resume
61
+ Set the workstream as active and suggest `/gsd-resume-work --ws <name>`.
62
+
63
+ ## Step 3: Display Results
64
+
65
+ Format the JSON output from gsd-tools into a human-readable display.
66
+ Include the `${GSD_WS}` flag in any routing suggestions.