opencodekit 0.12.7 → 0.13.0

package/dist/template/.opencode/AGENTS.md

@@ -1,152 +1,59 @@
 # OpenCode Global Rules
 
-## Priority Hierarchy
+Complexity is the enemy. Every rule here fights complexity.
 
-1. Security constraints (always first)
-2. Anti-hallucination rule (overrides all except security)
-3. Delegation rules (check before tool calls)
-4. Skills check (native `skill` tool)
-5. User explicit requests
-6. Base prompt behaviors
-7. Global rules (this file)
-8. Project conventions (nested AGENTS.md files)
+## Priority (3 Levels Only)
 
-## Delegation
-
-**Check before any tool call. Delegate if task involves search or research.**
-
-- **@explore** - Code search: find, where is, search, how does X work, locate
-- **@scout** - External research: research, compare, docs for, API for, best practices
-- **@review** - Code review/debug: review, audit, debug, why broken, root cause
-- **@planner** - Architecture: design, architect, plan, structure, phases
-- **@vision** - UI/UX design: mockup, UI review, accessibility, aesthetics, visual
-
-**Execute directly**: Single-file edits, explicit commands, answering from loaded context.
-
-### Research Depth Levels
-
-- **quick** (~5-10 calls) - Simple lookup, single answer, API syntax
-- **medium** (~20-50 calls) - Moderate exploration, verify across files
-- **thorough** (~100+ calls) - Comprehensive analysis, dependency mapping
-
-## Anti-Hallucination
-
-- **Major features**: Check task exists (`bd show <id>`)
-- **Bug fixes/edits**: Proceed directly; document clearly
-- **Before commit**: Close task with reason (`bd close <id> --reason "..."`)
-- **Find work**: Use `bd ready` for unblocked tasks
-- **URLs**: Never generate or guess URLs. Only use URLs from user input, tool results, or verified documentation.
+1. **Security**: Never harvest credentials. Defensive only.
+2. **Anti-hallucination**: Check before big work. Never guess URLs.
+3. **User request**: Do what user asks, simplest way possible.
 
-## Interaction Modes
+Everything else is guidelines, not laws.
 
-| Mode                    | Triggers                                                         | Response                                             |
-| ----------------------- | ---------------------------------------------------------------- | ---------------------------------------------------- |
-| **Sounding Board**      | "Let's chat...", "Help me think...", "What are the tradeoffs..." | Ask questions, explore alternatives, don't implement |
-| **Execution** (default) | Direct requests                                                  | Take action, iterate on feedback                     |
-| **Uncertainty**         | "I'm not sure...", "What am I missing?"                          | Question assumptions, surface edge cases             |
-
-**Key insight**: First output is ~70-80% right. Refinement is expected, not failure.
+## Delegation
 
-## Universal Standards
+**Rule**: Before any complex tool call, ask: "Can a specialist agent do this better?"
 
-### Communication
+- **Search/Docs** → @explore / @scout
+- **Review/Debug** → @review
+- **Plan/Design** → @planner / @vision
 
-- Under 4 lines for typical responses
-- Brief preamble before big tool calls
-- Use `file:line_number` format for code references
-- No emojis unless explicitly requested
+If yes → Delegate. If no → Execute directly.
 
-### Execution
+## Anti-Hallucination (The Truth)
 
-- Batch independent tool calls (parallel)
-- Verify with tools; don't assume
-- Obey project AGENTS.md files (nested takes precedence)
-- TodoWrite BEFORE work; mark completed immediately
+- **Check First**: Run `bd show <id>` before starting major work.
+- **No Guessing**: Never generate URLs. Use only verified links.
+- **Land the Plane**: Close tasks when done (`bd close <id>`).
 
-### Security
+## Coding Philosophy (Grug Style)
 
-- Defensive security only
-- Refuse credential harvesting
-- Allow security analysis, detection rules, vulnerability explanations
+1.  **Say No**: If you don't understand, ask. "I don't know" is better than a lie.
+2.  **No Premature Abstraction**: Don't abstract until you see the pattern 3 times.
+3.  **Break It Down**: Complex `if` conditions are bugs waiting to happen. Use named variables.
+    - _Bad_: `if (x && !y && (z || w))`
+    - _Good_: `const isValid = x && !y; const hasPermission = z || w; if (isValid && hasPermission)`
+4.  **Logs**: Log before and after state changes. Silent failures are the devil.
 
 ## Tool Priority
 
-Load `skill tool-priority` for full LSP, ast-grep, and grep reference.
-
-**Quick reference**: LSP tools → ast-grep → grep → glob → read/edit/write
-
-| Need                                       | Tool              |
-| ------------------------------------------ | ----------------- |
-| Code structure (functions, hooks, imports) | `ast-grep`        |
-| Text search (logs, config, TODOs)          | `grep`            |
-| Type info, definitions, references         | `lsp_lsp_*` tools |
-| File discovery                             | `glob`            |
-
 **Rule**: Always `read` before `edit`.
 
-## Context Engineering
-
-Load `skill context-engineering` for context management principles.
-
-**Quick reference**:
-
-- Prefer `lsp_lsp_document_symbols` over reading entire files
-- Navigate AGENTS.md hierarchy (progressive disclosure)
-- Prune context aggressively; completed work doesn't need to stay loaded
-
-## Research Tools
-
-| Tool           | Use When                                 |
-| -------------- | ---------------------------------------- |
-| **context7**   | Library docs (try first)                 |
-| **websearch**  | Docs not in Context7, recent releases    |
-| **codesearch** | Real implementation patterns from GitHub |
-| **webfetch**   | Specific URL user provided               |
-
-## Error Handling
-
-- **Transient** (network, timeout): Retry 2x with backoff
-- **Rate limit**: Stop, report to user
-- **Logic error**: Change strategy, don't repeat
-- **Blocked by hook/CI**: Analyze error, adjust approach, retry once
-
-## Memory System
-
-Load `skill memory-system` for memory tools and update patterns.
-
-**Quick reference**: `memory-read`, `memory-update`, `memory-search`, `observation`
-
-## Session Management
-
-Load `skill session-management` for session tools and context thresholds.
-
-**Philosophy**: Short sessions (<150k tokens) beat long bloated ones.
-
-**Quick reference**: `list_sessions`, `read_session`, `search_session`, `summarize_session`
-
-## Beads Usage
-
-**Leader agents only**: Only `build` and `rush` use beads tools.
-**Subagents** (explore, scout, planner, review, vision): Do NOT touch beads.
-
-Load `skill beads` for full workflow, tool reference, and patterns.
-
-**Quick reference**:
+1.  **LSP (Best)**: `lsp_lsp_document_symbols` (outline), `lsp_lsp_hover` (types), `lsp_lsp_goto_definition`.
+2.  **Structure**: `ast-grep` (Find functions/classes patterns)
+3.  **Search**: `grep` (Find text/TODOs)
+4.  **Files**: `glob` (Find files)
 
-```
-bd_init() → bd_claim() → bd_reserve(paths) → [work] → bd_done(id, msg) → RESTART
-```
+## Beads (Task Tracking)
 
-**Rules**:
+**Leader Only**: `build` and `rush` agents own the DB. Subagents read-only.
 
-- Always `bd_init()` first in any session using beads tools
-- Reserve before edit to prevent conflicts
-- One task per session - restart after `bd_done()`
+- **Start**: `bd_init()` → `bd_claim()`
+- **Work**: `bd_reserve()` (Lock files!) → Edit
+- **Finish**: `bd_done()` → **RESTART SESSION**
 
 ## Core Constraints
 
-- No sudo
-- POSIX compatible (macOS/Linux)
-- Manual verification for config changes
-- No auto-documentation without request
-- Use absolute paths
+- No sudo.
+- POSIX compatible (macOS/Linux).
+- Use absolute paths.

package/dist/template/.opencode/README.md

@@ -91,6 +91,7 @@ GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json
 - **@planner** - Architecture, multi-phase coordination
 - **@scout** - External research (library docs + GitHub patterns)
 - **@review** - Code review + debugging + security audit
+- **@vision** - UI/UX design: mockup, UI review, accessibility, aesthetics, visual
 
 **Built-in (OpenCode):**
 
@@ -329,8 +330,8 @@ fi
 
 ---
 
-**OpenCodeKit v0.9.2**  
+**OpenCodeKit v0.13.0**  
 **Architecture:** Two-Layer (Memory + Beads + Git)  
-**New in v0.9.2:** 6 new LSP tools, `ock init --beads` flag, improved tool guidance  
+**New in v0.13.0:** Codex-inspired session continuity, compaction-safe context, UNCONFIRMED markers  
 **Package:** `npx opencodekit` to scaffold new projects  
-**Last Updated:** January 2, 2026
+**Last Updated:** January 8, 2026

package/dist/template/.opencode/command/design.md

@@ -2,6 +2,7 @@
 description: UI/UX visual design with aesthetic direction and code output
 argument-hint: "<component|page|system|'review'> [topic] [--direction:<aesthetic>] [--quick|--deep]"
 agent: vision
+subtask: true
 ---
 
 # Design: $ARGUMENTS

package/dist/template/.opencode/command/fix.md

@@ -105,10 +105,37 @@ observation({
 
 If it's a gotcha worth remembering, update `project/gotchas.md`.
 
-## Commit & Sync
+## Complete
+
+If all verifications pass:
 
 ```bash
 git add <files>
+git status
+git diff --cached --stat
+```
+
+**Present to user:**
+
+```
+Fix Complete: $ARGUMENTS
+━━━━━━━━━━━━━━━━━━━━━━━
+
+Root cause: [brief]
+Changes: [files]
+Tests: Pass ✓
+
+Would you like me to:
+1. Commit these changes
+2. Show full diff first
+3. Skip commit (I'll review manually)
+```
+
+**Wait for user confirmation before committing.**
+
+If user confirms:
+
+```bash
 git commit -m "fix: [description]
 
 Root cause: [brief]

package/dist/template/.opencode/command/research.md

@@ -142,10 +142,6 @@ Write `.beads/artifacts/$ARGUMENTS/research.md`:
 - [Remaining question] - needs: [what would resolve it]
 ```
 
-## Sync
-
-!`bd sync`
-
 ## Output
 
 ```

package/dist/template/.opencode/command/start.md

@@ -0,0 +1,106 @@
+---
+description: Start working on a bead - claim it and prepare context
+argument-hint: "<bead-id>"
+agent: build
+---
+
+# Start: $ARGUMENTS
+
+You're claiming a task and preparing to work on it. This is the entry point before implementation.
+
+## Load Skills
+
+```typescript
+skill({ name: "beads" });
+```
+
+## Ensure Git Hooks Installed
+
+First-time setup per repo (prevents stale JSONL issues):
+
+```bash
+bd hooks install 2>/dev/null || echo "Hooks already installed"
+```
+
+## Current State
+
+### Git Status
+
+!`git status --porcelain`
+!`git branch --show-current`
+
+### Active Tasks
+
+!`bd list --status=in_progress`
+
+If you have uncommitted changes, ask the user:
+
+1. Stash them (`git stash`)
+2. Commit them first
+3. Continue anyway (risky)
+
+If you already have tasks in_progress, warn the user before claiming another.
+
+## Task Details
+
+!`bd show $ARGUMENTS`
+
+## Claim The Task
+
+```bash
+bd update $ARGUMENTS --status in_progress
+```
+
+## Create Branch
+
+If not already on a feature branch:
+
+```bash
+git checkout -b $ARGUMENTS
+```
+
+## Existing Artifacts
+
+!`ls .beads/artifacts/$ARGUMENTS/ 2>/dev/null || echo "No artifacts yet"`
+
+Look for:
+
+- `spec.md` - Requirements and constraints
+- `research.md` - Previous research
+- `plan.md` - Implementation plan
+
+## Determine Next Step
+
+Based on what exists:
+
+| Artifacts Found       | Next Command            |
+| --------------------- | ----------------------- |
+| Nothing               | `/research $ARGUMENTS`  |
+| Only spec.md          | `/plan $ARGUMENTS`      |
+| spec.md + research.md | `/plan $ARGUMENTS`      |
+| plan.md exists        | `/implement $ARGUMENTS` |
+
+## Output
+
+```
+Started: $ARGUMENTS
+━━━━━━━━━━━━━━━━━━━
+
+Branch: $ARGUMENTS
+Status: in_progress
+
+Artifacts:
+• spec.md: [exists/missing]
+• research.md: [exists/missing]
+• plan.md: [exists/missing]
+
+Next: [recommended command based on artifacts]
+```
+
+## Quick Start
+
+If `--quick` flag is passed and plan.md exists, skip directly to:
+
+```
+/implement $ARGUMENTS
+```

package/dist/template/.opencode/command/triage.md

@@ -1,6 +1,6 @@
 ---
 description: AI-powered task triage, prioritization, and workload analysis
-argument-hint: "[--auto-assign] [--sla] [--bottleneck]"
+argument-hint: "[--quick] [--auto-assign] [--sla] [--bottleneck]"
 agent: build
 ---
 
@@ -14,11 +14,54 @@ skill({ name: "beads" });
 
 Analyze open tasks and optimize prioritization using dependency graph analysis, SLA tracking, and multi-agent coordination.
 
-## Phase 1: Initialize Beads Connection
+## Quick Mode
+
+If `--quick` flag is passed, skip deep analysis and provide immediate actionable output:
+
+```bash
+bd ready --json
+bd list --status=in_progress --json
+```
+
+**Quick Output:**
+
+```
+Quick Triage
+━━━━━━━━━━━━
+
+Ready to start:
+• bd-abc12: "Task title" (P1)
+• bd-def34: "Task title" (P2)
+
+In progress:
+• bd-ghi56: "Task title" - claimed by [agent]
+
+Next: /start <bead-id>
+```
+
+Then stop. Don't run full analysis phases.
+
+## Full Triage (Default)
+
+## Phase 1: Health Check
+
+Run `bd doctor` to ensure database integrity (recommended weekly):
+
+```bash
+bd doctor --fix 2>/dev/null || bd doctor
+```
+
+This detects and auto-fixes:
+
+- Orphaned issues (work committed but issue not closed)
+- Database/JSONL sync issues
+- Migration updates
+
+## Phase 2: Initialize Beads Connection
 
 !`bd status`
 
-## Phase 2: Gather Workspace State
+## Phase 3: Gather Workspace State
 
 Run in parallel:
 
@@ -27,8 +70,8 @@ Run in parallel:
 
 ```typescript
 // Custom tools (not shell commands)
-bd-release(); // Lists active locks when called with no args
-bd-inbox({ n: 10, unread: true, to: "all" });
+bd - release(); // Lists active locks when called with no args
+bd - inbox({ n: 10, unread: true, to: "all" });
 
 // Search for past discussions on recurring issues
 search_session({ query: "blocked OR regression OR urgent", limit: 10 });
@@ -43,7 +86,7 @@ Capture:
 - Pending messages
 - Past context on recurring issues
 
-## Phase 3: Analyze Dependencies
+## Phase 4: Analyze Dependencies
 
 Use `bd dep tree` to understand blocking relationships:
 
@@ -55,7 +98,7 @@ This provides:
 - **Keystones**: High-impact tasks that unlock multiple paths
 - **Cycles**: Circular dependencies (must break)
 
-## Phase 4: Priority Classification
+## Phase 5: Priority Classification
 
 ### Priority Matrix
 
@@ -112,7 +155,7 @@ const slaStatus =
       : "OK";
 ```
 
-## Phase 5: Bottleneck Analysis
+## Phase 6: Bottleneck Analysis
 
 Identify blocking patterns:
 
@@ -154,7 +197,7 @@ Resolution Options:
 Run: bd update <id> --remove-dep <dep-id>
 ```
 
-## Phase 6: Generate Triage Report
+## Phase 7: Generate Triage Report
 
 ```
 ╔══════════════════════════════════════════════════════════════════════════╗
@@ -210,7 +253,7 @@ RECOMMENDATIONS
 ╚══════════════════════════════════════════════════════════════════════════╝
 ```
 
-## Phase 7: Auto-Assignment (Optional)
+## Phase 8: Auto-Assignment (Optional)
 
 If `--auto-assign` flag:
 
@@ -261,7 +304,7 @@ Skipped:
 - bd-old88: No matching role detected (manual assignment needed)
 ```
 
-## Phase 8: Batch Operations
+## Phase 9: Batch Operations
 
 ### Bulk Priority Update
 
@@ -286,7 +329,18 @@ console.log("2. Move to P4 backlog");
 console.log("3. Review individually");
 ```
 
-## Phase 9: Sync and Notify
+### Database Cleanup (Weekly Maintenance)
+
+Keep database small for performance (target: under 200-500 issues):
+
+```bash
+bd cleanup --days 7  # Remove closed issues older than 7 days
+bd list --status=closed --json | wc -l  # Check closed count
+```
+
+**Best Practice (from Steve Yegge):** Run `bd cleanup` every few days to prevent database bloat.
+
+## Phase 10: Sync and Notify
 
 ```typescript