adversarial-design-review

Conduct adversarial design reviews with separated roles and evidence-based findings.

2|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/genki-sano/dotfiles --skill adversarial-design-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adversarial-design-review
Source: https://github.com/genki-sano/dotfiles/tree/main/.claude/skills/adversarial-design-review
Command: npx skills add https://github.com/genki-sano/dotfiles --skill adversarial-design-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adversarial-design-review helps teams uncover architectural blind spots by operating as independent roles (researcher, designer, reviewer) to prevent cognitive bias and ensure thorough evaluation before committing to a single design.

Core Features & Use Cases

  • Role-separated critique workflow: researcher documents facts, designer proposes multiple options with trade-offs, reviewer validates and challenges proposals.
  • Coverage across architecture, directory structure, database schema, migration strategy, retry/error handling, and API design.
  • Evidence-based conclusions: requires sourcing, explicit verification, and traceable rationale to back decisions.

Quick Start

Provide an adversarial design review for a hypothetical system and outline trade-offs and risk mitigations.

Frequently Asked Questions about adversarial-design-review

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

FAQPage Schema
How do I conduct a design review for database schemas and API design?

Conduct an adversarial design review by assigning separated roles—researcher, designer, and reviewer—to evaluate database schemas and APIs. The researcher documents facts, the designer proposes options with trade-offs, and the reviewer challenges them to produce structured, evidence-based findings.

What is an adversarial design review and how does it prevent architectural risks?

An adversarial design review is a validation process that uncovers architectural blind spots by using independent roles—researcher, designer, and reviewer—to challenge design proposals. It mitigates risks by requiring explicit sourcing, verifications, and traceable rationale before committing to a design.

Can I use role-separated critique to evaluate migration strategies and retry handling?

Yes, you can apply role-separated critique to evaluate migration strategies and error handling. The workflow requires the designer to propose multiple options with trade-offs, which the reviewer then challenges using explicit verification and traceable rationale to validate the chosen retry strategy.

When do I need an adversarial approach for architecture trade-off analysis?

You need an adversarial approach for architecture trade-off analysis when multiple valid approaches exist with subtle tradeoffs. Use it before finalizing directory structures, DB schemas, or API designs to mitigate governance risks and prevent cognitive bias from compromising system validation.

What's the best way to validate architecture decisions before finalizing a design?

The best way to validate architecture decisions is through an evidence-based review requiring explicit sources, verifications, and traceable rationale. This process outputs a structured findings report with actionable recommendations to mitigate identified architectural risks before committing.

How to document evidence-based conclusions for architectural risk management?

Document evidence-based conclusions for risk management by having the reviewer validate architectural proposals with explicit sourcing and traceable rationale. This outputs a structured findings report containing actionable recommendations derived from verified facts and documented trade-offs.