@ngockhoale/ukit 1.5.18 → 1.5.20

package/manifests/platform.full.yaml

@@ -879,18 +879,6 @@ items:
     packs:
       - core
 
-  - id: command-abort-handoff
-    type: command
-    sourceTemplate: .claude/commands/ukit/abort-handoff.md
-    targetPath: .claude/commands/ukit/abort-handoff.md
-    requires:
-      - command-create-handoff
-    mergeStrategy: overwrite_with_backup
-    variables: []
-    enabledByDefault: true
-    packs:
-      - core
-
   - id: provider-compat-config
     type: config
     sourceTemplate: .claude/config/providers.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngockhoale/ukit",
-  "version": "1.5.18",
+  "version": "1.5.20",
   "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,6 +20,7 @@ const AUTO_PRUNE_OBSOLETE_PREFIXES = [
 
 const AUTO_PRUNE_OBSOLETE_PATHS = new Set([
   '.claude/ukit/.env.example',
+  '.claude/commands/ukit/abort-handoff.md',
 ]);
 
 function normalizeRelativePath(relativePath) {

package/templates/.claude/commands/ukit/create-handoff.md

@@ -9,6 +9,9 @@
 ## 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.
+> **NO git commit. NO git push.** This phase only writes docs files. No code changes.
+
 ---
 
 ## Step 1 — Read context (lite model)
@@ -31,7 +34,10 @@ Return compact summary. Do NOT write anything yet.
 
 Switch to strongest model. Use Step 1 summary — do NOT re-read files.
 
-1. If INDEX.md has undone tasks → warn human: continue old cycle or start fresh?
+1. Check INDEX.md task statuses:
+   - All tasks are `ready` (planning only) → **re-run allowed**: overwrite PLAN.md and TASK-xxx.md freely — this is iterative refinement.
+   - Any task is `pending_review`, `changes_requested`, `merge_conflict`, or `blocked` → **STOP**: warn human — tasks are already in implement/review phase, cannot overwrite safely.
+   - No tasks → fresh cycle, proceed normally.
 
 2. Resolve base branch:
    ```bash

package/templates/.claude/commands/ukit/implement-handoff.md

@@ -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`

package/templates/.claude/commands/ukit/review-handoff.md

@@ -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 implement-handoff:
 ```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 → implement-handoff 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)
 
@@ -37,7 +39,7 @@ Read `EXECUTOR_MODEL` from each task file `## Executor Report`.
 | missing / blank | any | REFUSE → `changes_requested`: "EXECUTOR_MODEL missing — re-run 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:implement-handoff 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:implement-handoff 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/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."},"ukit-abort-handoff":{"description":"Force abandon the current handoff cycle without archiving.","agent":"build","template":"Read `.claude/commands/ukit/abort-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-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"}}}}

package/templates/.claude/commands/ukit/abort-handoff.md

@@ -1,59 +0,0 @@
-# /ukit:abort-handoff — Force Abandon Cycle (no archive)
-
-**Role: CLEANUP**
-**Tool: any**
-**Model: lite model** (haiku · unic-lite)
-
-**Use when:** plan is wrong from the root, or cycle is unrecoverable. Discards everything — no archive, no history entry.
-**Different from `/ukit:clear-handoff`:** clear = "done, save it". abort = "throw it away".
-
----
-
-## Step 1 — Confirm intent
-
-Report the current state before doing anything:
-```
-⚠️  About to ABORT handoff cycle:
-  Cycle: <ID>   Goal: <goal>
-  Tasks that will be lost: TASK-001 [in_progress], TASK-002 [ready], ...
-  Branch to delete: handoff/integration (task worktrees already cleaned up during implement)
-  
-  This will NOT be archived. All uncommitted work in integration branch will be discarded.
-  Respond "confirm abort" to proceed.
-```
-
-Wait for human to confirm. If not confirmed → stop.
-
-## Step 2 — Force remove all worktrees + branches
-
-```bash
-# Remove task worktrees + branches
-git worktree list | grep '.worktrees/task-' | awk '{print $1}' | while read wt; do
-  name=$(basename $wt)
-  git worktree remove $wt --force
-  git branch -D handoff/$name 2>/dev/null
-done
-
-# Remove integration branch
-git branch -D handoff/integration 2>/dev/null
-
-git worktree prune
-```
-
-## Step 3 — Reset state files (no archive)
-
-```
-PLAN.md   → "# PLAN\n_(empty)_"
-INDEX.md  → empty table header only
-ACTIVE.md → "# ACTIVE\n_(no active cycle)_"
-tasks/TASK-*.md → delete all (keep _TEMPLATE.md)
-```
-
-## Step 4 — Report
-
-Cycle aborted. No archive written. Worktrees and branches removed. Ready for new cycle.
-
-> Claude Code: spawn `ukit-small-task-maintainer` (haiku) with steps 1–4.
-> Other tools: use lite model, follow steps above.
-
-**Next:** `/ukit:create-handoff <new problem description>` (start fresh)