@ngockhoale/ukit 1.5.19 → 1.5.21

package/CHANGELOG.md

@@ -2,25 +2,32 @@
 
 All notable changes to UKit are documented here.
 
+## 1.5.21 - 2026-06-09
+
+### Changed
+
+- Renamed handoff slash commands from `*-handoff` to `handoff-*` convention: `handoff-status`, `handoff-create`, `handoff-implement`, `handoff-review`, `handoff-clear`. Old `*-handoff.md` files removed; manifests and skill routing updated.
+- Auto-prune now targets `handoff-abort.md` (new name) instead of `clear-handoff.md`.
+
 ## 1.5.16 - 2026-06-06
 
 ### Changed
 
-- `clear-handoff`: added Step 2 — stage `docs/AI_HANDOFF/`, commit planning artifacts, merge `handoff/integration → $BASE`, push, delete integration branch. This is the **only** git commit+push in the entire handoff flow.
-- `review-handoff`: removed all merge/push instructions from Step 3. Reviewer now stops at "Run /ukit:clear-handoff" after all tasks approved.
-- Rule enforced: `create-handoff`, `implement-handoff`, `review-handoff` may only change files inside `docs/AI_HANDOFF/`. No commits to main, no pushes.
+- `handoff-clear`: added Step 2 — stage `docs/AI_HANDOFF/`, commit planning artifacts, merge `handoff/integration → $BASE`, push, delete integration branch. This is the **only** git commit+push in the entire handoff flow.
+- `handoff-review`: removed all merge/push instructions from Step 3. Reviewer now stops at "Run /ukit:handoff-clear" after all tasks approved.
+- Rule enforced: `handoff-create`, `handoff-implement`, `handoff-review` may only change files inside `docs/AI_HANDOFF/`. No commits to main, no pushes.
 
 ## 1.5.15 - 2026-06-06
 
 ### Changed
 
-- `review-handoff`: removed automatic `git merge handoff/integration → $BASE`. Reviewer now stops after all tasks are approved and instructs the human to merge manually. Only the end user (or an explicit human prompt) may commit to the base branch.
+- `handoff-review`: removed automatic `git merge handoff/integration → $BASE`. Reviewer now stops after all tasks are approved and instructs the human to merge manually. Only the end user (or an explicit human prompt) may commit to the base branch.
 
 ## 1.5.14 - 2026-06-05
 
 ### Added
 
-- Added 6 handoff slash commands to OpenCode template (`ukit-status-handoff`, `ukit-create-handoff`, `ukit-implement-handoff`, `ukit-review-handoff`, `ukit-clear-handoff`, `ukit-abort-handoff`). These now appear as Workflows in Kilo Code and slash commands in OpenCode after `ukit install`.
+- Added 6 handoff slash commands to OpenCode template (`ukit-handoff-status`, `ukit-handoff-create`, `ukit-handoff-implement`, `ukit-handoff-review`, `ukit-handoff-clear`, `ukit-handoff-abort`). These now appear as Workflows in Kilo Code and slash commands in OpenCode after `ukit install`.
 
 ### Fixed
 

package/manifests/platform.full.yaml

@@ -819,10 +819,10 @@ items:
     packs:
       - core
 
-  - id: command-create-handoff
+  - id: command-handoff-create
     type: command
-    sourceTemplate: .claude/commands/ukit/create-handoff.md
-    targetPath: .claude/commands/ukit/create-handoff.md
+    sourceTemplate: .claude/commands/ukit/handoff-create.md
+    targetPath: .claude/commands/ukit/handoff-create.md
     requires:
       - docs-ai-handoff
     mergeStrategy: overwrite_with_backup
@@ -831,48 +831,48 @@ items:
     packs:
       - core
 
-  - id: command-implement-handoff
+  - id: command-handoff-implement
     type: command
-    sourceTemplate: .claude/commands/ukit/implement-handoff.md
-    targetPath: .claude/commands/ukit/implement-handoff.md
+    sourceTemplate: .claude/commands/ukit/handoff-implement.md
+    targetPath: .claude/commands/ukit/handoff-implement.md
     requires:
-      - command-create-handoff
+      - command-handoff-create
     mergeStrategy: overwrite_with_backup
     variables: []
     enabledByDefault: true
     packs:
       - core
 
-  - id: command-review-handoff
+  - id: command-handoff-review
     type: command
-    sourceTemplate: .claude/commands/ukit/review-handoff.md
-    targetPath: .claude/commands/ukit/review-handoff.md
+    sourceTemplate: .claude/commands/ukit/handoff-review.md
+    targetPath: .claude/commands/ukit/handoff-review.md
     requires:
-      - command-create-handoff
+      - command-handoff-create
     mergeStrategy: overwrite_with_backup
     variables: []
     enabledByDefault: true
     packs:
       - core
 
-  - id: command-clear-handoff
+  - id: command-handoff-clear
     type: command
-    sourceTemplate: .claude/commands/ukit/clear-handoff.md
-    targetPath: .claude/commands/ukit/clear-handoff.md
+    sourceTemplate: .claude/commands/ukit/handoff-clear.md
+    targetPath: .claude/commands/ukit/handoff-clear.md
     requires:
-      - command-create-handoff
+      - command-handoff-create
     mergeStrategy: overwrite_with_backup
     variables: []
     enabledByDefault: true
     packs:
       - core
 
-  - id: command-status-handoff
+  - id: command-handoff-status
     type: command
-    sourceTemplate: .claude/commands/ukit/status-handoff.md
-    targetPath: .claude/commands/ukit/status-handoff.md
+    sourceTemplate: .claude/commands/ukit/handoff-status.md
+    targetPath: .claude/commands/ukit/handoff-status.md
     requires:
-      - command-create-handoff
+      - command-handoff-create
     mergeStrategy: overwrite_with_backup
     variables: []
     enabledByDefault: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngockhoale/ukit",
-  "version": "1.5.19",
+  "version": "1.5.21",
   "description": "Install/update an index-first AI workspace for Claude Code, Antigravity, OpenAI Codex, and OpenCode.",
   "license": "MIT",
   "type": "module",

package/src/core/runInstallPipeline.js

@@ -20,7 +20,7 @@ const AUTO_PRUNE_OBSOLETE_PREFIXES = [
 
 const AUTO_PRUNE_OBSOLETE_PATHS = new Set([
   '.claude/ukit/.env.example',
-  '.claude/commands/ukit/abort-handoff.md',
+  '.claude/commands/ukit/handoff-abort.md',
 ]);
 
 function normalizeRelativePath(relativePath) {

package/src/index/taskRouting.js

@@ -1549,7 +1549,7 @@ export async function checkHandoffBudget(rootDir) {
     oversizedFiles: oversizedFiles.map((f) => f.file),
     overBudget,
     warning,
-    action: warning ? 'clear-handoff' : null,
+    action: warning ? 'handoff-clear' : null,
   };
 }
 

package/templates/.claude/agents/handoff-planner.md

@@ -75,7 +75,7 @@ Wave structure is NOT stored here — inferred from task `Dependencies` fields a
 - Task count + IDs
 - Dependency graph (text form: TASK-001 → TASK-003, TASK-002 independent)
 - Any `needs_breakdown` tasks + reason
-- Next step: "Switch to Sonnet/unic-code → run `/ukit:implement-handoff`"
+- Next step: "Switch to Sonnet/unic-code → run `/ukit:handoff-implement`"
 
 ## Rules
 

package/templates/.claude/commands/ukit/{clear-handoff.md → handoff-clear.md}

@@ -1,4 +1,4 @@
-# /ukit:clear-handoff — Emergency Reset
+# /ukit:handoff-clear — Emergency Reset
 
 **Role: CLEANUP UTILITY**
 **Tool: any**
@@ -60,4 +60,4 @@ Handoff docs reset. Ready for new cycle.
 > Claude Code: spawn `ukit-small-task-maintainer` (haiku).
 > Other tools: lite model, follow steps 1–5.
 
-**Next:** `/ukit:create-handoff <new problem description>`
+**Next:** `/ukit:handoff-create <new problem description>`

package/templates/.claude/commands/ukit/{create-handoff.md → handoff-create.md}

@@ -1,4 +1,4 @@
-# /ukit:create-handoff — Phase 1 + 2: Plan
+# /ukit:handoff-create — Phase 1 + 2: Plan
 
 **Role: PLANNER**
 **Tool: any** (Claude Code / Codex / Antigravity / Kilo / OpenCode — your choice)
@@ -9,7 +9,8 @@
 ## Problem / feature
 $ARGUMENTS
 
-> **Can be run multiple times.** If the plan or tasks aren't satisfactory after the first run, re-run `/ukit:create-handoff` to refine until the plan is good — as long as no task has been implemented yet.
+> **Can be run multiple times.** If the plan or tasks aren't satisfactory after the first run, re-run `/ukit:handoff-create` to refine until the plan is good — as long as no task has been implemented yet.
+> **NO git commit. NO git push.** This phase only writes docs files. No code changes.
 
 ---
 
@@ -79,4 +80,4 @@ Switch to strongest model. Use Step 1 summary — do NOT re-read files.
 
 ---
 
-**Next:** switch to code model → `/ukit:implement-handoff`
+**Next:** switch to code model → `/ukit:handoff-implement`

package/templates/.claude/commands/ukit/{implement-handoff.md → handoff-implement.md}

@@ -1,4 +1,4 @@
-# /ukit:implement-handoff — Phase 3: Execute
+# /ukit:handoff-implement — Phase 3: Execute
 
 **Role: EXECUTOR (orchestrated)**
 **Tool: any** (Claude Code / Codex / Antigravity / Kilo / OpenCode — your choice)
@@ -8,6 +8,8 @@
 $ARGUMENTS
 _Empty = all `ready` tasks. Or: "TASK-001" for a specific task._
 
+> **NO git commit. NO git push. Ever.** AI only makes file changes. Human commits when ready.
+
 ---
 
 ## Step 1 — Setup
@@ -16,11 +18,13 @@ Read `docs/AI_HANDOFF/ACTIVE.md` → get `Base: <BASE>`.
 Read `docs/AI_HANDOFF/INDEX.md` → collect `ready` tasks (or specific task from $ARGUMENTS).
 If no ready tasks → report and stop.
 
-Create integration branch (once per cycle, skip if already exists):
+Verify working tree is clean before starting:
 ```bash
-git branch handoff/integration $BASE 2>/dev/null || echo "already exists"
+git status   # must be clean — no uncommitted changes
 ```
 
+If working tree is dirty → stop. Ask human to commit or stash first.
+
 ## Step 2 — Build wave groups
 
 Read each `tasks/TASK-xxx.md` for `Dependencies` field:
@@ -33,15 +37,15 @@ Read each `tasks/TASK-xxx.md` for `Dependencies` field:
 
 For each wave:
 
-### 3a — Create worktrees (from `handoff/integration`)
+### 3a — Create worktrees (from `$BASE`, no extra branch)
 ```bash
-git worktree add -b handoff/task-xxx .worktrees/task-xxx handoff/integration
+git worktree add -b handoff/task-xxx .worktrees/task-xxx $BASE
 # (omit -b if branch already exists)
 ```
 
 ### 3b — Run tasks in parallel (one agent/session per task)
 
-Each executor does independently in its own worktree:
+Each executor works independently in its own worktree — **NO git commit, NO git add**:
 
 ```
 Read docs/AI_HANDOFF/tasks/TASK-xxx.md
@@ -55,17 +59,13 @@ TDD — mandatory:
      cd .worktrees/task-xxx && <each verification command>
      Paste full output.
 
-Commit in worktree:
-  git -C .worktrees/task-xxx add -A
-  git -C .worktrees/task-xxx commit -m "feat(TASK-xxx): <intent>"
-  COMMIT_SHA=$(git -C .worktrees/task-xxx rev-parse HEAD)
+DO NOT run: git add, git commit, git push — leave files as-is in worktree.
 
 Executor Report (append to task file — do NOT touch INDEX.md):
   ## Executor Report
   EXECUTOR_TOOL: <tool>
   EXECUTOR_MODEL: <exact model ID — mandatory>
   EXECUTOR_SUBAGENT: <name or "-">
-  COMMIT_SHA: <sha>
   Verification Output: <paste>
   Status: PASS | FAIL
   Note: <issues or "none">
@@ -74,25 +74,31 @@ Executor Report (append to task file — do NOT touch INDEX.md):
 > Claude Code: spawn `feature-implementer` agents in parallel (one per task).
 > Other tools: open each task in separate session with code model.
 
-### 3c — Orchestrator: merge + IMMEDIATELY delete worktree
+### 3c — Orchestrator: copy changes to main + IMMEDIATELY delete worktree
 
 For each task that reported back:
 
 **PASS + EXECUTOR_MODEL present:**
 ```bash
-git checkout handoff/integration
-if git merge handoff/task-xxx --no-ff -m "feat(TASK-xxx)" 2>/dev/null; then
-  # Delete worktree and branch immediately — no lingering
-  git worktree remove .worktrees/task-xxx --force
-  git branch -D handoff/task-xxx
-  # update INDEX.md: status → pending_review
-else
-  git merge --abort
-  git worktree remove .worktrees/task-xxx --force
-  git branch -D handoff/task-xxx
-  # update INDEX.md: status → merge_conflict
-  # append to §Discussion: conflict with <previously merged tasks>
-fi
+WORKTREE=".worktrees/task-xxx"
+
+# Copy modified tracked files to main working tree
+git -C "$WORKTREE" diff --name-only | while read f; do
+  mkdir -p "$(dirname "$f")"
+  cp "$WORKTREE/$f" "$f"
+done
+
+# Copy new untracked files
+git -C "$WORKTREE" ls-files --others --exclude-standard | while read f; do
+  mkdir -p "$(dirname "$f")"
+  cp "$WORKTREE/$f" "$f"
+done
+
+# Delete worktree and branch immediately
+git worktree remove "$WORKTREE" --force
+git branch -D handoff/task-xxx
+
+# update INDEX.md: status → pending_review
 ```
 
 **FAIL:**
@@ -113,31 +119,20 @@ git branch -D handoff/task-xxx
 **Worktrees are always deleted immediately** — no exceptions.
 
 ### 3d — Next wave
-Branch new worktrees from `handoff/integration` (now includes Wave N). Repeat 3a–3c.
+Create new worktrees from `$BASE`. Repeat 3a–3c.
 
-## Step 4 — Finalize: squash merge + cleanup
+## Step 4 — Finalize: verify cleanup
 
-All waves complete. Bring all changes back to `$BASE` as a staged diff — no auto-commit.
+All waves complete. Verify:
 
 ```bash
-git checkout $BASE
-
-# Stage all integration changes without committing
-git merge --squash handoff/integration
-
-# Delete integration branch
-git branch -D handoff/integration
-
-# Safety-net: remove any stray task worktrees/branches
-git worktree list | grep '.worktrees/task-' | awk '{print $1}' | while read wt; do
-  name=$(basename "$wt")
-  git worktree remove "$wt" --force 2>/dev/null
-  git branch -D "handoff/$name" 2>/dev/null
-done
-git worktree prune
+git worktree list        # must show only main worktree
+git branch | grep handoff  # must be empty
+git status               # shows uncommitted changes — this is expected
+git diff --stat          # summary of everything that changed
 ```
 
-All changes are now **staged on `$BASE`**. No branches or worktrees remain.
+All changes are in the **main working tree as uncommitted files**. No branches or worktrees remain.
 
 ## Step 5 — Report
 
@@ -145,8 +140,8 @@ All changes are now **staged on `$BASE`**. No branches or worktrees remain.
 Wave summary:
   Wave 1: TASK-001 [pending_review], TASK-002 [blocked]
   Wave 2: TASK-003 [pending_review]
-All branches and worktrees removed.
-Staged diff on $BASE — ready for review.
+All worktrees and branches removed.
+Uncommitted changes in working tree — human commits when ready.
 ```
 
-**Next:** switch to strong model → `/ukit:review-handoff`
+**Next:** switch to strong model → `/ukit:handoff-review`

package/templates/.claude/commands/ukit/{review-handoff.md → handoff-review.md}

@@ -1,4 +1,4 @@
-# /ukit:review-handoff — Phase 4: Review
+# /ukit:handoff-review — Phase 4: Review
 
 **Role: REVIEWER**
 **Tool: any** (Claude Code / Codex / Antigravity / Kilo / OpenCode — your choice)
@@ -8,6 +8,8 @@
 $ARGUMENTS
 _Empty = all `pending_review` tasks. Or: "TASK-001" for a specific task._
 
+> **NO git commit. NO git push.** Reviewer only reads and reports. Human decides when to commit.
+
 ---
 
 ## Step 1 — Setup
@@ -16,15 +18,15 @@ Read `docs/AI_HANDOFF/ACTIVE.md` → get `Base: <BASE>`.
 Read `docs/AI_HANDOFF/INDEX.md` → collect `pending_review` tasks (or specific task).
 If none → report and stop.
 
-Verify we are on `$BASE` with staged changes from implement-handoff:
+Verify there are uncommitted changes from handoff-implement:
 ```bash
-git status          # should show staged changes, no handoff branches/worktrees
-git diff --staged --stat   # summary of everything implement-handoff merged
+git status           # should show modified/new files, no handoff branches/worktrees
+git diff --stat      # summary of all changes
 ```
 
-If `git diff --staged` is empty → implement-handoff was not completed. Stop and re-run it.
+If `git diff` is empty and `git status` is clean → handoff-implement was not completed. Stop and re-run it.
 
-## Step 2 — Review the staged diff
+## Step 2 — Review the diff
 
 ### 2a — Model isolation check (always first)
 
@@ -34,10 +36,10 @@ Read `EXECUTOR_MODEL` from each task file `## Executor Report`.
 |----------------|------------|--------|
 | present, ≠ yours | present | proceed |
 | present, == yours | present | REFUSE → `changes_requested`: "reviewer ≠ executor required" |
-| missing / blank | any | REFUSE → `changes_requested`: "EXECUTOR_MODEL missing — re-run implement" |
+| missing / blank | any | REFUSE → `changes_requested`: "EXECUTOR_MODEL missing — re-run handoff-implement" |
 | "unknown" | present | proceed + NOTES: "executor model unverified — human confirm" |
 
-### 2b — Re-run verification (on staged working tree)
+### 2b — Re-run verification
 
 ```bash
 <each command from §Verification Commands across all tasks>
@@ -48,7 +50,8 @@ If any command fails → verdict: `critical_block`. Stop.
 ### 2c — Review unified diff
 
 ```bash
-git diff --staged        # full staged diff vs $BASE
+git diff             # all uncommitted changes vs $BASE
+git status           # overview of modified/new/deleted files
 ```
 
 Review as one unified diff — correctness, regression risk, security, edge cases, maintainability.
@@ -79,26 +82,20 @@ Set `status = NEXT_STATUS_FOR_INDEX`. Orchestrator writes INDEX, not the reviewe
 
 Update INDEX.md: all approved tasks → `done`.
 
-Commit the staged changes:
-```bash
-git add docs/AI_HANDOFF/
-git commit -m "feat: complete handoff cycle"
-git push origin $BASE
-```
+**DO NOT commit. DO NOT push.** Leave the working tree as-is for human review.
 
 Report:
 ```
-✅ All tasks approved and committed to $BASE.
-Handoff cycle complete.
+✅ All tasks approved.
+Uncommitted changes are in the working tree — human commits when ready.
+  git diff --stat     ← review summary
+  git add . && git commit -m "..."   ← when ready
 ```
 
 **Any `changes_requested` or `critical_block`:**
 
-Do NOT commit. Unstage all changes and re-open the cycle:
-```bash
-git restore --staged .
-```
-Report which tasks need fixes. Executor re-runs `/ukit:implement-handoff TASK-xxx`.
+Report which files need fixes. Executor re-runs `/ukit:handoff-implement TASK-xxx`.
+Changes from the failed task remain in the working tree — executor fixes them in place (no new worktree needed for simple fixes).
 
 ## Step 4 — Report
 
@@ -106,12 +103,12 @@ Report which tasks need fixes. Executor re-runs `/ukit:implement-handoff TASK-xx
 Review summary:
   TASK-001: approved
   TASK-002: changes_requested — see §Discussion
-  Result: committed to $BASE | changes requested (staged reset, re-implement needed)
+  Working tree: unchanged — human commits when satisfied
 ```
 
 **Next:**
-- All approved → done. Committed to `$BASE`.
-- Has fixes → unstage (`git restore --staged .`) + executor re-runs `/ukit:implement-handoff TASK-xxx`
+- All approved → human reviews `git diff` and commits manually.
+- Has fixes → executor re-runs `/ukit:handoff-implement TASK-xxx`
 
 > Claude Code: spawn `code-reviewer` (opus) per task for 2a–2d. Orchestrator handles 1, 2e, 3.
 > Other tools: strong model sequentially per task, same steps.

package/templates/.claude/commands/ukit/{status-handoff.md → handoff-status.md}

@@ -1,4 +1,4 @@
-# /ukit:status-handoff — Dashboard (read-only)
+# /ukit:handoff-status — Dashboard (read-only)
 
 **Role: OBSERVER**
 **Tool: any**
@@ -39,10 +39,10 @@ Integration branch: handoff/integration [exists | not created yet]
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Next action:
-  pending_review tasks → /ukit:review-handoff
-  ready tasks          → /ukit:implement-handoff
-  all done             → /ukit:clear-handoff
-  no active cycle      → /ukit:create-handoff <description>
+  pending_review tasks → /ukit:handoff-review
+  ready tasks          → /ukit:handoff-implement
+  all done             → /ukit:handoff-clear
+  no active cycle      → /ukit:handoff-create <description>
 ```
 
 > Claude Code: spawn `ukit-small-task-maintainer` (haiku) with the above prompt.

package/templates/adapter-presets/opencode/opencode.template.json

@@ -1 +1 @@
-{"$schema":"https://opencode.ai/config.json","default_agent":"build","share":"disabled","compaction":{"auto":true,"prune":true,"reserved":10000},"watcher":{"ignore":[".git/**","node_modules/**",".cache/**",".ukit/**",".claude/ukit/permission-usage.json",".claude/ukit/permission-audit.log"]},"permission":{"doom_loop":"deny"},"command":{"ukit-route":{"description":"Internal shared UKit route. Run at the start of every non-trivial task to get skill and context hints before writing code.","agent":"build","template":"Run `node .claude/ukit/index/route-task.mjs \"<task>\" --adapter opencode`; reuse `.claude/ukit/skill-router-state.json`."},"ukit-context":{"description":"Internal UKit context.","agent":"build","template":"Run `node .claude/ukit/index/resolve-context.mjs \"<intent>\" [--target <file>]`."},"ukit-verify":{"description":"Internal UKit verify lane.","agent":"build","template":"Run `node .claude/ukit/index/verify-context.mjs \"<intent>\" [--target <file>]`."},"ukit-triage":{"description":"Internal UKit triage.","agent":"build","template":"Run `node .claude/ukit/index/triage.mjs \"<error>\"`."},"ukit-query":{"description":"Internal UKit query.","agent":"build","template":"Run `node .claude/ukit/index/query-index.mjs \"<error|symbol|path>\"`."},"ukit-index":{"description":"Internal UKit index.","agent":"build","template":"Run `node .claude/ukit/index/refresh-index.mjs` (fallback: `node .claude/ukit/index/build-index.mjs`)."},"ukit-status-handoff":{"description":"Handoff dashboard — show current cycle status (read-only).","agent":"build","template":"Read `docs/AI_HANDOFF/INDEX.md`, `docs/AI_HANDOFF/ACTIVE.md`, and `docs/AI_HANDOFF/PLAN.md`. Report: active cycle name, task table with status, any blockers. No writes."},"ukit-create-handoff":{"description":"Create a new handoff cycle — Phase 1+2: write PLAN.md + TASK-xxx.md files.","agent":"build","template":"Read `.claude/commands/ukit/create-handoff.md` for full instructions, then execute. Description: <what to build>"},"ukit-implement-handoff":{"description":"Execute handoff tasks — Phase 3: implement the next Ready task.","agent":"build","template":"Read `.claude/commands/ukit/implement-handoff.md` for full instructions, then execute. Task ID (optional): <TASK-xxx>"},"ukit-review-handoff":{"description":"Review handoff results — Phase 4: verify implementation and give verdict.","agent":"build","template":"Read `.claude/commands/ukit/review-handoff.md` for full instructions, then execute. Task ID (optional): <TASK-xxx>"},"ukit-clear-handoff":{"description":"Archive and reset the current handoff cycle.","agent":"build","template":"Read `.claude/commands/ukit/clear-handoff.md` for full instructions, then execute."}},"agent":{"build":{"description":"UKit build agent. Follow AGENTS.md. For every non-trivial task: run /ukit-route first, use index-first loop, activate matching skill, never claim done after read-only steps. Keep internal ukit-* helpers hidden; users only need ukit install.","permission":{"edit":"allow","task":"allow","skill":"allow","bash":{"*":"ask","pwd":"allow","ls":"allow","ls *":"allow","find *":"allow","rg *":"allow","grep *":"allow","cat *":"allow","sed *":"allow","head *":"allow","tail *":"allow","wc *":"allow","echo *":"allow","printf *":"allow","awk *":"allow","tr *":"allow","cut *":"allow","sort *":"allow","uniq *":"allow","diff *":"allow","jq *":"allow","stat *":"allow","file *":"allow","which *":"allow","date *":"allow","basename *":"allow","dirname *":"allow","realpath *":"allow","xargs *":"allow","mkdir *":"allow","touch *":"allow","cp *":"allow","vitest *":"allow","jest *":"allow","git status":"allow","git status *":"allow","git diff":"allow","git diff *":"allow","git log":"allow","git log *":"allow","git show *":"allow","git grep *":"allow","git rev-parse *":"allow","git branch *":"allow","git stash list":"allow","git ls-files *":"allow","git tag *":"allow","node .claude/ukit/index/*":"allow","node .claude/ukit/runtime/*":"allow","{{runtime.packageManager}} test":"allow","{{runtime.packageManager}} test *":"allow","{{runtime.packageManager}} lint":"allow","{{runtime.packageManager}} lint *":"allow","{{runtime.packageManager}} typecheck":"allow","{{runtime.packageManager}} typecheck *":"allow","{{runtime.packageManager}} build":"allow","{{runtime.packageManager}} build *":"allow","npm run test":"allow","npm run test *":"allow","npm run lint":"allow","npm run lint *":"allow","npm run typecheck":"allow","npm run typecheck *":"allow","npm run build":"allow","npm run build *":"allow","pnpm test":"allow","pnpm test *":"allow","pnpm lint":"allow","pnpm lint *":"allow","pnpm typecheck":"allow","pnpm typecheck *":"allow","pnpm build":"allow","pnpm build *":"allow","pnpm run test":"allow","pnpm run test *":"allow","pnpm run lint":"allow","pnpm run lint *":"allow","pnpm run typecheck":"allow","pnpm run typecheck *":"allow","pnpm run build":"allow","pnpm run build *":"allow","bun test":"allow","bun test *":"allow","bun run test":"allow","bun run test *":"allow","bun run lint":"allow","bun run lint *":"allow","bun run typecheck":"allow","bun run typecheck *":"allow","bun run build":"allow","bun run build *":"allow","git commit":"ask","git commit *":"ask","git push":"ask","git push *":"ask","git clean":"deny","git clean *":"deny","git reset":"deny","git reset *":"deny","rm *":"deny"}}},"plan":{"permission":{"edit":"ask","bash":"ask"}}}}
+{"$schema":"https://opencode.ai/config.json","default_agent":"build","share":"disabled","compaction":{"auto":true,"prune":true,"reserved":10000},"watcher":{"ignore":[".git/**","node_modules/**",".cache/**",".ukit/**",".claude/ukit/permission-usage.json",".claude/ukit/permission-audit.log"]},"permission":{"doom_loop":"deny"},"command":{"ukit-route":{"description":"Internal shared UKit route. Run at the start of every non-trivial task to get skill and context hints before writing code.","agent":"build","template":"Run `node .claude/ukit/index/route-task.mjs \"<task>\" --adapter opencode`; reuse `.claude/ukit/skill-router-state.json`."},"ukit-context":{"description":"Internal UKit context.","agent":"build","template":"Run `node .claude/ukit/index/resolve-context.mjs \"<intent>\" [--target <file>]`."},"ukit-verify":{"description":"Internal UKit verify lane.","agent":"build","template":"Run `node .claude/ukit/index/verify-context.mjs \"<intent>\" [--target <file>]`."},"ukit-triage":{"description":"Internal UKit triage.","agent":"build","template":"Run `node .claude/ukit/index/triage.mjs \"<error>\"`."},"ukit-query":{"description":"Internal UKit query.","agent":"build","template":"Run `node .claude/ukit/index/query-index.mjs \"<error|symbol|path>\"`."},"ukit-index":{"description":"Internal UKit index.","agent":"build","template":"Run `node .claude/ukit/index/refresh-index.mjs` (fallback: `node .claude/ukit/index/build-index.mjs`)."},"ukit-handoff-status":{"description":"Handoff dashboard — show current cycle status (read-only).","agent":"build","template":"Read `docs/AI_HANDOFF/INDEX.md`, `docs/AI_HANDOFF/ACTIVE.md`, and `docs/AI_HANDOFF/PLAN.md`. Report: active cycle name, task table with status, any blockers. No writes."},"ukit-handoff-create":{"description":"Create a new handoff cycle — Phase 1+2: write PLAN.md + TASK-xxx.md files.","agent":"build","template":"Read `.claude/commands/ukit/create-handoff.md` for full instructions, then execute. Description: <what to build>"},"ukit-handoff-implement":{"description":"Execute handoff tasks — Phase 3: implement the next Ready task.","agent":"build","template":"Read `.claude/commands/ukit/implement-handoff.md` for full instructions, then execute. Task ID (optional): <TASK-xxx>"},"ukit-handoff-review":{"description":"Review handoff results — Phase 4: verify implementation and give verdict.","agent":"build","template":"Read `.claude/commands/ukit/review-handoff.md` for full instructions, then execute. Task ID (optional): <TASK-xxx>"},"ukit-handoff-clear":{"description":"Archive and reset the current handoff cycle.","agent":"build","template":"Read `.claude/commands/ukit/clear-handoff.md` for full instructions, then execute."}},"agent":{"build":{"description":"UKit build agent. Follow AGENTS.md. For every non-trivial task: run /ukit-route first, use index-first loop, activate matching skill, never claim done after read-only steps. Keep internal ukit-* helpers hidden; users only need ukit install.","permission":{"edit":"allow","task":"allow","skill":"allow","bash":{"*":"ask","pwd":"allow","ls":"allow","ls *":"allow","find *":"allow","rg *":"allow","grep *":"allow","cat *":"allow","sed *":"allow","head *":"allow","tail *":"allow","wc *":"allow","echo *":"allow","printf *":"allow","awk *":"allow","tr *":"allow","cut *":"allow","sort *":"allow","uniq *":"allow","diff *":"allow","jq *":"allow","stat *":"allow","file *":"allow","which *":"allow","date *":"allow","basename *":"allow","dirname *":"allow","realpath *":"allow","xargs *":"allow","mkdir *":"allow","touch *":"allow","cp *":"allow","vitest *":"allow","jest *":"allow","git status":"allow","git status *":"allow","git diff":"allow","git diff *":"allow","git log":"allow","git log *":"allow","git show *":"allow","git grep *":"allow","git rev-parse *":"allow","git branch *":"allow","git stash list":"allow","git ls-files *":"allow","git tag *":"allow","node .claude/ukit/index/*":"allow","node .claude/ukit/runtime/*":"allow","{{runtime.packageManager}} test":"allow","{{runtime.packageManager}} test *":"allow","{{runtime.packageManager}} lint":"allow","{{runtime.packageManager}} lint *":"allow","{{runtime.packageManager}} typecheck":"allow","{{runtime.packageManager}} typecheck *":"allow","{{runtime.packageManager}} build":"allow","{{runtime.packageManager}} build *":"allow","npm run test":"allow","npm run test *":"allow","npm run lint":"allow","npm run lint *":"allow","npm run typecheck":"allow","npm run typecheck *":"allow","npm run build":"allow","npm run build *":"allow","pnpm test":"allow","pnpm test *":"allow","pnpm lint":"allow","pnpm lint *":"allow","pnpm typecheck":"allow","pnpm typecheck *":"allow","pnpm build":"allow","pnpm build *":"allow","pnpm run test":"allow","pnpm run test *":"allow","pnpm run lint":"allow","pnpm run lint *":"allow","pnpm run typecheck":"allow","pnpm run typecheck *":"allow","pnpm run build":"allow","pnpm run build *":"allow","bun test":"allow","bun test *":"allow","bun run test":"allow","bun run test *":"allow","bun run lint":"allow","bun run lint *":"allow","bun run typecheck":"allow","bun run typecheck *":"allow","bun run build":"allow","bun run build *":"allow","git commit":"ask","git commit *":"ask","git push":"ask","git push *":"ask","git clean":"deny","git clean *":"deny","git reset":"deny","git reset *":"deny","rm *":"deny"}}},"plan":{"permission":{"edit":"ask","bash":"ask"}}}}