opencodekit 0.15.21 → 0.16.0

package/dist/template/.opencode/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/dist/template/.opencode/memory/observations/2026-02-01-decision-add-skills-vs-commands-to-global-agents-.md

@@ -0,0 +1,15 @@
+---
+type: decision
+created: 2026-02-01T11:37:16.161Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["AGENTS.md", "skills vs commands", "global rules"]
+files: [".opencode/AGENTS.md"]
+---
+
+# 🎯 Add Skills vs Commands to global AGENTS rules
+
+🟢 **Confidence:** high
+
+User requested adding the 'Skills vs Commands' guidance to the global rules file .opencode/AGENTS.md.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-build-agent-auto-loads-skills-contextual.md

@@ -0,0 +1,31 @@
+---
+type: decision
+created: 2026-02-01T16:02:30.722Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["skills", "auto-loading", "build-agent", "context", "prd", "swarm", "debugging", "testing", "frontend"]
+---
+
+# 🎯 Build agent auto-loads skills contextually
+
+🟢 **Confidence:** high
+
+Build agent loads skills based on context, NOT all at once:
+
+**Always load:**
+- beads (task tracking)
+- verification-before-completion (never skip)
+
+**Conditional loading:**
+- prd-task: when prd.md exists
+- prd: when feature needs PRD creation
+- swarm-coordination: when 3+ parallel tasks
+- systematic-debugging: for bug fixes
+- test-driven-development: for test work
+- frontend-design: for UI/component work
+- using-git-worktrees: for epics or --worktree flag
+- requesting-code-review: before claiming done
+- finishing-a-development-branch: when completing feature
+
+This prevents skill overload and keeps context focused.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-fixed-agent-configuration-for-opencodeki.md

@@ -0,0 +1,25 @@
+---
+type: decision
+created: 2026-02-01T05:06:14.307Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["opencode", "agents", "configuration", "temperature", "steps", "scout", "build", "plan"]
+---
+
+# 🎯 Fixed agent configuration for OpenCodeKit
+
+🟢 **Confidence:** high
+
+Applied comprehensive fixes to .opencode/agent/ configuration:
+
+1. **scout.md**: Changed temperature from 0.3 to 1.0 (required for kimi-k2.5-free thinking mode), changed maxSteps to steps
+2. **explore.md**: Changed maxSteps to steps
+3. **review.md**: Changed maxSteps to steps  
+4. **vision.md**: Changed maxSteps to steps
+5. **looker.md**: Changed maxSteps to steps
+6. **painter.md**: Changed maxSteps to steps
+7. **build.md**: Added steps: 50 and color: "#4CAF50" (green)
+8. **plan.md**: Added steps: 50 and color: "#2196F3" (blue)
+
+All agents now use modern `steps` syntax instead of deprecated `maxSteps`. Scout agent temperature fixed to work with kimi-k2.5-free model. Primary agents have visual colors for UI distinction.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-focused-agents-md-upgrade-for-opencode-k.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T10:28:34.941Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["AGENTS.md", "opencode-expert", "configuration", "best practices", "kit users"]
+---
+
+# 🎯 Focused AGENTS.md upgrade for OpenCode kit users
+
+🟢 **Confidence:** high
+
+User requested a focused upgrade to AGENTS.md using opencode-expert guidance to add OpenCode configuration best practices and doc references for kit users.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-implement-tier-1-permission-upgrades.md

@@ -0,0 +1,15 @@
+---
+type: decision
+created: 2026-02-01T09:32:47.846Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["opencode.json", "permissions", "tier1", "git safety", "npm publish", "db reset", "secrets"]
+files: [".opencode/opencode.json"]
+---
+
+# 🎯 Implement Tier 1 permission upgrades
+
+🟢 **Confidence:** high
+
+User requested implementing best-practice Tier 1 permission upgrades in .opencode/opencode.json (git safety, npm publish guard, db reset guard, extra secret patterns). Proceed with bead creation and updates before edits.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-instructions-config-explicit-paths-not-w.md

@@ -0,0 +1,40 @@
+---
+type: decision
+created: 2026-02-01T14:09:52.652Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["opencode.json", "instructions", "context-injection", "tech-stack"]
+files: ["opencode.json", ".opencode/memory/user.md", ".opencode/memory/project/tech-stack.md"]
+---
+
+# 🎯 Instructions[] config: Explicit paths, not wildcards
+
+🟢 **Confidence:** high
+
+## Final Instructions Configuration
+
+Updated `opencode.json` instructions to be explicit rather than using wildcards:
+
+```json
+"instructions": [
+  ".opencode/memory/user.md",
+  ".opencode/memory/project/tech-stack.md"
+]
+```
+
+## Rationale
+
+1. **Explicit over implicit** - Wildcards (`*.md`) would pick up any future files, explicit paths are clearer
+2. **Single file approach** - Only tech-stack.md exists in project/ now
+3. **AI learns organically** - Observations are captured via `observation` tool, searched via `memory-search`
+4. **Observations NOT auto-injected** - Would bloat context; they're searchable instead
+
+## Full Context Injection Chain
+
+| File                                    | Purpose                    | Injection |
+| --------------------------------------- | -------------------------- | --------- |
+| `.opencode/memory/user.md`              | User preferences           | Auto      |
+| `.opencode/memory/project/tech-stack.md`| Tech stack & constraints   | Auto      |
+| `.opencode/memory/observations/*.md`    | AI learnings               | Searchable|
+| `.beads/artifacts/<id>/*`               | Bead-specific context      | Manual    |

package/dist/template/.opencode/memory/observations/2026-02-01-decision-merged-context-into-memory-project-singl.md

@@ -0,0 +1,42 @@
+---
+type: decision
+created: 2026-02-01T14:02:05.967Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["context-injection", "memory", "project-config", "tech-stack", "opencode"]
+files: [".opencode/context/project.md", ".opencode/memory/project/tech-stack.md", "opencode.json", ".opencode/memory/_templates/README.md", "dist/template/.opencode/memory/project/tech-stack.md"]
+---
+
+# 🎯 Merged context/ into memory/project/ - Single Source of Truth
+
+🟢 **Confidence:** high
+
+## Decision
+
+Merged `.opencode/context/project.md` into `.opencode/memory/project/tech-stack.md` to avoid duplication.
+
+## Rationale
+
+- **Before**: Two places for project context (context/project.md + memory/project/*.md)
+- **After**: Single location (memory/project/*.md) with tech-stack.md as the new summary file
+- **Why**: Instructions[] already loads memory/project/*.md, so tech-stack.md gets auto-injected
+
+## Structure After Change
+
+```
+.opencode/memory/project/
+├── tech-stack.md    [NEW] - Framework, DB, styling, constraints (auto-injected)
+├── architecture.md  - Modules, directory structure, data flow
+├── commands.md      - Build, test, lint, deploy commands
+├── conventions.md   - Code style, naming, commit messages
+└── gotchas.md       - Known issues, edge cases, troubleshooting
+```
+
+## Files Changed
+
+- Created: `.opencode/memory/project/tech-stack.md`
+- Deleted: `.opencode/context/` folder
+- Updated: `opencode.json` instructions[] (reverted to original)
+- Updated: `.opencode/memory/_templates/README.md`
+- Updated: `dist/template/.opencode/memory/project/tech-stack.md`

package/dist/template/.opencode/memory/observations/2026-02-01-decision-oracle-tool-should-use-review-agent-not-.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T10:51:20.528Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["oracle tool", "review agent", "opencode CLI", "Task tool", "proxypal replacement"]
+---
+
+# 🎯 Oracle tool should use review agent (not ProxyPal)
+
+🟢 **Confidence:** high
+
+User wants the oracle tool to be replaced so it calls the OpenCode review agent instead of ProxyPal. They initially mentioned CLI opencode run and later asked for Task tool usage; need clarification because Task tool isn’t available inside oracle tool runtime.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-plan-agent-auto-loads-skills-contextuall.md

@@ -0,0 +1,31 @@
+---
+type: decision
+created: 2026-02-01T16:08:24.231Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["skills", "auto-loading", "plan-agent", "context", "prd", "brainstorming", "writing-plans", "swarm-coordination"]
+---
+
+# 🎯 Plan agent auto-loads skills contextually
+
+🟢 **Confidence:** high
+
+Plan agent now loads skills based on context, NOT all at once:
+
+**Always load:**
+- beads (task tracking)
+- brainstorming (refine ideas before implementation)
+
+**Conditional loading:**
+- prd: for feature/epic tasks needing PRD creation
+- writing-plans: for detailed implementation plans (features, refactors, migrations)
+- swarm-coordination: for multi-phase work (3+ phases)
+- deep-research: for research-heavy tasks
+- frontend-design: for UI/UX planning (guidelines only)
+
+**Key differences from build agent:**
+- Plan agent loads `brainstorming` (not verification-before-completion) as core
+- Plan agent loads `prd` and `writing-plans` for planning artifacts
+- Plan agent loads `swarm-coordination` for multi-phase orchestration
+- Build agent loads execution-focused skills (debugging, TDD, code review)

package/dist/template/.opencode/memory/observations/2026-02-01-decision-plan-phased-oracle-command-merge-into-ne.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T10:58:28.385Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["oracle tool", "review agent", "opencode commands", "implement", "finish", "new command"]
+---
+
+# 🎯 Plan phased oracle + command merge into new command
+
+🟢 **Confidence:** high
+
+User wants phased changes: update oracle tool to use review agent, then combine implement+finish into a new command (name TBD).

package/dist/template/.opencode/memory/observations/2026-02-01-decision-prd-workflow-uses-prd-and-prd-task-skill.md

@@ -0,0 +1,23 @@
+---
+type: decision
+created: 2026-02-01T15:59:37.640Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["prd", "prd-task", "skills", "templates", "beads", "artifacts"]
+files: [".opencode/memory/_templates/prd.md"]
+---
+
+# 🎯 PRD workflow uses prd and prd-task skills
+
+🟢 **Confidence:** high
+
+When working with PRDs in /start command:
+1. Load `prd` skill when creating new PRDs (defines WHAT to build)
+2. Load `prd-task` skill when converting PRD to executable tasks
+3. PRD files go to `.beads/artifacts/<bead-id>/prd.md`
+4. Task JSON goes to `.beads/artifacts/<bead-id>/prd.json`
+5. Progress tracking in `.beads/artifacts/<bead-id>/progress.txt`
+
+The template at `.opencode/memory/_templates/prd.md` is for reference only.
+Skills handle the actual workflow.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-prefer-review-agent-via-opencode-cli-ove.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T10:38:32.958Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["oracle tool", "review agent", "opencode cli", "proxypal replacement"]
+---
+
+# 🎯 Prefer review agent via OpenCode CLI over ProxyPal oracle
+
+🟢 **Confidence:** high
+
+User wants to replace the ProxyPal-backed oracle tool with invoking the OpenCode CLI review agent (per opencode CLI docs) instead of using ProxyPal.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-add-ship-command-with.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T11:06:11.110Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["oracle tool removal", "/ship command", "implement finish merge", "review agent", "Task tool"]
+---
+
+# 🎯 Remove oracle tool; add /ship command with review after tests
+
+🟢 **Confidence:** high
+
+User wants best-practice simplification: remove oracle tool entirely, and create a combined command /ship that merges implement+finish and triggers review (via Task subagent) after tests.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-and-add-ship-command-.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T11:18:21.359Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["oracle removal", "ship command", "implement finish merge", "review agent", "Task tool"]
+---
+
+# 🎯 Remove oracle tool and add /ship command with review after tests
+
+🟢 **Confidence:** high
+
+User wants to remove the oracle tool entirely, delete /implement and /finish commands, and add a new /ship command that combines implement+finish and spawns the review agent via Task after tests.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-and-add-ship-command.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T11:11:24.824Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["oracle tool removal", "/ship command", "implement finish merge", "review agent", "Task tool"]
+---
+
+# 🎯 Remove oracle tool and add /ship command
+
+🟢 **Confidence:** high
+
+User wants to remove the oracle tool and replace it with a single /ship command that combines implement+finish and spawns the review agent via Task after tests.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-skills-vs-commands-section-from-a.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T11:38:24.397Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["AGENTS.md", "skills vs commands", "documentation cleanup"]
+---
+
+# 🎯 Remove Skills vs Commands section from AGENTS.md
+
+🟢 **Confidence:** high
+
+User requested cleaning up the 'Skills vs Commands' section in project AGENTS.md. Proceed to remove that block.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-oracle-tool-with-ship-command-fl.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T11:17:19.834Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["oracle removal", "ship command", "implement finish merge", "review agent", "Task tool"]
+---
+
+# 🎯 Replace oracle tool with /ship command flow
+
+🟢 **Confidence:** high
+
+User decided to remove the oracle tool and instead use a single /ship command that combines implement+finish and spawns the review agent via Task after tests.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-oracle-with-ship-command-workflo.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T11:15:30.702Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["oracle removal", "ship command", "implement finish merge", "review agent", "Task tool"]
+---
+
+# 🎯 Replace oracle with /ship command workflow
+
+🟢 **Confidence:** high
+
+User wants to remove the oracle tool entirely and use a single /ship command that combines implement+finish, spawning the review agent via Task after tests. Also remove /implement and /finish commands.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-proxypal-oracle-with-cli-review-.md

@@ -0,0 +1,14 @@
+---
+type: decision
+created: 2026-02-01T10:50:28.823Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["oracle tool", "review agent", "opencode cli", "proxypal replacement"]
+---
+
+# 🎯 Replace ProxyPal oracle with CLI review agent
+
+🟢 **Confidence:** high
+
+User wants to replace the ProxyPal-backed oracle tool with invoking the OpenCode CLI review agent, using opencode run instead of proxypal.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-simplified-dist-template-only-tech-stack.md

@@ -0,0 +1,50 @@
+---
+type: decision
+created: 2026-02-01T14:05:54.668Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["templates", "memory", "project-config", "organic-learning", "observation"]
+files: ["tech-stack.md"]
+---
+
+# 🎯 Simplified dist/template: Only tech-stack.md, AI learns organically
+
+🟢 **Confidence:** high
+
+## Decision
+
+Simplified dist/template to only include `tech-stack.md` - removed placeholder files that were just noise.
+
+## Before (5 files)
+```
+dist/template/.opencode/memory/project/
+├── tech-stack.md    - Summary for context injection
+├── architecture.md  - Empty placeholder with [...]
+├── commands.md      - Generic examples
+├── conventions.md   - Generic examples
+└── gotchas.md       - Empty placeholder with [...]
+```
+
+## After (1 file)
+```
+dist/template/.opencode/memory/project/
+└── tech-stack.md    - Summary for context injection
+```
+
+## Rationale
+
+1. **Empty templates are noise** - Placeholders like `[...]` don't help the AI
+2. **AI can discover organically** - Commands from package.json, conventions from codebase
+3. **Observation tool captures learnings** - Gotchas and patterns saved as they're discovered
+4. **Single file = less maintenance** - One file to fill out when starting a project
+
+## Key Insight
+
+The AI doesn't need pre-filled templates to learn about a project. It:
+- Reads package.json to discover commands
+- Reads existing code to learn conventions
+- Uses `observation` tool to capture gotchas when it hits them
+- Builds up knowledge in `.opencode/memory/observations/`
+
+This is more valuable than static placeholder files.

package/dist/template/.opencode/memory/observations/2026-02-01-decision-simplified-templates-only-tech-stack-md.md

@@ -0,0 +1,26 @@
+---
+type: decision
+created: 2026-02-01T15:12:56.167Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["templates", "memory", "tech-stack", "init", "organic-learning", "observation"]
+files: ["user.md", "tech-stack.md"]
+---
+
+# 🎯 Simplified templates: only tech-stack.md
+
+🟢 **Confidence:** high
+
+Removed redundant template files from `.opencode/memory/_templates/project/`:
+- ❌ architecture.md (removed)
+- ❌ commands.md (removed)
+- ❌ conventions.md (removed)
+- ❌ gotchas.md (removed)
+- ✅ tech-stack.md (kept)
+
+Updated `/init` command to only create:
+- `user.md` - user preferences
+- `tech-stack.md` - for AI context injection
+
+Philosophy: AI discovers commands, architecture, conventions, and gotchas organically from the codebase and saves learnings via the `observation` tool. Static placeholder templates are noise.