# dreeventechnologies/compound-engineering-plugin-ooacp architecture

> Architecture diagram of the GitHub repository dreeventechnologies/compound-engineering-plugin-ooacp, 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/dreeventechnologies/compound-engineering-plugin-ooacp
- Repository: https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp

## Overview

Compound Engineering combines an AI-agent skill workflow with a CLI that installs, converts, lists, and cleans up Claude-format plugins for supported agent hosts. The principal learning loop is brainstorm → plan → work → simplify → review → compound, with captured knowledge feeding later brainstorms and plans. The excerpts show the CLI’s parser, target dispatch, conversion, and writing layers; README statements support the skill-loop relationships. Several skill implementations are unsampled, so their internal calls are not inferred.

Main entry points: [`src/targets/codex.ts`](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/targets/codex.ts) (Codex writer), [`src/parsers/claude.ts`](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/parsers/claude.ts) (Parsed plugin), [`src/index.ts`](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/index.ts) (CLI entry), [`src/commands/cleanup.ts`](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/commands/cleanup.ts) (Cleanup command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Engineering workflow"]
  node_brainstorm["Brainstorm"]
  node_plan["Plan"]
  node_work["Work"]
  node_simplify["Simplify code"]
  node_review["Code review"]
  node_compound["Compound learning"]
end

subgraph group_cli["Plugin CLI"]
  node_cli["CLI entry<br/>[index.ts]"]
  node_install["Install command<br/>[install.ts]"]
  node_convert["Convert command<br/>[convert.ts]"]
  node_cleanup["Cleanup command<br/>[cleanup.ts]"]
end

subgraph group_conversion["Conversion and targets"]
  node_target_dispatch["Target dispatch<br/>[index.ts]"]
  node_converters["Host converters"]
  node_codex_writer["Codex writer<br/>[codex.ts]"]
  node_managed_artifacts["Managed artifacts"]
  node_legacy_artifacts["Legacy artifact map"]
end

subgraph group_shared["Shared parsing and utilities"]
  node_plugin["Parsed plugin<br/>[claude.ts]"]
  node_frontmatter["Frontmatter<br/>[frontmatter.ts]"]
  node_codex_content["Codex content transforms<br/>[codex-content.ts]"]
  node_file_utils["File operations<br/>[files.ts]"]
  node_legacy_cleanup["Legacy cleanup<br/>[legacy-cleanup.ts]"]
end

node_engineer(("Engineer"))
node_codex_target(("Codex host"))
node_agent_hosts(("Supported agent hosts"))

node_engineer -->|"defines requirements"| node_brainstorm
node_brainstorm -->|"sharpens plan"| node_plan
node_plan -->|"guides execution"| node_work
node_work -->|"precedes refinement"| node_simplify
node_simplify -->|"precedes review"| node_review
node_review -->|"captures learning"| node_compound
node_compound -->|"grounds later work"| node_brainstorm
node_compound -->|"informs future plans"| node_plan
node_engineer -->|"invokes"| node_cli
node_cli -->|"routes to"| node_install
node_cli -->|"routes to"| node_convert
node_cli -->|"routes to"| node_cleanup
node_install -->|"loads"| node_plugin
node_convert -->|"loads"| node_plugin
node_cleanup -->|"loads"| node_plugin
node_install -->|"selects target"| node_target_dispatch
node_convert -->|"selects target"| node_target_dispatch
node_target_dispatch -->|"converts plugin"| node_converters
node_target_dispatch -->|"writes bundle"| node_codex_writer
node_codex_writer -.->|"writes artifacts"| node_codex_target
node_codex_writer -->|"checks paths"| node_managed_artifacts
node_codex_writer -->|"reads legacy map"| node_legacy_artifacts
node_cleanup -->|"classifies legacy files"| node_legacy_cleanup
node_cleanup -->|"backs up artifacts"| node_managed_artifacts
node_plugin -->|"parses metadata"| node_frontmatter
node_plugin -->|"reads plugin files"| node_file_utils
node_converters -->|"formats metadata"| node_frontmatter
node_converters -->|"transforms Codex text"| node_codex_content
node_codex_content -.->|"formats prompt metadata"| node_frontmatter
node_codex_writer -->|"writes files"| node_file_utils
node_agent_hosts -.->|"receives installation"| node_install

click node_brainstorm "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/skills/ce-brainstorm"
click node_plan "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/skills/ce-plan"
click node_work "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/skills/ce-work"
click node_review "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/skills/ce-code-review"
click node_compound "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/skills/ce-compound"
click node_cli "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/index.ts"
click node_install "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/commands/install.ts"
click node_convert "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/commands/convert.ts"
click node_cleanup "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/commands/cleanup.ts"
click node_plugin "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/parsers/claude.ts"
click node_target_dispatch "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/targets/index.ts"
click node_converters "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/src/converters"
click node_codex_writer "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/targets/codex.ts"
click node_managed_artifacts "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/targets/managed-artifacts.ts"
click node_legacy_artifacts "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/data/plugin-legacy-artifacts.ts"
click node_frontmatter "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/utils/frontmatter.ts"
click node_codex_content "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/utils/codex-content.ts"
click node_file_utils "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/utils/files.ts"
click node_legacy_cleanup "https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/utils/legacy-cleanup.ts"

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_brainstorm,node_plan,node_work,node_simplify,node_review,node_compound toneBlue
class node_cli,node_install,node_convert,node_cleanup toneAmber
class node_target_dispatch,node_converters,node_codex_writer,node_managed_artifacts,node_legacy_artifacts toneMint
class node_plugin,node_frontmatter,node_codex_content,node_file_utils,node_legacy_cleanup toneRose
class node_engineer,node_codex_target,node_agent_hosts toneIndigo
```

## Components

### Engineering workflow

- [Brainstorm](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/skills/ce-brainstorm): `skills/ce-brainstorm`
- [Plan](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/skills/ce-plan): `skills/ce-plan`
- [Work](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/skills/ce-work): `skills/ce-work`
- **Simplify code**
- [Code review](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/skills/ce-code-review): `skills/ce-code-review`
- [Compound learning](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/skills/ce-compound): `skills/ce-compound`

### Plugin CLI

- [CLI entry](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/index.ts): `src/index.ts`
- [Install command](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/commands/install.ts): `src/commands/install.ts`
- [Convert command](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/commands/convert.ts): `src/commands/convert.ts`
- [Cleanup command](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/commands/cleanup.ts): `src/commands/cleanup.ts`

### Conversion and targets

- [Target dispatch](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/targets/index.ts): `src/targets/index.ts`
- [Host converters](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/tree/main/src/converters): `src/converters`
- [Codex writer](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/targets/codex.ts): `src/targets/codex.ts`
- [Managed artifacts](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/targets/managed-artifacts.ts): `src/targets/managed-artifacts.ts`
- [Legacy artifact map](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/data/plugin-legacy-artifacts.ts): `src/data/plugin-legacy-artifacts.ts`

### Shared parsing and utilities

- [Parsed plugin](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/parsers/claude.ts): `src/parsers/claude.ts`
- [Frontmatter](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/utils/frontmatter.ts): `src/utils/frontmatter.ts`
- [Codex content transforms](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/utils/codex-content.ts): `src/utils/codex-content.ts`
- [File operations](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/utils/files.ts): `src/utils/files.ts`
- [Legacy cleanup](https://github.com/dreeventechnologies/compound-engineering-plugin-ooacp/blob/main/src/utils/legacy-cleanup.ts): `src/utils/legacy-cleanup.ts`

### Other components

- **Engineer**
- **Codex host**
- **Supported agent hosts**

## Connections

- Engineer → Brainstorm: defines requirements
- Brainstorm → Plan: sharpens plan
- Plan → Work: guides execution
- Work → Simplify code: precedes refinement
- Simplify code → Code review: precedes review
- Code review → Compound learning: captures learning
- Compound learning → Brainstorm: grounds later work
- Compound learning → Plan: informs future plans
- Engineer → CLI entry: invokes
- CLI entry → Install command: routes to (evidence: `src/index.ts`)
- CLI entry → Convert command: routes to (evidence: `src/index.ts`)
- CLI entry → Cleanup command: routes to (evidence: `src/index.ts`)
- Install command → Parsed plugin: loads (evidence: `src/commands/install.ts`)
- Convert command → Parsed plugin: loads (evidence: `src/commands/convert.ts`)
- Cleanup command → Parsed plugin: loads (evidence: `src/commands/cleanup.ts`)
- Install command → Target dispatch: selects target (evidence: `src/commands/install.ts`)
- Convert command → Target dispatch: selects target (evidence: `src/commands/convert.ts`)
- Target dispatch → Host converters: converts plugin (evidence: `src/targets/index.ts`)
- Target dispatch → Codex writer: writes bundle (evidence: `src/targets/index.ts`)
- Codex writer → Codex host: writes artifacts (evidence: `src/targets/codex.ts`)
- Codex writer → Managed artifacts: checks paths (evidence: `src/targets/codex.ts`)
- Codex writer → Legacy artifact map: reads legacy map (evidence: `src/targets/codex.ts`)
- Cleanup command → Legacy cleanup: classifies legacy files (evidence: `src/commands/cleanup.ts`)
- Cleanup command → Managed artifacts: backs up artifacts (evidence: `src/commands/cleanup.ts`)
- Parsed plugin → Frontmatter: parses metadata (evidence: `src/parsers/claude.ts`)
- Parsed plugin → File operations: reads plugin files (evidence: `src/parsers/claude.ts`)
- Host converters → Frontmatter: formats metadata (evidence: `src/converters/claude-to-opencode.ts`)
- Host converters → Codex content transforms: transforms Codex text (evidence: `src/converters/claude-to-codex.ts`)
- Codex content transforms → Frontmatter: formats prompt metadata
- Codex writer → File operations: writes files (evidence: `src/targets/codex.ts`)
- Supported agent hosts → Install command: receives installation
