How brandonsimpson/devils-advocate works
Devil’s Advocate is a Claude Code plugin for strict, evidence-based critiques of code and plans, plus session critique history. The main workflow starts when a user invokes the critique skill; it selects the relevant criteria, checks the work and project standards, and reports pass/fail results with evidence and fixes. Blockers can trigger a fix-and-re-critique loop. The log skill presents session history. Relationships below are based on the README; no source excerpts were provided, so implementation details beyond documented behavior are omitted.
Main entry points: critique/SKILL.md Critique skill · log/SKILL.md Log skill
Components 12
Critique workflow
- Critique skill
plugin/skills/critique/SKILL.md - Code critique
plugin/skills/critique/SKILL.md - Plan critique
plugin/skills/critique/SKILL.md
Review context
- Standards discovery
plugin/skills/critique/SKILL.md - Pattern analysis
plugin/skills/critique/SKILL.md - Independent review
plugin/skills/critique/SKILL.md
Fix cycle
- Fix step
plugin/skills/critique/SKILL.md - Blocker re-critique
plugin/skills/critique/SKILL.md
Session history
- Log skill
plugin/skills/log/SKILL.md - Critique logs
Other components
- User
- Claude Code
Connections 13
- User → Claude Code: invokes plugin
README.md - Claude Code → Critique skill: routes command
README.md - Critique skill → Code critique: selects criteria
README.md - Critique skill → Plan critique: selects criteria
README.md - Critique skill → Standards discovery: discovers standards
README.md - Critique skill → Pattern analysis: mines patterns
README.md - Critique skill → Independent review: dispatches when needed
README.md - Critique skill → Fix step: structures fixes
README.md - Fix step → Blocker re-critique: rechecks blockers
README.md - Critique skill → Critique logs: saves critiques
README.md - User → Claude Code: requests history
README.md - Claude Code → Log skill: routes command
README.md - Log skill → Critique logs: shows session history
README.md