# colinb4987/grill-with-docs architecture

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

- Interactive diagram: https://gitdiagram.com/colinb4987/grill-with-docs
- Repository: https://github.com/colinb4987/grill-with-docs

## Overview

Grill with Docs is a skill-only plugin: a user invokes the skill with a plan and documents, and the skill conducts an evidence-grounded adversarial review that ends in a synthesis. Its documented stages include decision-tree construction, numbered interview rounds, tiered evidence handling, conflict surfacing, and synthesis. The README describes the supporting reference materials, but no source excerpts were provided, so relationships among those materials are shown only where documented.

Main entry points: [`plugin/skills/grill-with-docs/SKILL.md`](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/SKILL.md) (Review skill), [`plugin/plugin.json`](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/plugin.json) (Plugin manifest), [`plugin/skills/grill-with-docs/references/adversarial.md`](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/adversarial.md) (Failure patterns), [`plugin/skills/grill-with-docs/references/commands.md`](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/commands.md) (User commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_review["Review workflow"]
  node_plan["Plan or decision"]
  node_skill["Review skill<br/>[SKILL.md]"]
  node_adversarial["Failure patterns<br/>[adversarial.md]"]
  node_commands["User commands<br/>[commands.md]"]
  node_example["Worked session<br/>[examples.md]"]
  node_synthesis["Review synthesis<br/>[SKILL.md]"]
end

subgraph group_evidence["Evidence handling"]
  node_source_docs["Supplied documents"]
  node_ingestion["Document ingestion<br/>[ingestion.md]"]
  node_evidence_rules["Evidence rules<br/>[evidence.md]"]
end

subgraph group_plugin["Plugin package"]
  node_manifest["Plugin manifest<br/>[plugin.json]"]
end

node_user(("User"))

node_user -->|"invokes explicitly"| node_skill
node_user -->|"provides"| node_plan
node_user -->|"attaches"| node_source_docs
node_skill -->|"builds decision tree"| node_plan
node_skill -->|"uses as evidence"| node_source_docs
node_skill -->|"uses guidance"| node_ingestion
node_skill -->|"uses guidance"| node_evidence_rules
node_skill -->|"uses catalogue"| node_adversarial
node_skill -->|"supports controls"| node_commands
node_skill -->|"includes example"| node_example
node_skill -->|"produces"| node_synthesis
node_manifest -->|"packages"| node_skill

click node_skill "https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/SKILL.md"
click node_ingestion "https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/ingestion.md"
click node_evidence_rules "https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/evidence.md"
click node_adversarial "https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/adversarial.md"
click node_commands "https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/commands.md"
click node_example "https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/examples.md"
click node_synthesis "https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/SKILL.md"
click node_manifest "https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/plugin.json"

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_plan,node_skill,node_adversarial,node_commands,node_example,node_synthesis,node_user toneBlue
class node_source_docs,node_ingestion,node_evidence_rules toneAmber
class node_manifest toneMint
```

## Components

### Review workflow

- **Plan or decision**
- [Review skill](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/SKILL.md): `plugin/skills/grill-with-docs/SKILL.md`
- [Failure patterns](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/adversarial.md): `plugin/skills/grill-with-docs/references/adversarial.md`
- [User commands](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/commands.md): `plugin/skills/grill-with-docs/references/commands.md`
- [Worked session](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/examples.md): `plugin/skills/grill-with-docs/references/examples.md`
- [Review synthesis](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/SKILL.md): `plugin/skills/grill-with-docs/SKILL.md`

### Evidence handling

- **Supplied documents**
- [Document ingestion](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/ingestion.md): `plugin/skills/grill-with-docs/references/ingestion.md`
- [Evidence rules](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/skills/grill-with-docs/references/evidence.md): `plugin/skills/grill-with-docs/references/evidence.md`

### Plugin package

- [Plugin manifest](https://github.com/colinb4987/grill-with-docs/blob/plugin/v1/plugin/plugin.json): `plugin/plugin.json`

### Other components

- **User**

## Connections

- User → Review skill: invokes explicitly (evidence: `README.md`)
- User → Plan or decision: provides (evidence: `README.md`)
- User → Supplied documents: attaches (evidence: `README.md`)
- Review skill → Plan or decision: builds decision tree (evidence: `README.md`)
- Review skill → Supplied documents: uses as evidence (evidence: `README.md`)
- Review skill → Document ingestion: uses guidance (evidence: `README.md`)
- Review skill → Evidence rules: uses guidance (evidence: `README.md`)
- Review skill → Failure patterns: uses catalogue (evidence: `README.md`)
- Review skill → User commands: supports controls (evidence: `README.md`)
- Review skill → Worked session: includes example (evidence: `README.md`)
- Review skill → Review synthesis: produces (evidence: `README.md`)
- Plugin manifest → Review skill: packages (evidence: `README.md`)
