doc

Explain complex code through clear narratives and visual diagrams

Create Mermaid or ASCII diagrams for flowcharts, architecture, ERDs, C4 models, mindmaps, and more

Run documentation health checks (freshness, links, drift, cross-doc consistency)

Manage architecture RFCs (create, review, list, update)

Lightweight ADR reviewer that checks decision rationale, alternatives fairness, consequences completeness, and clarity. Reads Author's Notes as prioritized attack vectors. Use when the ADR review operation needs a quick quality check.

Adversarial RFC critic that red-teams architecture proposals. Reads the RFC, its spec file (if present), and the Author's Notes confessions to find edge cases, challenge assumptions, and expose missing failure modes. Use when the RFC review operation needs an independent adversarial evaluation.

Create, review, and manage Architecture Decision Records (ADRs) with auto-numbering, template detection, quality review, and index maintenance. Use when user mentions "ADR", "architecture decision", "document this decision", "create ADR", "review ADR", editing ADR files (docs/adr/, doc/adr/, .adr/), or discussing architectural choices and tradeoffs.

Explains complex code through clear narratives, visual diagrams, and step-by-step breakdowns. Use when user asks to explain code, understand algorithms, analyze design patterns, wants code walkthroughs, or mentions "explain this code", "how does this work", "code breakdown", or "understand this function".

Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual documentation.

Audit, classify, validate, and scaffold documentation using the Diataxis framework (Tutorials, How-to guides, Reference, Explanation). Use when user mentions "diataxis", "documentation framework", "quadrant", "doc audit", "doc coverage", "collapsed document", "tutorial vs how-to", "quadrant purity", "documentation types", or wants to classify docs by type.

Guide users through structured collaborative documentation creation. Use when user wants to write documentation, update README, create architecture docs, draft proposals, technical specs, decision docs, refactor documentation, create API docs, or document code.