# cexll/myclaude architecture

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

- Interactive diagram: https://gitdiagram.com/cexll/myclaude
- Repository: https://github.com/cexll/myclaude

## Overview

This repository combines Claude Code workflow skills and hooks with a Go wrapper that runs coding tasks through multiple AI backends. The principal documented flow is Claude Code orchestrating work and the wrapper executing it; the `/do` skill is the recommended feature-development workflow. The tree also includes harness coordination, browser automation, and an installer. Several skill families named in the README are absent from the supplied tree, so they are not represented as source nodes; some wrapper internals are connected only where excerpts show the relationship.

Main entry points: [`codeagent-wrapper/internal/app/app.go`](https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/app/app.go) (CLI Runtime), [`codeagent-wrapper/internal/application/runtaskset/runtaskset.go`](https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/application/runtaskset/runtaskset.go) (Parallel Task Planning), [`bin/cli.js`](https://github.com/cexll/myclaude/blob/master/bin/cli.js) (Module Installer), [`skills/do/scripts/task.py`](https://github.com/cexll/myclaude/blob/master/skills/do/scripts/task.py) (Feature Workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Installation"]
  node_installer["Module Installer<br/>[cli.js]"]
  node_install_engine["Install Engine<br/>[install.py]"]
end

subgraph group_workflows["Claude Workflows"]
  node_do_workflow["Feature Workflow<br/>[task.py]"]
  node_do_hooks["Workflow Hooks"]
  node_harness_session["Harness Scheduling"]
  node_harness_common["Harness Utilities<br/>[_harness_common.py]"]
  node_harness_reflect["Self Reflection"]
end

subgraph group_wrapper["Codeagent Wrapper"]
  node_wrapper_entry["Wrapper Entry<br/>[main.go]"]
  node_wrapper_app["CLI Runtime<br/>[app.go]"]
  node_task_planning["Parallel Task Planning<br/>[runtaskset.go]"]
  node_task_specs["Task Specs<br/>[spec.go]"]
  node_task_execution["Task Executor<br/>[executor.go]"]
  node_backend_adapters["Backend Adapters"]
  node_event_parser["Event Parser<br/>[parser.go]"]
  node_output["Structured Output<br/>[output.go]"]
end

subgraph group_tools["Automation Skills"]
  node_browser["Browser Automation"]
end

node_user(("Developer"))
node_claude(("Claude Code"))

node_user -->|"installs modules"| node_installer
node_installer -.->|"runs installer"| node_install_engine
node_claude -->|"selects workflow"| node_do_workflow
node_claude -->|"orchestrates execution"| node_wrapper_entry
node_wrapper_entry -->|"starts runtime"| node_wrapper_app
node_wrapper_app -.->|"runs parallel mode"| node_task_planning
node_task_planning -->|"builds task plan"| node_task_specs
node_task_planning -->|"writes results"| node_output
node_wrapper_app -.->|"dispatches tasks"| node_backend_adapters
node_wrapper_app -.->|"parses backend events"| node_event_parser
node_do_workflow -.->|"uses lifecycle hooks"| node_do_hooks
node_harness_session -.->|"shares utilities"| node_harness_common
node_harness_reflect -->|"imports helpers"| node_harness_common
node_user -->|"runs browser tasks"| node_browser

click node_installer "https://github.com/cexll/myclaude/blob/master/bin/cli.js"
click node_install_engine "https://github.com/cexll/myclaude/blob/master/install.py"
click node_do_workflow "https://github.com/cexll/myclaude/blob/master/skills/do/scripts/task.py"
click node_do_hooks "https://github.com/cexll/myclaude/tree/master/skills/do/hooks"
click node_harness_session "https://github.com/cexll/myclaude/blob/master/skills/harness/hooks/harness-sessionstart.py"
click node_harness_common "https://github.com/cexll/myclaude/blob/master/skills/harness/hooks/_harness_common.py"
click node_harness_reflect "https://github.com/cexll/myclaude/blob/master/skills/harness/hooks/self-reflect-stop.py"
click node_wrapper_entry "https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/cmd/codeagent-wrapper/main.go"
click node_wrapper_app "https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/app/app.go"
click node_task_planning "https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/application/runtaskset/runtaskset.go"
click node_task_specs "https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/application/runtask/spec.go"
click node_task_execution "https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/executor/executor.go"
click node_backend_adapters "https://github.com/cexll/myclaude/tree/master/codeagent-wrapper/internal/backend"
click node_event_parser "https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/parser/parser.go"
click node_output "https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/application/output/output.go"
click node_browser "https://github.com/cexll/myclaude/tree/master/skills/browser/scripts"

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_install_engine toneBlue
class node_do_workflow,node_do_hooks,node_harness_session,node_harness_common,node_harness_reflect toneAmber
class node_wrapper_entry,node_wrapper_app,node_task_planning,node_task_specs,node_task_execution,node_backend_adapters,node_event_parser,node_output toneMint
class node_browser toneRose
class node_user,node_claude toneIndigo
```

## Components

### Installation

- [Module Installer](https://github.com/cexll/myclaude/blob/master/bin/cli.js): `bin/cli.js`
- [Install Engine](https://github.com/cexll/myclaude/blob/master/install.py): `install.py`

### Claude Workflows

- [Feature Workflow](https://github.com/cexll/myclaude/blob/master/skills/do/scripts/task.py): `skills/do/scripts/task.py`
- [Workflow Hooks](https://github.com/cexll/myclaude/tree/master/skills/do/hooks): `skills/do/hooks`
- [Harness Scheduling](https://github.com/cexll/myclaude/blob/master/skills/harness/hooks/harness-sessionstart.py): `skills/harness/hooks/harness-sessionstart.py`
- [Harness Utilities](https://github.com/cexll/myclaude/blob/master/skills/harness/hooks/_harness_common.py): `skills/harness/hooks/_harness_common.py`
- [Self Reflection](https://github.com/cexll/myclaude/blob/master/skills/harness/hooks/self-reflect-stop.py): `skills/harness/hooks/self-reflect-stop.py`

### Codeagent Wrapper

- [Wrapper Entry](https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/cmd/codeagent-wrapper/main.go): `codeagent-wrapper/cmd/codeagent-wrapper/main.go`
- [CLI Runtime](https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/app/app.go): `codeagent-wrapper/internal/app/app.go`
- [Parallel Task Planning](https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/application/runtaskset/runtaskset.go): `codeagent-wrapper/internal/application/runtaskset/runtaskset.go`
- [Task Specs](https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/application/runtask/spec.go): `codeagent-wrapper/internal/application/runtask/spec.go`
- [Task Executor](https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/executor/executor.go): `codeagent-wrapper/internal/executor/executor.go`
- [Backend Adapters](https://github.com/cexll/myclaude/tree/master/codeagent-wrapper/internal/backend): `codeagent-wrapper/internal/backend`
- [Event Parser](https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/parser/parser.go): `codeagent-wrapper/internal/parser/parser.go`
- [Structured Output](https://github.com/cexll/myclaude/blob/master/codeagent-wrapper/internal/application/output/output.go): `codeagent-wrapper/internal/application/output/output.go`

### Automation Skills

- [Browser Automation](https://github.com/cexll/myclaude/tree/master/skills/browser/scripts): `skills/browser/scripts`

### Other components

- **Developer**
- **Claude Code**

## Connections

- Developer → Module Installer: installs modules (evidence: `README.md`)
- Module Installer → Install Engine: runs installer
- Claude Code → Feature Workflow: selects workflow (evidence: `README.md`)
- Claude Code → Wrapper Entry: orchestrates execution (evidence: `README.md`)
- Wrapper Entry → CLI Runtime: starts runtime (evidence: `codeagent-wrapper/cmd/codeagent-wrapper/main.go`)
- CLI Runtime → Parallel Task Planning: runs parallel mode
- Parallel Task Planning → Task Specs: builds task plan (evidence: `codeagent-wrapper/internal/application/runtaskset/runtaskset.go`)
- Parallel Task Planning → Structured Output: writes results (evidence: `codeagent-wrapper/internal/application/runtaskset/runtaskset.go`)
- CLI Runtime → Backend Adapters: dispatches tasks
- CLI Runtime → Event Parser: parses backend events
- Feature Workflow → Workflow Hooks: uses lifecycle hooks
- Harness Scheduling → Harness Utilities: shares utilities
- Self Reflection → Harness Utilities: imports helpers (evidence: `skills/harness/hooks/self-reflect-stop.py`)
- Developer → Browser Automation: runs browser tasks (evidence: `README.md`)
