# brandonsimpson/devils-advocate architecture

> Architecture diagram of the GitHub repository brandonsimpson/devils-advocate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/brandonsimpson/devils-advocate
- Repository: https://github.com/brandonsimpson/devils-advocate

## Overview

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: [`plugin/skills/critique/SKILL.md`](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md) (Critique skill), [`plugin/skills/log/SKILL.md`](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/log/SKILL.md) (Log skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_review["Critique workflow"]
  node_critique_skill["Critique skill<br/>[SKILL.md]"]
  node_code_review["Code critique<br/>[SKILL.md]"]
  node_plan_review["Plan critique<br/>[SKILL.md]"]
end

subgraph group_context["Review context"]
  node_standards["Standards discovery<br/>[SKILL.md]"]
  node_pattern_review["Pattern analysis<br/>[SKILL.md]"]
  node_independent_review["Independent review<br/>[SKILL.md]"]
end

subgraph group_iteration["Fix cycle"]
  node_fix_step["Fix step<br/>[SKILL.md]"]
  node_recritique["Blocker re-critique<br/>[SKILL.md]"]
end

subgraph group_history["Session history"]
  node_log_skill["Log skill<br/>[SKILL.md]"]
  node_critique_logs[("Critique logs")]
end

node_user(("User"))
node_claude_code["Claude Code"]

node_user -->|"invokes plugin"| node_claude_code
node_claude_code -->|"routes command"| node_critique_skill
node_critique_skill -->|"selects criteria"| node_code_review
node_critique_skill -->|"selects criteria"| node_plan_review
node_critique_skill -->|"discovers standards"| node_standards
node_critique_skill -->|"mines patterns"| node_pattern_review
node_critique_skill -->|"dispatches when needed"| node_independent_review
node_critique_skill -->|"structures fixes"| node_fix_step
node_fix_step -->|"rechecks blockers"| node_recritique
node_critique_skill -->|"saves critiques"| node_critique_logs
node_user -->|"requests history"| node_claude_code
node_claude_code -->|"routes command"| node_log_skill
node_log_skill -->|"shows session history"| node_critique_logs

click node_critique_skill "https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md"
click node_code_review "https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md"
click node_plan_review "https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md"
click node_standards "https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md"
click node_pattern_review "https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md"
click node_independent_review "https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md"
click node_fix_step "https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md"
click node_recritique "https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md"
click node_log_skill "https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/log/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_critique_skill,node_code_review,node_plan_review,node_user toneBlue
class node_standards,node_pattern_review,node_independent_review toneAmber
class node_fix_step,node_recritique toneMint
class node_log_skill,node_critique_logs toneRose
class node_claude_code toneIndigo
```

## Components

### Critique workflow

- [Critique skill](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md): `plugin/skills/critique/SKILL.md`
- [Code critique](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md): `plugin/skills/critique/SKILL.md`
- [Plan critique](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md): `plugin/skills/critique/SKILL.md`

### Review context

- [Standards discovery](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md): `plugin/skills/critique/SKILL.md`
- [Pattern analysis](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md): `plugin/skills/critique/SKILL.md`
- [Independent review](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md): `plugin/skills/critique/SKILL.md`

### Fix cycle

- [Fix step](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md): `plugin/skills/critique/SKILL.md`
- [Blocker re-critique](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/critique/SKILL.md): `plugin/skills/critique/SKILL.md`

### Session history

- [Log skill](https://github.com/brandonsimpson/devils-advocate/blob/main/plugin/skills/log/SKILL.md): `plugin/skills/log/SKILL.md`
- **Critique logs**

### Other components

- **User**
- **Claude Code**

## Connections

- User → Claude Code: invokes plugin (evidence: `README.md`)
- Claude Code → Critique skill: routes command (evidence: `README.md`)
- Critique skill → Code critique: selects criteria (evidence: `README.md`)
- Critique skill → Plan critique: selects criteria (evidence: `README.md`)
- Critique skill → Standards discovery: discovers standards (evidence: `README.md`)
- Critique skill → Pattern analysis: mines patterns (evidence: `README.md`)
- Critique skill → Independent review: dispatches when needed (evidence: `README.md`)
- Critique skill → Fix step: structures fixes (evidence: `README.md`)
- Fix step → Blocker re-critique: rechecks blockers (evidence: `README.md`)
- Critique skill → Critique logs: saves critiques (evidence: `README.md`)
- User → Claude Code: requests history (evidence: `README.md`)
- Claude Code → Log skill: routes command (evidence: `README.md`)
- Log skill → Critique logs: shows session history (evidence: `README.md`)
