gsd-opencode 1.10.2 → 1.20.0

package/get-shit-done/templates/VALIDATION.md

@@ -0,0 +1,104 @@
+---
+phase: {N}
+slug: {phase-slug}
+status: draft
+nyquist_compliant: false
+wave_0_complete: false
+created: {date}
+---
+
+# Phase {N} — Validation Strategy
+
+> Generated by `gsd-phase-researcher` during `/gsd-plan-phase {N}`.
+> Updated by `gsd-plan-checker` after plan approval.
+> Governs feedback sampling during `/gsd-execute-phase {N}`.
+
+---
+
+## Test Infrastructure
+
+| Property | Value |
+|----------|-------|
+| **Framework** | {pytest 7.x / jest 29.x / vitest / go test / other} |
+| **Config file** | {path/to/pytest.ini or "none — Wave 0 installs"} |
+| **Quick run command** | `{e.g., pytest -x --tb=short}` |
+| **Full suite command** | `{e.g., pytest tests/ --tb=short}` |
+| **Estimated runtime** | ~{N} seconds |
+| **CI pipeline** | {.github/workflows/test.yml — exists / needs creation} |
+
+---
+
+## Nyquist Sampling Rate
+
+> The minimum feedback frequency required to reliably catch errors in this phase.
+
+- **After every task commit:** Run `{quick run command}`
+- **After every plan wave:** Run `{full suite command}`
+- **Before `/gsd-verify-work`:** Full suite must be green
+- **Maximum acceptable task feedback latency:** {N} seconds
+
+---
+
+## Per-task Verification Map
+
+| task ID | Plan | Wave | Requirement | Test Type | Automated Command | File Exists | Status |
+|---------|------|------|-------------|-----------|-------------------|-------------|--------|
+| {N}-01-01 | 01 | 1 | REQ-{XX} | unit | `pytest tests/test_{module}.py::test_{name} -x` | ✅ / ❌ W0 | ⬜ pending |
+| {N}-01-02 | 01 | 1 | REQ-{XX} | integration | `pytest tests/test_{flow}.py -x` | ✅ / ❌ W0 | ⬜ pending |
+| {N}-02-01 | 02 | 2 | REQ-{XX} | smoke | `curl -s {endpoint} \| grep {expected}` | ✅ N/A | ⬜ pending |
+
+*Status values: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky*
+
+---
+
+## Wave 0 Requirements
+
+> Test scaffolding committed BEFORE any implementation task. Executor runs Wave 0 first.
+
+- [ ] `{tests/test_file.py}` — stubs for REQ-{XX}, REQ-{XX}
+- [ ] `{tests/conftest.py}` — shared fixtures
+- [ ] `{framework install}` — if no framework detected
+
+*If none required: "Existing infrastructure covers all phase requirements — no Wave 0 test tasks needed."*
+
+---
+
+## Manual-Only Verifications
+
+> Behaviors that genuinely cannot be automated, with justification.
+> These are surfaced during `/gsd-verify-work` UAT.
+
+| Behavior | Requirement | Why Manual | Test Instructions |
+|----------|-------------|------------|-------------------|
+| {behavior} | REQ-{XX} | {reason: visual, third-party auth, physical device...} | {step-by-step} |
+
+*If none: "All phase behaviors have automated verification coverage."*
+
+---
+
+## Validation Sign-Off
+
+Updated by `gsd-plan-checker` when plans are approved:
+
+- [ ] All tasks have `<automated>` verify commands or Wave 0 dependencies
+- [ ] No 3 consecutive implementation tasks without automated verify (sampling continuity)
+- [ ] Wave 0 test files cover all MISSING references
+- [ ] No watch-mode flags in any automated command
+- [ ] Feedback latency per task: < {N}s ✅
+- [ ] `nyquist_compliant: true` set in frontmatter
+
+**Plan-checker approval:** {pending / approved on YYYY-MM-DD}
+
+---
+
+## Execution Tracking
+
+Updated during `/gsd-execute-phase {N}`:
+
+| Wave | Tasks | Tests Run | Pass | Fail | Sampling Status |
+|------|-------|-----------|------|------|-----------------|
+| 0 | {N} | — | — | — | scaffold |
+| 1 | {N} | {command} | {N} | {N} | ✅ sampled |
+| 2 | {N} | {command} | {N} | {N} | ✅ sampled |
+
+**Phase validation complete:** {pending / YYYY-MM-DD HH:MM}

package/get-shit-done/templates/codebase/structure.md

@@ -15,7 +15,7 @@ Template for `.planning/codebase/STRUCTURE.md` - captures physical file organiza
 
 ## Directory Layout
 
-[ASCII tree of top-level directories with purpose]
+[ASCII box-drawing tree of top-level directories with purpose - use ├── └── │ characters for tree structure only]
 
 ```
 [project-root]/
@@ -127,7 +127,7 @@ get-shit-done/
 ├── bin/                # Executable entry points
 ├── commands/           # Slash command definitions
 │   └── gsd/           # GSD-specific commands
-├── get-shit-done/     # Skill resources
+├── get-shit-done/     # skill resources
 │   ├── references/    # Principle documents
 │   ├── templates/     # File templates
 │   └── workflows/     # Multi-step procedures
@@ -186,14 +186,14 @@ get-shit-done/
 
 **Documentation:**
 - `README.md` - User-facing installation and usage guide
-- `CLAUDE.md` - Instructions for OpenCode when working in this repo
+- `OPENCODE.md` - Instructions for OpenCode when working in this repo
 
 ## Naming Conventions
 
 **Files:**
 - kebab-case.md: Markdown documents
 - kebab-case.js: JavaScript source files
-- UPPERCASE.md: Important project files (README, CLAUDE, CHANGELOG)
+- UPPERCASE.md: Important project files (README, OPENCODE, CHANGELOG)
 
 **Directories:**
 - kebab-case: All directories
@@ -247,7 +247,7 @@ get-shit-done/
 
 <guidelines>
 **What belongs in STRUCTURE.md:**
-- Directory layout (ASCII tree)
+- Directory layout (ASCII box-drawing tree for structure visualization)
 - Purpose of each directory
 - Key file locations (entry points, configs, core logic)
 - Naming conventions
@@ -267,7 +267,7 @@ get-shit-done/
 - Locate entry points, configs, and main logic areas
 - Keep directory tree concise (max 2-3 levels)
 
-**ASCII tree format:**
+**Tree format (ASCII box-drawing characters for structure only):**
 ```
 root/
 ├── dir1/           # Purpose

package/get-shit-done/templates/config.json

@@ -0,0 +1,37 @@
+{
+  "mode": "interactive",
+  "depth": "standard",
+  "workflow": {
+    "research": true,
+    "plan_check": true,
+    "verifier": true,
+    "auto_advance": false,
+    "nyquist_validation": false
+  },
+  "planning": {
+    "commit_docs": true,
+    "search_gitignored": false
+  },
+  "parallelization": {
+    "enabled": true,
+    "plan_level": true,
+    "task_level": false,
+    "skip_checkpoints": true,
+    "max_concurrent_agents": 3,
+    "min_plans_for_parallel": 2
+  },
+  "gates": {
+    "confirm_project": true,
+    "confirm_phases": true,
+    "confirm_roadmap": true,
+    "confirm_breakdown": true,
+    "confirm_plan": true,
+    "execute_next_plan": true,
+    "issues_review": true,
+    "confirm_transition": true
+  },
+  "safety": {
+    "always_confirm_destructive": true,
+    "always_confirm_external_services": true
+  }
+}

package/get-shit-done/templates/context.md

@@ -1,6 +1,6 @@
 # Phase Context Template
 
-Template for `.planning/phases/XX-name/{phase}-CONTEXT.md` - captures implementation decisions for a phase.
+Template for `.planning/phases/XX-name/{phase_num}-CONTEXT.md` - captures implementation decisions for a phase.
 
 **Purpose:** Document decisions that downstream agents need. Researcher uses this to know WHAT to investigate. Planner uses this to know WHAT choices are locked vs flexible.
 
@@ -275,16 +275,8 @@ The output should answer: "What does the researcher need to investigate? What ch
 - "Fast and responsive"
 - "Easy to use"
 
-**Sections explained:**
-
-- **Domain** — The scope anchor. Copied/derived from ROADMAP.md. Fixed boundary.
-- **Decisions** — Organized by areas discussed (NOT predefined categories). Section headers come from the actual discussion — "Layout style", "Flag design", "Grouping criteria", etc.
-- **OpenCode's Discretion** — Explicit acknowledgment of what OpenCode can decide during implementation.
-- **Specifics** — Product references, examples, "like X but..." statements.
-- **Deferred** — Ideas captured but explicitly out of scope. Prevents scope creep while preserving good ideas.
-
 **After creation:**
-- File lives in phase directory: `.planning/phases/XX-name/{phase}-CONTEXT.md`
+- File lives in phase directory: `.planning/phases/XX-name/{phase_num}-CONTEXT.md`
 - `gsd-phase-researcher` uses decisions to focus investigation
 - `gsd-planner` uses decisions + research to create executable tasks
 - Downstream agents should NOT need to ask the user again about captured decisions

package/get-shit-done/templates/continue-here.md

@@ -20,17 +20,17 @@ last_updated: 2025-01-15T14:30:00Z
 <completed_work>
 [What got done this session - be specific]
 
-- Task 1: [name] - Done
-- Task 2: [name] - Done
-- Task 3: [name] - In progress, [what's done on it]
+- task 1: [name] - Done
+- task 2: [name] - Done
+- task 3: [name] - In progress, [what's done on it]
 </completed_work>
 
 <remaining_work>
 [What's left in this phase]
 
-- Task 3: [name] - [what's left to do]
-- Task 4: [name] - Not started
-- Task 5: [name] - Not started
+- task 3: [name] - [what's left to do]
+- task 4: [name] - Not started
+- task 5: [name] - Not started
 </remaining_work>
 
 <decisions_made>

package/get-shit-done/templates/debug-subagent-prompt.md

@@ -53,7 +53,7 @@ Create: .planning/debug/{slug}.md
 
 **From /gsd-debug:**
 ```python
-Task(
+task(
   prompt=filled_template,
   subagent_type="gsd-debugger",
   description="Debug {slug}"
@@ -62,7 +62,7 @@ Task(
 
 **From diagnose-issues (UAT):**
 ```python
-Task(prompt=template, subagent_type="gsd-debugger", description="Debug UAT-001")
+task(prompt=template, subagent_type="gsd-debugger", description="Debug UAT-001")
 ```
 
 ---

package/get-shit-done/templates/discovery.md

@@ -35,7 +35,7 @@ Output: DISCOVERY.md with recommendation
 
 <discovery_scope>
 <include>
-- [Question to answer]
+- [question to answer]
 - [Area to investigate]
 - [Specific comparison if needed]
 </include>
@@ -51,21 +51,21 @@ Output: DISCOVERY.md with recommendation
 **Source Priority:**
 1. **Context7 MCP** - For library/framework documentation (current, authoritative)
 2. **Official Docs** - For platform-specific or non-indexed libraries
-3. **webfetch** - For comparisons, trends, community patterns (verify all findings)
+3. **websearch** - For comparisons, trends, community patterns (verify all findings)
 
 **Quality Checklist:**
 Before completing discovery, verify:
 - [ ] All claims have authoritative sources (Context7 or official docs)
 - [ ] Negative claims ("X is not possible") verified with official documentation
-- [ ] API syntax/configuration from Context7 or official docs (never webfetch alone)
-- [ ] webfetch findings cross-checked with authoritative sources
+- [ ] API syntax/configuration from Context7 or official docs (never websearch alone)
+- [ ] websearch findings cross-checked with authoritative sources
 - [ ] Recent updates/changelogs checked for breaking changes
 - [ ] Alternative approaches considered (not just first solution found)
 
 **Confidence Levels:**
 - HIGH: Context7 or official docs confirm
-- MEDIUM: webfetch + Context7/official docs confirm
-- LOW: webfetch only or training knowledge only (mark for validation)
+- MEDIUM: websearch + Context7/official docs confirm
+- LOW: websearch only or training knowledge only (mark for validation)
 
 </discovery_protocol>
 

package/get-shit-done/templates/milestone-archive.md

@@ -39,7 +39,7 @@ Plans:
 
 **For decimal phases, include (INSERTED) marker:**
 
-### Phase 2.1: Critical Security Patch (INSERTED)
+### Phase 2.1: Critical Security patch (INSERTED)
 
 **Goal**: Fix authentication bypass vulnerability
 **Depends on**: Phase 2
@@ -47,7 +47,7 @@ Plans:
 
 Plans:
 
-- [x] 02.1-01: Patch auth vulnerability
+- [x] 02.1-01: patch auth vulnerability
 
 **Details:**
 {{PHASE_DETAILS_FROM_ROADMAP}}
@@ -58,7 +58,7 @@ Plans:
 
 **Decimal Phases:**
 
-- Phase 2.1: Critical Security Patch (inserted after Phase 2 for urgent fix)
+- Phase 2.1: Critical Security patch (inserted after Phase 2 for urgent fix)
 - Phase 5.1: Performance Hotfix (inserted after Phase 5 for production issue)
 
 **Key Decisions:**

package/get-shit-done/templates/phase-prompt.md

@@ -20,6 +20,7 @@ wave: N                     # Execution wave (1, 2, 3...). Pre-computed at plan
 depends_on: []              # Plan IDs this plan requires (e.g., ["01-01"]).
 files_modified: []          # Files this plan modifies.
 autonomous: true            # false if plan has checkpoints requiring user interaction
+requirements: []            # REQUIRED — Requirement IDs from ROADMAP this plan addresses. MUST NOT be empty.
 user_setup: []              # Human-required setup OpenCode cannot automate (see below)
 
 # Goal-backward verification (derived during planning, verified after execution)
@@ -60,7 +61,7 @@ Output: [What artifacts will be created]
 <tasks>
 
 <task type="auto">
-  <name>Task 1: [Action-oriented name]</name>
+  <name>task 1: [Action-oriented name]</name>
   <files>path/to/file.ext, another/file.ext</files>
   <action>[Specific implementation - what to do, how to do it, what to avoid and WHY]</action>
   <verify>[Command or check to prove it worked]</verify>
@@ -68,7 +69,7 @@ Output: [What artifacts will be created]
 </task>
 
 <task type="auto">
-  <name>Task 2: [Action-oriented name]</name>
+  <name>task 2: [Action-oriented name]</name>
   <files>path/to/file.ext</files>
   <action>[Specific implementation]</action>
   <verify>[Command or check]</verify>
@@ -129,6 +130,7 @@ After completion, create `.planning/phases/XX-name/{phase}-{plan}-SUMMARY.md`
 | `depends_on` | Yes | Array of plan IDs this plan requires. |
 | `files_modified` | Yes | Files this plan touches. |
 | `autonomous` | Yes | `true` if no checkpoints, `false` if has checkpoints |
+| `requirements` | Yes | **MUST** list requirement IDs from ROADMAP. Every roadmap requirement MUST appear in at least one plan. |
 | `user_setup` | No | Array of human-required setup items (external services) |
 | `must_haves` | Yes | Goal-backward verification criteria (see below) |
 
@@ -272,7 +274,7 @@ See `~/.config/opencode/get-shit-done/references/tdd.md` for TDD plan structure.
 
 ---
 
-## Task Types
+## task Types
 
 | Type | Use For | Autonomy |
 |------|---------|----------|
@@ -320,7 +322,7 @@ Output: User model, API endpoints, and UI components.
 
 <tasks>
 <task type="auto">
-  <name>Task 1: Create User model</name>
+  <name>task 1: Create User model</name>
   <files>src/features/user/model.ts</files>
   <action>Define User type with id, email, name, createdAt. Export TypeScript interface.</action>
   <verify>tsc --noEmit passes</verify>
@@ -328,7 +330,7 @@ Output: User model, API endpoints, and UI components.
 </task>
 
 <task type="auto">
-  <name>Task 2: Create User API endpoints</name>
+  <name>task 2: Create User API endpoints</name>
   <files>src/features/user/api.ts</files>
   <action>GET /users (list), GET /users/:id (single), POST /users (create). Use User type from model.</action>
   <verify>curl tests pass for all endpoints</verify>
@@ -386,7 +388,7 @@ Output: Working dashboard component.
 
 <tasks>
 <task type="auto">
-  <name>Task 1: Build Dashboard layout</name>
+  <name>task 1: Build Dashboard layout</name>
   <files>src/components/Dashboard.tsx</files>
   <action>Create responsive grid with UserList and ProductList components. Use Tailwind for styling.</action>
   <verify>npm run build succeeds</verify>
@@ -553,7 +555,7 @@ must_haves:
 
 **Why this matters:**
 
-Task completion ≠ Goal achievement. A task "create chat component" can complete by creating a placeholder. The `must_haves` field captures what must actually work, enabling verification to catch gaps before they compound.
+task completion ≠ Goal achievement. A task "create chat component" can complete by creating a placeholder. The `must_haves` field captures what must actually work, enabling verification to catch gaps before they compound.
 
 **Verification flow:**
 

package/get-shit-done/templates/planner-subagent-prompt.md

@@ -22,14 +22,14 @@ Template for spawning gsd-planner agent. The agent contains all planning experti
 @.planning/REQUIREMENTS.md
 
 **Phase Context (if exists):**
-@.planning/phases/{phase_dir}/{phase}-CONTEXT.md
+@.planning/phases/{phase_dir}/{phase_num}-CONTEXT.md
 
 **Research (if exists):**
-@.planning/phases/{phase_dir}/{phase}-RESEARCH.md
+@.planning/phases/{phase_dir}/{phase_num}-RESEARCH.md
 
 **Gap Closure (if --gaps mode):**
-@.planning/phases/{phase_dir}/{phase}-VERIFICATION.md
-@.planning/phases/{phase_dir}/{phase}-UAT.md
+@.planning/phases/{phase_dir}/{phase_num}-VERIFICATION.md
+@.planning/phases/{phase_dir}/{phase_num}-UAT.md
 
 </planning_context>
 
@@ -70,7 +70,7 @@ Before returning PLANNING COMPLETE:
 
 **From /gsd-plan-phase (standard mode):**
 ```python
-Task(
+task(
   prompt=filled_template,
   subagent_type="gsd-planner",
   description="Plan Phase {phase}"
@@ -79,7 +79,7 @@ Task(
 
 **From /gsd-plan-phase --gaps (gap closure mode):**
 ```python
-Task(
+task(
   prompt=filled_template,  # with mode: gap_closure
   subagent_type="gsd-planner",
   description="Plan gaps for Phase {phase}"

package/get-shit-done/templates/research-project/ARCHITECTURE.md

@@ -177,7 +177,7 @@ src/
 <guidelines>
 
 **System Overview:**
-- Use ASCII diagrams for clarity
+- Use ASCII box-drawing diagrams for clarity (├── └── │ ─ for structure visualization only)
 - Show major components and their relationships
 - Don't over-detail — this is conceptual, not implementation
 

package/get-shit-done/templates/research.md

@@ -1,6 +1,6 @@
 # Research Template
 
-Template for `.planning/phases/XX-name/{phase}-RESEARCH.md` - comprehensive ecosystem research before planning.
+Template for `.planning/phases/XX-name/{phase_num}-RESEARCH.md` - comprehensive ecosystem research before planning.
 
 **Purpose:** Document what OpenCode needs to know to implement a phase well - not just "which library" but "how do experts build this."
 
@@ -15,6 +15,29 @@ Template for `.planning/phases/XX-name/{phase}-RESEARCH.md` - comprehensive ecos
 **Domain:** [primary technology/problem domain]
 **Confidence:** [HIGH/MEDIUM/LOW]
 
+<user_constraints>
+## User Constraints (from CONTEXT.md)
+
+**CRITICAL:** If CONTEXT.md exists from /gsd-discuss-phase, copy locked decisions here verbatim. These MUST be honored by the planner.
+
+### Locked Decisions
+[Copy from CONTEXT.md `## Decisions` section - these are NON-NEGOTIABLE]
+- [Decision 1]
+- [Decision 2]
+
+### OpenCode's Discretion
+[Copy from CONTEXT.md - areas where researcher/planner can choose]
+- [Area 1]
+- [Area 2]
+
+### Deferred Ideas (OUT OF SCOPE)
+[Copy from CONTEXT.md - do NOT research or plan these]
+- [Deferred 1]
+- [Deferred 2]
+
+**If no CONTEXT.md exists:** write "No user constraints - all decisions at OpenCode's discretion"
+</user_constraints>
+
 <research_summary>
 ## Summary
 
@@ -170,12 +193,12 @@ What's changed recently:
 
 Things that couldn't be fully resolved:
 
-1. **[Question]**
+1. **[question]**
    - What we know: [partial info]
    - What's unclear: [the gap]
    - Recommendation: [how to handle during planning/execution]
 
-2. **[Question]**
+2. **[question]**
    - What we know: [partial info]
    - What's unclear: [the gap]
    - Recommendation: [how to handle]
@@ -189,10 +212,10 @@ Things that couldn't be fully resolved:
 - [Official docs URL] - [what was checked]
 
 ### Secondary (MEDIUM confidence)
-- [webfetch verified with official source] - [finding + verification]
+- [websearch verified with official source] - [finding + verification]
 
 ### Tertiary (LOW confidence - needs validation)
-- [webfetch only] - [finding, marked for validation during implementation]
+- [websearch only] - [finding, marked for validation during implementation]
 </sources>
 
 <metadata>
@@ -524,6 +547,6 @@ function useVehicleControls(rigidBodyRef) {
 - Code examples can be referenced in task actions
 
 **After creation:**
-- File lives in phase directory: `.planning/phases/XX-name/{phase}-RESEARCH.md`
+- File lives in phase directory: `.planning/phases/XX-name/{phase_num}-RESEARCH.md`
 - Referenced during planning workflow
 - plan-phase loads it automatically when present

package/get-shit-done/templates/roadmap.md

@@ -29,7 +29,7 @@ Decimal phases appear between their surrounding integers in numeric order.
 ### Phase 1: [Name]
 **Goal**: [What this phase delivers]
 **Depends on**: Nothing (first phase)
-**Requirements**: [REQ-01, REQ-02, REQ-03]
+**Requirements**: [REQ-01, REQ-02, REQ-03]  <!-- brackets optional, parser handles both formats -->
 **Success Criteria** (what must be TRUE):
   1. [Observable behavior from user perspective]
   2. [Observable behavior from user perspective]

package/get-shit-done/templates/state.md

@@ -174,33 +174,3 @@ It's a DIGEST, not an archive. If accumulated context grows too large:
 The goal is "read once, know where we are" — if it's too long, that fails.
 
 </size_constraint>
-
-<guidelines>
-
-**When created:**
-- During project initialization (after ROADMAP.md)
-- Reference PROJECT.md (extract core value and current focus)
-- Initialize empty sections
-
-**When read:**
-- Every workflow starts by reading STATE.md
-- Then read PROJECT.md for full context
-- Provides instant context restoration
-
-**When updated:**
-- After each plan execution (update position, note decisions, update issues/blockers)
-- After phase transitions (update progress bar, clear resolved blockers, refresh project reference)
-
-**Size management:**
-- Keep under 100 lines total
-- Recent decisions only in STATE.md (full log in PROJECT.md)
-- Keep only active blockers
-
-**Sections:**
-- Project Reference: Pointer to PROJECT.md with core value
-- Current Position: Where we are now (phase, plan, status)
-- Performance Metrics: Velocity tracking
-- Accumulated Context: Recent decisions, pending todos, blockers
-- Session Continuity: Resume information
-
-</guidelines>

package/get-shit-done/templates/summary-complex.md

@@ -0,0 +1,59 @@
+---
+phase: XX-name
+plan: YY
+subsystem: [primary category]
+tags: [searchable tech]
+requires:
+  - phase: [prior phase]
+    provides: [what that phase built]
+provides:
+  - [bullet list of what was built/delivered]
+affects: [list of phase names or keywords]
+tech-stack:
+  added: [libraries/tools]
+  patterns: [architectural/code patterns]
+key-files:
+  created: [important files created]
+  modified: [important files modified]
+key-decisions:
+  - "Decision 1"
+patterns-established:
+  - "Pattern 1: description"
+duration: Xmin
+completed: YYYY-MM-DD
+---
+
+# Phase [X]: [Name] Summary (Complex)
+
+**[Substantive one-liner describing outcome]**
+
+## Performance
+- **Duration:** [time]
+- **Tasks:** [count completed]
+- **Files modified:** [count]
+
+## Accomplishments
+- [Key outcome 1]
+- [Key outcome 2]
+
+## task Commits
+1. **task 1: [task name]** - `hash`
+2. **task 2: [task name]** - `hash`
+3. **task 3: [task name]** - `hash`
+
+## Files Created/Modified
+- `path/to/file.ts` - What it does
+- `path/to/another.ts` - What it does
+
+## Decisions Made
+[Key decisions with brief rationale]
+
+## Deviations from Plan (Auto-fixed)
+[Detailed auto-fix records per GSD deviation rules]
+
+## Issues Encountered
+[Problems during planned work and resolutions]
+
+## Next Phase Readiness
+[What's ready for next phase]
+[Blockers or concerns]

package/get-shit-done/templates/summary-minimal.md

@@ -0,0 +1,41 @@
+---
+phase: XX-name
+plan: YY
+subsystem: [primary category]
+tags: [searchable tech]
+provides:
+  - [bullet list of what was built/delivered]
+affects: [list of phase names or keywords]
+tech-stack:
+  added: [libraries/tools]
+  patterns: [architectural/code patterns]
+key-files:
+  created: [important files created]
+  modified: [important files modified]
+key-decisions: []
+duration: Xmin
+completed: YYYY-MM-DD
+---
+
+# Phase [X]: [Name] Summary (Minimal)
+
+**[Substantive one-liner describing outcome]**
+
+## Performance
+- **Duration:** [time]
+- **Tasks:** [count]
+- **Files modified:** [count]
+
+## Accomplishments
+- [Most important outcome]
+- [Second key accomplishment]
+
+## task Commits
+1. **task 1: [task name]** - `hash`
+2. **task 2: [task name]** - `hash`
+
+## Files Created/Modified
+- `path/to/file.ts` - What it does
+
+## Next Phase Readiness
+[Ready for next phase]