gsd-opencode 1.3.33 → 1.4.2

package/get-shit-done/templates/checkpoint-return.md

@@ -0,0 +1,204 @@
+# Checkpoint Return Template
+
+Structured format for subagent checkpoint returns. Enables orchestrator to spawn continuation agents without relying on resume.
+
+---
+
+## Template
+
+```markdown
+## CHECKPOINT REACHED
+
+**Type:** [human-verify | decision | human-action]
+**Plan:** {phase}-{plan}
+**Progress:** {completed}/{total} tasks complete
+
+### Completed Tasks
+
+| Task | Name | Commit | Files |
+|------|------|--------|-------|
+| 1 | [task name] | [hash] | [key files created/modified] |
+| 2 | [task name] | [hash] | [key files created/modified] |
+
+### Current Task
+
+**Task {N}:** [task name]
+**Status:** [blocked | awaiting verification | awaiting decision]
+**Blocked by:** [specific blocker - auth required, user verification needed, decision needed]
+
+### Checkpoint Details
+
+[Checkpoint-specific content based on type - see below]
+
+### Awaiting
+
+[What user needs to do/provide]
+```
+
+---
+
+## Checkpoint Type Details
+
+### For human-verify
+
+```markdown
+### Checkpoint Details
+
+**What was built:**
+[Description of completed work]
+
+**How to verify:**
+1. [Step 1 - exact command/URL]
+2. [Step 2 - what to check]
+3. [Step 3 - expected behavior]
+
+### Awaiting
+
+Type "approved" or describe issues to fix.
+```
+
+### For human-action
+
+```markdown
+### Checkpoint Details
+
+**Automation attempted:**
+[What Claude tried to do]
+
+**Error encountered:**
+[Exact error message or auth failure]
+
+**What you need to do:**
+1. [Step 1]
+2. [Step 2]
+
+**I'll verify after:**
+[How Claude will confirm completion]
+
+### Awaiting
+
+Type "done" when complete.
+```
+
+### For decision
+
+```markdown
+### Checkpoint Details
+
+**Decision needed:**
+[What's being decided]
+
+**Context:**
+[Why this matters]
+
+**Options:**
+
+| Option | Pros | Cons |
+|--------|------|------|
+| [option-a] | [benefits] | [tradeoffs] |
+| [option-b] | [benefits] | [tradeoffs] |
+
+### Awaiting
+
+Select: [option-a | option-b | ...]
+```
+
+---
+
+## Why This Structure
+
+**Completed Tasks table:** Orchestrator knows exactly what's done. Fresh agent won't redo work.
+
+**Commit hashes:** Verification that work was committed. Fresh agent can check git log.
+
+**Files column:** Quick reference for what exists. Fresh agent can verify state.
+
+**Current Task + Blocked by:** Precise continuation point. Fresh agent knows exactly where to pick up.
+
+**Checkpoint Details:** User-facing content. Orchestrator presents this directly.
+
+---
+
+## Example: Auth Gate
+
+```markdown
+## CHECKPOINT REACHED
+
+**Type:** human-action
+**Plan:** 01-01
+**Progress:** 1/3 tasks complete
+
+### Completed Tasks
+
+| Task | Name | Commit | Files |
+|------|------|--------|-------|
+| 1 | Initialize Next.js 15 project | d6fe73f | package.json, tsconfig.json, next.config.js, app/ |
+
+### Current Task
+
+**Task 2:** Initialize Convex backend
+**Status:** blocked
+**Blocked by:** Convex CLI authentication required
+
+### Checkpoint Details
+
+**Automation attempted:**
+Ran `npx convex dev` to initialize Convex backend
+
+**Error encountered:**
+"Error: Not authenticated. Run `npx convex login` first."
+
+**What you need to do:**
+1. Run: `npx convex login`
+2. Complete browser authentication
+3. Run: `npx convex dev`
+4. Create project named "convex-saas-community" when prompted
+
+**I'll verify after:**
+`cat .env.local | grep CONVEX` returns the Convex URL
+
+### Awaiting
+
+Type "done" when Convex is authenticated and project created.
+```
+
+---
+
+## Example: Visual Verification
+
+```markdown
+## CHECKPOINT REACHED
+
+**Type:** human-verify
+**Plan:** 03-02
+**Progress:** 2/3 tasks complete
+
+### Completed Tasks
+
+| Task | Name | Commit | Files |
+|------|------|--------|-------|
+| 1 | Create dashboard layout | a1b2c3d | src/app/dashboard/layout.tsx, src/components/Sidebar.tsx |
+| 2 | Add responsive navigation | e4f5g6h | src/components/NavBar.tsx, src/styles/nav.css |
+
+### Current Task
+
+**Task 3:** Verify responsive behavior
+**Status:** awaiting verification
+**Blocked by:** Human visual verification required
+
+### Checkpoint Details
+
+**What was built:**
+Responsive dashboard with collapsible sidebar navigation
+
+**How to verify:**
+1. Run: `npm run dev`
+2. Visit: http://localhost:3000/dashboard
+3. Desktop (>1024px): Sidebar visible on left, content on right
+4. Tablet (768px): Sidebar collapses to icons
+5. Mobile (375px): Sidebar hidden, hamburger menu appears
+
+### Awaiting
+
+Type "approved" or describe issues to fix.
+```

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

@@ -124,7 +124,7 @@ Template for `.planning/codebase/ARCHITECTURE.md` - captures conceptual code org
 **Command Layer:**
 - Purpose: Parse user input and route to appropriate handler
 - Contains: Command definitions, argument parsing, help text
-- Location: `src/commands/*.ts`
+- Location: `src/command/*.ts`
 - Depends on: Service layer for business logic
 - Used by: CLI entry point (`src/index.ts`)
 
@@ -148,7 +148,7 @@ Template for `.planning/codebase/ARCHITECTURE.md` - captures conceptual code org
 
 1. User runs: `gsd new-project`
 2. Commander parses args and flags
-3. Command handler invoked (`src/commands/new-project.ts`)
+3. Command handler invoked (`src/command/new-project.ts`)
 4. Handler calls service methods (`src/services/project.ts` → `create()`)
 5. Service reads templates, processes files, writes output
 6. Results logged to console
@@ -168,7 +168,7 @@ Template for `.planning/codebase/ARCHITECTURE.md` - captures conceptual code org
 
 **Command:**
 - Purpose: CLI command definition
-- Examples: `src/commands/new-project.ts`, `src/commands/plan-phase.ts`
+- Examples: `src/command/new-project.ts`, `src/command/plan-phase.ts`
 - Pattern: Commander.js command registration
 
 **Template:**
@@ -184,7 +184,7 @@ Template for `.planning/codebase/ARCHITECTURE.md` - captures conceptual code org
 - Responsibilities: Register commands, parse args, display help
 
 **Commands:**
-- Location: `src/commands/*.ts`
+- Location: `src/command/*.ts`
 - Triggers: Matched command from CLI
 - Responsibilities: Validate input, call services, format output
 

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

@@ -306,5 +306,5 @@ Template for `.planning/codebase/CONCERNS.md` - captures known issues and areas
 - Planning refactoring work
 
 **How this gets populated:**
-Explore agents detect these during codebase mapping. Manual additions welcome for human-discovered issues. This is living documentation, not a complaint list.
+explore agents detect these during codebase mapping. Manual additions welcome for human-discovered issues. This is living documentation, not a complaint list.
 </guidelines>

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

@@ -125,7 +125,7 @@ Template for `.planning/codebase/STRUCTURE.md` - captures physical file organiza
 ```
 get-shit-done/
 ├── bin/                # Executable entry points
-├── commands/           # Slash command definitions
+├── command/           # Slash command definitions
 │   └── gsd/           # GSD-specific commands
 ├── get-shit-done/     # Skill resources
 │   ├── references/    # Principle documents
@@ -145,8 +145,8 @@ get-shit-done/
 - Key files: install.js - handles npx installation
 - Subdirectories: None
 
-**commands/gsd/**
-- Purpose: Slash command definitions for Claude Code
+**command/gsd/**
+- Purpose: Slash command definitions for OpenCode
 - Contains: *.md files (one per command)
 - Key files: new-project.md, plan-phase.md, execute-plan.md
 - Subdirectories: None (flat structure)
@@ -166,7 +166,7 @@ get-shit-done/
 **get-shit-done/workflows/**
 - Purpose: Reusable multi-step procedures
 - Contains: Workflow definitions called by commands
-- Key files: execute-phase.md, research-phase.md
+- Key files: execute-plan.md, research-phase.md
 - Subdirectories: None
 
 ## Key File Locations
@@ -186,7 +186,7 @@ get-shit-done/
 
 **Documentation:**
 - `README.md` - User-facing installation and usage guide
-- `CLAUDE.md` - Instructions for Claude Code when working in this repo
+- `CLAUDE.md` - Instructions for OpenCode when working in this repo
 
 ## Naming Conventions
 
@@ -197,7 +197,7 @@ get-shit-done/
 
 **Directories:**
 - kebab-case: All directories
-- Plural for collections: templates/, commands/, workflows/
+- Plural for collections: templates/, command/, workflows/
 
 **Special Patterns:**
 - {command-name}.md: Slash command definition
@@ -206,8 +206,8 @@ get-shit-done/
 ## Where to Add New Code
 
 **New Slash Command:**
-- Primary code: `commands/gsd/{command-name}.md`
-- Tests: `tests/commands/{command-name}.test.js` (if testing implemented)
+- Primary code: `command/gsd/{command-name}.md`
+- Tests: `tests/command/{command-name}.test.js` (if testing implemented)
 - Documentation: Update `README.md` with new command
 
 **New Template:**
@@ -220,7 +220,7 @@ get-shit-done/
 
 **New Reference Document:**
 - Implementation: `get-shit-done/references/{name}.md`
-- Usage: Reference from commands/workflows as needed
+- Usage: Reference from command/workflows as needed
 
 **Utilities:**
 - No utilities yet (`install.js` is monolithic)
@@ -233,8 +233,8 @@ get-shit-done/
 - Source: Copied by bin/install.js during installation
 - Committed: Yes (source of truth)
 
-**commands/**
-- Purpose: Slash commands installed to ~/.config/opencode/commands/
+**command/**
+- Purpose: Slash commands installed to ~/.config/opencode/command/
 - Source: Copied by bin/install.js during installation
 - Committed: Yes (source of truth)
 

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

@@ -1,6 +1,14 @@
 {
   "mode": "interactive",
   "depth": "standard",
+  "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,

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

@@ -32,17 +32,6 @@ Template for `.planning/phases/XX-name/{phase}-CONTEXT.md` - captures the user's
 
 </essential>
 
-<boundaries>
-## What's Out of Scope
-
-[Explicit exclusions for this phase. What are we NOT building? Where does this phase end and the next begin?]
-
-- [Not doing X - that's Phase Y]
-- [Not including Z - deferred]
-- [Explicitly excluding W]
-
-</boundaries>
-
 <specifics>
 ## Specific Ideas
 
@@ -91,16 +80,6 @@ The main thing is seeing their active projects and what needs attention. Think o
 
 </essential>
 
-<boundaries>
-## What's Out of Scope
-
-- Team features (shared dashboards, permissions) - that's a future milestone
-- Analytics/reporting - just show what needs attention, not graphs
-- Customizable layouts - keep it simple, one good layout
-- Mobile optimization - desktop first for now
-
-</boundaries>
-
 <specifics>
 ## Specific Ideas
 

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

@@ -0,0 +1,235 @@
+# Continuation Prompt Template
+
+Template for spawning fresh agent to continue plan execution after checkpoint resolution.
+
+---
+
+## Template
+
+```markdown
+<objective>
+Continue executing plan {plan_number} of phase {phase_number}-{phase_name}.
+
+**DO NOT REDO completed tasks.** They are already committed. Start from the resume point below.
+
+Commit each remaining task atomically. Create SUMMARY.md when all tasks complete. Update STATE.md.
+</objective>
+
+<completed_tasks>
+The following tasks are ALREADY DONE. Do not repeat them.
+
+{completed_tasks_table}
+
+**Verify before continuing:** Check that these commits exist with `git log --oneline -5`
+</completed_tasks>
+
+<resume_point>
+**Resume from:** Task {resume_task_number} - {resume_task_name}
+**Status:** {resume_status}
+**User response:** {user_response}
+
+{resume_instructions}
+</resume_point>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/execute-plan.md
+@~/.config/opencode/get-shit-done/templates/summary.md
+@~/.config/opencode/get-shit-done/references/checkpoints.md
+@~/.config/opencode/get-shit-done/references/tdd.md
+</execution_context>
+
+<context>
+Plan: @{plan_path}
+Project state: @.planning/STATE.md
+Config: @.planning/config.json (if exists)
+</context>
+
+<checkpoint_behavior>
+If you hit another checkpoint, return using the format in:
+@~/.config/opencode/get-shit-done/templates/checkpoint-return.md
+
+Include ALL completed tasks (both previous and new) in the Completed Tasks table.
+</checkpoint_behavior>
+
+<completion_format>
+When plan completes successfully, return:
+
+## PLAN COMPLETE
+
+**Plan:** {phase}-{plan}
+**Tasks:** {total}/{total}
+**SUMMARY:** {path to SUMMARY.md}
+
+**Commits:**
+- {hash}: {message}
+...
+
+Include commits from both previous execution and this continuation.
+</completion_format>
+
+<success_criteria>
+- [ ] Verified previous commits exist (did not redo work)
+- [ ] Remaining tasks executed
+- [ ] Each new task committed individually
+- [ ] SUMMARY.md created in plan directory (covers ALL tasks)
+- [ ] STATE.md updated with position and decisions
+</success_criteria>
+```
+
+---
+
+## Placeholders
+
+| Placeholder | Source | Example |
+|-------------|--------|---------|
+| `{phase_number}` | Checkpoint return | `01` |
+| `{phase_name}` | Checkpoint return | `foundation` |
+| `{plan_number}` | Checkpoint return | `01` |
+| `{plan_path}` | Original prompt | `.planning/phases/01-foundation/01-01-PLAN.md` |
+| `{completed_tasks_table}` | Checkpoint return | Markdown table of completed tasks |
+| `{resume_task_number}` | Checkpoint return | `2` |
+| `{resume_task_name}` | Checkpoint return | `Initialize Convex backend` |
+| `{resume_status}` | Derived from checkpoint type | `User completed authentication` |
+| `{user_response}` | User input | `done` or `approved` or `option-a` |
+| `{resume_instructions}` | Derived from checkpoint type | See below |
+
+---
+
+## Resume Instructions by Checkpoint Type
+
+### After human-action (e.g., auth gate)
+
+```markdown
+**Resume from:** Task 2 - Initialize Convex backend
+**Status:** User completed authentication
+**User response:** done
+
+The user has completed the manual action. Verify it worked, then continue:
+1. Verify: `cat .env.local | grep CONVEX` shows Convex URL
+2. If verified: Continue with remaining Task 2 steps (if any), then Task 3
+3. If not verified: Report what's missing, create new checkpoint
+```
+
+### After human-verify (e.g., visual check)
+
+```markdown
+**Resume from:** Task 3 - Verify responsive behavior
+**Status:** User approved verification
+**User response:** approved
+
+User confirmed the implementation is correct. Continue to next task.
+```
+
+Or if issues reported:
+
+```markdown
+**Resume from:** Task 3 - Verify responsive behavior
+**Status:** User reported issues
+**User response:** "Sidebar overlaps content on tablet view"
+
+Fix the reported issues:
+1. Address: "Sidebar overlaps content on tablet view"
+2. After fixing, re-present the verification checkpoint
+```
+
+### After decision
+
+```markdown
+**Resume from:** Task 4 - Select authentication provider
+**Status:** User made decision
+**User response:** clerk
+
+Proceed with the selected option (Clerk). Implement accordingly.
+```
+
+---
+
+## Example: Continuation After Auth Gate
+
+```markdown
+<objective>
+Continue executing plan 01 of phase 01-foundation.
+
+**DO NOT REDO completed tasks.** They are already committed. Start from the resume point below.
+
+Commit each remaining task atomically. Create SUMMARY.md when all tasks complete. Update STATE.md.
+</objective>
+
+<completed_tasks>
+The following tasks are ALREADY DONE. Do not repeat them.
+
+| Task | Name | Commit | Files |
+|------|------|--------|-------|
+| 1 | Initialize Next.js 15 project | d6fe73f | package.json, tsconfig.json, next.config.js, app/ |
+
+**Verify before continuing:** Check that these commits exist with `git log --oneline -5`
+</completed_tasks>
+
+<resume_point>
+**Resume from:** Task 2 - Initialize Convex backend
+**Status:** User completed authentication
+**User response:** done
+
+The user has completed the manual action. Verify it worked, then continue:
+1. Verify: `cat .env.local | grep CONVEX` shows Convex URL
+2. If verified: Continue with remaining Task 2 steps (create schema, verify deployment), then Task 3
+3. If not verified: Report what's missing, create new checkpoint
+</resume_point>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/execute-plan.md
+@~/.config/opencode/get-shit-done/templates/summary.md
+@~/.config/opencode/get-shit-done/references/checkpoints.md
+@~/.config/opencode/get-shit-done/references/tdd.md
+</execution_context>
+
+<context>
+Plan: @.planning/phases/01-foundation/01-01-PLAN.md
+Project state: @.planning/STATE.md
+</context>
+
+<checkpoint_behavior>
+If you hit another checkpoint, return using the format in:
+@~/.config/opencode/get-shit-done/templates/checkpoint-return.md
+
+Include ALL completed tasks (both previous and new) in the Completed Tasks table.
+</checkpoint_behavior>
+
+<completion_format>
+When plan completes successfully, return:
+
+## PLAN COMPLETE
+
+**Plan:** 01-01
+**Tasks:** 3/3
+**SUMMARY:** .planning/phases/01-foundation/01-01-SUMMARY.md
+
+**Commits:**
+- d6fe73f: feat(01-01): initialize Next.js 15 with TypeScript and Tailwind
+- [new]: feat(01-01): initialize Convex backend with schema
+- [new]: feat(01-01): integrate Clerk authentication
+</completion_format>
+
+<success_criteria>
+- [ ] Verified previous commits exist (did not redo work)
+- [ ] Remaining tasks executed
+- [ ] Each new task committed individually
+- [ ] SUMMARY.md created in plan directory (covers ALL tasks)
+- [ ] STATE.md updated with position and decisions
+</success_criteria>
+```
+
+---
+
+## Usage
+
+Orchestrator fills placeholders from checkpoint return and user response:
+
+```python
+Task(
+    prompt=filled_continuation_template,
+    subagent_type="general"
+)
+```
+
+Fresh agent loads @-references, verifies completed work, continues from resume point.

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

@@ -47,7 +47,7 @@ Plans:
 
 Plans:
 
-- [x] 2.1-01: Patch auth vulnerability
+- [x] 02.1-01: Patch auth vulnerability
 
 **Details:**
 {{PHASE_DETAILS_FROM_ROADMAP}}