Senior Board Audit: a four-agent adversarial code review skill (MIT, looking for feedback)

[mahdyhasan]

Hi all, sharing a skill I built and use on my own projects in case it's useful to others here. Feedback welcome.

What it does

senior-board-audit runs a four-agent adversarial audit on a codebase instead of a single-agent review:

• Auditor catalogs every component and orchestrates the board.
• Defender argues the current code is sound. Names its strengths.
• Challenger attacks with code-level evidence. Proposes alternatives.
• Judge rules: KEEP, REFACTOR, REWRITE, DELETE, or SPLIT, with severity BLOCKER/MAJOR/MINOR/NOTE.

The audit adapts to project stage. Pre-coding asks architecture and scale questions. Mid-project hunts bottlenecks, race conditions, and resilience gaps. Pre-ship stress-tests rollback paths, load capacity, and secret rotation.

What it produces

Five files in docs/audit/{date}/:

• report.md (executive summary + findings by severity)
• inventory.md
• dependency-map.md
• challenge-rounds.md (side-by-side alternatives for top 5 issues)
• unanswered-questions.md

It refuses to modify any source file. Verdicts only, no patches.

Why I built it

Most reviews end too polite (rubber stamp) or too unstructured (50 nits with no ranking). The board structure forces disagreement onto the record and requires a verdict on every component. Borrows from how surgeons, pilots, and financial auditors handle high-stakes review.

Repo

https://github.com/ScaleWithAugmex/senior-board-audit

MIT licensed. Works with Claude Opus and other coding agents that can read files and reason across multiple passes. The README has install instructions for Claude Code, claude.ai, and any agent that accepts markdown-based skills.

What I'd love feedback on

1. Whether the question banks miss anything important for stages 0/1/2.
2. Red-flag categories I should add (currently covers code, security, performance, resilience, observability, AI-specific, deployment).
3. Whether the four-agent structure holds up on languages outside Python/JS/PHP (the current focus).

Happy to answer questions or take PRs.