adversarial-document-reviewer

Challenge technical documents by testing premises and surfacing unstated assumptions.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ybbms777/compound-engineering --skill adversarial-document-reviewer-ybbms777
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adversarial-document-reviewer
Source: https://github.com/ybbms777/compound-engineering/tree/main/skills/agent-adversarial-document-reviewer
Command: npx skills add https://github.com/ybbms777/compound-engineering --skill adversarial-document-reviewer-ybbms777

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the risk of moving forward with flawed technical plans, requirements, or architectural decisions that standard document reviewers miss, preventing costly rework and failed implementations.

Core Features & Use Cases

  • Premise & Assumption Challenging: Surfaces unstated assumptions and mismatches between stated goals and actual requirements for documents with 5+ requirements, high-stakes domains, or new abstractions.
  • Decision Stress-Testing: Constructs falsification tests and reversal cost analysis for major technical decisions to identify confirmation bias and high-risk choices before work begins.
  • Use Case: Use it when reviewing a new payment processing architecture plan, a compliance-focused data migration document, or a complex feature requirements doc to catch hidden flaws early in the development cycle.

Quick Start

Use the adversarial-document-reviewer skill to analyze the attached technical plan for unstated assumptions and flawed major decisions.

Frequently Asked Questions about adversarial-document-reviewer

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

FAQPage Schema
How do I catch hidden assumptions in a technical plan before implementation?

To catch hidden assumptions in a technical plan, you need an adversarial review process that surfaces unstated premises and mismatches between stated goals and actual requirements. This approach challenges the epistemological validity of documents before resources are committed.

What is adversarial document review for software engineering projects?

Adversarial document review is a method that challenges the epistemological validity of technical documents by testing premises, surfacing unstated assumptions, and stress-testing major decisions. It eliminates confirmation bias and catches flawed decision-making early.

How do I stress-test major architectural decisions to prevent costly rework?

To stress-test major architectural decisions, you can construct falsification tests and perform reversal cost analysis. This process identifies confirmation bias and high-risk choices in proposals for new abstractions or significant architectural changes before work begins.

When should I use adversarial review for technical requirements?

You should use adversarial review for technical requirements when dealing with high-stakes domains, documents with more than 5 requirements or implementation units, and proposals for new abstractions or significant architectural changes like payment processing or data migration plans.

Does adversarial review work for compliance-focused data migration documents?

Yes, adversarial review works effectively for compliance-focused data migration documents. It surfaces unaddressed risks and flawed decision-making by challenging premises and testing the epistemological validity of the technical plan before implementation begins.