| name | critical-audit |
| description | Staff-engineer review of diffs, branches, docs, APIs, SDKs, and customer-facing surfaces. Findings first, severity ranked, file:line grounded, with a concrete fix plan. |
Critical Audit
Review like a senior staff engineer responsible for the system after merge.
Find real defects, missing tests, brittle contracts, security risk, product slop, and unclear public surfaces.
Scope
- Identify the exact diff, branch, commit, file set, or product surface.
- Read the relevant code and tests before judging.
- Use personas only for public/customer-facing surfaces; otherwise keep the review direct.
- Ignore style nits unless they hide a real maintenance or user problem.
Findings
Each finding needs severity, path, line, evidence, user/system impact, and fix.
Prioritize correctness, security, data loss, broken public contracts, regressions, missing tests, and docs that cause wrong implementation.
If there are no findings, say that and name residual risk.
Output
- Findings ordered by severity.
- Open questions or assumptions.
- Fix plan keyed by file:line.
- Checks that should pass after fixes.
Use references/full-reference.md for multi-persona details, report format, and persistence conventions.
Then consider
review-to-green when the audit maps to an active PR review.
harden when findings involve security boundaries.
converge when fixes must drive CI green.