# matsengrp/claude-code-agents architecture

> Architecture diagram of the GitHub repository matsengrp/claude-code-agents, 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/matsengrp/claude-code-agents
- Repository: https://github.com/matsengrp/claude-code-agents

## Overview

This archived repository is a catalog of Claude Code subagent instruction files, not a software runtime. The documented workflow is that a user invokes a specialized agent in Claude Code, which performs a review, edit, or research task and returns its result. The README identifies the agents’ roles and explicitly notes the PDF navigator dependency; relationships beyond those documented capabilities are not inferred from unsampled agent files.

Main entry points: [`pdf-question-answerer.md`](https://github.com/matsengrp/claude-code-agents/blob/main/pdf-question-answerer.md) (PDF Question Answerer), [`clean-code-reviewer.md`](https://github.com/matsengrp/claude-code-agents/blob/main/clean-code-reviewer.md) (Clean Code Reviewer), [`antipattern-scanner.md`](https://github.com/matsengrp/claude-code-agents/blob/main/antipattern-scanner.md) (Antipattern Scanner), [`code-smell-detector.md`](https://github.com/matsengrp/claude-code-agents/blob/main/code-smell-detector.md) (Code Smell Detector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_code["Code Quality"]
  node_code_review["Clean Code Reviewer"]
  node_antipattern["Antipattern Scanner"]
  node_smell["Code Smell Detector"]
  node_snakemake["Snakemake Pipeline Expert"]
end

subgraph group_writing["Scientific Writing"]
  node_tex_editor["Scientific TeX Editor"]
  node_grammar["TeX Grammar Checker"]
  node_tense["TeX Verb Tense Checker"]
  node_topic["Topic Sentence Stickler"]
end

subgraph group_pdf["PDF Work"]
  node_pdf_qa["PDF Question Answerer"]
  node_pdf_proof["PDF Proof Reader"]
end

subgraph group_publication["Submission Checks"]
  node_journal["Journal Submission Checker"]
end

node_user(("User"))
node_claude["Claude Code"]
node_pdf_navigator["PDF Navigator MCP"]
node_result(("Task Result"))

node_user -->|"requests task"| node_claude
node_claude -->|"invokes agent"| node_code_review
node_claude -->|"invokes agent"| node_topic
node_claude -->|"invokes agent"| node_pdf_qa
node_claude -->|"dispatches agent"| node_antipattern
node_claude -->|"dispatches agent"| node_smell
node_claude -->|"dispatches agent"| node_tex_editor
node_claude -->|"dispatches agent"| node_grammar
node_claude -->|"dispatches agent"| node_tense
node_claude -->|"dispatches agent"| node_pdf_proof
node_claude -->|"dispatches agent"| node_journal
node_claude -->|"dispatches agent"| node_snakemake
node_code_review -->|"returns review"| node_result
node_topic -->|"returns feedback"| node_result
node_pdf_qa -->|"returns answers"| node_result
node_pdf_qa -.->|"requires integration"| node_pdf_navigator
node_pdf_proof -->|"returns proofing"| node_result
node_tex_editor -->|"returns edits"| node_result
node_grammar -->|"returns corrections"| node_result
node_tense -->|"returns feedback"| node_result
node_journal -->|"returns checks"| node_result
node_antipattern -.->|"returns findings"| node_result
node_smell -.->|"returns findings"| node_result
node_snakemake -.->|"returns guidance"| node_result

click node_code_review "https://github.com/matsengrp/claude-code-agents/blob/main/clean-code-reviewer.md"
click node_antipattern "https://github.com/matsengrp/claude-code-agents/blob/main/antipattern-scanner.md"
click node_smell "https://github.com/matsengrp/claude-code-agents/blob/main/code-smell-detector.md"
click node_tex_editor "https://github.com/matsengrp/claude-code-agents/blob/main/scientific-tex-editor.md"
click node_grammar "https://github.com/matsengrp/claude-code-agents/blob/main/tex-grammar-checker.md"
click node_tense "https://github.com/matsengrp/claude-code-agents/blob/main/tex-verb-tense-checker.md"
click node_topic "https://github.com/matsengrp/claude-code-agents/blob/main/topic-sentence-stickler.md"
click node_pdf_qa "https://github.com/matsengrp/claude-code-agents/blob/main/pdf-question-answerer.md"
click node_pdf_proof "https://github.com/matsengrp/claude-code-agents/blob/main/pdf-proof-reader.md"
click node_journal "https://github.com/matsengrp/claude-code-agents/blob/main/journal-submission-checker.md"
click node_snakemake "https://github.com/matsengrp/claude-code-agents/blob/main/snakemake-pipeline-expert.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_code_review,node_antipattern,node_smell,node_snakemake,node_user toneBlue
class node_tex_editor,node_grammar,node_tense,node_topic toneAmber
class node_pdf_qa,node_pdf_proof toneMint
class node_journal,node_result toneRose
class node_claude,node_pdf_navigator toneIndigo
```

## Components

### Code Quality

- [Clean Code Reviewer](https://github.com/matsengrp/claude-code-agents/blob/main/clean-code-reviewer.md): `clean-code-reviewer.md`
- [Antipattern Scanner](https://github.com/matsengrp/claude-code-agents/blob/main/antipattern-scanner.md): `antipattern-scanner.md`
- [Code Smell Detector](https://github.com/matsengrp/claude-code-agents/blob/main/code-smell-detector.md): `code-smell-detector.md`
- [Snakemake Pipeline Expert](https://github.com/matsengrp/claude-code-agents/blob/main/snakemake-pipeline-expert.md): `snakemake-pipeline-expert.md`

### Scientific Writing

- [Scientific TeX Editor](https://github.com/matsengrp/claude-code-agents/blob/main/scientific-tex-editor.md): `scientific-tex-editor.md`
- [TeX Grammar Checker](https://github.com/matsengrp/claude-code-agents/blob/main/tex-grammar-checker.md): `tex-grammar-checker.md`
- [TeX Verb Tense Checker](https://github.com/matsengrp/claude-code-agents/blob/main/tex-verb-tense-checker.md): `tex-verb-tense-checker.md`
- [Topic Sentence Stickler](https://github.com/matsengrp/claude-code-agents/blob/main/topic-sentence-stickler.md): `topic-sentence-stickler.md`

### PDF Work

- [PDF Question Answerer](https://github.com/matsengrp/claude-code-agents/blob/main/pdf-question-answerer.md): `pdf-question-answerer.md`
- [PDF Proof Reader](https://github.com/matsengrp/claude-code-agents/blob/main/pdf-proof-reader.md): `pdf-proof-reader.md`

### Submission Checks

- [Journal Submission Checker](https://github.com/matsengrp/claude-code-agents/blob/main/journal-submission-checker.md): `journal-submission-checker.md`

### Other components

- **User**
- **Claude Code**
- **PDF Navigator MCP**
- **Task Result**

## Connections

- User → Claude Code: requests task (evidence: `README.md`)
- Claude Code → Clean Code Reviewer: invokes agent (evidence: `README.md`)
- Claude Code → Topic Sentence Stickler: invokes agent (evidence: `README.md`)
- Claude Code → PDF Question Answerer: invokes agent (evidence: `README.md`)
- Claude Code → Antipattern Scanner: dispatches agent (evidence: `README.md`)
- Claude Code → Code Smell Detector: dispatches agent (evidence: `README.md`)
- Claude Code → Scientific TeX Editor: dispatches agent (evidence: `README.md`)
- Claude Code → TeX Grammar Checker: dispatches agent (evidence: `README.md`)
- Claude Code → TeX Verb Tense Checker: dispatches agent (evidence: `README.md`)
- Claude Code → PDF Proof Reader: dispatches agent (evidence: `README.md`)
- Claude Code → Journal Submission Checker: dispatches agent (evidence: `README.md`)
- Claude Code → Snakemake Pipeline Expert: dispatches agent (evidence: `README.md`)
- Clean Code Reviewer → Task Result: returns review (evidence: `README.md`)
- Topic Sentence Stickler → Task Result: returns feedback (evidence: `README.md`)
- PDF Question Answerer → Task Result: returns answers (evidence: `README.md`)
- PDF Question Answerer → PDF Navigator MCP: requires integration (evidence: `README.md`)
- PDF Proof Reader → Task Result: returns proofing (evidence: `README.md`)
- Scientific TeX Editor → Task Result: returns edits (evidence: `README.md`)
- TeX Grammar Checker → Task Result: returns corrections (evidence: `README.md`)
- TeX Verb Tense Checker → Task Result: returns feedback (evidence: `README.md`)
- Journal Submission Checker → Task Result: returns checks (evidence: `README.md`)
- Antipattern Scanner → Task Result: returns findings
- Code Smell Detector → Task Result: returns findings
- Snakemake Pipeline Expert → Task Result: returns guidance
