opencode-goopspec 0.1.2 → 0.1.4

package/templates/handoff.md

@@ -0,0 +1,140 @@
+# Session Handoff
+
+**Generated:** {{generated_timestamp}}
+**Phase:** {{current_phase}}
+**Session:** {{session_id}}
+
+---
+
+## Accomplished This Session
+
+### Completed Tasks
+{{#completed_tasks}}
+- [x] {{task_id}}: {{description}} {{#commit}}(commit: `{{commit}}`){{/commit}}
+{{/completed_tasks}}
+
+### Key Outcomes
+{{#key_outcomes}}
+- {{.}}
+{{/key_outcomes}}
+
+### Decisions Made
+{{#decisions}}
+- **{{title}}**: {{choice}} — {{rationale}}
+{{/decisions}}
+
+---
+
+## Current State
+
+### Workflow Position
+| Attribute | Value |
+|-----------|-------|
+| **Phase** | {{phase}} |
+| **Spec Locked** | {{spec_locked}} |
+| **Wave** | {{current_wave}} of {{total_waves}} |
+| **Task** | {{current_task}} of {{total_tasks}} |
+
+### Files Modified
+{{#files_modified}}
+- `{{path}}` — {{description}}
+{{/files_modified}}
+
+### Commits Made
+{{#commits}}
+- `{{sha}}` — {{message}}
+{{/commits}}
+
+---
+
+## Next Session Instructions
+
+### Command to Run
+```
+{{next_command}}
+```
+
+### Files to Read First
+{{#files_to_read}}
+1. `{{path}}` — {{reason}}
+{{/files_to_read}}
+
+### Context Summary
+
+{{context_summary}}
+
+### Immediate Next Task
+
+**Task:** {{next_task_id}} — {{next_task_name}}
+
+**Files:** 
+{{#next_task_files}}
+- `{{.}}`
+{{/next_task_files}}
+
+**Action:** {{next_task_action}}
+
+**Verify:** `{{next_task_verify}}`
+
+---
+
+## Warnings & Blockers
+
+### Active Blockers
+{{#blockers}}
+- **{{title}}**: {{description}}
+  - Type: {{type}}
+  - Resolution: {{resolution}}
+{{/blockers}}
+
+{{^blockers}}
+None — clear to proceed.
+{{/blockers}}
+
+### Gotchas Discovered
+{{#gotchas}}
+- {{.}}
+{{/gotchas}}
+
+{{^gotchas}}
+None discovered this session.
+{{/gotchas}}
+
+### Pending Decisions
+{{#pending_decisions}}
+- **{{title}}**: {{description}}
+  - Options: {{options}}
+  - Recommendation: {{recommendation}}
+{{/pending_decisions}}
+
+{{^pending_decisions}}
+None — no user input needed.
+{{/pending_decisions}}
+
+---
+
+## Memory Saved
+
+Key learnings persisted to memory this session:
+
+{{#memory_saved}}
+- **{{title}}** ({{type}}, importance: {{importance}})
+{{/memory_saved}}
+
+---
+
+## Resume Checklist
+
+For the next session:
+
+- [ ] Start new session for fresh context
+- [ ] Run: `{{next_command}}`
+- [ ] Read files listed above
+- [ ] Continue with immediate next task
+
+---
+
+*Start a new session for fresh 200k context window.*
+*All state is preserved in GoopSpec files.*
+
+*Session Handoff — GoopSpec v0.1.4*

package/templates/project.md

@@ -0,0 +1,114 @@
+# PROJECT: {{project_name}}
+
+**Type:** {{project_type}}
+**Created:** {{created_date}}
+**Status:** Active
+
+---
+
+## Vision
+
+{{vision_statement}}
+
+### Why This Matters
+{{why_it_matters}}
+
+### Target Users
+{{target_users}}
+
+---
+
+## Success Criteria
+
+When complete, we will have:
+
+{{#success_criteria}}
+- {{.}}
+{{/success_criteria}}
+
+---
+
+## Technical Foundation
+
+### Stack
+| Layer | Technology | Version |
+|-------|------------|---------|
+| Runtime | {{runtime}} | {{runtime_version}} |
+| Language | {{language}} | {{language_version}} |
+| Framework | {{framework}} | {{framework_version}} |
+| Database | {{database}} | {{database_version}} |
+| Testing | {{testing}} | {{testing_version}} |
+
+### Key Dependencies
+{{#dependencies}}
+- `{{name}}`: {{purpose}}
+{{/dependencies}}
+
+---
+
+## Conventions
+
+### Naming
+- **Files:** {{file_naming}}
+- **Functions:** {{function_naming}}
+- **Components:** {{component_naming}}
+- **Constants:** {{constant_naming}}
+
+### Code Style
+- **Exports:** {{export_style}}
+- **Types:** {{type_style}}
+- **Error Handling:** {{error_handling}}
+
+### Git
+- **Branch Format:** {{branch_format}}
+- **Commit Format:** {{commit_format}}
+- **PR Process:** {{pr_process}}
+
+---
+
+## Architecture Overview
+
+{{architecture_description}}
+
+### Directory Structure
+```
+{{directory_structure}}
+```
+
+### Key Integration Points
+{{#integration_points}}
+- **{{name}}:** {{description}}
+{{/integration_points}}
+
+---
+
+## Boundaries
+
+### Always Do
+{{#always_do}}
+- {{.}}
+{{/always_do}}
+
+### Ask First
+{{#ask_first}}
+- {{.}}
+{{/ask_first}}
+
+### Never Do
+{{#never_do}}
+- {{.}}
+{{/never_do}}
+
+---
+
+## Milestones
+
+| Milestone | Status | Target |
+|-----------|--------|--------|
+{{#milestones}}
+| {{name}} | {{status}} | {{target_date}} |
+{{/milestones}}
+
+---
+
+*Project foundation document - GoopSpec v0.1.4*

package/templates/requirements.md

@@ -0,0 +1,121 @@
+# REQUIREMENTS: {{feature_name}}
+
+**Generated:** {{generated_date}}
+**Interview Status:** {{interview_status}}
+**Ready for Planning:** {{ready_for_planning}}
+
+---
+
+## Vision
+
+{{vision_statement}}
+
+**Problem Solved:** {{problem_solved}}
+
+**Why Now:** {{why_now}}
+
+---
+
+## Must-Haves (The Contract)
+
+These are non-negotiable. The feature is incomplete without ALL of these:
+
+{{#must_haves}}
+- [ ] **{{id}}**: {{title}}
+  - {{description}}
+  - **Acceptance:** {{acceptance_criteria}}
+{{/must_haves}}
+
+---
+
+## Nice-to-Haves
+
+These enhance the deliverable but are not required for acceptance:
+
+{{#nice_to_haves}}
+- [ ] **{{id}}**: {{title}}
+  - {{description}}
+  - **Defer if:** {{defer_condition}}
+{{/nice_to_haves}}
+
+---
+
+## Out of Scope
+
+Explicitly excluded from this work:
+
+{{#out_of_scope}}
+- **{{item}}**: {{reason}}
+{{/out_of_scope}}
+
+---
+
+## Constraints
+
+### Technical Constraints
+{{#technical_constraints}}
+- {{.}}
+{{/technical_constraints}}
+
+### Practical Constraints
+{{#practical_constraints}}
+- {{.}}
+{{/practical_constraints}}
+
+### Integration Constraints
+{{#integration_constraints}}
+- **{{system}}:** {{constraint}}
+{{/integration_constraints}}
+
+---
+
+## Assumptions
+
+We are assuming the following to be true:
+
+{{#assumptions}}
+- **{{assumption}}**
+  - If false: {{impact}}
+{{/assumptions}}
+
+---
+
+## Risks & Mitigations
+
+| Risk | Impact | Likelihood | Mitigation |
+|------|--------|------------|------------|
+{{#risks}}
+| {{risk}} | {{impact}} | {{likelihood}} | {{mitigation}} |
+{{/risks}}
+
+---
+
+## Open Questions
+
+Questions that need answers before or during planning:
+
+{{#open_questions}}
+- [ ] **Q{{number}}:** {{question}}
+  - Status: {{status}}
+  - Answer: {{answer}}
+{{/open_questions}}
+
+---
+
+## Interview Checklist
+
+| Question | Answered |
+|----------|----------|
+| Vision defined | {{vision_answered}} |
+| Must-haves listed | {{must_haves_answered}} |
+| Constraints documented | {{constraints_answered}} |
+| Out of scope defined | {{out_of_scope_answered}} |
+| Assumptions listed | {{assumptions_answered}} |
+| Risks identified | {{risks_answered}} |
+
+**Interview Complete:** {{interview_complete}}
+
+---
+
+*Discovery interview output - GoopSpec v0.1.4*
+*Run `/goop-plan` when ready for planning.*

package/templates/spec.md

@@ -4,6 +4,8 @@
 **Created:** {{created_date}}
 **Last Updated:** {{updated_date}}
 **Status:** {{status}}
+**Locked:** {{locked}}
+{{#locked_at}}**Locked At:** {{locked_at}}{{/locked_at}}
 
 ---
 
@@ -13,6 +15,8 @@
 
 **Why this matters:** {{why}}
 
+**Target Users:** {{target_users}}
+
 ---
 
 ## Must-Haves (The Contract)
@@ -20,17 +24,27 @@
 These are non-negotiable. The spec is not complete until ALL must-haves are delivered.
 
 {{#must_haves}}
-- [ ] **{{title}}**: {{description}}
-{{/must_haves}}
+### MH{{number}}: {{title}}
+
+{{description}}
+
+**Acceptance Criteria:**
+{{#acceptance_criteria}}
+- [ ] {{.}}
+{{/acceptance_criteria}}
+
+**Traced To:** {{#traced_to}}Wave {{wave}}, Task {{task}}{{/traced_to}}{{^traced_to}}*Not yet mapped*{{/traced_to}}
 
 ---
+{{/must_haves}}
 
 ## Nice-to-Haves
 
 These enhance the deliverable but are not required for acceptance.
 
 {{#nice_to_haves}}
-- [ ] **{{title}}**: {{description}}
+- [ ] **NH{{number}}: {{title}}**: {{description}}
+  - Defer if: {{defer_condition}}
 {{/nice_to_haves}}
 
 ---
@@ -40,7 +54,7 @@ These enhance the deliverable but are not required for acceptance.
 Explicitly excluded to prevent scope creep.
 
 {{#out_of_scope}}
-- {{item}}
+- **{{item}}** — {{reason}}
 {{/out_of_scope}}
 
 ---
@@ -48,17 +62,21 @@ Explicitly excluded to prevent scope creep.
 ## Technical Constraints
 
 ### Stack (Non-Negotiable)
-- **Runtime:** {{runtime}}
-- **Language:** {{language}}
-- **Framework:** {{framework}}
-- **Database:** {{database}}
-- **Testing:** {{testing}}
+| Component | Technology | Version |
+|-----------|------------|---------|
+| Runtime | {{runtime}} | {{runtime_version}} |
+| Language | {{language}} | {{language_version}} |
+| Framework | {{framework}} | {{framework_version}} |
+| Database | {{database}} | {{database_version}} |
+| Testing | {{testing}} | {{testing_version}} |
 
 ### Conventions
-- **Files:** {{file_naming}}
-- **Components:** {{component_naming}}
-- **Functions:** {{function_naming}}
-- **Commits:** {{commit_format}}
+| Aspect | Standard |
+|--------|----------|
+| Files | {{file_naming}} |
+| Components | {{component_naming}} |
+| Functions | {{function_naming}} |
+| Commits | {{commit_format}} |
 
 ### Boundaries
 
@@ -79,25 +97,72 @@ Explicitly excluded to prevent scope creep.
 
 ---
 
+## Assumptions
+
+We are assuming:
+
+{{#assumptions}}
+- **{{assumption}}**
+  - If false: {{impact}}
+{{/assumptions}}
+
+---
+
+## Risks & Mitigations
+
+| Risk | Impact | Likelihood | Mitigation |
+|------|--------|------------|------------|
+{{#risks}}
+| {{risk}} | {{impact}} | {{likelihood}} | {{mitigation}} |
+{{/risks}}
+
+---
+
+## Traceability Matrix
+
+Every must-have maps to specific blueprint tasks:
+
+| Must-Have | Covered By | Status |
+|-----------|------------|--------|
+{{#traceability}}
+| MH{{mh_number}}: {{mh_title}} | Wave {{wave}}, Task {{task}} | {{status}} |
+{{/traceability}}
+
+**Coverage:** {{coverage_percentage}}% of must-haves mapped
+
+---
+
 ## Acceptance Criteria
 
 The spec is complete when:
 
-{{#acceptance_criteria}}
+{{#final_acceptance}}
 1. {{.}}
-{{/acceptance_criteria}}
+{{/final_acceptance}}
 
 ---
 
 ## Amendment History
 
-| Version | Date | Change | Approved By |
-|---------|------|--------|-------------|
+| Version | Date | Change | Impact | Approved By |
+|---------|------|--------|--------|-------------|
 {{#amendments}}
-| {{version}} | {{date}} | {{change}} | {{approved_by}} |
+| {{version}} | {{date}} | {{change}} | {{impact}} | {{approved_by}} |
 {{/amendments}}
 
 ---
 
-*This specification is a CONTRACT. Changes require explicit amendment.*
-*GoopSpec v0.1.0*
+## Verification Protocol
+
+Before acceptance, verify:
+
+- [ ] All must-haves pass acceptance criteria
+- [ ] All tests pass
+- [ ] No type errors
+- [ ] Security checklist reviewed
+- [ ] Documentation updated
+
+---
+
+*This specification is a CONTRACT. Changes require explicit amendment via `/goop-amend`.*
+*GoopSpec v0.1.4*

package/templates/state.md

@@ -0,0 +1,103 @@
+# Current State
+
+**Last Updated:** {{last_updated}}
+**Session:** {{session_id}}
+
+---
+
+## Workflow Position
+
+| Attribute | Value |
+|-----------|-------|
+| **Phase** | {{phase}} |
+| **Interview Complete** | {{interview_complete}} |
+| **Spec Locked** | {{spec_locked}} |
+| **Wave** | {{current_wave}} of {{total_waves}} |
+| **Task** | {{current_task}} of {{total_tasks}} |
+
+---
+
+## Quick Resume
+
+### Command to Run
+```
+{{next_command}}
+```
+
+### What's Next
+{{next_task_description}}
+
+### Files to Read
+{{#files_to_read}}
+1. `{{.}}`
+{{/files_to_read}}
+
+---
+
+## Progress Summary
+
+### Completed
+{{#completed_items}}
+- [x] {{.}}
+{{/completed_items}}
+
+### In Progress
+{{#in_progress_items}}
+- [ ] {{.}} ← **Current**
+{{/in_progress_items}}
+
+### Remaining
+{{#remaining_items}}
+- [ ] {{.}}
+{{/remaining_items}}
+
+---
+
+## Active Blockers
+
+{{#blockers}}
+### {{title}}
+- **Type:** {{type}}
+- **Impact:** {{impact}}
+- **Resolution:** {{resolution}}
+{{/blockers}}
+
+{{^blockers}}
+No active blockers.
+{{/blockers}}
+
+---
+
+## Pending Decisions
+
+{{#pending_decisions}}
+### {{title}}
+- **Context:** {{context}}
+- **Options:** {{options}}
+- **Recommendation:** {{recommendation}}
+{{/pending_decisions}}
+
+{{^pending_decisions}}
+No pending decisions.
+{{/pending_decisions}}
+
+---
+
+## Recent Activity
+
+| Time | Action | Agent |
+|------|--------|-------|
+{{#recent_activity}}
+| {{time}} | {{action}} | {{agent}} |
+{{/recent_activity}}
+
+---
+
+## Session Context
+
+{{session_context}}
+
+---
+
+*Human-readable state mirror - GoopSpec v0.1.4*
+*See also: state.json for machine-readable state*