| type | skill |
| lifecycle | stable |
| inheritance | inheritable |
| name | brain-audit |
| description | Perform a local brain audit for ACT Edition using deterministic QA plus targeted file review, then produce severity-ranked fixes. |
| tier | standard |
| applyTo | **/*audit*brain*,**/*brain*qa*,**/*epistemic*qa*,**/*quality* |
| currency | 2026-05-13T00:00:00.000Z |
| lastReviewed | 2026-05-13T00:00:00.000Z |
Brain Audit
Run a local quality audit of the Edition brain and report issues with concrete, minimal fixes.
When to Use
- User asks to "audit the brain"
- Before release or migration
- After broad instruction/skill edits
- When behavior feels inconsistent with ACT principles
Local Audit Protocol
- Start from the
/audit-brain prompt, which routes to the brain-auditor worker.
- Gather local deterministic evidence from repository state:
- frontmatter completeness and freshness (
currency, lastReviewed, required fields)
- manifest consistency (
.github/config/edition-manifest.json vs shipped artifacts)
- cross-reference integrity (files referenced by prompts/instructions/skills exist)
- Validate findings directly in affected files.
- Report findings ordered by severity with exact file references.
- Apply approved fixes, then rerun the same local evidence checks to confirm closure.
Reporting Standard
Each finding includes:
- Severity (
high, medium, low)
- File path
- Why it matters operationally
- Minimal fix
Boundaries
- Local deterministic evidence is mandatory.
- Do not block audit completion on external model tokens.
- Separate "must-fix now" from "quality debt".
Falsifiability
This skill needs revision if, within 90 days:
- High-severity findings from this audit repeatedly reappear after claimed fixes
- Deterministic checks pass but release regressions keep surfacing from unchanged audit gaps
- Audit reports cannot be mapped to concrete file edits
Track outcomes in docs/ledgers/curation-log.md when available.
