opencode-starterkit 1.0.1

package/baseline/memory/_templates/tasks.md

@@ -0,0 +1,198 @@
+# Implementation Tasks
+
+**Bead:** [bead-id]
+**Spec:** [link to spec]
+**Date:** [YYYY-MM-DD]
+
+---
+
+## Task Metadata
+
+Each task can have these optional fields in YAML frontmatter:
+
+```yaml
+---
+id: "1.1" # Task identifier
+depends_on: [] # Task IDs that must complete first
+parallel: true # Can run concurrently with other parallel tasks
+conflicts_with: [] # Task IDs that modify same files (cannot parallelize)
+files: [] # Files this task will modify
+estimated_minutes: 30 # Time estimate for planning
+---
+```
+
+---
+
+## 1. Setup
+
+### 1.1 [Prerequisite task]
+
+```yaml
+depends_on: []
+parallel: false
+files: ["package.json", "tsconfig.json"]
+```
+
+- [ ] [Task description]
+
+### 1.2 [Environment or config task]
+
+```yaml
+depends_on: ["1.1"]
+parallel: false
+files: [".env.example"]
+```
+
+- [ ] [Task description]
+
+---
+
+## 2. Core Implementation
+
+### 2.1 [Primary implementation task]
+
+```yaml
+depends_on: ["1.1", "1.2"]
+parallel: true
+conflicts_with: []
+files: ["src/feature/index.ts"]
+```
+
+- [ ] [Task description]
+
+### 2.2 [Secondary implementation task]
+
+```yaml
+depends_on: ["1.1", "1.2"]
+parallel: true
+conflicts_with: []
+files: ["src/feature/utils.ts"]
+```
+
+- [ ] [Task description]
+
+### 2.3 [Integration task]
+
+```yaml
+depends_on: ["2.1", "2.2"]
+parallel: false
+conflicts_with: []
+files: ["src/feature/index.ts", "src/feature/utils.ts"]
+```
+
+- [ ] [Task description]
+
+---
+
+## 3. Testing
+
+### 3.1 [Unit test task]
+
+```yaml
+depends_on: ["2.1"]
+parallel: true
+files: ["tests/feature.test.ts"]
+```
+
+- [ ] [Task description]
+
+### 3.2 [Integration test task]
+
+```yaml
+depends_on: ["2.3"]
+parallel: true
+files: ["tests/integration/feature.test.ts"]
+```
+
+- [ ] [Task description]
+
+### 3.3 [Edge case verification]
+
+```yaml
+depends_on: ["3.1", "3.2"]
+parallel: false
+files: []
+```
+
+- [ ] [Task description]
+
+---
+
+## 4. Documentation
+
+### 4.1 [Code comments / JSDoc]
+
+```yaml
+depends_on: ["2.3"]
+parallel: true
+files: ["src/feature/*.ts"]
+```
+
+- [ ] [Task description]
+
+### 4.2 [README updates]
+
+```yaml
+depends_on: ["2.3"]
+parallel: true
+files: ["README.md"]
+```
+
+- [ ] [Task description]
+
+---
+
+## 5. Verification
+
+### 5.1 All tests pass
+
+```yaml
+depends_on: ["3.1", "3.2", "3.3"]
+parallel: false
+```
+
+- [ ] `[test command]`
+
+### 5.2 Lint clean
+
+```yaml
+depends_on: ["2.3", "4.1"]
+parallel: true
+```
+
+- [ ] `[lint command]`
+
+### 5.3 Build succeeds
+
+```yaml
+depends_on: ["5.1", "5.2"]
+parallel: false
+```
+
+- [ ] `[build command]`
+
+---
+
+## Dependency Graph
+
+Visualize task flow (auto-generated from above):
+
+```
+1.1 ──┬──> 2.1 ──┬──> 2.3 ──┬──> 3.2 ──┬──> 5.1 ──> 5.3
+     │         │         │         │
+1.2 ──┘   2.2 ──┘    3.1 ──┘    5.2 ──┘
+                      │
+                 4.1 ──┘
+                 4.2
+```
+
+**Legend:**
+
+- `──>` = depends_on (sequential)
+- Tasks at same level with `parallel: true` = can run concurrently
+
+---
+
+## Notes
+
+<!-- Implementation notes, gotchas, or decisions made during task creation -->

package/baseline/memory/_templates/tech-stack.md

@@ -0,0 +1,85 @@
+---
+purpose: Tech stack, constraints, and integrations for AI context injection
+updated: 2026-02-01
+---
+
+# Tech Stack
+
+This file is automatically injected into ALL AI prompts via `opencode.json` instructions[].
+
+## Framework & Language
+
+- **Framework:** [e.g., Next.js 15, React 19]
+- **Language:** TypeScript (strict mode)
+- **Runtime:** [e.g., Node.js 22, Bun 1.x]
+
+## Styling & UI
+
+- **CSS:** [e.g., Tailwind CSS v4]
+- **Components:** [e.g., shadcn/ui, Radix Primitives]
+- **Design System:** [e.g., Custom tokens in tailwind.config.ts]
+
+## Data & State
+
+- **Database:** [e.g., PostgreSQL via Supabase]
+- **ORM:** [e.g., Drizzle, Prisma]
+- **State Management:** [e.g., Zustand, React Query]
+- **API Style:** [e.g., REST, tRPC, GraphQL]
+
+## Testing
+
+- **Unit Tests:** [e.g., Vitest]
+- **E2E Tests:** [e.g., Playwright]
+- **Coverage Target:** [e.g., 80%]
+
+## Key Constraints
+
+- [Constraint 1: e.g., Must work offline]
+- [Constraint 2: e.g., WCAG 2.1 AA compliance required]
+- [Constraint 3: e.g., Bundle size < 500KB]
+
+## Active Integrations
+
+- [Service 1: e.g., Stripe for payments]
+- [Service 2: e.g., Resend for email]
+- [Service 3: e.g., Sentry for error tracking]
+
+## Context Budget Guidelines
+
+**Quality Degradation Rule:** Target ~50% context per plan execution for consistent quality.
+
+| Task Complexity | Max Tasks/Plan | Typical Context Usage |
+| --------------- | -------------- | --------------------- |
+| Simple (CRUD)   | 3              | ~30-45%               |
+| Complex (auth)  | 2              | ~40-50%               |
+| Very complex    | 1-2            | ~30-50%               |
+
+**Split Signals:**
+
+- More than 3 tasks → Create child plans
+- Multiple subsystems → Separate plans
+- > 5 file modifications per task → Split
+- Discovery + implementation → Split
+
+## Verification Commands
+
+**Always run before claiming complete:**
+
+```bash
+# Type checking
+[typecheck command, e.g., npm run typecheck]
+
+# Linting
+[lint command, e.g., npm run lint]
+
+# Testing
+[test command, e.g., npm test]
+
+# Building
+[build command, e.g., npm run build]
+```
+
+---
+
+_Update this file when tech stack or constraints change._
+_AI will capture architecture, conventions, and gotchas via the `observation` tool as it works._

package/baseline/memory/_templates/user.md

@@ -0,0 +1,26 @@
+---
+purpose: User identity, preferences, communication style
+updated: 2024-12-21
+---
+
+# User Profile
+
+## Identity
+
+<!-- Name, role, git contributor identity -->
+
+## Communication Preferences
+
+<!-- Concise vs detailed, tone preferences -->
+
+## Workflow Preferences
+
+<!-- Preferred tools, testing habits, review style -->
+
+## Technical Preferences
+
+<!-- Languages, frameworks, patterns they favor -->
+
+## Things to Remember
+
+<!-- Personal quirks, pet peeves, preferences learned -->

package/baseline/memory/project/gotchas.md

@@ -0,0 +1,67 @@
+---
+purpose: Footguns, edge cases, and warnings discovered during development
+updated: 2026-02-12
+---
+
+# Gotchas
+
+Track unexpected behaviors, edge cases, and warnings here. Update when you hit something surprising.
+
+## LLM Coding (Harness Problem)
+
+The edit tool (`str_replace`) is the #1 source of failures in LLM coding. Models fail at reproducing content with exact whitespace/encoding, not at understanding tasks.
+
+### Edit Tool Failures
+
+- **Whitespace mismatch** — Tabs vs spaces, trailing spaces, line endings (CRLF vs LF)
+- **Content changed** — File modified since last read
+- **Multiple matches** — Same string appears twice, edit fails
+- **Stale context** — Editing from memory instead of fresh read
+
+### Mitigation Strategies
+
+1. **Always read fresh** before editing — no assumptions
+2. **Use LSP tools** to locate symbols precisely (goToDefinition, findReferences)
+3. **Include unique context** — 2-3 lines before/after for uniqueness
+4. **Prefer smaller files** — <400 lines reduces edit complexity
+5. **Verify after edit** — read back to confirm success
+
+### File Size Guidance
+
+| Size          | Strategy                                   |
+| ------------- | ------------------------------------------ |
+| < 100 lines   | Full rewrite often easier than str_replace |
+| 100-400 lines | Structured edit with good context          |
+| > 400 lines   | Strongly prefer structured edits           |
+
+**Use the `structured-edit` skill for reliable edits.**
+
+### Context Hygiene
+
+- Compress completed work phases before moving on
+- Use `/dcp sweep` after a closed phase to remove stale noise
+- Token budget: <50k start → 50-100k mid → >150k restart session
+- Subagent outputs can leak tokens — compress completed phases and sweep stale subagent noise
+
+## OpenCode Config
+
+- **`compaction` key invalid**: Not in official schema at opencode.ai/config.json. Remove if present.
+- **`experimental` key invalid**: Not in schema. Remove if present.
+- **`tools` key invalid**: Not in schema. Remove if present.
+- **`formatter` valid but undocumented**: Works but missing from schema (schema incomplete).
+
+## Memory System
+
+- Subagents (explore, scout, review) should NOT write to memory - only leader agents
+- Use `observation: false` and `memory-update: false` in agent configs to enforce
+
+## Build System
+
+- `dist/` is generated - never edit directly
+- Build copies `.opencode/` to `dist/template/` via rsync
+- Run `npm run build` to regenerate
+
+## Beads
+
+- Only leader agents (build, plan) should modify beads state
+- Subagents read with `br show <id>`, report findings back

package/baseline/memory/project/project.md

@@ -0,0 +1,92 @@
+---
+purpose: Project vision, success criteria, and core principles
+updated: 2026-02-12
+---
+
+# OpenCodeKit
+
+## Vision
+
+A project scaffolding tool that generates OpenCode-ready project templates.
+
+OpenCodeKit (`ock`) enables developers to bootstrap AI-assisted development environments with all essential configurations, skills, commands, and integrations pre-configured and validated.
+
+## Success Criteria
+
+- [ ] Users can `ock init` and get a working OpenCode project in under 60 seconds
+- [ ] Generated projects include all essential files (AGENTS.md, skills, commands, memory)
+- [ ] 100% of generated templates pass validation (typecheck, lint)
+- [ ] Templates are customizable through CLI prompts or config
+- [ ] Integration with beads for task tracking works out-of-the-box
+
+## Target Users
+
+### Primary
+
+- **Solo developers** setting up AI-assisted workflows for personal projects
+- **Teams** standardizing their OpenCode configuration across multiple projects
+
+### User Needs
+
+- Quick setup without manual configuration
+- Consistent, validated project structures
+- Customizable templates for different use cases
+- Integrated task tracking from day one
+
+## Core Principles
+
+1. **Convention over configuration** - Sensible defaults, minimal setup required
+2. **Minimal but complete** - Include only essential files, no bloat
+3. **Extensible** - Easy to add custom skills, commands, and templates
+4. **Validated by default** - All generated projects pass typecheck and lint
+5. **Git-backed** - All state and tracking integrated with git workflow
+
+## Tech Stack
+
+- **Runtime:** Node.js >= 20.19.0
+- **Language:** TypeScript (ESNext, strict mode)
+- **Build:** tsdown + rsync for template bundling
+- **CLI Framework:** cac
+- **UI Prompts:** @clack/prompts
+- **Validation:** zod
+- **Task Tracking:** beads_rust (br)
+
+## Current Phase
+
+**Scale** - Core complete, adding advanced features.
+
+See [roadmap.md](./roadmap.md) for phase details and [state.md](./state.md) for current position.
+
+## Architecture
+
+```
+src/
+├── index.ts          # CLI entry point
+├── commands/         # CLI commands (init, etc.)
+├── utils/            # Shared utilities
+└── validation/       # Validation scripts
+
+dist/
+├── index.js          # Built CLI
+└── template/         # Bundled .opencode/ template
+
+.opencode/
+├── agent/            # Agent definitions
+├── command/          # OpenCode commands
+├── skill/            # Reusable skills
+├── tool/             # Custom tools
+└── memory/           # Project memory
+```
+
+## Key Files
+
+| File          | Purpose                     |
+| ------------- | --------------------------- |
+| AGENTS.md     | Project rules for AI agents |
+| package.json  | Dependencies and scripts    |
+| build.ts      | Build configuration         |
+| tsconfig.json | TypeScript configuration    |
+
+---
+
+_Update this file when vision, success criteria, or principles change._

package/baseline/memory/project/roadmap.md

@@ -0,0 +1,142 @@
+---
+purpose: Project roadmap with phases, milestones, and bead organization
+updated: 2026-02-12
+---
+
+# Roadmap
+
+## Overview
+
+| Phase  | Goal                                              | Status      | Beads |
+| ------ | ------------------------------------------------- | ----------- | ----- |
+| MVP    | Core `ock init` command with basic template       | Complete    | [#]   |
+| Extend | Additional commands (`/ship`, `/plan`, `/resume`) | Complete    | [#]   |
+| Polish | Error handling, docs, validation improvements     | Complete    | [#]   |
+| Scale  | Plugin system, custom templates, advanced config  | In Progress | [#]   |
+
+## Phase 1: MVP
+
+**Goal:** Users can run `ock init` to generate a working OpenCode project template.
+
+**Success Criteria:**
+
+- [x] `ock init` command creates project structure
+- [x] Generated files include AGENTS.md, skills, commands, memory
+- [x] Templates pass typecheck and lint
+- [x] Basic CLI prompts for project configuration
+
+**Beads:**
+
+| ID  | Title             | Type    | Status | Depends On |
+| --- | ----------------- | ------- | ------ | ---------- |
+| -   | Core init command | feature | closed | -          |
+| -   | Template bundling | task    | closed | -          |
+| -   | CLI prompts       | task    | closed | -          |
+
+**Out of Scope:**
+
+- Advanced customization
+- Plugin system
+- Multiple template options
+
+---
+
+## Phase 2: Extend
+
+**Goal:** Add essential OpenCode commands for common workflows.
+
+**Success Criteria:**
+
+- [x] `/ship` command for deployment workflows
+- [x] `/plan` command for implementation planning
+- [x] `/resume` command for continuing work
+- [x] `/handoff` command for session handoffs
+- [x] `/status` command for project state
+
+**Beads:**
+
+| ID  | Title           | Type    | Status | Depends On |
+| --- | --------------- | ------- | ------ | ---------- |
+| -   | Ship command    | feature | closed | MVP        |
+| -   | Plan command    | feature | closed | MVP        |
+| -   | Resume command  | feature | closed | MVP        |
+| -   | Handoff command | feature | closed | MVP        |
+| -   | Status command  | feature | closed | MVP        |
+
+**Dependencies:**
+
+- Requires MVP completion
+
+---
+
+## Phase 3: Polish
+
+**Goal:** Improve quality, documentation, and error handling.
+
+**Success Criteria:**
+
+- [x] Comprehensive error messages with actionable guidance
+- [x] Documentation for all commands
+- [x] Validation scripts for template integrity
+- [x] Improved CLI UX with progress indicators
+
+**Beads:**
+
+| ID  | Title               | Type | Status | Depends On |
+| --- | ------------------- | ---- | ------ | ---------- |
+| -   | Error handling      | task | closed | Extend     |
+| -   | Documentation       | task | closed | Extend     |
+| -   | Validation scripts  | task | closed | Extend     |
+| -   | CLI UX improvements | task | closed | Extend     |
+
+**Dependencies:**
+
+- Requires Extend completion
+
+---
+
+## Phase 4: Scale
+
+**Goal:** Add advanced features for power users and customization.
+
+**Success Criteria:**
+
+- [ ] Plugin system for extending CLI functionality
+- [ ] Custom template support (user-defined templates)
+- [ ] Advanced configuration options
+- [ ] Template marketplace or sharing mechanism
+
+**Beads:**
+
+| ID  | Title            | Type    | Status | Depends On    |
+| --- | ---------------- | ------- | ------ | ------------- |
+| -   | Plugin system    | epic    | open   | Polish        |
+| -   | Custom templates | feature | open   | Polish        |
+| -   | Advanced config  | task    | open   | Polish        |
+| -   | Template sharing | epic    | open   | Plugin system |
+
+**Dependencies:**
+
+- Requires Polish completion
+
+---
+
+## Legend
+
+**Status:**
+
+- `Not Started` - No work begun
+- `In Progress` - Active development
+- `Complete` - All beads closed
+
+**Type:**
+
+- `task` - Tactical, single-session work
+- `feature` - New capability, multi-session
+- `epic` - Cross-domain, significant scope
+- `bug` - Fix for broken behavior
+
+---
+
+_Update this file when phases complete or roadmap changes._
+_Use `/plan` command to create detailed plans for active phases._

package/baseline/memory/project/state.md

@@ -0,0 +1,84 @@
+---
+purpose: Current project state, active decisions, blockers, and position tracking
+updated: 2026-02-12
+---
+
+# State
+
+## Current Position
+
+**Active Bead:** (none active)
+**Status:** Ready for new work
+**Started:** 2026-02-12
+**Phase:** Scale
+
+## Recent Completed Work
+
+| Bead | Title                 | Completed | Summary                                           |
+| ---- | --------------------- | --------- | ------------------------------------------------- |
+| -    | Polish phase tasks    | 2026-02   | Error handling, docs, validation, UX improvements |
+| -    | Extend phase commands | 2026-02   | Ship, plan, resume, handoff, status commands      |
+| -    | MVP core features     | 2026-02   | Init command, template bundling, CLI prompts      |
+
+## Active Decisions
+
+| Date       | Decision          | Rationale                                  | Impact                          |
+| ---------- | ----------------- | ------------------------------------------ | ------------------------------- |
+| 2026-02-12 | Scale phase focus | Core complete, ready for advanced features | Plugin system, custom templates |
+
+## Blockers
+
+| Bead | Blocker | Since | Owner |
+| ---- | ------- | ----- | ----- |
+| -    | (none)  | -     | -     |
+
+## Open Questions
+
+| Question                         | Context                        | Blocking | Priority |
+| -------------------------------- | ------------------------------ | -------- | -------- |
+| What plugin system architecture? | Scale phase planning           | Yes      | High     |
+| How to handle custom templates?  | User-defined templates feature | Yes      | High     |
+
+## Context Notes
+
+### Technical
+
+- Node.js runtime required (>= 20.19.0)
+- TypeScript strict mode enforced
+- Build uses tsdown + rsync to bundle .opencode/ template
+- oxlint for linting (fast, modern)
+
+### Product
+
+- Target: solo developers and teams
+- Key differentiator: validated, ready-to-use templates
+- Integration with beads_rust for task tracking
+
+### Process
+
+- Run `npm run lint:fix` before commits
+- Validate with `npm run typecheck`
+- Never modify dist/ directly
+
+## Next Actions
+
+1. [ ] Define plugin system architecture
+2. [ ] Design custom template API
+3. [ ] Create Scale phase implementation plan
+4. [ ] Identify Scale phase beads
+
+## Session Handoff
+
+**Last Session:** 2026-02-12
+**Next Session Priority:** Define plugin system architecture
+**Known Issues:** None currently blocking
+**Context Links:**
+
+- AGENTS.md - Project rules
+- .opencode/skill/ - Available skills
+- .opencode/command/ - Available commands
+
+---
+
+_Update this file at the end of each significant session or when state changes._
+_This file is the "you are here" marker for the project._