What problem does it solve?
It provides a structured, adversarial review process for design documents, exposing hidden flaws, bias, and risky assumptions through multiple AI agents and systematic cost‑benefit analysis.
Core Features & Use Cases
- Multi‑model orchestration: Launches four reviewer agents (opus and sonnet models) in parallel.
- Deduplication & pattern detection: Consolidates overlapping findings and highlights cross‑agent signals.
- Validation & cost‑benefit analysis: Verifies each finding against codebase context and evaluates severity, probability, remediation cost, reversibility, and fit.
- Classification & reporting: Categorizes issues as Critical, Recommended, or Noted and generates a detailed markdown report.
- Use case: Review a new architectural design before implementation to ensure robustness and prioritize remediation effort.
Quick Start
Run the ar skill on the design document at ./docs/architecture.md.