opencode-goopspec 0.1.3 → 0.1.4

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 (53) hide show
  1. package/README.md +253 -331
  2. package/agents/goop-debugger.md +175 -172
  3. package/agents/goop-designer.md +232 -160
  4. package/agents/goop-executor.md +197 -127
  5. package/agents/goop-explorer.md +148 -150
  6. package/agents/goop-librarian.md +218 -164
  7. package/agents/goop-orchestrator.md +364 -338
  8. package/agents/goop-planner.md +331 -153
  9. package/agents/goop-researcher.md +198 -126
  10. package/agents/goop-tester.md +277 -202
  11. package/agents/goop-verifier.md +191 -201
  12. package/agents/goop-writer.md +241 -133
  13. package/agents/memory-distiller.md +228 -136
  14. package/commands/goop-accept.md +430 -36
  15. package/commands/goop-amend.md +13 -0
  16. package/commands/goop-complete.md +13 -0
  17. package/commands/goop-debug.md +13 -0
  18. package/commands/goop-discuss.md +419 -7
  19. package/commands/goop-execute.md +386 -37
  20. package/commands/goop-help.md +11 -0
  21. package/commands/goop-map-codebase.md +13 -0
  22. package/commands/goop-memory.md +11 -0
  23. package/commands/goop-milestone.md +13 -0
  24. package/commands/goop-pause.md +12 -0
  25. package/commands/goop-plan.md +320 -266
  26. package/commands/goop-quick.md +12 -0
  27. package/commands/goop-recall.md +11 -0
  28. package/commands/goop-remember.md +12 -0
  29. package/commands/goop-research.md +13 -0
  30. package/commands/goop-resume.md +12 -0
  31. package/commands/goop-setup.md +18 -8
  32. package/commands/goop-specify.md +315 -39
  33. package/commands/goop-status.md +276 -28
  34. package/dist/index.js +328 -15
  35. package/package.json +1 -1
  36. package/references/context-injection.md +307 -0
  37. package/references/discovery-interview.md +278 -0
  38. package/references/enforcement-system.md +213 -0
  39. package/references/handoff-protocol.md +290 -0
  40. package/references/model-profiles.md +1 -1
  41. package/references/phase-gates.md +360 -0
  42. package/references/plugin-architecture.md +212 -0
  43. package/references/response-format.md +41 -9
  44. package/references/subagent-protocol.md +83 -33
  45. package/references/visual-style.md +199 -0
  46. package/references/xml-response-schema.md +236 -0
  47. package/templates/blueprint.md +88 -41
  48. package/templates/chronicle.md +130 -16
  49. package/templates/handoff.md +140 -0
  50. package/templates/project.md +114 -0
  51. package/templates/requirements.md +121 -0
  52. package/templates/spec.md +85 -20
  53. package/templates/state.md +103 -0
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  name: goop-status
3
- description: Show current GoopSpec status
3
+ description: Show current GoopSpec status and next steps
4
4
  ---
5
5
 
6
6
  # /goop-status
7
7
 
8
- **Show project status.** View progress, active phase, and pending tasks.
8
+ **Show project status.** View progress, active phase, gates, and suggested next command.
9
9
 
10
10
  ## Usage
11
11
 
@@ -13,39 +13,287 @@ description: Show current GoopSpec status
13
13
  /goop-status [--verbose]
14
14
  ```
15
15
 
16
- ## How It Works
16
+ ## Tools Used
17
17
 
18
- Displays a dashboard of the current GoopSpec session.
18
+ | Tool | Purpose in This Command |
19
+ |------|------------------------|
20
+ | `goop_status` | Primary tool - retrieves full workflow state |
21
+ | `memory_search` | Optionally find recent context |
19
22
 
20
- ### Information Shown
21
- - **Project State:** Initialized? Active Milestone?
22
- - **Current Phase:** Discuss, Plan, Research, Specify, Execute, or Accept.
23
- - **Progress:** Wave completion (e.g., "Wave 2 of 4").
24
- - **Task Status:** Current active task and recent completions.
25
- - **Gates:** Spec locked? Acceptance pending?
23
+ **Hook Support:** None specific - read-only operation.
26
24
 
27
- ### Interactive Actions
28
- From the status view, the agent often suggests the logical next command (e.g., "Execution complete. Run `/goop-accept` to verify.").
25
+ ---
26
+
27
+ ## Process
28
+
29
+ **Execute these reads:**
30
+
31
+ ```
32
+ Read(".goopspec/state.json")
33
+ Read(".goopspec/REQUIREMENTS.md")
34
+ Read(".goopspec/SPEC.md")
35
+ Read(".goopspec/BLUEPRINT.md")
36
+ Read(".goopspec/CHRONICLE.md")
37
+ Read(".goopspec/HANDOFF.md")
38
+ ```
39
+
40
+ ## Status Dashboard
41
+
42
+ Display a comprehensive status view:
43
+
44
+ ```
45
+ +--------------------------------------------------------+
46
+ | GOOPSPEC STATUS |
47
+ +--------------------------------------------------------+
48
+
49
+ ## Project State
50
+
51
+ | Attribute | Value |
52
+ |-----------|-------|
53
+ | Phase | [current phase] |
54
+ | Interview Complete | [Yes/No] |
55
+ | Spec Locked | [Yes/No] |
56
+ | Wave | [N of M] |
57
+ | Task | [X of Y] |
58
+
59
+ ## Gate Status
60
+
61
+ | Gate | Status | Requirement |
62
+ |------|--------|-------------|
63
+ | Discovery | [PASSED/BLOCKED] | interview_complete |
64
+ | Spec | [PASSED/BLOCKED] | spec_locked |
65
+ | Execution | [PASSED/BLOCKED] | all_tasks_done |
66
+ | Acceptance | [PASSED/BLOCKED] | verification_passed |
67
+
68
+ ## Progress
69
+
70
+ [Progress bar and completion percentage]
71
+
72
+ ### Completed
73
+ - [x] [Item 1]
74
+ - [x] [Item 2]
75
+
76
+ ### In Progress
77
+ - [ ] [Current item] <- **Current**
78
+
79
+ ### Remaining
80
+ - [ ] [Item 3]
81
+ - [ ] [Item 4]
82
+
83
+ ## Active Blockers
84
+
85
+ [None | List of blockers]
86
+
87
+ ## Pending Decisions
29
88
 
30
- ## Example Output
89
+ [None | List of decisions awaiting user input]
31
90
 
91
+ ## Recent Activity
92
+
93
+ | Time | Action | Agent |
94
+ |------|--------|-------|
95
+ | [time] | [action] | [agent] |
96
+
97
+ +--------------------------------------------------------+
98
+
99
+ ## > Suggested Next Command
100
+
101
+ Based on current state: `/goop-[command]`
102
+
103
+ [Brief explanation of why this is suggested]
104
+
105
+ +--------------------------------------------------------+
106
+ ```
107
+
108
+ ## Information Sources
109
+
110
+ | Source | Information |
111
+ |--------|-------------|
112
+ | `state.json` | Phase, locks, timestamps |
113
+ | `REQUIREMENTS.md` | Interview status |
114
+ | `SPEC.md` | Must-haves, lock status |
115
+ | `BLUEPRINT.md` | Waves, tasks, traceability |
116
+ | `CHRONICLE.md` | Progress, decisions, blockers |
117
+ | `HANDOFF.md` | Last session context |
118
+
119
+ ## Gate Logic
120
+
121
+ ### Discovery Gate
122
+ ```
123
+ IF REQUIREMENTS.md exists AND interview_complete == true:
124
+ PASSED
125
+ ELSE:
126
+ BLOCKED - Run /goop-discuss
127
+ ```
128
+
129
+ ### Spec Gate
130
+ ```
131
+ IF SPEC.md exists AND spec_locked == true:
132
+ PASSED
133
+ ELSE:
134
+ BLOCKED - Run /goop-specify
32
135
  ```
33
- ⬢ GoopSpec Status
34
- ─────────────────
35
- Phase: EXECUTE (Wave 2/4)
36
- Task: [2.1] Implement Login Handler (In Progress)
37
- Milestone: Auth System v1
38
136
 
39
- Progress:
40
- [✓] Wave 1: Foundation
41
- [→] Wave 2: Core Logic
42
- [✓] 2.1 Define types
43
- [→] 2.2 Implement handler
44
- [ ] 2.3 Add tests
45
- [ ] Wave 3: Integration
137
+ ### Execution Gate
138
+ ```
139
+ IF CHRONICLE shows all waves complete:
140
+ PASSED
141
+ ELSE:
142
+ BLOCKED - Continue /goop-execute
143
+ ```
46
144
 
47
- Next: Finish Task 2.2
145
+ ### Acceptance Gate
48
146
  ```
147
+ IF verification_passed == true AND user_accepted == true:
148
+ PASSED
149
+ ELSE:
150
+ BLOCKED - Run /goop-accept
151
+ ```
152
+
153
+ ## Suggested Commands
154
+
155
+ Based on current state, suggest the appropriate next command:
156
+
157
+ | State | Suggested Command |
158
+ |-------|-------------------|
159
+ | No project | `/goop-discuss` to start discovery |
160
+ | Interview incomplete | `/goop-discuss` to complete interview |
161
+ | Interview complete, no spec | `/goop-plan` to create blueprint |
162
+ | Spec draft, not locked | `/goop-specify` to lock |
163
+ | Spec locked, not executing | `/goop-execute` to start |
164
+ | Executing, tasks remaining | `/goop-execute` to continue |
165
+ | Executing, all done | `/goop-accept` to verify |
166
+ | Verified, not accepted | `/goop-accept` to accept |
167
+ | Accepted | `/goop-complete` to archive |
168
+
169
+ ## Verbose Mode
170
+
171
+ With `--verbose`:
172
+
173
+ ```
174
+ ## Full Task History
175
+
176
+ | Wave | Task | Status | Commit | Time |
177
+ |------|------|--------|--------|------|
178
+ | 1 | 1.1 | Complete | abc123 | 10m |
179
+ | 1 | 1.2 | Complete | def456 | 15m |
180
+ | 2 | 2.1 | In Progress | - | - |
181
+
182
+ ## Memory Stats
183
+
184
+ - Total memories: [N]
185
+ - Decisions: [M]
186
+ - Observations: [P]
187
+ - Recent: [list]
188
+
189
+ ## Recent Deviations
190
+
191
+ | Rule | Description | Resolution |
192
+ |------|-------------|------------|
193
+ | [N] | [What happened] | [How resolved] |
194
+
195
+ ## Checkpoint History
196
+
197
+ | ID | Phase | Wave | Created |
198
+ |----|-------|------|---------|
199
+ | [id] | [phase] | [wave] | [time] |
200
+ ```
201
+
202
+ ## Examples
203
+
204
+ **Fresh Project:**
205
+ ```
206
+ User: /goop-status
207
+
208
+ +--------------------------------------------------------+
209
+ | GOOPSPEC STATUS |
210
+ +--------------------------------------------------------+
211
+
212
+ ## Project State
213
+
214
+ | Attribute | Value |
215
+ |-----------|-------|
216
+ | Phase | idle |
217
+ | Interview Complete | No |
218
+ | Spec Locked | No |
219
+
220
+ ## Gate Status
221
+
222
+ | Gate | Status |
223
+ |------|--------|
224
+ | Discovery | BLOCKED |
225
+ | Spec | BLOCKED |
226
+ | Execution | BLOCKED |
227
+ | Acceptance | BLOCKED |
228
+
229
+ ## > Suggested Next Command
230
+
231
+ `/goop-discuss` - Start discovery interview
232
+
233
+ No project documents found. Begin with discovery.
234
+ ```
235
+
236
+ **Mid-Execution:**
237
+ ```
238
+ User: /goop-status
239
+
240
+ +--------------------------------------------------------+
241
+ | GOOPSPEC STATUS |
242
+ +--------------------------------------------------------+
243
+
244
+ ## Project State
245
+
246
+ | Attribute | Value |
247
+ |-----------|-------|
248
+ | Phase | execute |
249
+ | Interview Complete | Yes |
250
+ | Spec Locked | Yes |
251
+ | Wave | 2 of 3 |
252
+ | Task | 3 of 4 |
253
+
254
+ ## Gate Status
255
+
256
+ | Gate | Status |
257
+ |------|--------|
258
+ | Discovery | PASSED |
259
+ | Spec | PASSED |
260
+ | Execution | In Progress |
261
+ | Acceptance | Pending |
262
+
263
+ ## Progress
264
+
265
+ [################____] 75%
266
+
267
+ ### Completed
268
+ - [x] Wave 1: Foundation (4/4 tasks)
269
+ - [x] Wave 2.1: Define types
270
+ - [x] Wave 2.2: Implement handler
271
+
272
+ ### In Progress
273
+ - [ ] Wave 2.3: Add validation <- **Current**
274
+
275
+ ### Remaining
276
+ - [ ] Wave 2.4: Add tests
277
+ - [ ] Wave 3: Integration (3 tasks)
278
+
279
+ ## > Suggested Next Command
280
+
281
+ `/goop-execute` - Continue Wave 2
282
+
283
+ 2 tasks remaining in Wave 2, then Wave 3.
284
+ ```
285
+
286
+ ## Success Criteria
287
+
288
+ - [ ] All state files read
289
+ - [ ] Phase correctly identified
290
+ - [ ] Gate status accurately shown
291
+ - [ ] Progress clearly displayed
292
+ - [ ] Blockers highlighted
293
+ - [ ] Next command suggested based on state
294
+ - [ ] Verbose mode shows full history
295
+
296
+ ---
49
297
 
50
- ## Flags
51
- - `--verbose`: Show full task history, memory stats, and recent deviations.
298
+ *Status Protocol v0.1.4*
299
+ *"Know where you are. Know where to go."*