opencode-goopspec 0.1.0

package/skills/verification/skill.md

@@ -0,0 +1,178 @@
+---
+name: verification
+description: Verify implementations against specifications
+category: review
+triggers:
+  - verify
+  - check
+  - validate
+  - audit
+version: 0.1.0
+requires:
+  - goop-core
+---
+
+# Verification Skill
+
+## Verification Philosophy
+
+Task completion ≠ Goal achievement
+
+Verify that the implementation:
+1. Does what the spec says
+2. Handles edge cases
+3. Meets quality standards
+4. Is maintainable
+
+## Verification Levels
+
+### Level 1: Syntax
+- Code compiles/transpiles
+- No linting errors
+- Types check
+
+### Level 2: Unit
+- Individual functions work
+- Edge cases handled
+- Errors thrown appropriately
+
+### Level 3: Integration
+- Components work together
+- Data flows correctly
+- State managed properly
+
+### Level 4: E2E
+- User flows complete
+- UI renders correctly
+- Performance acceptable
+
+### Level 5: Security
+- No vulnerabilities
+- Auth works correctly
+- Data protected
+
+## Verification Checklist
+
+### Code Quality
+- [ ] Follows project conventions
+- [ ] No unused code
+- [ ] No hardcoded values
+- [ ] Proper error handling
+- [ ] Logging in place
+
+### Functionality
+- [ ] All spec requirements met
+- [ ] Edge cases handled
+- [ ] Error states work
+- [ ] Happy path works
+
+### Tests
+- [ ] Tests exist for new code
+- [ ] Tests pass
+- [ ] Coverage acceptable
+- [ ] Tests are meaningful
+
+### Documentation
+- [ ] Code is self-documenting
+- [ ] Complex logic commented
+- [ ] API documented
+- [ ] README updated if needed
+
+## Must-Have Verification
+
+From SPEC.md must-haves:
+
+### Truths (Observable Behaviors)
+```markdown
+- [ ] User can log in with email/password
+- [ ] Invalid credentials show error
+- [ ] Session persists across refresh
+```
+
+### Artifacts (Required Files)
+```markdown
+| Path | Exists | Exports | Min Lines |
+|------|--------|---------|-----------|
+| src/auth/login.ts | ✓ | login() | 50 |
+```
+
+### Key Links (Connections)
+```markdown
+| From | To | Via | Verified |
+|------|-----|-----|----------|
+| login.ts | session.ts | createSession() | ✓ |
+```
+
+## Verification Commands
+
+```bash
+# Type checking
+npm run typecheck
+
+# Linting
+npm run lint
+
+# Unit tests
+npm test
+
+# Integration tests
+npm run test:integration
+
+# E2E tests
+npm run test:e2e
+
+# Build
+npm run build
+```
+
+## VERIFY.md Template
+
+```markdown
+# Verification: Phase {N}
+
+**Date:** {YYYY-MM-DD}
+**Verifier:** GoopSpec Verifier Agent
+
+## Summary
+{Pass/Fail with brief explanation}
+
+## Must-Haves
+
+### Truths
+| Behavior | Status | Notes |
+|----------|--------|-------|
+| User can log in | ✓ | Tested manually |
+
+### Artifacts
+| File | Status | Notes |
+|------|--------|-------|
+| src/auth/login.ts | ✓ | 75 lines |
+
+### Key Links
+| Connection | Status | Notes |
+|------------|--------|-------|
+| login → session | ✓ | createSession called |
+
+## Quality Checks
+
+| Check | Status |
+|-------|--------|
+| TypeScript | ✓ Pass |
+| ESLint | ✓ Pass |
+| Tests | ✓ 45/45 |
+| Build | ✓ Success |
+
+## Issues Found
+{List any issues or none}
+
+## Recommendations
+{Suggestions for improvement}
+```
+
+## Best Practices
+
+1. **Verify against spec** - Not against assumptions
+2. **Test boundaries** - Edge cases, limits, errors
+3. **Check behavior** - Not just code existence
+4. **Document findings** - Even if all passes
+5. **Be ruthless** - Better to catch issues now

package/skills/visual-regression/skill.md

@@ -0,0 +1,86 @@
+---
+name: visual-regression
+description: Detect unintended visual changes in UI through automated screenshot comparison.
+category: review
+triggers:
+  - visual regression
+  - screenshots
+  - ui testing
+  - diff
+version: 0.1.0
+---
+
+# Visual Regression Testing Skill
+
+## Purpose
+Detect unintended visual changes in UI through automated screenshot comparison.
+
+## How It Works
+
+1. Capture baseline screenshots of components/pages
+2. Run tests to capture new screenshots
+3. Compare against baselines pixel-by-pixel
+4. Flag differences for review
+5. Update baselines when changes are intentional
+
+## Tools
+
+### Playwright Visual Comparisons
+```typescript
+import { test, expect } from '@playwright/test';
+
+test('homepage visual regression', async ({ page }) => {
+  await page.goto('/');
+  await expect(page).toHaveScreenshot('homepage.png', {
+    maxDiffPixels: 100,
+    threshold: 0.2,
+  });
+});
+```
+
+### Percy/Chromatic Integration
+- Cloud-based visual testing
+- Cross-browser comparisons
+- Approval workflows
+
+## Best Practices
+
+### 1. Stable Tests
+- Wait for animations to complete
+- Use consistent viewport sizes
+- Mock dynamic content (dates, avatars)
+- Disable animations during tests
+
+### 2. Meaningful Baselines
+- Capture at key breakpoints
+- Include interactive states
+- Test light and dark themes
+
+### 3. Efficient Reviews
+- Set appropriate diff thresholds
+- Use component-level screenshots
+- Group related screenshots
+
+## Configuration
+
+```typescript
+// playwright.config.ts
+export default defineConfig({
+  expect: {
+    toHaveScreenshot: {
+      maxDiffPixels: 50,
+      threshold: 0.1,
+      animations: 'disabled',
+    },
+  },
+  use: {
+    viewport: { width: 1280, height: 720 },
+  },
+});
+```
+
+## When to Update Baselines
+
+- Intentional design changes
+- After reviewing and approving diffs
+- Never auto-update without review

package/templates/blueprint.md

@@ -0,0 +1,141 @@
+# BLUEPRINT: {{project_name}}
+
+**Spec Version:** {{spec_version}}
+**Created:** {{created_date}}
+**Mode:** {{mode}}
+
+---
+
+## Overview
+
+**Goal:** {{goal}}
+
+**Approach:** {{approach}}
+
+**Waves:** {{wave_count}}
+**Estimated Tasks:** {{task_count}}
+
+---
+
+## Wave Architecture
+
+```
+{{#waves}}
+Wave {{number}}: {{name}} {{#parallel}}(parallel){{/parallel}}{{^parallel}}(sequential){{/parallel}}
+{{#depends_on}}  └── depends on Wave {{.}}{{/depends_on}}
+{{/waves}}
+```
+
+---
+
+{{#waves}}
+## Wave {{number}}: {{name}}
+
+**Goal:** {{goal}}
+**Parallel:** {{#parallel}}Yes — tasks can run concurrently{{/parallel}}{{^parallel}}No — sequential execution{{/parallel}}
+{{#depends_on}}
+**Depends On:** Wave {{.}}
+{{/depends_on}}
+
+### Tasks
+
+{{#tasks}}
+### Task {{wave}}.{{number}}: {{name}}
+
+**Intent:** {{intent}}
+
+**Deliverables:**
+{{#deliverables}}
+- [ ] {{.}}
+{{/deliverables}}
+
+**Files:**
+{{#files}}
+- `{{.}}`
+{{/files}}
+
+**Verification:**
+```bash
+{{verification}}
+```
+
+**Acceptance:**
+{{acceptance}}
+
+{{#blocks}}
+**Blocks:** {{blocks}}
+{{/blocks}}
+
+---
+
+{{/tasks}}
+
+{{/waves}}
+
+## Verification Checklist
+
+Before marking complete:
+
+{{#verification_checklist}}
+- [ ] {{.}}
+{{/verification_checklist}}
+
+---
+
+## Must-Haves Traceability
+
+Mapping tasks to spec requirements:
+
+| Must-Have | Covered By |
+|-----------|------------|
+{{#must_have_mapping}}
+| {{must_have}} | Wave {{wave}}, Task {{task}} |
+{{/must_have_mapping}}
+
+---
+
+## Risk Assessment
+
+{{#risks}}
+### {{risk}}
+- **Likelihood:** {{likelihood}}
+- **Impact:** {{impact}}
+- **Mitigation:** {{mitigation}}
+{{/risks}}
+
+{{^risks}}
+No significant risks identified.
+{{/risks}}
+
+---
+
+## Execution Notes
+
+### For Orchestrator
+- Delegate ALL code tasks to executor agents
+- Track progress in CHRONICLE.md
+- Save to memory at wave boundaries
+- Confirm with user at CONTRACT GATES
+
+### For Subagents
+- Read SPEC.md for requirements
+- Check CHRONICLE.md for context
+- Use memory_search before decisions
+- Persist learnings with memory_save
+
+---
+
+## Deviation Protocol
+
+If you encounter issues:
+
+1. **Bug Found** → Auto-fix, document in CHRONICLE.md
+2. **Missing Functionality** → Auto-add if critical, document
+3. **Blocking Issue** → Auto-fix (deps, imports), document
+4. **Architectural Decision** → STOP, ask user, log to memory
+
+---
+
+*Blueprint derived from SPEC.md*
+*Execute with confidence — the plan is the contract*
+*GoopSpec v0.1.0*

package/templates/chronicle.md

@@ -0,0 +1,156 @@
+# CHRONICLE: {{project_name}}
+
+**Last Updated:** {{last_updated}}
+**Current Phase:** {{current_phase}}
+
+---
+
+## Journey Status
+
+```
+{{progress_bar}} {{progress_percent}}%
+```
+
+**Position:** {{position_description}}
+
+| Metric | Value |
+|--------|-------|
+| Waves Completed | {{waves_completed}}/{{waves_total}} |
+| Tasks Done | {{tasks_completed}} |
+| Time Invested | {{total_time}} |
+| Current Mode | {{mode}} |
+
+---
+
+## Current Wave
+
+### Wave {{current_wave}}: {{wave_name}}
+
+**Status:** {{wave_status}}
+**Started:** {{wave_started}}
+
+**Tasks:**
+{{#wave_tasks}}
+- [{{status}}] {{name}}
+{{/wave_tasks}}
+
+**Blockers:**
+{{#blockers}}
+- **[{{severity}}]** {{description}}
+{{/blockers}}
+{{^blockers}}
+None
+{{/blockers}}
+
+---
+
+## Recent Activity
+
+{{#recent_activity}}
+### {{timestamp}}
+- **Action:** {{action}}
+- **Outcome:** {{outcome}}
+{{#decision}}
+- **Decision:** {{decision}} — *Reason: {{reason}}*
+{{/decision}}
+{{/recent_activity}}
+
+---
+
+## Decisions Made
+
+Significant choices captured for future reference.
+
+{{#decisions}}
+### {{date}}: {{title}}
+- **Choice:** {{choice}}
+- **Alternatives:** {{alternatives}}
+- **Reasoning:** {{reasoning}}
+- **Impact:** {{impact}}
+{{/decisions}}
+
+{{^decisions}}
+No decisions recorded yet.
+{{/decisions}}
+
+---
+
+## Learnings
+
+Insights gained during this journey.
+
+{{#learnings}}
+- **{{topic}}:** {{insight}}
+{{/learnings}}
+
+{{^learnings}}
+No learnings captured yet.
+{{/learnings}}
+
+---
+
+## Checkpoints
+
+Saved positions for recovery.
+
+{{#checkpoints}}
+| ID | Phase | Wave | Created | Description |
+|----|-------|------|---------|-------------|
+| {{id}} | {{phase}} | {{wave}} | {{created}} | {{description}} |
+{{/checkpoints}}
+
+{{^checkpoints}}
+No checkpoints saved.
+{{/checkpoints}}
+
+---
+
+## Memory Integration
+
+### Recent Memory Entries
+{{#recent_memories}}
+- **[{{type}}]** {{title}} — {{created}}
+{{/recent_memories}}
+
+### Relevant Past Context
+{{#relevant_context}}
+- {{context}}
+{{/relevant_context}}
+
+---
+
+## Next Steps
+
+### Immediate
+{{#immediate_next}}
+1. {{.}}
+{{/immediate_next}}
+
+### After This Wave
+{{#after_wave}}
+- {{.}}
+{{/after_wave}}
+
+---
+
+## Quick Commands
+
+```bash
+# Check status
+/goop-status
+
+# Continue work
+/goop-execute
+
+# Save checkpoint
+/goop-checkpoint
+
+# Search past work
+/goop-recall "{{query}}"
+```
+
+---
+
+*Chronicle auto-updated by GoopSpec after each action*
+*This is your journey log — decisions persist, context flows*
+*GoopSpec v0.1.0*

package/templates/milestone.md

@@ -0,0 +1,131 @@
+# MILESTONE: {{milestone_name}}
+
+**Version:** {{version}}
+**Started:** {{started_date}}
+**Target:** {{target_date}}
+**Status:** {{status}}
+
+---
+
+## Milestone Goal
+
+{{goal}}
+
+**Definition of Done:**
+{{#definition_of_done}}
+- [ ] {{.}}
+{{/definition_of_done}}
+
+---
+
+## Progress
+
+```
+{{progress_bar}} {{progress_percent}}%
+```
+
+| Metric | Current | Target |
+|--------|---------|--------|
+| Waves | {{waves_completed}}/{{waves_total}} | {{waves_total}} |
+| Tasks | {{tasks_completed}} | {{tasks_total}} |
+| Time | {{time_spent}} | {{time_estimated}} |
+
+---
+
+## Waves in This Milestone
+
+{{#waves}}
+### Wave {{number}}: {{name}}
+
+**Status:** {{status}}
+**Tasks:** {{tasks_completed}}/{{tasks_total}}
+
+{{#completed}}
+**Completed:** {{completed_date}}
+**Summary:** {{summary}}
+{{/completed}}
+
+{{^completed}}
+**Next:** {{next_task}}
+{{/completed}}
+
+{{/waves}}
+
+---
+
+## Key Deliverables
+
+{{#deliverables}}
+- [{{status}}] **{{name}}**: {{description}}
+{{/deliverables}}
+
+---
+
+## Dependencies
+
+### External
+{{#external_deps}}
+- {{dependency}} — {{status}}
+{{/external_deps}}
+
+### Internal
+{{#internal_deps}}
+- Requires: {{requirement}} — {{status}}
+{{/internal_deps}}
+
+---
+
+## Decisions Log
+
+Significant decisions made during this milestone:
+
+{{#decisions}}
+| Date | Decision | Rationale |
+|------|----------|-----------|
+| {{date}} | {{decision}} | {{rationale}} |
+{{/decisions}}
+
+---
+
+## Blockers & Risks
+
+### Active Blockers
+{{#blockers}}
+- **[{{severity}}]** {{description}}
+  - **Impact:** {{impact}}
+  - **Resolution:** {{resolution}}
+{{/blockers}}
+{{^blockers}}
+None
+{{/blockers}}
+
+### Identified Risks
+{{#risks}}
+- **{{risk}}**: {{mitigation}}
+{{/risks}}
+
+---
+
+## On Completion
+
+When this milestone completes:
+
+1. Run `/goop-complete` to archive
+2. Generate RETROSPECTIVE.md
+3. Extract LEARNINGS.md → Memory
+4. Tag git: `git tag -a {{version}} -m "{{milestone_name}}"`
+5. Update project status
+
+---
+
+## Notes
+
+{{#notes}}
+- {{note}}
+{{/notes}}
+
+---
+
+*Milestone tracking by GoopSpec*
+*Complete milestones are archived with learnings extracted*
+*GoopSpec v0.1.0*