arbiterForge/codeArbiter / plugins/ca-pi/skills/ca-audit
ca-audit
UnverifiedAssemble the governance record for a range — commits, overrides, ADRs, sprint auto-decisions, open questions, checkpoint findings — into one dated audit packet. Read-only.
/ca-audit — promotion packet
Everything codeArbiter logs, it logs append-only and scattered: overrides.log, triage.log,
decisions/, sprint-log.md, checkpoints/. This command assembles them into the one document a
team lead, compliance reviewer, or auditor actually asks for: what happened in this window, who
authorized it, and what is still open. Read-only over every source; its only write is the packet.
Window
<from-ref> <to-ref>— two tags/SHAs (e.g.v1.2.0 v1.3.0).--since-checkpoint— usesource_commitandrecorded_atfrom the latest checkpoint report under.codearbiter/checkpoints/as the commit and UTC time anchors.--since <date>— ISO date to HEAD.- No argument → from the most recent tag to HEAD (no tags → last checkpoint; neither → BLOCK and ask for an explicit window).
Flow
- Resolve the window to a commit range and a time range; both appear in the packet header. For a checkpoint window, select the report with the latest valid
recorded_at, verify itssource_commitresolves to a commit and is an ancestor of HEAD, and cite the report. Include itsworktree_dirtyvalue as a review-scope limitation. Missing or invalid anchors require an explicit ref/date window; never infer one from the report filename or the integer override counter inlast-checkpoint. - Gather, citing each source file:
- Commits —
git logover the range, grouped by Conventional-Commit type; merge commits listed with their PR reference. - Overrides — every
overrides.logline in the time range, verbatim (includingSECURITY-OVERRIDEandDEV:entries), each with itsBY:identity. - Triage — every small-lane classification in
triage.login range. - Decisions — ADRs created or superseded in range (from
decisions/file dates and the supersede chains), each with its Decided-by attribution. - Sprint auto-decisions — entries from
sprint-log.mdin range; list everylow-confidence entry verbatim, count thehighones. - Open questions — all currently-unresolved
[CONFIRM-NN]items. - Checkpoint findings — from the most recent
checkpoints/*.md: findings still open.
- Commits —
- Write the packet to
<project-root>/.codearbiter/audits/<YYYY-MM-DD>.md(second run the same day appends-2,-3, … — an existing packet is never overwritten). Surface the path and a three-line summary: commits, overrides, open items.
Hard gate
Read-only over every source — MUST NOT modify any log, decision, or checkpoint while assembling. MUST NOT overwrite an existing packet. MUST quote override and low-confidence sprint entries verbatim — never paraphrase an audit line. An empty section is stated as empty, never omitted — "no overrides in window" is itself the finding.
When NOT to use
- Live project state right now →
/ca-status. - Triggering reviews →
/ca-checkpoint(this command only reports what reviews already found).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 463k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 463k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 463k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |