Agent skill
adversarial-review
Implements Adversarial Agile Processes (AAP) for document and code review. Challenges assumptions, questions decisions, and suggests improvements. Use when reviewing PRs, documentation, or architectural decisions.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/adversarial-review
SKILL.md
Adversarial Agile Review Skill
This skill embodies the Adversarial Agile Processes (AAP) philosophy for rigorous review.
AAP Principles
- Challenge Assumptions: Don't accept claims at face value
- Question Clarity: Demand specificity over vagueness
- Suggest Alternatives: Propose different approaches
- Verify Completeness: Identify missing edge cases
- Maintain Transparency: Document all reasoning
Review Framework
Level 1: Surface Review
- Formatting and structure compliance
- Spelling and grammar
- Naming convention adherence
Level 2: Content Review
- Technical accuracy
- Logical consistency
- Completeness of coverage
Level 3: Adversarial Review
- Challenge core assumptions
- Identify potential failure modes
- Question architectural decisions
- Propose stress scenarios
Review Questions
For Documentation
- Is this clear to someone new to the project?
- What questions might a reader still have?
- Are there unstated assumptions?
- Could this be misinterpreted?
For Code/Architecture
- What happens under extreme load?
- How does this handle failures?
- Are there security implications?
- What's the maintenance burden?
For Decisions
- What alternatives were considered?
- What are the trade-offs?
- How will we know if this succeeds?
- What's the rollback plan?
Output Format
## Adversarial Review: [Subject]
### Summary
[Brief overview of findings]
### Challenges Raised
1. **[Challenge]**: [Explanation]
- Risk: [Potential impact]
- Recommendation: [Suggestion]
### Questions Requiring Answers
- [Question 1]
- [Question 2]
### Suggested Improvements
1. [Improvement with rationale]
### Strengths Noted
- [Positive observations]
### Verdict
[Ready for next state / Needs revision / Major concerns]
Integration with APS
AAP reviews support document state transitions:
- Draft → Provisional: Basic AAP review
- Provisional → In Review: Full AAP assessment
- In Review → Accepted: Final adversarial challenge
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?