# masoncl/review-prompts architecture

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

- Interactive diagram: https://gitdiagram.com/masoncl/review-prompts
- Repository: https://github.com/masoncl/review-prompts

## Overview

This repository packages AI-assisted code-review prompts for Linux kernel, systemd, iproute, nfs-utils, and pahole. The main workflow is an engineer invoking a project’s review, debug, or verify command; the project skill supplies context and subsystem guides provide domain-specific knowledge. Kernel also includes substantial review utilities for categorizing patch changes, processing Claude output, and running parallel Claude commands. Relationships reflect the README and sampled script behavior; unsampled prompt files are represented by their existing directories.

Main entry points: [`kernel/skills/kernel.md`](https://github.com/masoncl/review-prompts/blob/main/kernel/skills/kernel.md) (Kernel skill), [`kernel/scripts/create_changes.py`](https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/create_changes.py) (Change categorizer), [`kernel/scripts/claude-json.py`](https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/claude-json.py) (Stream parser), [`kernel/scripts/claude_xargs.py`](https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/claude_xargs.py) (Parallel runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shared["Shared integration"]
  node_setup["Prompt installer<br/>[setup.sh]"]
  node_agent_adapters["Agent adapters"]
end

subgraph group_kernel["Kernel prompts"]
  node_kernel_skill["Kernel skill<br/>[kernel.md]"]
  node_kernel_commands["Review commands"]
  node_kernel_guides["Kernel guides"]
  node_change_categorizer["Change categorizer<br/>[create_changes.py]"]
  node_stream_parser["Stream parser<br/>[claude-json.py]"]
  node_parallel_runner["Parallel runner<br/>[claude_xargs.py]"]
  node_descendant_finder["Commit descendants"]
end

subgraph group_systemd["systemd prompts"]
  node_systemd_skill["systemd skill<br/>[systemd.md]"]
  node_systemd_commands["Review commands"]
  node_systemd_guides["systemd guides"]
end

subgraph group_iproute["iproute prompts"]
  node_iproute_skill["iproute skill<br/>[iproute.md]"]
  node_iproute_commands["Review commands"]
  node_iproute_guides["iproute guides"]
end

subgraph group_nfs["nfs-utils prompts"]
  node_nfs_skill["nfs-utils skill<br/>[nfs-utils.md]"]
  node_nfs_commands["Review commands"]
  node_nfs_guides["nfs-utils guides"]
end

subgraph group_pahole["pahole prompts"]
  node_pahole_skill["pahole skill<br/>[pahole.md]"]
  node_pahole_commands["Review commands"]
  node_pahole_guides["pahole guides"]
end

node_engineer(("Engineer"))

node_engineer -->|"installs prompts"| node_setup
node_engineer -->|"invokes"| node_kernel_commands
node_engineer -->|"invokes"| node_systemd_commands
node_engineer -->|"invokes"| node_iproute_commands
node_engineer -->|"invokes"| node_nfs_commands
node_engineer -->|"invokes"| node_pahole_commands
node_kernel_skill -->|"loads on demand"| node_kernel_guides
node_systemd_skill -->|"loads context"| node_systemd_guides
node_iproute_skill -->|"loads context"| node_iproute_guides
node_nfs_skill -->|"loads context"| node_nfs_guides
node_pahole_skill -->|"loads context"| node_pahole_guides
node_change_categorizer -->|"writes review context"| node_engineer
node_parallel_runner -->|"reports results"| node_engineer
node_stream_parser -->|"outputs parsed text"| node_engineer
node_descendant_finder -->|"prints descendants"| node_engineer

click node_setup "https://github.com/masoncl/review-prompts/blob/main/setup.sh"
click node_agent_adapters "https://github.com/masoncl/review-prompts/tree/main/agents"
click node_kernel_skill "https://github.com/masoncl/review-prompts/blob/main/kernel/skills/kernel.md"
click node_kernel_commands "https://github.com/masoncl/review-prompts/tree/main/kernel/slash-commands"
click node_kernel_guides "https://github.com/masoncl/review-prompts/tree/main/kernel/subsystem"
click node_change_categorizer "https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/create_changes.py"
click node_stream_parser "https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/claude-json.py"
click node_parallel_runner "https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/claude_xargs.py"
click node_descendant_finder "https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/find_descendants.py"
click node_systemd_skill "https://github.com/masoncl/review-prompts/blob/main/systemd/skills/systemd.md"
click node_systemd_commands "https://github.com/masoncl/review-prompts/tree/main/systemd/slash-commands"
click node_systemd_guides "https://github.com/masoncl/review-prompts/tree/main/systemd"
click node_iproute_skill "https://github.com/masoncl/review-prompts/blob/main/iproute/skills/iproute.md"
click node_iproute_commands "https://github.com/masoncl/review-prompts/tree/main/iproute/slash-commands"
click node_iproute_guides "https://github.com/masoncl/review-prompts/tree/main/iproute"
click node_nfs_skill "https://github.com/masoncl/review-prompts/blob/main/nfs-utils/skills/nfs-utils.md"
click node_nfs_commands "https://github.com/masoncl/review-prompts/tree/main/nfs-utils/slash-commands"
click node_nfs_guides "https://github.com/masoncl/review-prompts/tree/main/nfs-utils/subsystem"
click node_pahole_skill "https://github.com/masoncl/review-prompts/blob/main/pahole/skills/pahole.md"
click node_pahole_commands "https://github.com/masoncl/review-prompts/tree/main/pahole/slash-commands"
click node_pahole_guides "https://github.com/masoncl/review-prompts/tree/main/pahole"

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_setup,node_agent_adapters toneBlue
class node_kernel_skill,node_kernel_commands,node_kernel_guides,node_change_categorizer,node_stream_parser,node_parallel_runner,node_descendant_finder toneAmber
class node_systemd_skill,node_systemd_commands,node_systemd_guides toneMint
class node_iproute_skill,node_iproute_commands,node_iproute_guides toneRose
class node_nfs_skill,node_nfs_commands,node_nfs_guides,node_engineer toneIndigo
class node_pahole_skill,node_pahole_commands,node_pahole_guides toneTeal
```

## Components

### Shared integration

- [Prompt installer](https://github.com/masoncl/review-prompts/blob/main/setup.sh): `setup.sh`
- [Agent adapters](https://github.com/masoncl/review-prompts/tree/main/agents): `agents`

### Kernel prompts

- [Kernel skill](https://github.com/masoncl/review-prompts/blob/main/kernel/skills/kernel.md): `kernel/skills/kernel.md`
- [Review commands](https://github.com/masoncl/review-prompts/tree/main/kernel/slash-commands): `kernel/slash-commands`
- [Kernel guides](https://github.com/masoncl/review-prompts/tree/main/kernel/subsystem): `kernel/subsystem`
- [Change categorizer](https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/create_changes.py): `kernel/scripts/create_changes.py`
- [Stream parser](https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/claude-json.py): `kernel/scripts/claude-json.py`
- [Parallel runner](https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/claude_xargs.py): `kernel/scripts/claude_xargs.py`
- [Commit descendants](https://github.com/masoncl/review-prompts/blob/main/kernel/scripts/find_descendants.py): `kernel/scripts/find_descendants.py`

### systemd prompts

- [systemd skill](https://github.com/masoncl/review-prompts/blob/main/systemd/skills/systemd.md): `systemd/skills/systemd.md`
- [Review commands](https://github.com/masoncl/review-prompts/tree/main/systemd/slash-commands): `systemd/slash-commands`
- [systemd guides](https://github.com/masoncl/review-prompts/tree/main/systemd): `systemd`

### iproute prompts

- [iproute skill](https://github.com/masoncl/review-prompts/blob/main/iproute/skills/iproute.md): `iproute/skills/iproute.md`
- [Review commands](https://github.com/masoncl/review-prompts/tree/main/iproute/slash-commands): `iproute/slash-commands`
- [iproute guides](https://github.com/masoncl/review-prompts/tree/main/iproute): `iproute`

### nfs-utils prompts

- [nfs-utils skill](https://github.com/masoncl/review-prompts/blob/main/nfs-utils/skills/nfs-utils.md): `nfs-utils/skills/nfs-utils.md`
- [Review commands](https://github.com/masoncl/review-prompts/tree/main/nfs-utils/slash-commands): `nfs-utils/slash-commands`
- [nfs-utils guides](https://github.com/masoncl/review-prompts/tree/main/nfs-utils/subsystem): `nfs-utils/subsystem`

### pahole prompts

- [pahole skill](https://github.com/masoncl/review-prompts/blob/main/pahole/skills/pahole.md): `pahole/skills/pahole.md`
- [Review commands](https://github.com/masoncl/review-prompts/tree/main/pahole/slash-commands): `pahole/slash-commands`
- [pahole guides](https://github.com/masoncl/review-prompts/tree/main/pahole): `pahole`

### Other components

- **Engineer**

## Connections

- Engineer → Prompt installer: installs prompts (evidence: `README.md`)
- Engineer → Review commands: invokes (evidence: `README.md`)
- Engineer → Review commands: invokes (evidence: `README.md`)
- Engineer → Review commands: invokes (evidence: `README.md`)
- Engineer → Review commands: invokes (evidence: `README.md`)
- Engineer → Review commands: invokes (evidence: `README.md`)
- Kernel skill → Kernel guides: loads on demand (evidence: `README.md`)
- systemd skill → systemd guides: loads context (evidence: `README.md`)
- iproute skill → iproute guides: loads context (evidence: `README.md`)
- nfs-utils skill → nfs-utils guides: loads context (evidence: `README.md`)
- pahole skill → pahole guides: loads context (evidence: `README.md`)
- Change categorizer → Engineer: writes review context (evidence: `kernel/scripts/create_changes.py`)
- Parallel runner → Engineer: reports results (evidence: `kernel/scripts/claude_xargs.py`)
- Stream parser → Engineer: outputs parsed text (evidence: `kernel/scripts/claude-json.py`)
- Commit descendants → Engineer: prints descendants (evidence: `kernel/scripts/find_descendants.py`)
