# kele-dev/claude-orchestrator-skill architecture

> Architecture diagram of the GitHub repository kele-dev/claude-orchestrator-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kele-dev/claude-orchestrator-skill
- Repository: https://github.com/kele-dev/claude-orchestrator-skill

## Overview

Claude Orchestrator Skill is a Claude Code plugin that delegates project work to save tokens while keeping planning and PRD writing in the main session. Its primary workflow is task intake, planning, delegated execution, verification/review, and reporting; team and autopilot add parallel or repeated batches, caps, and checkpoints. Skills define user-facing modes, agent prompts define delegated roles, hooks enforce session behavior, and scripts summarize transcripts and token usage. Relationships below follow README statements and shown imports; unsampled skill internals are represented by their exact directory paths.

Main entry points: [`agents/haiku-coder.md`](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/agents/haiku-coder.md) (Haiku coder), [`hooks/session-info.mjs`](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/session-info.mjs) (Session info), [`skills/team/SKILL.md`](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/team/SKILL.md) (Team mode), [`skills/autopilot/SKILL.md`](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/autopilot/SKILL.md) (Autopilot mode)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_modes["Task modes"]
  node_on["On mode<br/>[SKILL.md]"]
  node_team["Team mode<br/>[SKILL.md]"]
  node_autopilot["Autopilot mode<br/>[SKILL.md]"]
  node_off["Off mode<br/>[SKILL.md]"]
  node_learn["Project lessons<br/>[SKILL.md]"]
  node_init["Project mapping<br/>[SKILL.md]"]
  node_resume["Resume work<br/>[SKILL.md]"]
  node_status["Status view<br/>[SKILL.md]"]
end

subgraph group_delegation["Delegated work"]
  node_planner["Opus planner<br/>[opus-planner.md]"]
  node_coder["Haiku coder<br/>[haiku-coder.md]"]
  node_developer["Sonnet developer<br/>[sonnet-dev.md]"]
  node_reviewer["Opus reviewer<br/>[opus-reviewer.md]"]
end

subgraph group_session["Session controls"]
  node_edit_guard["Edit guard<br/>[guard-edit.mjs]"]
  node_review_guard["Review guard<br/>[guard-review.mjs]"]
  node_output_trim["Output trim<br/>[trim-output.mjs]"]
  node_session_info["Session info<br/>[session-info.mjs]"]
  node_long_session["Long-session warning<br/>[long-session.mjs]"]
  node_project_store[("Project store")]
end

subgraph group_analysis["Transcript analysis"]
  node_budget["Budget report<br/>[budget.mjs]"]
  node_digest["Transcript digest<br/>[digest.mjs]"]
  node_trace["Token trace<br/>[trace-tokens.mjs]"]
  node_transcript["Transcript helpers<br/>[transcript.mjs]"]
end

node_user(("User"))
node_main(("Main session"))

node_user -->|"starts mode"| node_on
node_user -->|"starts parallel"| node_team
node_user -->|"starts autonomous"| node_autopilot
node_main -->|"plans work"| node_planner
node_main -->|"delegates tasks"| node_coder
node_main -->|"escalates work"| node_developer
node_main -->|"requests review"| node_reviewer
node_team -->|"runs lanes"| node_coder
node_autopilot -->|"runs batches"| node_coder
node_main -->|"writes PRD"| node_on
node_main -->|"saves lessons"| node_project_store
node_main -->|"saves checkpoints"| node_project_store
node_resume -->|"reads checkpoints"| node_project_store
node_learn -->|"reads lessons"| node_project_store
node_init -->|"writes map"| node_project_store
node_status -->|"reads status data"| node_project_store
node_edit_guard -->|"blocks edits"| node_main
node_review_guard -->|"checks PRD path"| node_reviewer
node_output_trim -->|"trims output"| node_main
node_session_info -->|"indexes data"| node_project_store
node_session_info -->|"prints command"| node_digest
node_long_session -->|"warns on growth"| node_main
node_budget -->|"parses entries"| node_transcript
node_digest -->|"reads entries"| node_transcript
node_trace -->|"reports token use"| node_user

click node_on "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/on/SKILL.md"
click node_team "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/team/SKILL.md"
click node_autopilot "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/autopilot/SKILL.md"
click node_off "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/off/SKILL.md"
click node_learn "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/learn/SKILL.md"
click node_init "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/init/SKILL.md"
click node_resume "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/resume/SKILL.md"
click node_status "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/status/SKILL.md"
click node_planner "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/agents/opus-planner.md"
click node_coder "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/agents/haiku-coder.md"
click node_developer "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/agents/sonnet-dev.md"
click node_reviewer "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/agents/opus-reviewer.md"
click node_edit_guard "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/guard-edit.mjs"
click node_review_guard "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/guard-review.mjs"
click node_output_trim "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/trim-output.mjs"
click node_session_info "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/session-info.mjs"
click node_long_session "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/long-session.mjs"
click node_budget "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/scripts/budget.mjs"
click node_digest "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/scripts/digest.mjs"
click node_trace "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/scripts/trace-tokens.mjs"
click node_transcript "https://github.com/kele-dev/claude-orchestrator-skill/blob/main/scripts/transcript.mjs"

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_on,node_team,node_autopilot,node_off,node_learn,node_init,node_resume,node_status,node_user toneBlue
class node_planner,node_coder,node_developer,node_reviewer toneAmber
class node_edit_guard,node_review_guard,node_output_trim,node_session_info,node_long_session,node_project_store toneMint
class node_budget,node_digest,node_trace,node_transcript toneRose
class node_main toneIndigo
```

## Components

### Task modes

- [On mode](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/on/SKILL.md): `skills/on/SKILL.md`
- [Team mode](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/team/SKILL.md): `skills/team/SKILL.md`
- [Autopilot mode](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/autopilot/SKILL.md): `skills/autopilot/SKILL.md`
- [Off mode](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/off/SKILL.md): `skills/off/SKILL.md`
- [Project lessons](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/learn/SKILL.md): `skills/learn/SKILL.md`
- [Project mapping](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/init/SKILL.md): `skills/init/SKILL.md`
- [Resume work](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/resume/SKILL.md): `skills/resume/SKILL.md`
- [Status view](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/skills/status/SKILL.md): `skills/status/SKILL.md`

### Delegated work

- [Opus planner](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/agents/opus-planner.md): `agents/opus-planner.md`
- [Haiku coder](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/agents/haiku-coder.md): `agents/haiku-coder.md`
- [Sonnet developer](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/agents/sonnet-dev.md): `agents/sonnet-dev.md`
- [Opus reviewer](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/agents/opus-reviewer.md): `agents/opus-reviewer.md`

### Session controls

- [Edit guard](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/guard-edit.mjs): `hooks/guard-edit.mjs`
- [Review guard](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/guard-review.mjs): `hooks/guard-review.mjs`
- [Output trim](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/trim-output.mjs): `hooks/trim-output.mjs`
- [Session info](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/session-info.mjs): `hooks/session-info.mjs`
- [Long-session warning](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/hooks/long-session.mjs): `hooks/long-session.mjs`
- **Project store**

### Transcript analysis

- [Budget report](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/scripts/budget.mjs): `scripts/budget.mjs`
- [Transcript digest](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/scripts/digest.mjs): `scripts/digest.mjs`
- [Token trace](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/scripts/trace-tokens.mjs): `scripts/trace-tokens.mjs`
- [Transcript helpers](https://github.com/kele-dev/claude-orchestrator-skill/blob/main/scripts/transcript.mjs): `scripts/transcript.mjs`

### Other components

- **User**
- **Main session**

## Connections

- User → On mode: starts mode (evidence: `README.md`)
- User → Team mode: starts parallel (evidence: `README.md`)
- User → Autopilot mode: starts autonomous (evidence: `README.md`)
- Main session → Opus planner: plans work (evidence: `README.md`)
- Main session → Haiku coder: delegates tasks (evidence: `README.md`)
- Main session → Sonnet developer: escalates work (evidence: `README.md`)
- Main session → Opus reviewer: requests review (evidence: `README.md`)
- Team mode → Haiku coder: runs lanes (evidence: `README.md`)
- Autopilot mode → Haiku coder: runs batches (evidence: `README.md`)
- Main session → On mode: writes PRD (evidence: `README.md`)
- Main session → Project store: saves lessons (evidence: `README.md`)
- Main session → Project store: saves checkpoints (evidence: `README.md`)
- Resume work → Project store: reads checkpoints (evidence: `README.md`)
- Project lessons → Project store: reads lessons (evidence: `README.md`)
- Project mapping → Project store: writes map (evidence: `README.md`)
- Status view → Project store: reads status data (evidence: `README.md`)
- Edit guard → Main session: blocks edits (evidence: `README.md`)
- Review guard → Opus reviewer: checks PRD path (evidence: `hooks/guard-review.mjs`)
- Output trim → Main session: trims output (evidence: `README.md`)
- Session info → Project store: indexes data (evidence: `hooks/session-info.mjs`)
- Session info → Transcript digest: prints command (evidence: `hooks/session-info.mjs`)
- Long-session warning → Main session: warns on growth (evidence: `README.md`)
- Budget report → Transcript helpers: parses entries (evidence: `scripts/budget.mjs`)
- Transcript digest → Transcript helpers: reads entries (evidence: `scripts/digest.mjs`)
- Token trace → User: reports token use (evidence: `scripts/trace-tokens.mjs`)
