opencode-goopspec 0.1.0

package/templates/research.md

@@ -0,0 +1,117 @@
+# Research: {Phase Name}
+
+**Domain:** {Identified domain}
+**Date:** {YYYY-MM-DD}
+**Sources:** {Count} expert resources analyzed
+
+## Executive Summary
+
+{2-3 sentences on key findings}
+
+## Standard Stack
+
+### Core Technologies
+
+| Category | Recommended | Alternatives | Notes |
+|----------|-------------|--------------|-------|
+| Framework | {Primary} | {Alt 1}, {Alt 2} | {Why} |
+| Database | {Primary} | {Alt 1} | {Why} |
+| Testing | {Primary} | {Alt 1} | {Why} |
+
+### Supporting Tools
+
+- {Tool 1} - {Purpose}
+- {Tool 2} - {Purpose}
+
+## Architecture Patterns
+
+### Recommended Pattern
+
+{Pattern name with brief description}
+
+**When to use:** {Criteria}
+**Tradeoffs:** {Pros/cons}
+
+### Project Structure
+
+```
+project/
+├── {directory}/     # {purpose}
+├── {directory}/     # {purpose}
+└── ...
+```
+
+## Common Pitfalls
+
+### Critical Issues
+
+1. **{Issue}** - {Description and consequence}
+   - **Prevention:** {How to avoid}
+
+### Performance Traps
+
+1. **{Trap}** - {Description}
+   - **Solution:** {Best practice}
+
+### Maintenance Concerns
+
+1. **{Concern}** - {Long-term impact}
+   - **Mitigation:** {Strategy}
+
+## Expert Resources
+
+### Official Documentation
+
+- [{Title}]({url}) - {Description}
+
+### Community Guides
+
+- [{Title}]({url}) - {Description}
+
+### Example Projects
+
+- [{Title}]({url}) - {What to learn from it}
+
+## Recommendations
+
+### Must Use
+
+- {Technology/pattern} - {Rationale}
+
+### Should Consider
+
+- {Technology/pattern} - {When it applies}
+
+### Avoid
+
+- {Technology/approach} - {Why}
+
+## Uncertainties
+
+Areas needing clarification:
+
+- {Question 1}
+- {Question 2}
+
+---
+
+## Memory Persistence
+
+Key findings to persist:
+
+### Facts
+{{#facts}}
+- {{fact}}
+{{/facts}}
+
+### Concepts
+{{#concepts}}
+- {{concept}}
+{{/concepts}}
+
+---
+
+*Research conducted by GoopSpec Intel Agents*
+*Synthesized from {{source_count}} sources*
+*Persisted to memory for future recall*
+*GoopSpec v0.1.0*

package/templates/retrospective.md

@@ -0,0 +1,188 @@
+# RETROSPECTIVE: {{milestone_name}}
+
+**Version:** {{version}}
+**Completed:** {{completed_date}}
+**Duration:** {{total_duration}}
+**Archived:** {{archived_date}}
+
+---
+
+## Summary
+
+{{summary}}
+
+**Key Achievement:** {{key_achievement}}
+
+---
+
+## Metrics
+
+| Metric | Planned | Actual | Variance |
+|--------|---------|--------|----------|
+| Waves | {{planned_waves}} | {{actual_waves}} | {{wave_variance}} |
+| Tasks | {{planned_tasks}} | {{actual_tasks}} | {{task_variance}} |
+| Duration | {{planned_duration}} | {{actual_duration}} | {{duration_variance}} |
+| Commits | — | {{total_commits}} | — |
+
+### Performance
+- **Average task time:** {{avg_task_time}}
+- **Fastest wave:** {{fastest_wave}}
+- **Slowest wave:** {{slowest_wave}}
+
+---
+
+## What Worked Well
+
+{{#worked_well}}
+### {{title}}
+{{description}}
+
+**Evidence:** {{evidence}}
+**Carry Forward:** {{carry_forward}}
+
+{{/worked_well}}
+
+---
+
+## What Didn't Work
+
+{{#didnt_work}}
+### {{title}}
+{{description}}
+
+**Impact:** {{impact}}
+**Root Cause:** {{root_cause}}
+**Prevention:** {{prevention}}
+
+{{/didnt_work}}
+
+---
+
+## Surprises
+
+Things we didn't anticipate:
+
+{{#surprises}}
+- **{{surprise}}**: {{how_handled}}
+{{/surprises}}
+
+---
+
+## Key Decisions
+
+Architectural and design choices made:
+
+{{#key_decisions}}
+### {{decision}}
+- **Context:** {{context}}
+- **Choice:** {{choice}}
+- **Alternatives:** {{alternatives}}
+- **Outcome:** {{outcome}}
+- **Would Choose Again:** {{would_choose_again}}
+{{/key_decisions}}
+
+---
+
+## Technical Debt Incurred
+
+{{#tech_debt}}
+- **{{item}}**
+  - Location: `{{location}}`
+  - Reason: {{reason}}
+  - Effort to fix: {{effort}}
+  - Priority: {{priority}}
+{{/tech_debt}}
+
+{{^tech_debt}}
+No significant technical debt incurred.
+{{/tech_debt}}
+
+---
+
+## Patterns Established
+
+Reusable patterns for future work:
+
+{{#patterns}}
+### {{name}}
+- **When to use:** {{when}}
+- **Implementation:** {{implementation}}
+- **Example:** `{{example_file}}`
+{{/patterns}}
+
+---
+
+## Tools & Libraries
+
+### Added
+{{#tools_added}}
+- **{{name}}** ({{version}}): {{purpose}} — {{verdict}}
+{{/tools_added}}
+
+### Removed
+{{#tools_removed}}
+- **{{name}}**: {{reason}}
+{{/tools_removed}}
+
+### Evaluated but Rejected
+{{#tools_rejected}}
+- **{{name}}**: {{reason}}
+{{/tools_rejected}}
+
+---
+
+## Team Notes
+
+### For Future Self
+{{#notes_future_self}}
+- {{note}}
+{{/notes_future_self}}
+
+### For Others
+{{#notes_others}}
+- {{note}}
+{{/notes_others}}
+
+---
+
+## Memory Extraction
+
+The following will be persisted to memory:
+
+### Facts
+{{#facts}}
+- {{fact}}
+{{/facts}}
+
+### Concepts
+{{#concepts}}
+- {{concept}}
+{{/concepts}}
+
+### Gotchas
+{{#gotchas}}
+- **{{gotcha}}**: {{solution}}
+{{/gotchas}}
+
+---
+
+## Archive Location
+
+```
+.goopspec/archive/{{version}}-{{slug}}/
+├── SPEC.md
+├── BLUEPRINT.md
+├── CHRONICLE.md
+├── RESEARCH.md
+├── RETROSPECTIVE.md   (this file)
+├── LEARNINGS.md       (extracted patterns)
+└── waves/
+    └── ...
+```
+
+---
+
+*Retrospective generated on milestone completion*
+*Learnings extracted and persisted to memory*
+*Search with: /goop-recall "{{milestone_name}}"*
+*GoopSpec v0.1.0*

package/templates/spec.md

@@ -0,0 +1,103 @@
+# SPEC: {{project_name}}
+
+**Version:** {{version}}
+**Created:** {{created_date}}
+**Last Updated:** {{updated_date}}
+**Status:** {{status}}
+
+---
+
+## Vision
+
+{{vision}}
+
+**Why this matters:** {{why}}
+
+---
+
+## Must-Haves (The Contract)
+
+These are non-negotiable. The spec is not complete until ALL must-haves are delivered.
+
+{{#must_haves}}
+- [ ] **{{title}}**: {{description}}
+{{/must_haves}}
+
+---
+
+## Nice-to-Haves
+
+These enhance the deliverable but are not required for acceptance.
+
+{{#nice_to_haves}}
+- [ ] **{{title}}**: {{description}}
+{{/nice_to_haves}}
+
+---
+
+## Out of Scope
+
+Explicitly excluded to prevent scope creep.
+
+{{#out_of_scope}}
+- {{item}}
+{{/out_of_scope}}
+
+---
+
+## Technical Constraints
+
+### Stack (Non-Negotiable)
+- **Runtime:** {{runtime}}
+- **Language:** {{language}}
+- **Framework:** {{framework}}
+- **Database:** {{database}}
+- **Testing:** {{testing}}
+
+### Conventions
+- **Files:** {{file_naming}}
+- **Components:** {{component_naming}}
+- **Functions:** {{function_naming}}
+- **Commits:** {{commit_format}}
+
+### Boundaries
+
+**Always Do:**
+{{#always}}
+- {{.}}
+{{/always}}
+
+**Ask First:**
+{{#ask_first}}
+- {{.}}
+{{/ask_first}}
+
+**Never Do:**
+{{#never}}
+- {{.}}
+{{/never}}
+
+---
+
+## Acceptance Criteria
+
+The spec is complete when:
+
+{{#acceptance_criteria}}
+1. {{.}}
+{{/acceptance_criteria}}
+
+---
+
+## Amendment History
+
+| Version | Date | Change | Approved By |
+|---------|------|--------|-------------|
+{{#amendments}}
+| {{version}} | {{date}} | {{change}} | {{approved_by}} |
+{{/amendments}}
+
+---
+
+*This specification is a CONTRACT. Changes require explicit amendment.*
+*GoopSpec v0.1.0*

package/templates/summary.md

@@ -0,0 +1,202 @@
+---
+phase: {{phase}}
+plan: {{plan}}
+subsystem: {{subsystem}}
+tags: {{tags}}
+requires: {{requires}}
+provides: {{provides}}
+affects: {{affects}}
+tech_stack: {{tech_stack}}
+key_files: {{key_files}}
+key_decisions: {{key_decisions}}
+patterns_established: {{patterns_established}}
+duration: {{duration}}
+completed: {{completed}}
+---
+
+# Phase {{phase}} Plan {{plan}} Summary: {{title}}
+
+**{{one_liner}}**
+
+## Performance
+
+- **Duration:** {{duration}} (e.g., 23 min, 1h 15m)
+- **Started:** {{started_timestamp}}
+- **Completed:** {{completed_timestamp}}
+- **Tasks:** {{task_count}} completed
+- **Files modified:** {{file_count}}
+
+## Accomplishments
+
+{{#accomplishments}}
+- {{.}}
+{{/accomplishments}}
+
+## Task Commits
+
+Each task was committed atomically:
+
+{{#task_commits}}
+1. **Task {{number}}: {{name}}** - `{{hash}}` ({{type}})
+{{/task_commits}}
+
+**Plan metadata:** {{plan_commit_hash}} (docs: complete plan)
+
+_Note: TDD tasks may have multiple commits (test → feat → refactor)_
+
+## Files Created/Modified
+
+{{#files_created}}
+- `{{path}}` - {{description}}
+{{/files_created}}
+
+{{#files_modified}}
+- `{{path}}` - {{description}}
+{{/files_modified}}
+
+## Decisions Made
+
+{{#decisions}}
+- **{{decision}}** - {{rationale}}
+{{/decisions}}
+
+{{^decisions}}
+None - followed plan as specified
+{{/decisions}}
+
+## Deviations from Plan
+
+{{#has_deviations}}
+### Auto-fixed Issues
+
+{{#deviations}}
+**{{number}}. [Rule {{rule}} - {{category}}] {{description}}**
+- **Found during:** Task {{task_number}} ({{task_name}})
+- **Issue:** {{issue_detail}}
+- **Fix:** {{fix_description}}
+- **Files modified:** {{files}}
+- **Verification:** {{verification}}
+- **Committed in:** {{commit_hash}} (part of task commit)
+
+{{/deviations}}
+
+---
+{{/has_deviations}}
+
+{{^has_deviations}}
+None - plan executed exactly as written
+{{/has_deviations}}
+
+## Technical Details
+
+### Stack Changes
+{{#tech_stack.added}}
+- Added: {{.}}
+{{/tech_stack.added}}
+
+{{#tech_stack.patterns}}
+- Patterns: {{.}}
+{{/tech_stack.patterns}}
+
+### Dependencies
+{{#dependencies_added}}
+- Added: `{{name}}` {{version}} - {{purpose}}
+{{/dependencies_added}}
+
+{{#dependencies_removed}}
+- Removed: `{{name}}` - {{reason}}
+{{/dependencies_removed}}
+
+## Verification Results
+
+{{#verification_results}}
+- [x] {{check}}
+{{/verification_results}}
+
+## Impact Assessment
+
+### Breaking Changes
+{{#breaking_changes}}
+- **{{change}}**: {{impact}} - {{mitigation}}
+{{/breaking_changes}}
+{{^breaking_changes}}
+None
+{{/breaking_changes}}
+
+### Migration Notes
+{{#migration_notes}}
+- {{note}}
+{{/migration_notes}}
+{{^migration_notes}}
+None required
+{{/migration_notes}}
+
+### Future Considerations
+{{#future_considerations}}
+- {{consideration}}
+{{/future_considerations}}
+{{^future_considerations}}
+None noted
+{{/future_considerations}}
+
+## Context for Future Plans
+
+### What This Plan Built
+{{#provides_list}}
+- {{.}}
+{{/provides_list}}
+
+### What Depends On This
+{{#affects_list}}
+- {{affected_phase}}: {{reason}}
+{{/affects_list}}
+
+### Key Files to Reference
+{{#key_files_reference}}
+- `{{path}}`: {{purpose}}
+{{/key_files_reference}}
+
+## Lessons Learned
+
+{{#lessons_learned}}
+- {{lesson}}
+{{/lessons_learned}}
+{{^lessons_learned}}
+None specifically noted
+{{/lessons_learned}}
+
+## Notes for Project Owner
+
+{{#owner_notes}}
+- {{note}}
+{{/owner_notes}}
+{{^owner_notes}}
+No specific notes
+{{/owner_notes}}
+
+---
+
+## Memory Persistence
+
+Learnings to persist from this task:
+
+### Patterns
+{{#patterns_learned}}
+- {{pattern}}
+{{/patterns_learned}}
+
+### Gotchas
+{{#gotchas_learned}}
+- {{gotcha}}
+{{/gotchas_learned}}
+
+---
+
+*Summary auto-generated by GoopSpec*
+*Learnings extracted and persisted to memory*
+
+**View blueprint:** `.goopspec/BLUEPRINT.md`
+**View chronicle:** `.goopspec/CHRONICLE.md`
+**Status:** Complete
+
+*GoopSpec v0.1.0*