Refine feature and sprint intent into a useful specification. Capture scope, observable criteria and material choices without repeated artifact approval ceremonies.
中文简介正在准备中。当前显示原文说明。
Daily repo hygiene — review the day's repo state, then perform the cleanups under per-action confirmation. Fast-forward only, never destructive without a yes.
中文简介正在准备中。当前显示原文说明。
查看安装方法安装前可以查看交给 AI 代理的指令内容。
The best-practice checklist you run when you sit down to code, made routine and gated. The SessionStart briefing reports hygiene state read-only; this command is where the actions happen — each one confirmed individually, none taken unbidden. Arbiter gathers and proposes; you decide every mutation.
The orchestrator reads the current repo state (reusing the briefing's read-only computation — branch, ahead/behind, dirty tree, stashes, prune-candidate branches, stale worktrees) and presents it, then offers each applicable action in turn. Skip an action that has no candidates; never bundle confirmations across different actions or items — branch deletions always stay per-item, and the sole exception is step 3's explicitly enumerated worktree group, which is still one confirmation that names every member, never an implied yes.
Fetch + fast-forward pull — kick git fetch, then offer a --ff-only
pull of the current branch. Eligibility is the briefing summary's
ff_pull_eligible flag (SH-6: clean working tree AND behind upstream) — the same
pure helper the SessionStart briefing computes, not a condition re-derived here.
On a dirty tree the pull is withheld and the dirty state is reported instead. A
diverged branch (would need a merge) is refused with a diverged-branch message —
never a merge commit.
Prune merged local branches — list local branches already merged on remote
(the : gone] upstream set), excluding the current branch and the default
(main). Delete a listed branch only after an explicit per-branch confirmation;
declining leaves it in place.
A : gone] branch that was squash-merged will typically refuse plain
git branch -d — its upstream is already pruned, so -d has nothing to test
reachability against. Before reporting that as a stop, check for a merged PR
record: gh pr list --head <branch> --state merged --json headRefOid. When a
MERGED PR's headRefOid equals that branch's local tip, containment is
proven and git branch -D is permitted — with the proof stated and the
branch named in the confirmation — mirroring the post-merge-cleanup Phase 5
contract. Without that proof, a refusal stays a report-and-stop; never guess.
Remove stale worktrees — list stale/merged worktrees (branch gone-or-merged, or path missing on disk), never the main worktree. Present the full stale list together with each item's evidence, then offer removal as an explicitly enumerated group — one confirmation that names every member — as well as per-item confirmation for anyone who wants to keep some. Declining the group falls back to per-item confirmation, and declining any item leaves it intact.
Surface stashes / dirty / un-pushed — list stashes, uncommitted changes, and
un-pushed commits, each with a suggested next step ($ca-commit, git push,
git stash show). Report-and-route only: never discard a stash, reset, or push.
Advisory board-drift sweep — run git log over the recent merge window
(since the last ca-scoped tag, or a rolling 30-day window when no tag exists)
and pipe that text to "$PY" "${PLUGIN_ROOT}/hooks/boardsync.py" reconcile. Resolve $PY
once by presence — PY=python3; { command -v python3 >/dev/null 2>&1 && python3 --version >/dev/null 2>&1; } || PY=python
— never python3 X || python X, which reruns X on any nonzero exit (#577); this resolution
covers step 6's helper call too.
Display the advisory drift report as-is: DRIFTED tasks (work merged but board
state not [x]) and informational UNKNOWN ids (in the log but absent from the
board). This step is read-only and best-effort — the dotted-id grep can miss a
task never named in a commit. The board is never mutated here; open-tasks.md
is never written. Any drifted task must be resolved explicitly through
$ca-task done <id> — the only blessed board writer. State this clearly to the
user; do not auto-flip.
Archival sweep — proposed per item, never batched (B-24). Long-done tasks
accumulate on the board; they are already excluded from the in-flight count.
List dated done items strictly more than 14 calendar days old
(ARCHIVE_CUTOFF_DAYS), then ask about each one
separately, noting which ones the user says yes to.
An item marked [x] with no (done YYYY-MM-DD) stamp cannot be aged, so
it is never in the proposed set. Offer it only if the user asks, and only with
--allow-undated — both $ca-task done and the board classifier require
the stamp, so an unstamped entry is legacy or override-era and its real age is
unknown.
Declining is always available and costs nothing: an unarchived task stays exactly where it is. Never archive without a yes.
If at least one item was confirmed: an archive is calendar-driven hygiene,
not a consequence of any in-flight work, so it never rides another commit.
Before creating the archive branch, require a clean working tree and index
(git status --porcelain emits nothing); otherwise STOP before mutating the
board. Then switch to the configured default branch, fetch it and fast-forward
it with step 1's --ff-only pull, and STOP on checkout, fetch, divergence, or
pull failure. Verify that HEAD is the fetched default tip. Only then create and
switch to a fresh dedicated branch with non-overwriting git switch -c, e.g.
chore/board-archive-<YYYY-MM-DD>-<HHMMSSZ>. Branch creation MUST fail closed
if the branch name already exists; never reuse or reset an earlier sweep's
branch. Verify the new branch is current and still points at the fetched
default tip before the first archive helper call.
This ordered isolation is what makes the sweep committable at all: writing
straight to disk on whatever branch happens to be current would either land
on main (refused outright) or mix into an unrelated feature branch's staged
work (a type split under commit-gate Phase 3) — see #573. One fresh branch per
sweep, never reused across sessions.
On that branch, archive each confirmed item, still one at a time:
"$PY" "${PLUGIN_ROOT}/hooks/taskwrite.py" archive <id>.
One confirmation per item, one helper call per item — the two map 1:1 on
purpose. A batched "archive all 12?" turns twelve decisions into one, and the
helper's own per-item ordering (append to done-tasks.md first, then remove
from open-tasks.md) is what makes an interrupted sweep recoverable; a batch
loop that answered once would throw that away.
Once every confirmed item is archived, stage .codearbiter/open-tasks.md and
.codearbiter/done-tasks.md — the very first archive ever run creates
done-tasks.md; that new file is expected here, not scope creep — and hand
off to $ca-chore docs, which exits through commit-gate (classification
docs) and finishing-a-development-branch as usual. .codearbiter/ prose
is already a listed docs chore type.
Present a one-line summary of what was done and what was declined.
$ca-status.$ca-doctor.$ca-commit.--ff-only and ONLY on a clean working tree — never a merge
commit, never on a dirty tree, never a rebase.$ca-task done <id>.还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Refine feature and sprint intent into a useful specification. Capture scope, observable criteria and material choices without repeated artifact approval ceremonies.
中文简介正在准备中。当前显示原文说明。
Vet a new or changed third-party dependency for license, provenance, and supply-chain risk before any install runs.
中文简介正在准备中。当前显示原文说明。
Record user-decided ADRs or inspect their health read-only. Preserve attribution and acceptance evidence.
中文简介正在准备中。当前显示原文说明。
Inspect ADR health read-only; optionally select one ADR with --adr N.
中文简介正在准备中。当前显示原文说明。
Assemble the governance record for a range — commits, overrides, ADRs, sprint auto-decisions, open questions, checkpoint findings — into one dated audit packet. Read-only.
中文简介正在准备中。当前显示原文说明。
Lightweight Q&A about the project — answer from context and return, no routing, no state change.
中文简介正在准备中。当前显示原文说明。