# arumwu/arum-codex-subagents architecture

> Architecture diagram of the GitHub repository arumwu/arum-codex-subagents, 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/arumwu/arum-codex-subagents
- Repository: https://github.com/arumwu/arum-codex-subagents

## Overview

Arum Codex Subagents is a curated bundle of 12 custom-agent profiles, not an agent runtime. The documented workflow is to install the TOML profiles into a Codex agent directory, then ask a Codex session to delegate work to a named role. The graph groups the profiles by their documented responsibilities; Codex behavior and the installer’s implementation are external or unsampled, so relationships rely on the README rather than inspected runtime code.

Main entry points: [`install.sh`](https://github.com/arumwu/arum-codex-subagents/blob/main/install.sh) (Profile Installer), [`agents`](https://github.com/arumwu/arum-codex-subagents/tree/main/agents) (Browser & Debug)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Installation"]
  node_installer["Profile Installer<br/>[install.sh]"]
  node_codex_agents[("Codex Agent Directory")]
end

subgraph group_analysis["Analysis Agents"]
  node_debug_profiles["Browser &amp; Debug"]
  node_mapping_docs["Code &amp; Docs Research"]
end

subgraph group_engineering["Engineering Agents"]
  node_mcp_php["MCP &amp; PHP"]
  node_wordpress_sql["WordPress &amp; SQL"]
end

subgraph group_governance["Product &amp; Assurance"]
  node_product_review["Product &amp; Review"]
  node_security_seo["Security &amp; SEO"]
end

node_user(("Developer"))
node_codex(("Codex Session"))

node_user -->|"runs"| node_installer
node_installer -->|"installs profiles"| node_codex_agents
node_user -->|"requests delegation"| node_codex
node_codex -->|"delegates to"| node_debug_profiles
node_codex -->|"delegates to"| node_mapping_docs
node_codex -->|"delegates to"| node_mcp_php
node_codex -->|"delegates to"| node_wordpress_sql
node_codex -->|"delegates to"| node_product_review
node_codex -->|"delegates to"| node_security_seo
node_codex_agents -->|"loads profiles"| node_codex

click node_installer "https://github.com/arumwu/arum-codex-subagents/blob/main/install.sh"
click node_debug_profiles "https://github.com/arumwu/arum-codex-subagents/tree/main/agents"
click node_mapping_docs "https://github.com/arumwu/arum-codex-subagents/tree/main/agents"
click node_mcp_php "https://github.com/arumwu/arum-codex-subagents/tree/main/agents"
click node_wordpress_sql "https://github.com/arumwu/arum-codex-subagents/tree/main/agents"
click node_product_review "https://github.com/arumwu/arum-codex-subagents/tree/main/agents"
click node_security_seo "https://github.com/arumwu/arum-codex-subagents/tree/main/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_installer,node_codex_agents toneBlue
class node_debug_profiles,node_mapping_docs toneAmber
class node_mcp_php,node_wordpress_sql toneMint
class node_product_review,node_security_seo toneRose
class node_user,node_codex toneIndigo
```

## Components

### Installation

- [Profile Installer](https://github.com/arumwu/arum-codex-subagents/blob/main/install.sh): `install.sh`
- **Codex Agent Directory**

### Analysis Agents

- [Browser & Debug](https://github.com/arumwu/arum-codex-subagents/tree/main/agents): `agents`
- [Code & Docs Research](https://github.com/arumwu/arum-codex-subagents/tree/main/agents): `agents`

### Engineering Agents

- [MCP & PHP](https://github.com/arumwu/arum-codex-subagents/tree/main/agents): `agents`
- [WordPress & SQL](https://github.com/arumwu/arum-codex-subagents/tree/main/agents): `agents`

### Product & Assurance

- [Product & Review](https://github.com/arumwu/arum-codex-subagents/tree/main/agents): `agents`
- [Security & SEO](https://github.com/arumwu/arum-codex-subagents/tree/main/agents): `agents`

### Other components

- **Developer**
- **Codex Session**

## Connections

- Developer → Profile Installer: runs (evidence: `README.md`)
- Profile Installer → Codex Agent Directory: installs profiles (evidence: `README.md`)
- Developer → Codex Session: requests delegation (evidence: `README.md`)
- Codex Session → Browser & Debug: delegates to (evidence: `README.md`)
- Codex Session → Code & Docs Research: delegates to (evidence: `README.md`)
- Codex Session → MCP & PHP: delegates to (evidence: `README.md`)
- Codex Session → WordPress & SQL: delegates to (evidence: `README.md`)
- Codex Session → Product & Review: delegates to (evidence: `README.md`)
- Codex Session → Security & SEO: delegates to (evidence: `README.md`)
- Codex Agent Directory → Codex Session: loads profiles (evidence: `README.md`)
