# proflead/codex-agents-library architecture

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

- Interactive diagram: https://gitdiagram.com/proflead/codex-agents-library
- Repository: https://github.com/proflead/codex-agents-library

## Overview

This repository is a Codex project-scoped library of 36 custom subagents, not an application runtime. The documented workflow is: a user opens the project in Codex, explicitly requests a subagent, Codex loads the project configuration and agent definitions, and the selected agent performs a specialist task. The capability groups below preserve the README catalog. No source excerpts were provided, so relationships rely on the README; individual agent behavior is summarized at catalog level.

Main entry points: [`.codex/agents`](https://github.com/proflead/codex-agents-library/tree/main/.codex/agents) (Orchestration agents), [`.codex/config.toml`](https://github.com/proflead/codex-agents-library/blob/main/.codex/config.toml) (Project config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coordination["Planning &amp; orchestration"]
  node_config["Project config<br/>[config.toml]"]
  node_orchestration["Orchestration agents<br/>[agents]"]
end

subgraph group_development["Software development"]
  node_development_agents["Development agents<br/>[agents]"]
  node_language_agents["Language experts<br/>[agents]"]
end

subgraph group_quality["Testing &amp; quality"]
  node_quality_agents["Quality agents<br/>[agents]"]
end

subgraph group_design["Design &amp; productivity"]
  node_design_agents["Design agents<br/>[agents]"]
  node_productivity_agents["Productivity agents<br/>[agents]"]
end

subgraph group_operations["DevOps &amp; debugging"]
  node_operations_agents["DevOps agents<br/>[agents]"]
  node_debug_agents["Debugging agents<br/>[agents]"]
end

node_user(("Project user"))
node_codex["Codex runtime"]
node_work["Specialist work"]

node_user -->|"requests task"| node_codex
node_codex -->|"loads settings"| node_config
node_codex -->|"loads definitions"| node_orchestration
node_codex -->|"spawns explicitly"| node_development_agents
node_codex -->|"spawns explicitly"| node_language_agents
node_codex -->|"spawns explicitly"| node_quality_agents
node_codex -->|"spawns explicitly"| node_design_agents
node_codex -->|"spawns explicitly"| node_productivity_agents
node_codex -->|"spawns explicitly"| node_operations_agents
node_codex -->|"spawns explicitly"| node_debug_agents
node_orchestration -->|"integrates outputs"| node_work
node_development_agents -->|"performs task"| node_work
node_language_agents -->|"performs task"| node_work
node_quality_agents -->|"performs task"| node_work
node_design_agents -->|"performs task"| node_work
node_productivity_agents -->|"performs task"| node_work
node_operations_agents -->|"performs task"| node_work
node_debug_agents -->|"performs task"| node_work

click node_config "https://github.com/proflead/codex-agents-library/blob/main/.codex/config.toml"
click node_orchestration "https://github.com/proflead/codex-agents-library/tree/main/.codex/agents"
click node_development_agents "https://github.com/proflead/codex-agents-library/tree/main/.codex/agents"
click node_language_agents "https://github.com/proflead/codex-agents-library/tree/main/.codex/agents"
click node_quality_agents "https://github.com/proflead/codex-agents-library/tree/main/.codex/agents"
click node_design_agents "https://github.com/proflead/codex-agents-library/tree/main/.codex/agents"
click node_productivity_agents "https://github.com/proflead/codex-agents-library/tree/main/.codex/agents"
click node_operations_agents "https://github.com/proflead/codex-agents-library/tree/main/.codex/agents"
click node_debug_agents "https://github.com/proflead/codex-agents-library/tree/main/.codex/agents"

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_config,node_orchestration,node_user toneBlue
class node_development_agents,node_language_agents toneAmber
class node_quality_agents toneMint
class node_design_agents,node_productivity_agents toneRose
class node_operations_agents,node_debug_agents,node_codex,node_work toneIndigo
```

## Components

### Planning & orchestration

- [Project config](https://github.com/proflead/codex-agents-library/blob/main/.codex/config.toml): `.codex/config.toml`
- [Orchestration agents](https://github.com/proflead/codex-agents-library/tree/main/.codex/agents): `.codex/agents`

### Software development

- [Development agents](https://github.com/proflead/codex-agents-library/tree/main/.codex/agents): `.codex/agents`
- [Language experts](https://github.com/proflead/codex-agents-library/tree/main/.codex/agents): `.codex/agents`

### Testing & quality

- [Quality agents](https://github.com/proflead/codex-agents-library/tree/main/.codex/agents): `.codex/agents`

### Design & productivity

- [Design agents](https://github.com/proflead/codex-agents-library/tree/main/.codex/agents): `.codex/agents`
- [Productivity agents](https://github.com/proflead/codex-agents-library/tree/main/.codex/agents): `.codex/agents`

### DevOps & debugging

- [DevOps agents](https://github.com/proflead/codex-agents-library/tree/main/.codex/agents): `.codex/agents`
- [Debugging agents](https://github.com/proflead/codex-agents-library/tree/main/.codex/agents): `.codex/agents`

### Other components

- **Project user**
- **Codex runtime**
- **Specialist work**

## Connections

- Project user → Codex runtime: requests task (evidence: `README.md`)
- Codex runtime → Project config: loads settings (evidence: `README.md`)
- Codex runtime → Orchestration agents: loads definitions (evidence: `README.md`)
- Codex runtime → Development agents: spawns explicitly (evidence: `README.md`)
- Codex runtime → Language experts: spawns explicitly (evidence: `README.md`)
- Codex runtime → Quality agents: spawns explicitly (evidence: `README.md`)
- Codex runtime → Design agents: spawns explicitly (evidence: `README.md`)
- Codex runtime → Productivity agents: spawns explicitly (evidence: `README.md`)
- Codex runtime → DevOps agents: spawns explicitly (evidence: `README.md`)
- Codex runtime → Debugging agents: spawns explicitly (evidence: `README.md`)
- Orchestration agents → Specialist work: integrates outputs (evidence: `README.md`)
- Development agents → Specialist work: performs task (evidence: `README.md`)
- Language experts → Specialist work: performs task (evidence: `README.md`)
- Quality agents → Specialist work: performs task (evidence: `README.md`)
- Design agents → Specialist work: performs task (evidence: `README.md`)
- Productivity agents → Specialist work: performs task (evidence: `README.md`)
- DevOps agents → Specialist work: performs task (evidence: `README.md`)
- Debugging agents → Specialist work: performs task (evidence: `README.md`)
