ca-checkpoint
Periodic multi-reviewer sweep of the whole codebase — surfaces a triaged checkpoint report.
SKILL.mdplugins/ca-codex/skills/ca-checkpoint/SKILL.md
GitHub$ca-checkpoint — codebase sweep
Periodic sweep of the entire codebase with the reviewer fleet, funneled to a single dated report. Surfaces findings — not a promotion gate, enforces no sign-off.
Flow
Build the unit list — the same fleet as
$ca-review, scoped to the whole codebase against the<project-root>/.codearbiter/docs:Reviewer Reads security-reviewersecurity-controls.md; reviews security postureauth-crypto-reviewersecurity-controls.md; authn/crypto/key/secret pathsdependency-reviewerdependency manifests; license + supply-chain posture migration-reviewermigration history; safety + classification coverage-auditortest coverage vs. obligations across the tree architecture-drift-reviewerdecisions/; drift between code and accepted ADRsRoute to
dispatching-parallel-agents(routines/dispatching-parallel-agents/SKILL.md) with that unit list (read-only batch). It dedupes, then funnels throughfinding-triage→verdict-aggregatorand returns the single read-only verdict.After the verdict returns, separately dispatch
checkpoint-aggregatorwith that verdict and the reviewed commit fromgit rev-parse HEAD, the UTC review-start time, and whether the reviewed worktree was dirty. Retain these observed values from before the sweep. It writes the dated report to<project-root>/.codearbiter/checkpoints/YYYY-MM-DD.md: findings by severity with file:line, and out-of-scope items marked inline[NEEDS-TRIAGE].Write the current override count to
<project-root>/.codearbiter/last-checkpoint— the integer baseline the startup briefing subtracts for its overrides-since-checkpoint counter. The value is the number of non-comment, non-blank lines inoverrides.logat this moment (0if the log is absent). This re-zeros theover:Nsegment until the next$ca-override. Write a bare integer, not a timestamp — the briefing treats any value above the current total as stale and falls back to showing every override.Report the checkpoint path.
Hard gate
Read-only except writing the checkpoint doc and last-checkpoint — MUST NOT modify code. MUST NOT
consume raw reviewer output — only the finding-triage → verdict-aggregator verdict. Checkpoint
persistence MUST remain the separate checkpoint-aggregator step and MUST NOT run for $ca-review
or another generic parallel batch. MUST NOT resolve a [CONFIRM-NN] surfaced during the sweep by guessing. The report surfaces findings; it does
not block or sign off anything.
When NOT to use
- Reviewing just the current diff →
$ca-review. - A pre-implementation threat model →
$ca-threat-model. - ADR health only →
$ca-adr-status. - A whole-codebase deep audit →
$ca-tribunal(checkpoint is the lean periodic sweep; tribunal its rare deep counterpart).