# yuxiaoma66/coclaudex architecture

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

- Interactive diagram: https://gitdiagram.com/yuxiaoma66/coclaudex
- Repository: https://github.com/yuxiaoma66/coclaudex

## Overview

coClaudex is a Claude Code skill for running sliced code or paper work through execution, independent review, and Claude confirmation. The principal workflow plans and gets approval for slices, selects an executor/reviewer combination, executes, reviews evidence, and either reworks, commits, or escalates. The README documents resumable `.colab/` audit files, model tiers, and paper-specific handling; because those runtime files are not in the tree and the skill source was not sampled, the graph focuses on documented dispatch and the sampled Codex runner, without asserting internal state wiring.

Main entry points: [`skills/coclaudex/SKILL.md`](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md) (Execute slice), [`skills/coclaudex/scripts/codex_run.py`](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/scripts/codex_run.py) (Codex runner), [`agents/coclaudex-exec-sonnet-medium.md`](https://github.com/yuxiaoma66/coclaudex/blob/main/agents/coclaudex-exec-sonnet-medium.md) (Claude executors), [`agents/coclaudex-review-opus-medium.md`](https://github.com/yuxiaoma66/coclaudex/blob/main/agents/coclaudex-review-opus-medium.md) (Claude reviewers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Slice workflow"]
  node_plan["Plan slices<br/>[SKILL.md]"]
  node_select["Choose combo<br/>[SKILL.md]"]
  node_execute["Execute slice<br/>[SKILL.md]"]
  node_review["Review slice<br/>[SKILL.md]"]
  node_confirm["Confirm findings<br/>[SKILL.md]"]
  node_commit["Commit slice<br/>[SKILL.md]"]
  node_escalate["Escalate slice<br/>[SKILL.md]"]
end

subgraph group_agents["Model agents"]
  node_claude_exec["Claude executors"]
  node_claude_review["Claude reviewers"]
  node_handoff["Handoff template<br/>[handoff.md]"]
  node_worker_rules["Worker rules<br/>[worker-rules.md]"]
  node_review_templates["Review templates<br/>[review-code.md]"]
end

subgraph group_codex["Codex integration"]
  node_codex_runner["Codex runner<br/>[codex_run.py]"]
  node_codex_cli(("Codex CLI"))
  node_review_schema["Review schema<br/>[review.schema.json]"]
end

subgraph group_support["Run configuration"]
  node_config["Tier configuration<br/>[config.json]"]
end

node_user(("User"))
node_claude(("Claude Code"))

node_user -->|"requests work"| node_claude
node_claude -->|"plans work"| node_plan
node_plan -->|"requests approval"| node_user
node_user -->|"chooses combo"| node_select
node_select -->|"dispatches slice"| node_execute
node_execute -->|"uses"| node_handoff
node_execute -->|"applies rules"| node_worker_rules
node_execute -->|"dispatches Claude"| node_claude_exec
node_execute -->|"dispatches Codex"| node_codex_runner
node_codex_runner -->|"runs"| node_codex_cli
node_codex_runner -->|"reads tiers"| node_config
node_review -->|"dispatches Claude"| node_claude_review
node_review -->|"dispatches Codex"| node_codex_runner
node_review -->|"uses"| node_review_templates
node_codex_runner -->|"validates reviews"| node_review_schema
node_execute -->|"submits result"| node_review
node_review -->|"returns evidence"| node_confirm
node_claude -->|"reproduces findings"| node_confirm
node_confirm -->|"requests rework"| node_execute
node_confirm -->|"commits in-scope files"| node_commit
node_confirm -->|"escalates after two rounds"| node_escalate
node_escalate -->|"asks for decision"| node_user

click node_plan "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md"
click node_select "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md"
click node_execute "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md"
click node_review "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md"
click node_confirm "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md"
click node_commit "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md"
click node_escalate "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md"
click node_claude_exec "https://github.com/yuxiaoma66/coclaudex/blob/main/agents/coclaudex-exec-sonnet-medium.md"
click node_claude_review "https://github.com/yuxiaoma66/coclaudex/blob/main/agents/coclaudex-review-opus-medium.md"
click node_handoff "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/templates/handoff.md"
click node_worker_rules "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/templates/worker-rules.md"
click node_review_templates "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/templates/review-code.md"
click node_codex_runner "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/scripts/codex_run.py"
click node_review_schema "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/schemas/review.schema.json"
click node_config "https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/config.json"

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_plan,node_select,node_execute,node_review,node_confirm,node_commit,node_escalate,node_user toneBlue
class node_claude_exec,node_claude_review,node_handoff,node_worker_rules,node_review_templates toneAmber
class node_codex_runner,node_codex_cli,node_review_schema toneMint
class node_config toneRose
class node_claude toneIndigo
```

## Components

### Slice workflow

- [Plan slices](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md): `skills/coclaudex/SKILL.md`
- [Choose combo](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md): `skills/coclaudex/SKILL.md`
- [Execute slice](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md): `skills/coclaudex/SKILL.md`
- [Review slice](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md): `skills/coclaudex/SKILL.md`
- [Confirm findings](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md): `skills/coclaudex/SKILL.md`
- [Commit slice](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md): `skills/coclaudex/SKILL.md`
- [Escalate slice](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/SKILL.md): `skills/coclaudex/SKILL.md`

### Model agents

- [Claude executors](https://github.com/yuxiaoma66/coclaudex/blob/main/agents/coclaudex-exec-sonnet-medium.md): `agents/coclaudex-exec-sonnet-medium.md`
- [Claude reviewers](https://github.com/yuxiaoma66/coclaudex/blob/main/agents/coclaudex-review-opus-medium.md): `agents/coclaudex-review-opus-medium.md`
- [Handoff template](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/templates/handoff.md): `skills/coclaudex/templates/handoff.md`
- [Worker rules](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/templates/worker-rules.md): `skills/coclaudex/templates/worker-rules.md`
- [Review templates](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/templates/review-code.md): `skills/coclaudex/templates/review-code.md`

### Codex integration

- [Codex runner](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/scripts/codex_run.py): `skills/coclaudex/scripts/codex_run.py`
- **Codex CLI**
- [Review schema](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/schemas/review.schema.json): `skills/coclaudex/schemas/review.schema.json`

### Run configuration

- [Tier configuration](https://github.com/yuxiaoma66/coclaudex/blob/main/skills/coclaudex/config.json): `skills/coclaudex/config.json`

### Other components

- **User**
- **Claude Code**

## Connections

- User → Claude Code: requests work
- Claude Code → Plan slices: plans work
- Plan slices → User: requests approval
- User → Choose combo: chooses combo
- Choose combo → Execute slice: dispatches slice
- Execute slice → Handoff template: uses
- Execute slice → Worker rules: applies rules
- Execute slice → Claude executors: dispatches Claude
- Execute slice → Codex runner: dispatches Codex
- Codex runner → Codex CLI: runs
- Codex runner → Tier configuration: reads tiers
- Review slice → Claude reviewers: dispatches Claude
- Review slice → Codex runner: dispatches Codex
- Review slice → Review templates: uses
- Codex runner → Review schema: validates reviews
- Execute slice → Review slice: submits result
- Review slice → Confirm findings: returns evidence
- Claude Code → Confirm findings: reproduces findings
- Confirm findings → Execute slice: requests rework
- Confirm findings → Commit slice: commits in-scope files
- Confirm findings → Escalate slice: escalates after two rounds
- Escalate slice → User: asks for decision