opencodekit 0.22.0 → 0.23.0

package/dist/template/.opencode/skill/development-lifecycle/SKILL.md

@@ -57,7 +57,7 @@ This skill orchestrates the complete feature development workflow, guiding you t
                                                                           └─────────────┘
 ```
 
-**Note:** Research (`/research <bead-id>`) can happen at any phase when you need external information or deeper codebase understanding. It's not a sequential step but a parallel activity.
+**Note:** Research (`/research <plan-id>`) can happen at any phase when you need external information or deeper codebase understanding. It's not a sequential step but a parallel activity.
 
 ## Phase 1: Ideation (brainstorming)
 
@@ -65,7 +65,7 @@ This skill orchestrates the complete feature development workflow, guiding you t
 
 - [ ] Load `brainstorming`
 - [ ] Validate design with user
-- [ ] Write `.beads/artifacts/<bead-id>/design.md`
+- [ ] Write `.opencode/artifacts/<slug>/design.md`
 
 **When:** You have a rough idea but need to explore and refine it.
 
@@ -81,7 +81,7 @@ This skill orchestrates the complete feature development workflow, guiding you t
 **Exit criteria:**
 
 - Design validated by user
-- Output: `.beads/artifacts/<bead-id>/design.md`
+- Output: `.opencode/artifacts/<slug>/design.md`
 
 **Template:** `.opencode/memory/_templates/design.md`
 
@@ -91,9 +91,9 @@ This skill orchestrates the complete feature development workflow, guiding you t
 
 ### Phase 2 Checklist
 
-- [ ] Confirm or create bead id
+- [ ] Confirm or create plan context
 - [ ] Ask clarifying questions
-- [ ] Write `.beads/artifacts/<bead-id>/prd.md`
+- [ ] Write `.opencode/artifacts/<slug>/spec.md`
 
 **When:** Design is validated, need formal requirements and task breakdown.
 
@@ -101,7 +101,7 @@ This skill orchestrates the complete feature development workflow, guiding you t
 
 **Process:**
 
-1. Confirm bead id (create if needed: `br create "Feature Name"`)
+1. Confirm or create plan context
 2. Ask clarifying questions (5-7 max)
 3. Explore codebase patterns and constraints
 4. Write PRD with machine-convertible Tasks section
@@ -109,7 +109,7 @@ This skill orchestrates the complete feature development workflow, guiding you t
 **Exit criteria:**
 
 - PRD with all sections completed
-- Output: `.beads/artifacts/<bead-id>/prd.md`
+- Output: `.opencode/artifacts/<slug>/spec.md`
 
 **Template:** `.opencode/memory/_templates/prd.md`
 
@@ -119,25 +119,25 @@ This skill orchestrates the complete feature development workflow, guiding you t
 
 ### Phase 3 Checklist
 
-- [ ] Read PRD from `.beads/artifacts/<bead-id>/prd.md`
-- [ ] Generate `.beads/artifacts/<bead-id>/prd.json`
-- [ ] Ensure `progress.txt` exists
+- [ ] Read PRD from `.opencode/artifacts/<slug>/spec.md`
+- [ ] Generate `.opencode/artifacts/tasks.json`
+- [ ] Ensure `.opencode/artifacts/progress.txt` exists
 
 **When:** PRD is complete, need executable task list.
 
-**Entry criteria:** PRD exists at `.beads/artifacts/<bead-id>/prd.md`.
+**Entry criteria:** PRD exists at `.opencode/artifacts/<slug>/spec.md`.
 
 **Process:**
 
 1. Read PRD and extract ## Tasks section
 2. Convert to JSON format with dependencies
-3. Create progress.txt for cross-iteration memory
+3. Create `.opencode/artifacts/progress.txt` for cross-iteration memory
 
 **Exit criteria:**
 
 - JSON task file created
 - Progress file initialized
-- Output: `.beads/artifacts/<bead-id>/prd.json`, `progress.txt`
+- Output: `.opencode/artifacts/tasks.json`, `.opencode/artifacts/progress.txt`
 
 ---
 
@@ -147,11 +147,11 @@ This skill orchestrates the complete feature development workflow, guiding you t
 
 - [ ] Create bite-sized tasks with exact file paths
 - [ ] Include TDD steps and verification commands
-- [ ] Write `.beads/artifacts/<bead-id>/plan.md`
+- [ ] Write `.opencode/artifacts/<slug>/plan.md`
 
 **When:** Tasks defined, need detailed implementation instructions.
 
-**Entry criteria:** Task list exists (prd.json or tasks.md).
+**Entry criteria:** Task list exists (tasks.json or tasks.md).
 
 **Process:**
 
@@ -163,7 +163,7 @@ This skill orchestrates the complete feature development workflow, guiding you t
 **Exit criteria:**
 
 - Detailed plan ready for execution
-- Output: `.beads/artifacts/<bead-id>/plan.md`
+- Output: `.opencode/artifacts/<slug>/plan.md`
 
 **Template:** `.opencode/memory/_templates/tasks.md` (for task structure reference)
 
@@ -179,7 +179,7 @@ This skill orchestrates the complete feature development workflow, guiding you t
 
 **When:** Plan is ready, time to build.
 
-**Entry criteria:** Plan exists at `.beads/artifacts/<bead-id>/plan.md`.
+**Entry criteria:** Plan exists at `.opencode/artifacts/<slug>/plan.md`.
 
 **Process:**
 
@@ -202,7 +202,7 @@ This skill orchestrates the complete feature development workflow, guiding you t
 
 - [ ] Identify verification commands
 - [ ] Run full verification suite
-- [ ] Only then claim completion and close bead
+- [ ] Only then claim completion
 
 **When:** Implementation complete, before claiming done.
 
@@ -219,7 +219,7 @@ This skill orchestrates the complete feature development workflow, guiding you t
 **Exit criteria:**
 
 - All verification commands pass with evidence
-- Bead can be closed: `br close <bead-id>`
+- All tasks verified complete
 
 ---
 
@@ -246,28 +246,9 @@ For small changes, you can skip early phases:
 
 ---
 
-## Beads Integration
-
-Every phase should operate within a bead context:
-
-```bash
-# Create bead for new feature
-br create "Feature Name"
-
-# Check current bead status
-br show <bead-id>
-
-# Update status as you progress
-br update <bead-id> --status in_progress
-
-# Close when complete
-br close <bead-id> --reason "All verification passed"
+---
 
-# Sync changes
-br sync --flush-only
-```
 
----
 
 ## Example Full Workflow
 
@@ -278,23 +259,23 @@ User: "I want to add a dark mode toggle"
    → skill({ name: "brainstorming" })
    → Questions about scope, triggers, persistence
    → Design decisions documented
-   → Output: .beads/artifacts/br-dark-mode/design.md
+   → Output: .opencode/artifacts/<slug>/design.md
 
 2. SPECIFICATION
    → skill({ name: "prd" })
    → Full PRD with requirements
    → Tasks section for conversion
-   → Output: .beads/artifacts/br-dark-mode/prd.md
+   → Output: .opencode/artifacts/<slug>/spec.md
 
 3. TASK CONVERSION
    → skill({ name: "prd-task" })
    → JSON task list with dependencies
-   → Output: .beads/artifacts/br-dark-mode/prd.json
+   → Output: .opencode/artifacts/tasks.json
 
 4. PLANNING
    → skill({ name: "writing-plans" })
    → Bite-sized implementation steps
-   → Output: .beads/artifacts/br-dark-mode/plan.md
+   → Output: .opencode/artifacts/<slug>/plan.md
 
 5. IMPLEMENTATION
    → skill({ name: "executing-plans" })
@@ -306,7 +287,7 @@ User: "I want to add a dark mode toggle"
    → Tests pass: ✓
    → Lint clean: ✓
    → Build succeeds: ✓
-   → br close br-dark-mode --reason "Dark mode implemented and verified"
+    → All gates pass: ✓
 ```
 
 ---
@@ -316,5 +297,5 @@ User: "I want to add a dark mode toggle"
 1. **Phase-appropriate skills:** Load the right skill for each phase
 2. **Evidence at every gate:** No phase transition without verification
 3. **Templates guide structure:** Use templates for consistent output
-4. **Beads track progress:** Every feature gets a bead
+4. **Plans track progress:** Every feature gets a plan
 5. **Skip only when appropriate:** Small changes can skip early phases

package/dist/template/.opencode/skill/gemini-large-context/SKILL.md

@@ -130,12 +130,12 @@ Assess test coverage:
 When researching within task boundaries:
 
 ```bash
-# 1. Include bead spec in context
-gemini -p "@src/ @.beads/artifacts/br-xxx/spec.md
+# 1. Include plan spec in context
+gemini -p "@src/ @.opencode/artifacts/$(cat .opencode/artifacts/.active)/spec.md
 Research implementations matching spec constraints"
 
-# 2. Save findings to bead artifacts
-# Write to .beads/artifacts/br-xxx/research.md
+# 2. Save findings to plan files
+# Write to .opencode/artifacts/$(cat .opencode/artifacts/.active)/research.md
 ```
 
 ### Delegating Large Research to Gemini

package/dist/template/.opencode/skill/opensrc/references/example-workflow.md

@@ -39,7 +39,7 @@ read({
 
 // 6. Document findings
 write({
-  filePath: ".beads/artifacts/br-xxx/research.md",
+  filePath: ".opencode/artifacts/<slug>/research.md",
   content: `# Zod Async Refinements
 
 **Finding:** Async refinements use \`parseAsync()\` not \`parse()\`

package/dist/template/.opencode/skill/subagent-driven-development/SKILL.md

@@ -35,7 +35,7 @@ dependencies: [executing-plans]
 
 Read plan file, create TodoWrite with all tasks.
 
-**Context file pattern:** If the plan exceeds ~500 tokens, write it to `.beads/artifacts/<id>/plan-context.md` and reference by path in subagent prompts instead of inlining. This saves tokens when dispatching multiple subagents from the same plan.
+**Context file pattern:** If the plan exceeds ~500 tokens, write it to `.opencode/artifacts/plan-context.md` and reference by path in subagent prompts instead of inlining. This saves tokens when dispatching multiple subagents from the same plan.
 
 ### 2. Execute Task with Subagent
 

package/dist/template/.opencode/skill/using-git-worktrees/SKILL.md

@@ -116,16 +116,16 @@ After creating a worktree, persist its absolute path for session resume:
 
 ```bash
 # After creating worktree
-mkdir -p .beads/artifacts/$BEAD_ID
-echo "/absolute/path/to/worktree" > .beads/artifacts/$BEAD_ID/worktree.txt
+mkdir -p .opencode/artifacts/
+echo "/absolute/path/to/worktree" > .opencode/artifacts/worktree.txt
 ```
 
 On session resume, restore the active worktree if tracking exists:
 
 ```bash
-# Check if worktree exists for active bead
-if [ -f .beads/artifacts/$BEAD_ID/worktree.txt ]; then
-  WORKTREE_PATH=$(cat .beads/artifacts/$BEAD_ID/worktree.txt)
+# Check if worktree exists for active plan
+if [ -f .opencode/artifacts/worktree.txt ]; then
+  WORKTREE_PATH=$(cat .opencode/artifacts/worktree.txt)
   cd "$WORKTREE_PATH"
 fi
 ```
@@ -133,7 +133,7 @@ fi
 On worktree cleanup (after merge), remove the tracking file:
 
 ```bash
-rm -f .beads/artifacts/$BEAD_ID/worktree.txt
+rm -f .opencode/artifacts/worktree.txt
 ```
 
 ### 3. Run Project Setup

package/dist/template/.opencode/skill/verification-before-completion/SKILL.md

@@ -207,12 +207,12 @@ Total time = max(typecheck, lint) + test, not typecheck + lint + test.
 
 If you just verified and nothing changed, don't re-verify:
 
-1. After gates pass, record a stamp in `.beads/verify.log`
+1. After gates pass, record a stamp in `.opencode/artifacts/verify.log`
 2. Before running gates, compare current state to last stamp
 3. If match → report cached PASS, skip redundant work
 4. Cache is always bypassed for `--full` and ship/release
 
-This matters when other commands need verification (e.g., closing beads, `/ship`). If you verified 30 seconds ago and made no changes, the cache lets you skip.
+This matters when other commands need verification (e.g., closing tasks, `/ship`). If you verified 30 seconds ago and made no changes, the cache lets you skip.
 
 ## Enforcement Gates
 
@@ -220,9 +220,9 @@ Prompt-level rules get ignored under pressure. These gates are **hard blocks**
 
 ### Gate 1: Completion Claims Require verify.log
 
-Before ANY completion claim (bead close, PR creation, `/ship`, task completion):
+Before ANY completion claim (close plan, PR creation, `/ship`, task completion):
 
-1. Check `.beads/verify.log` exists and contains a recent `PASS` stamp
+1. Check `.opencode/artifacts/verify.log` exists and contains a recent `PASS` stamp
 2. If verify.log is missing or stale (older than last file change) → **BLOCK** — run verification first
 3. If verify.log shows `FAIL` → **BLOCK** — do not proceed
 
@@ -252,12 +252,12 @@ Tasks can "pass" verification while containing stub implementations. This gate c
 ### When to Run
 
 - After all PRD tasks are marked complete (during `/ship` Phase 4-5)
-- Before closing any bead
+- Before closing any task
 - When `--full` verification is requested
 
 ### Stub Patterns to Detect
 
-Scan all files modified in the current task/bead for these phantom indicators:
+Scan all files modified in the current task for these phantom indicators:
 
 ```bash
 # Run against modified code files only (exclude .md, .json, .yml to avoid false positives)

package/dist/template/.opencode/skill/verification-before-completion/references/VERIFICATION_PROTOCOL.md

@@ -17,7 +17,7 @@ CHANGED=$({
   git ls-files --others --exclude-standard -- '*.ts' '*.tsx' '*.js' '*.jsx'
 } | sort -u)
 
-# If in a bead worktree, diff against the branch point:
+# If in a plan worktree, diff against the branch point:
 # CHANGED=$({
 #   git diff --name-only --diff-filter=d main...HEAD -- '*.ts' '*.tsx' '*.js' '*.jsx'
 #   git ls-files --others --exclude-standard -- '*.ts' '*.tsx' '*.js' '*.jsx'
@@ -108,14 +108,14 @@ STAMP=$(printf '%s\n%s\n%s' \
   "$(git ls-files --others --exclude-standard -- '*.ts' '*.tsx' '*.js' '*.jsx' | xargs cat 2>/dev/null)" \
   | shasum -a 256 | cut -d' ' -f1)
 
-echo "$STAMP $(date -u +%Y-%m-%dT%H:%M:%SZ) PASS" >> .beads/verify.log
+echo "$STAMP $(date -u +%Y-%m-%dT%H:%M:%SZ) PASS" >> .opencode/artifacts/verify.log
 ```
 
 ### Skip Check (before running gates)
 
 ```bash
 # Read last verification stamp
-LAST_STAMP=$(tail -1 .beads/verify.log 2>/dev/null | awk '{print $1}')
+LAST_STAMP=$(tail -1 .opencode/artifacts/verify.log 2>/dev/null | awk '{print $1}')
 
 # Recompute current fingerprint (same formula as recording)
 CURRENT_STAMP=$(printf '%s\n%s\n%s' \
@@ -137,11 +137,11 @@ fi
 - Any file edited, staged, or committed since last verification
 - `--full` flag always bypasses cache
 - Manual `--no-cache` flag bypasses cache
-- Different bead context (bead ID changed)
+- Different plan context (plan ID changed)
 
 ### Agent Behavior
 
-When another command needs verification (e.g., closing a bead, `/ship`):
+When another command needs verification (e.g., closing a plan, `/ship`):
 
 1. **Check cache first** — if clean, report `"Verification: cached PASS (no changes since <timestamp>)"`
 2. **If cache miss** — run incremental gates normally

package/package.json

@@ -1,78 +1,78 @@
 {
-	"name": "opencodekit",
-	"version": "0.22.0",
-	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
-	"keywords": [
-		"agents",
-		"cli",
-		"mcp",
-		"opencode",
-		"opencodekit",
-		"template"
-	],
-	"homepage": "https://github.com/opencodekit-template/opencodekit-template#readme",
-	"bugs": {
-		"url": "https://github.com/opencodekit-template/opencodekit-template/issues"
-	},
-	"license": "MIT",
-	"author": "heyhuynhgiabuu <buub1309120@gmail.com>",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/opencodekit-template/opencodekit-template.git"
-	},
-	"bin": {
-		"ock": "dist/index.js"
-	},
-	"files": [
-		"dist",
-		"README.md"
-	],
-	"type": "module",
-	"publishConfig": {
-		"access": "public",
-		"registry": "https://registry.npmjs.org"
-	},
-	"scripts": {
-		"dev": "tsx src/index.ts",
-		"build": "tsdown && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json --exclude='plugin/*.bak' --exclude=memory.db --exclude=memory.db-shm --exclude=memory.db-wal --exclude='memory.db.corrupt.*' --exclude=memory-recovery.log .opencode/ dist/template/.opencode/",
-		"typecheck": "tsgo --noEmit",
-		"test": "vitest run",
-		"test:watch": "vitest",
-		"validate:command-doc": "tsx src/validation/command-doc.ts --check",
-		"validate:docs-drift": "tsx src/validation/docs-drift.ts --check",
-		"validate:skill-lint": "tsx src/validation/skill-lint.ts --check",
-		"validate:governance": "npm run validate:command-doc && npm run validate:docs-drift && npm run validate:skill-lint",
-		"lint": "oxlint .",
-		"lint:fix": "oxlint --fix .",
-		"format": "oxfmt",
-		"format:check": "oxfmt --check"
-	},
-	"dependencies": {
-		"@ai-sdk/provider": "^3.0.8",
-		"@ai-sdk/provider-utils": "^4.0.15",
-		"@clack/prompts": "^0.7.0",
-		"@opencode-ai/plugin": "^1.2.6",
-		"cac": "^6.7.14",
-		"cli-table3": "^0.6.5",
-		"diff": "^8.0.3",
-		"env-paths": "^4.0.0",
-		"node-machine-id": "^1.1.12",
-		"ora": "^9.3.0",
-		"picocolors": "^1.1.1",
-		"zod": "^3.25.76"
-	},
-	"devDependencies": {
-		"@types/diff": "^8.0.0",
-		"@types/node": "^22.19.11",
-		"@typescript/native-preview": "latest",
-		"oxfmt": "^0.23.0",
-		"oxlint": "^1.48.0",
-		"tsdown": "latest",
-		"tsx": "latest",
-		"typescript": "^5.9.3",
-		"vitest": "latest"
-	},
-	"engines": {
-		"node": ">=20.19.0"
-	}
+  "name": "opencodekit",
+  "version": "0.23.0",
+  "description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
+  "keywords": [
+    "agents",
+    "cli",
+    "mcp",
+    "opencode",
+    "opencodekit",
+    "template"
+  ],
+  "homepage": "https://github.com/opencodekit-template/opencodekit-template#readme",
+  "bugs": {
+    "url": "https://github.com/opencodekit-template/opencodekit-template/issues"
+  },
+  "license": "MIT",
+  "author": "heyhuynhgiabuu <buub1309120@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/opencodekit-template/opencodekit-template.git"
+  },
+  "bin": {
+    "ock": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsdown && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json --exclude='plugin/*.bak' --exclude=memory.db --exclude=memory.db-shm --exclude=memory.db-wal --exclude='memory.db.corrupt.*' --exclude=memory-recovery.log .opencode/ dist/template/.opencode/",
+    "typecheck": "tsgo --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "validate:command-doc": "tsx src/validation/command-doc.ts --check",
+    "validate:docs-drift": "tsx src/validation/docs-drift.ts --check",
+    "validate:skill-lint": "tsx src/validation/skill-lint.ts --check",
+    "validate:governance": "npm run validate:command-doc && npm run validate:docs-drift && npm run validate:skill-lint",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check"
+  },
+  "dependencies": {
+    "@ai-sdk/provider": "^3.0.8",
+    "@ai-sdk/provider-utils": "^4.0.15",
+    "@clack/prompts": "^0.7.0",
+    "@opencode-ai/plugin": "^1.2.6",
+    "cac": "^6.7.14",
+    "cli-table3": "^0.6.5",
+    "diff": "^8.0.3",
+    "env-paths": "^4.0.0",
+    "node-machine-id": "^1.1.12",
+    "ora": "^9.3.0",
+    "picocolors": "^1.1.1",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/diff": "^8.0.0",
+    "@types/node": "^22.19.11",
+    "@typescript/native-preview": "latest",
+    "oxfmt": "^0.23.0",
+    "oxlint": "^1.48.0",
+    "tsdown": "latest",
+    "tsx": "latest",
+    "typescript": "^5.9.3",
+    "vitest": "latest"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  }
 }