القائمة
Post-merge worktree teardown — use when the PR of the current goal's worktree is merged and you want to clean up and return to main.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Cut an npm release of @kvnwolf/dobby from the main checkout — inferred bump, raw-TS tarball gate, publish, tag, GitHub release with changelog.
Syncs documentation, authors the commit message + PR body, runs the gate and performs the git/gh ceremony directly (stage → `dobby check --fix` → commit → push → PR), then monitors the PR to a verdict. Use when committing code, finishing a task, pushing changes, or creating a PR.
One-pass migration of a consumer repo off vite-plus onto @kvnwolf/dobby — swap deps, thin `tsconfig.json` and delete the now-default tool configs (biome/vite/vitest/drizzle, kept only for real deltas), move files to canonical paths, regenerate dobby.config.json, drop .conductor, rewire CI + Vercel build, verify with `dobby check`. Run in a consumer repo, once, after updating the dobby plugin.
Set up a repo (greenfield or existing) for the work skills — interview, install @kvnwolf/dobby, scaffold the base files + thin tsconfig, write the dobby.config.json contract. Run once.
Disciplined diagnosis loop for hard bugs — build a fast deterministic feedback loop, rank falsifiable hypotheses, instrument one variable at a time. Use when something is failing, a bug is intermittent or non-obvious, or there's a performance regression.
Dispatch a scoped, ad-hoc task to a worker agent (or a few in parallel) and review what comes back — without the full /dobby:execute plan-and-waves ceremony. Use for a small fix or change, or a bounded investigation, when you don't need a STATE.md spec.
| name | finish |
| description | Post-merge worktree teardown — use when the PR of the current goal's worktree is merged and you want to clean up and return to main. |
The end of a work session. Once the goal's PR is merged, tear down its worktree: run bunx dobby down to close the kit-opened cmux panes (killing the dev server) and run the project's cleanup, then delete the branch and pull the main checkout up to date — closing the goal so the tree is ready for the next one.
One session per goal. Each goal gets its own worktree; parallel goals run in parallel worktrees (one per cmux pane/session — legitimate and encouraged). /dobby:finish tears down THIS goal's worktree after its PR merges — it does not touch other goals' worktrees. Run it (typed, manually) after the PR merges.
Determine which worktree this finish targets and in which mode:
claude session created the worktree via EnterWorktree during /dobby:scope, so the session is still inside it (cwd under .claude/worktrees/<slug>/). This is the common path: the goal's slug and branch (worktree-<slug>) are known from the current worktree, and teardown will use the native ExitWorktree..claude/worktrees/ (or git worktree list) to find candidates, and confirm the target with the user before touching anything — pick the one whose branch matches the merged PR. Teardown will use raw git from the main checkout (native ExitWorktree only removes worktrees the CURRENT session made).Resolve the target's slug, branch (worktree-<slug>), and path (.claude/worktrees/<slug>/) now — every later step keys off them.
Confirm the PR is merged before destroying anything. For the target branch:
gh pr view <branch> --json state,mergedAt,url
state: "MERGED" and the worktree tree is clean → proceed to Step 3 without a prompt.OPEN, CLOSED (not merged), no PR for the branch, or uncommitted changes in the worktree (git -C <path> status --porcelain is non-empty) → this is a destructive-action gate, so show the exact state (PR state + URL, and the dirty-file list if any) and require explicit user confirmation before removing the worktree/branch. Use AskUserQuestion here — an in-stage destructive-action gate, NOT a stage handoff:
discard_changes in Step 4). Only pick this on the user's explicit say-so.Do not proceed to teardown on anything but a MERGED-clean state or an explicit "destroy anyway".
bunx dobby downConfirm dobby is installed: [ -f dobby.config.json ] && [ -x node_modules/.bin/dobby ]. If either is missing, STOP and point the user to /dobby:onboard or /dobby:migrate-config — there is no fallback.
Run bunx dobby down to tear the run down. It closes the kit-opened cmux panes (which terminates the dev server they host, or kills the detached background process when cmux is absent), deletes the per-worktree Neon branch, and runs the project's teardown[] extras from dobby.config.json — all the pre-removal cleanup, mechanized. You NEVER enumerate or close panes by hand and NEVER hunt for a background job — dobby down owns all of it. A no-app project (no run script, no panes, no teardown extras) no-ops cleanly.
bash -c 'cd <path> && bunx dobby down'), never from the main checkout.If dobby down reports a failure, report it and let the user decide whether to continue removing the worktree — a half-cleaned resource is the user's call, not an auto-force.
Now remove the worktree and its branch. The mechanism depends on the mode from Step 1:
The authoritative merge signal is the Step 2 gh pr view = MERGED gate, not git's branch-ancestry check. This matters because most repos squash-merge PRs: after a squash-merge the feature branch tip is a different commit (new SHA/tree) that is NOT an ancestor of main, so git's own "is this branch merged?" test (git branch -d) reports it as unmerged even though the PR is legitimately merged. Once Step 2 says MERGED, the branch is safe to delete regardless of what -d thinks.
Same-session → native ExitWorktree with remove: it deletes the worktree directory and its branch AND restores the cwd to the main checkout (this is why native is preferred same-session — raw git leaves you stranded inside a directory it just deleted). Only pass discard_changes: true if the user explicitly confirmed "destroy anyway" in Step 2 over uncommitted changes; on the clean MERGED path, no discard. If ExitWorktree(remove) reports the branch as unmerged and refuses to delete it (the squash-merge case above), that's expected — it does NOT contradict the Step 2 MERGED verdict; delete the leftover branch with the force delete below.
Orphan mode → raw git, run from the main checkout (never from inside the target worktree — you'd be removing the ground under your feet):
git worktree remove <path> # add --force ONLY if the user confirmed destroying a dirty tree in Step 2
git branch -D worktree-<slug> # force-delete: after a squash-merge -d always refuses a legitimately-merged branch
Use -D here on purpose: the Step 2 MERGED gate is the authoritative "safe to delete" signal, and -d would refuse a squash-merged branch (its tip isn't an ancestor of main) even though the PR merged cleanly — following -d would strand the user on every normal finish. The safety net is Step 2, not git's ancestry check. (If Step 2 was NOT a clean MERGED but the user chose "destroy anyway", -D is likewise what carries that acceptance forward.)
Bring the main checkout up to date with the merge:
git pull # on the main checkout
On a conflict or divergence (the pull doesn't fast-forward cleanly), report it and stop — never force. Show what git said and let the user reconcile; /dobby:finish does not rebase, reset, or force-pull.
The goal is closed: its worktree and branch are gone, the dev server is down, and main is current. /dobby:finish is terminal — there is no next stage to hand off to.
Note the goal is done, then present an AskUserQuestion (one question) that restates the goal is closed and offers:
/dobby:scope) (Recommended) — begin the next goal in a fresh session (per one-session-per-goal); invoke /dobby:scope via the Skill tool.Interact with the user in their language. Write any note you persist in English; keep domain terms in their real-world form.
dobby.config.json + local bin); missing → STOP pointing to /dobby:onboard / /dobby:migrate-config.claude/worktrees/); slug/branch/path resolvedgh pr view <branch> --json state,mergedAt,url: MERGED-and-clean proceeds; anything else (open/closed/no PR/dirty) shows the exact state and gets explicit user confirmation (AskUserQuestion) before destroyingbunx dobby down run from inside the worktree (orphan: with the worktree path as cwd) — closes the kit cmux panes / kills the detached run, deletes the Neon branch, runs teardown[] extras; no-app project no-ops cleanly; a reported failure is surfaced for the user's call, not auto-forcedExitWorktree(remove) same-session (cwd restored to main; discard_changes only after explicit Step 2 confirmation) / raw git worktree remove + git branch -D worktree-<slug> for orphans, run from the main checkout — -D because a squash-merged branch reads as unmerged to -d; Step 2 MERGED is the authoritative safe-to-delete signalgit pull on the main checkout; on conflict/divergence reported and stopped — never forced/dobby:scope recommended, or stop here); /dobby:scope invoked through the Skill tool on selection