opencode-goopspec 0.1.4 → 0.1.6

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 (91) hide show
  1. package/README.md +7 -8
  2. package/agents/goop-debugger.md +2 -2
  3. package/agents/goop-designer.md +2 -2
  4. package/agents/goop-executor.md +17 -7
  5. package/agents/goop-explorer.md +2 -2
  6. package/agents/goop-librarian.md +1 -1
  7. package/agents/goop-orchestrator.md +47 -5
  8. package/agents/goop-planner.md +3 -3
  9. package/agents/goop-researcher.md +2 -2
  10. package/agents/goop-tester.md +1 -1
  11. package/agents/goop-verifier.md +2 -2
  12. package/agents/goop-writer.md +1 -1
  13. package/agents/memory-distiller.md +2 -2
  14. package/commands/goop-accept.md +27 -401
  15. package/commands/goop-discuss.md +29 -393
  16. package/commands/goop-execute.md +22 -356
  17. package/commands/goop-map-codebase.md +44 -478
  18. package/commands/goop-plan.md +23 -433
  19. package/commands/goop-quick.md +58 -31
  20. package/commands/goop-setup.md +35 -278
  21. package/commands/goop-specify.md +26 -291
  22. package/commands/goop-status.md +26 -261
  23. package/dist/index.js +34981 -239
  24. package/dist/worker/index.js +35883 -0
  25. package/package.json +5 -2
  26. package/references/accept-process.md +402 -0
  27. package/references/context-injection.md +1 -1
  28. package/references/discovery-interview.md +1 -1
  29. package/references/discuss-process.md +383 -0
  30. package/references/dispatch-patterns.md +46 -21
  31. package/references/enforcement-system.md +1 -1
  32. package/references/execute-process.md +358 -0
  33. package/references/git-workflow.md +349 -0
  34. package/references/handoff-protocol.md +1 -1
  35. package/references/map-codebase-process.md +353 -0
  36. package/references/model-profiles.md +16 -16
  37. package/references/orchestrator-philosophy.md +155 -223
  38. package/references/phase-gates.md +1 -1
  39. package/references/plan-process.md +397 -0
  40. package/references/plugin-architecture.md +1 -1
  41. package/references/quick-process.md +343 -0
  42. package/references/response-format.md +2 -2
  43. package/references/specify-process.md +251 -0
  44. package/references/status-process.md +253 -0
  45. package/references/subagent-protocol.md +2 -2
  46. package/references/team-coordination.md +183 -0
  47. package/references/xml-response-schema.md +5 -5
  48. package/skills/accessibility/skill.md +1 -1
  49. package/skills/accessibility-testing/skill.md +1 -1
  50. package/skills/api-docs/skill.md +1 -1
  51. package/skills/architecture-design/skill.md +1 -1
  52. package/skills/atomic-commits/skill.md +92 -15
  53. package/skills/code-review/skill.md +1 -1
  54. package/skills/codebase-mapping/skill.md +1 -1
  55. package/skills/convention-detection/skill.md +1 -1
  56. package/skills/debugging/skill.md +1 -1
  57. package/skills/deviation-handling/skill.md +1 -1
  58. package/skills/documentation/skill.md +1 -1
  59. package/skills/goop-core/skill.md +48 -11
  60. package/skills/memory-usage/skill.md +1 -1
  61. package/skills/parallel-planning/skill.md +1 -1
  62. package/skills/pattern-extraction/skill.md +1 -1
  63. package/skills/performance-optimization/skill.md +1 -1
  64. package/skills/playwright/skill.md +1 -1
  65. package/skills/playwright-testing/skill.md +1 -1
  66. package/skills/progress-tracking/skill.md +1 -1
  67. package/skills/readme-generation/skill.md +1 -1
  68. package/skills/research/skill.md +1 -1
  69. package/skills/responsive-design/skill.md +1 -1
  70. package/skills/scientific-method/skill.md +1 -1
  71. package/skills/security-audit/skill.md +1 -1
  72. package/skills/task-decomposition/skill.md +1 -1
  73. package/skills/task-delegation/skill.md +60 -34
  74. package/skills/technical-writing/skill.md +1 -1
  75. package/skills/testing/skill.md +1 -1
  76. package/skills/ui-design/skill.md +1 -1
  77. package/skills/ux-patterns/skill.md +1 -1
  78. package/skills/verification/skill.md +1 -1
  79. package/skills/visual-regression/skill.md +1 -1
  80. package/templates/blueprint.md +1 -1
  81. package/templates/chronicle.md +1 -1
  82. package/templates/handoff.md +1 -1
  83. package/templates/milestone.md +1 -1
  84. package/templates/project-knowledge-base.md +93 -0
  85. package/templates/project.md +1 -1
  86. package/templates/requirements.md +1 -1
  87. package/templates/research.md +1 -1
  88. package/templates/retrospective.md +1 -1
  89. package/templates/spec.md +1 -1
  90. package/templates/state.md +1 -1
  91. package/templates/summary.md +1 -1
@@ -16,32 +16,23 @@ alternatives:
16
16
 
17
17
  **Verify and accept work.** The final gate before completion.
18
18
 
19
- ## Usage
19
+ ## Immediate Action
20
20
 
21
- ```bash
22
- /goop-accept
21
+ **STOP. Execute this tool call NOW before reading anything else:**
23
22
  ```
24
-
25
- ## Gate Requirement
26
-
27
- ```
28
- +================================================================+
29
- | ACCEPTANCE GATE: All tasks must be complete before acceptance. |
30
- | Verification must pass. User must explicitly accept. |
31
- +================================================================+
23
+ goop_reference({ name: "accept-process" })
32
24
  ```
33
25
 
34
- **Required before this command:**
35
- - All waves complete in CHRONICLE.md
36
- - No unresolved blockers
37
- - Verification passing
26
+ **Then follow the process from that reference.** Do not process user messages until you have loaded and understood the protocol.
38
27
 
39
- **If not satisfied:** Refuse and show what's missing
28
+ ## Quick Summary
40
29
 
41
- ## Tools Used
30
+ **Gate:** All waves complete, no unresolved blockers.
42
31
 
43
- | Tool | Purpose in This Command |
44
- |------|------------------------|
32
+ ### Tools Used
33
+
34
+ | Tool | Purpose |
35
+ |------|---------|
45
36
  | `goop_status` | Check execution complete status |
46
37
  | `goop_spec` | Load must-haves for verification |
47
38
  | `goop_reference` | Load security-checklist, verification protocols |
@@ -49,409 +40,44 @@ alternatives:
49
40
  | `memory_decision` | Record accept/reject decision with evidence |
50
41
  | `goop_adl` | Log verification gaps |
51
42
 
52
- **Hook Support:** `tool.execute.after` may trigger archive phase on acceptance.
53
-
54
- ---
55
-
56
- ## Process
57
-
58
- ### Phase 1: Gate Check
59
-
60
- **Execute BEFORE anything else:**
61
-
62
- ```
63
- goop_status()
64
- Read(".goopspec/CHRONICLE.md")
65
- Read(".goopspec/SPEC.md")
66
- Read(".goopspec/BLUEPRINT.md")
67
- ```
68
-
69
- **1.1 Check execution complete:**
70
-
71
- ```
72
- IF CHRONICLE shows incomplete waves:
73
- REFUSE with:
74
-
75
- +--------------------------------------------------------+
76
- | GOOPSPEC > GATE BLOCKED |
77
- +--------------------------------------------------------+
78
- | Execution incomplete. |
79
- | |
80
- | Remaining: |
81
- | - Wave [N]: [X] tasks pending |
82
- | |
83
- | Run: /goop-execute |
84
- +--------------------------------------------------------+
85
- ```
86
-
87
- **1.2 Check for blockers:**
88
-
89
- ```
90
- IF unresolved blockers exist:
91
- REFUSE with:
92
-
93
- +--------------------------------------------------------+
94
- | GOOPSPEC > BLOCKERS UNRESOLVED |
95
- +--------------------------------------------------------+
96
- | Cannot accept with active blockers: |
97
- | |
98
- | - [Blocker 1] |
99
- | - [Blocker 2] |
100
- | |
101
- | Resolve blockers, then retry. |
102
- +--------------------------------------------------------+
103
- ```
104
-
105
- **1.3 Gate passed:**
106
-
107
- ```
108
- +--------------------------------------------------------+
109
- | GOOPSPEC > ACCEPTANCE |
110
- +--------------------------------------------------------+
111
- | Execution gate: PASSED |
112
- | Running verification... |
113
- +--------------------------------------------------------+
114
- ```
115
-
116
- ### Phase 2: Run Verification
117
-
118
- **Spawn goop-verifier:**
119
-
120
- ```
121
- task({
122
- subagent_type: "goop-verifier",
123
- description: "Verify against specification",
124
- prompt: `
125
- ## TASK
126
- Verify implementation against SPEC.md
127
-
128
- ## REQUIREMENTS
129
- [Full SPEC.md content]
130
-
131
- ## BLUEPRINT
132
- [Full BLUEPRINT.md content - for traceability]
133
-
134
- ## CHRONICLE
135
- [Progress log - what was built]
136
-
137
- ## INSTRUCTIONS
138
- 1. Verify every must-have has:
139
- - Implementation (code exists)
140
- - Tests (coverage)
141
- - Acceptance criteria met
43
+ ### Process Overview
142
44
 
143
- 2. Build requirement matrix:
144
- | Must-Have | Status | Evidence |
145
-
146
- 3. Run security checklist
45
+ 1. **Gate Check** — Verify all waves complete, no blockers
46
+ 2. **Run Verification** Spawn goop-verifier and goop-tester
47
+ 3. **Present Report** — Requirement matrix, test results, security check
48
+ 4. **Request Acceptance** — User must type "accept"
49
+ 5. **Handle Response** — Update state, generate HANDOFF.md
147
50
 
148
- 4. Check for regressions
51
+ ### Acceptance Keywords
149
52
 
150
- 5. Return XML with VERIFICATION PASSED/FAILED
151
- `
152
- })
153
- ```
154
-
155
- **Spawn goop-tester (parallel):**
156
-
157
- ```
158
- task({
159
- subagent_type: "goop-tester",
160
- description: "Run test suite",
161
- prompt: `
162
- ## TASK
163
- Run complete test suite and report results
164
-
165
- ## INSTRUCTIONS
166
- 1. Run: bun test
167
- 2. Run: bun run typecheck
168
- 3. Report coverage
169
- 4. Flag any failures
170
- 5. Return XML with test results
171
- `
172
- })
173
- ```
174
-
175
- ### Phase 3: Present Verification Report
176
-
177
- **Parse XML responses and present:**
178
-
179
- ```
180
- +--------------------------------------------------------+
181
- | GOOPSPEC > VERIFICATION REPORT |
182
- +--------------------------------------------------------+
183
-
184
- ## Requirement Matrix
185
-
186
- | Must-Have | Status | Evidence |
187
- |-----------|--------|----------|
188
- | MH1: [Title] | PASS | Tests: 5/5, Commit: abc123 |
189
- | MH2: [Title] | PASS | Tests: 3/3, Commit: def456 |
190
- | MH3: [Title] | PASS | Manual: UI verified |
191
-
192
- ## Test Results
193
-
194
- | Suite | Passed | Failed | Coverage |
195
- |-------|--------|--------|----------|
196
- | Unit | 42 | 0 | 87% |
197
- | Integration | 8 | 0 | 92% |
198
-
199
- ## Security Check
200
-
201
- | Check | Status |
202
- |-------|--------|
203
- | No hardcoded secrets | PASS |
204
- | Input validation | PASS |
205
- | Auth on protected routes | PASS |
206
-
207
- ## Overall: [PASSED/FAILED]
208
-
209
- +--------------------------------------------------------+
210
- ```
211
-
212
- **If FAILED:**
213
-
214
- ```
215
- +--------------------------------------------------------+
216
- | GOOPSPEC > VERIFICATION FAILED |
217
- +--------------------------------------------------------+
218
-
219
- **Failures:**
220
-
221
- | Must-Have | Issue | Resolution |
222
- |-----------|-------|------------|
223
- | MH2 | Test failing | Fix auth edge case |
224
- | MH3 | Missing feature | Implement retry logic |
225
-
226
- +--------------------------------------------------------+
227
-
228
- **Options:**
229
- 1. Fix issues → /goop-execute to continue
230
- 2. Amend spec → /goop-amend to change requirements
231
- 3. Accept anyway → Type "accept-with-issues"
232
-
233
- +--------------------------------------------------------+
234
- ```
235
-
236
- ### Phase 4: Request Acceptance
237
-
238
- **If PASSED:**
239
-
240
- ```
241
- +--------------------------------------------------------+
242
- | GOOPSPEC > ACCEPTANCE GATE |
243
- +--------------------------------------------------------+
244
-
245
- **Verification:** PASSED
246
- **Must-Haves:** [N/N] complete
247
- **Tests:** [X] passing
248
-
249
- +--------------------------------------------------------+
250
-
251
- Type **"accept"** to complete this milestone.
252
- Type **"issues"** to report problems.
253
- Type **"cancel"** to return to execution.
254
-
255
- +--------------------------------------------------------+
256
- ```
257
-
258
- ### Phase 5: Handle Response
259
-
260
- **On "accept":**
261
-
262
- 1. Update state.json:
263
- ```json
264
- {
265
- "phase": "accept",
266
- "verification_passed": true,
267
- "user_accepted": true,
268
- "accepted_at": "[timestamp]"
269
- }
270
- ```
271
-
272
- 2. Save to memory:
273
- ```
274
- memory_save({
275
- type: "decision",
276
- title: "Accepted: [Feature]",
277
- content: "User accepted [feature] with [N] must-haves verified",
278
- importance: 0.8
279
- })
280
- ```
281
-
282
- 3. Generate HANDOFF.md:
283
- ```markdown
284
- # Session Handoff
285
-
286
- **Phase:** accept
287
-
288
- ## Accomplished
289
- - All must-haves verified
290
- - Tests passing
291
- - User accepted
292
-
293
- ## Next Session
294
- Run: /goop-complete
295
-
296
- ## Context
297
- Verification passed. Ready to archive.
298
- ```
299
-
300
- 4. Display completion:
301
- ```
302
- +--------------------------------------------------------+
303
- | GOOPSPEC > ACCEPTED |
304
- +--------------------------------------------------------+
305
-
306
- **Feature:** [Name]
307
- **Status:** Accepted
308
- **Verified:** [timestamp]
309
-
310
- +--------------------------------------------------------+
311
-
312
- ## > Next Step
313
-
314
- **Complete the milestone** — Archive and extract learnings
315
-
316
- `/goop-complete`
317
-
318
- Start a new session for clean archive.
319
-
320
- +--------------------------------------------------------+
321
- ```
322
-
323
- **On "issues":**
324
-
325
- ```
326
- What issues did you find?
327
-
328
- [Use question tool or text input]
329
- ```
330
-
331
- Then:
332
- 1. Log issues in CHRONICLE.md
333
- 2. Return to execution phase
334
- 3. Suggest `/goop-execute` to fix
335
-
336
- **On "accept-with-issues":**
337
-
338
- 1. Log that acceptance was with known issues
339
- 2. Document issues in CHRONICLE.md
340
- 3. Proceed to acceptance
341
-
342
- ```
343
- +--------------------------------------------------------+
344
- | GOOPSPEC > ACCEPTED WITH ISSUES |
345
- +--------------------------------------------------------+
346
-
347
- **Known Issues:**
348
- - [Issue 1]
349
- - [Issue 2]
350
-
351
- These will be documented in the retrospective.
352
-
353
- ## > Next Step
354
- `/goop-complete`
355
- +--------------------------------------------------------+
356
- ```
53
+ | Keyword | Action |
54
+ |---------|--------|
55
+ | `accept` | Complete milestone, proceed to /goop-complete |
56
+ | `issues` | Log issues, return to execution |
57
+ | `accept-with-issues` | Accept with documented known issues |
58
+ | `cancel` | Return to execution |
357
59
 
358
60
  ## Output
359
61
 
360
62
  | File | Purpose |
361
63
  |------|---------|
362
- | `.goopspec/state.json` | Updated with acceptance |
64
+ | State (via goop_state) | Updated with acceptance |
363
65
  | `.goopspec/CHRONICLE.md` | Verification results |
364
66
  | `.goopspec/HANDOFF.md` | Session handoff |
365
67
 
366
- ## Transitions
367
-
368
- | Outcome | Next Step |
369
- |---------|-----------|
370
- | Accepted | `/goop-complete` to archive |
371
- | Verification failed | `/goop-execute` to fix |
372
- | Issues reported | `/goop-execute` to address |
373
- | Spec needs change | `/goop-amend` to modify |
374
-
375
- ## Examples
376
-
377
- **Successful Acceptance:**
378
- ```
379
- User: /goop-accept
380
-
381
- Orchestrator:
382
- +--------------------------------------------------------+
383
- | GOOPSPEC > VERIFICATION REPORT |
384
- +--------------------------------------------------------+
385
-
386
- | Must-Have | Status | Evidence |
387
- |-----------|--------|----------|
388
- | MH1: Toggle UI | PASS | Tests: 3/3 |
389
- | MH2: Theme switch | PASS | Tests: 5/5 |
390
- | MH3: Persist pref | PASS | Tests: 2/2 |
391
-
392
- ## Overall: PASSED
393
-
394
- Type "accept" to complete.
395
-
396
- User: accept
397
-
398
- Orchestrator:
399
- +--------------------------------------------------------+
400
- | GOOPSPEC > ACCEPTED |
401
- +--------------------------------------------------------+
402
-
403
- ## > Next Step
404
- `/goop-complete`
405
- ```
406
-
407
- **Verification Failed:**
408
- ```
409
- User: /goop-accept
410
-
411
- Orchestrator:
412
- +--------------------------------------------------------+
413
- | GOOPSPEC > VERIFICATION FAILED |
414
- +--------------------------------------------------------+
415
-
416
- **Failures:**
417
- | MH2 | Test failing | edge case in theme switch |
418
-
419
- **Options:**
420
- 1. Fix issues → /goop-execute
421
- 2. Accept anyway → "accept-with-issues"
422
-
423
- User: Let's fix it
424
-
425
- Orchestrator: Run `/goop-execute` to continue.
426
- ```
427
-
428
68
  ## Success Criteria
429
69
 
430
70
  - [ ] Gate check performed (execution complete, no blockers)
431
71
  - [ ] goop-verifier spawned with full context
432
- - [ ] goop-tester spawned for test suite
433
72
  - [ ] Verification report presented clearly
434
- - [ ] Requirement matrix shows all must-haves
435
73
  - [ ] User explicitly typed "accept"
436
- - [ ] state.json updated with acceptance
437
74
  - [ ] HANDOFF.md generated
438
- - [ ] User knows next step is `/goop-complete`
439
75
 
440
76
  ## Anti-Patterns
441
77
 
442
- **DON'T:**
443
- - Skip the execution completion check
444
- - Accept without running verification
445
- - Auto-accept without user confirmation
446
- - Skip handoff generation
447
-
448
- **DO:**
449
- - Verify every must-have has evidence
450
- - Present clear verification report
451
- - Require explicit "accept" keyword
452
- - Document any accepted issues
78
+ **DON'T:** Skip execution check, accept without verification, auto-accept
79
+ **DO:** Verify every must-have has evidence, require explicit "accept" keyword
453
80
 
454
81
  ---
455
82
 
456
- *Acceptance Protocol v0.1.4*
457
- *"Verify everything. Accept explicitly."*
83
+ *Load `goop_reference({ name: "accept-process" })` for full process details.*