ar

Coordinate four AI agents to review design documents and generate markdown reports.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/madebymlai/feldspar --skill ar-madebymlai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ar
Source: https://github.com/madebymlai/feldspar/tree/main/.claude/skills/ar
Command: npx skills add https://github.com/madebymlai/feldspar --skill ar-madebymlai

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about ar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate an adversarial review of my software architecture design document?

Automate an adversarial review of your software architecture design document by running a multi-model orchestration of four AI agents. The agents generate parallel critiques, deduplicate findings, validate claims against codebase context, and classify issues by severity in a markdown report.

What is multi-model adversarial review for design documents?

Multi-model adversarial review for design documents is a process that uses multiple AI agents to expose hidden flaws, bias, and risky assumptions. It applies systematic cost-benefit analysis to evaluate severity, probability, remediation cost, and reversibility for each identified issue.

How do I run a cost-benefit analysis on findings from a security design doc review?

Run a cost-benefit analysis on security design doc findings by validating each critique against codebase context. The process evaluates issue severity, probability, remediation cost, reversibility, and fit, categorizing results as Critical, Recommended, or Noted in a structured report.

Can I use multiple AI agents to review a performance design doc in parallel?

Yes, you can use multiple AI agents to review a performance design doc in parallel. The orchestration launches four reviewer agents using opus and sonnet models simultaneously to consolidate overlapping findings, validate claims, and highlight cross-agent signals.

What is the best way to prioritize remediation effort before implementing a new software architecture?

The best way to prioritize remediation effort before implementing a new software architecture is to classify identified issues as Critical, Recommended, or Noted. This structured classification follows multi-agent validation and cost-benefit assessment of each finding.

Does multi-agent design review work without external dependencies?

Yes, multi-agent design review works without external dependencies. The orchestration coordinates four internal reviewer agents, deduplicates overlapping findings, validates claims against codebase context, and produces a detailed markdown report independently.