{ "markdown": "
\n\n\"Compound\n\n# Compound Engineering\n\n**AI skills that make each unit of engineering work easier than the last.**\n\n[![Build Status](https://github.com/EveryInc/compound-engineering-plugin/actions/workflows/ci.yml/badge.svg)](https://github.com/EveryInc/compound-engineering-plugin/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-black.svg)](LICENSE)\n[![Skills](https://img.shields.io/badge/skills-33-black.svg)](docs/guides/README.md)\n\n
\n\nCompound Engineering is a plugin of 33 skills for AI coding agents. It structures the work around a loop — brainstorm, plan, build, review, then **capture what you learned** — so the knowledge from each change is written down where the next change can read it.\n\nIt runs on 14 agent hosts, including Claude Code, Cursor, and Codex.\n\nMaintained by [Kieran Klaassen](https://github.com/kieranklaassen) and [Trevin Chow](https://github.com/tmchow), with contributions from the open-source community.\n\n## Install\n\n### Claude Code\n\n```text\n/plugin marketplace add EveryInc/compound-engineering-plugin\n/plugin install compound-engineering\n```\n\n> [!IMPORTANT]\n> **Already have Compound Engineering installed?** Refresh the marketplace *before* updating — see [Upgrading](docs/install/upgrading.md). Running `/plugin update` alone keeps you on the old version.\n\n### Cursor\n\nIn Cursor Agent chat, install from the plugin marketplace:\n\n```text\n/add-plugin compound-engineering\n```\n\nOr search for \"compound engineering\" in the plugin marketplace.\n\n### Grok Bot\n\nGrok Bot is its own app, but it uses your Cursor account and plugin library. There is no separate Grok Bot login. Install Compound Engineering once on that account and Grok Bot agents can load it.\n\nIn Cursor Agent chat:\n\n```text\n/add-plugin compound-engineering\n```\n\nOr search for \"compound engineering\" in the Cursor plugin marketplace. Do not run `/add-plugin` in the Grok Bot chat, and do not clone this repository onto the Grok Bot computer.\n\n### Codex App\n\nCompound Engineering is not listed in Codex's built-in plugin marketplace yet. Add it as a custom marketplace:\n\n1. In the Codex app, open **Plugins** from the sidebar.\n2. Click the arrow next to **Create**, then select **Add marketplace**.\n3. Enter:\n\n | Field | Value |\n | --- | --- |\n | Source | `EveryInc/compound-engineering-plugin` |\n | Git ref | `main` |\n | Sparse paths | leave blank |\n\n4. Click **Add marketplace**.\n5. Search for **Compound Engineering**, install **compound-engineering-plugin**, then restart Codex.\n\nThe Codex app install is self-contained for Compound Engineering. Specialist reviewer and research behavior lives inside the skills as local prompt assets; no separate custom-agent install step is required.\n\n### Codex CLI\n\nRegister the marketplace, then install the plugin.\n\n1. **Register the marketplace with Codex:**\n\n ```bash\n codex plugin marketplace add EveryInc/compound-engineering-plugin\n ```\n\n2. **Install the plugin:**\n\n ```bash\n codex plugin add compound-engineering@compound-engineering-plugin\n ```\n\n You can also launch `codex`, run `/plugins`, find the **Compound Engineering** marketplace, select the **compound-engineering** plugin, and choose **Install**. Restart Codex after install completes.\n\nThe native Codex plugin install is self-contained for Compound Engineering. Specialist reviewer and research behavior lives inside the skills as local prompt assets; no separate custom-agent install step is required.\n\nFor a non-default Codex profile, run every Codex-related step against the same `CODEX_HOME`. This example installs CE into a `work` profile:\n\n```bash\nCODEX_HOME=\"$HOME/.codex/profiles/work\" codex plugin marketplace add EveryInc/compound-engineering-plugin\nCODEX_HOME=\"$HOME/.codex/profiles/work\" codex plugin add compound-engineering@compound-engineering-plugin\n```\n\nThe marketplace step only makes the plugin available; the plugin install is what activates the native CE skills for that profile.\n\n**Another editor or CLI?** Kimi Code CLI, Cline, Grok Build CLI, Devin CLI, GitHub Copilot, Factory Droid, Qwen Code, OpenCode, Pi, oh-my-pi (omp), and Antigravity CLI are all supported — see [More install options](#more-install-options).\n\n---\n\n## Philosophy\n\n**Each unit of engineering work should make subsequent units easier -- not harder.**\n\nInvocation syntax: this README uses `/skill-name` examples for slash-skill hosts. In Codex, invoke installed skills with `$skill-name` (for example, `$ce-plan` and `$lfg`). In oh-my-pi (omp), these prompts can model-route to visible skills; use the native deterministic `/skill:` form for manual-only or hidden skills (for example, `/skill:ce-polish`). `/goal` remains a Codex built-in command.\n\nTraditional development accumulates technical debt. Every feature adds complexity. Every bug fix leaves behind a little more local knowledge that someone has to rediscover later. The codebase gets larger, the context gets harder to hold, and the next change becomes slower.\n\nCompound engineering inverts this. 80% is in planning and review, 20% is in execution:\n\n- Plan thoroughly before writing code with `/ce-brainstorm` and `/ce-plan` using one readiness-based plan artifact\n- Review to catch issues and calibrate judgment with `/ce-code-review` and `/ce-doc-review`\n- Codify knowledge so it is reusable with `/ce-compound`\n- Keep quality high so future changes are easy\n\nThe point is not ceremony. The point is leverage. A good brainstorm makes the plan sharper. A good plan makes execution smaller. A good review catches the pattern, not just the bug. A good compound note means the next agent does not have to learn the same lesson from scratch.\n\n## The loop\n\nThe core loop is six steps: **brainstorm** the requirements, **plan** the implementation, **work** through the plan, **simplify** what you wrote, **review** the result, then **compound** the learning -- and repeat with better context.\n\n| Skill | Purpose |\n|-------|---------|\n| [`/ce-brainstorm`](docs/guides/ce-brainstorm.md) | Interactive Q&A to think through a feature or problem and write a requirements-only unified plan before planning |\n| [`/ce-plan`](docs/guides/ce-plan.md) | Enrich feature ideas or requirements-only plans into implementation-ready plans |\n| [`/ce-work`](docs/guides/ce-work.md) | Execute implementation-ready plans natively or through a qualified cross-model author while retaining host verification, commits, and shipping |\n| [`/ce-simplify-code`](docs/guides/ce-simplify-code.md) | Refine the freshly written code for clarity and reuse before review |\n| [`/ce-code-review`](docs/guides/ce-code-review.md) | Report-only multi-agent review against the plan before merging; local apply is explicit |\n| [`/ce-compound`](docs/guides/ce-compound.md) | Capture the learning into `docs/solutions/` so the next loop starts smarter |\n\nEach cycle compounds: `/ce-compound` writes learnings that the next `/ce-brainstorm` and `/ce-plan` read as grounding -- brainstorms sharpen plans, plans inform future plans, reviews catch more issues, patterns get documented. That return arrow is the whole point.\n\n\"A\n\n**Run one teaches it. Run two remembers.**\n\nReplayed from a real pair of sessions 18 days apart, with names and paths anonymized and the six-minute run compressed to about 30 seconds. Nothing shown is behavior the skills don't have — see assets/demo for the source and the substitutions.\n\n> Artifact folders like `docs/solutions/` and `docs/plans/` are the **defaults**. A project whose `docs/` is tracked content can relocate every CE artifact folder under one repo-relative root via the `docs_root` setting -- see [configuration](docs/guides/configuration.md#artifact-root).\n\n## Try it\n\nAfter installing, run `/ce-setup` in any project. It reports optional tool capabilities, creates repo `.compound-engineering/config.yaml` when missing, refreshes the committed example, and gitignores an existing local override.\n\n**The standard loop** -- turn a rough idea into shipped, reviewed code:\n\n```text\n/ce-brainstorm make background job retries safer\n/ce-plan\n/ce-work\n/ce-simplify-code\n/ce-code-review\n/ce-compound\n```\n\n**Autonomous** -- hand off a feature and let the agent run the whole pipeline:\n\n```text\n/ce-brainstorm describe the feature\n/lfg\n```\n\n`/lfg` runs the loop hands-off: it plans, works through the plan, simplifies, runs code review and applies the fixes, runs browser tests, then commits. When a git remote exists it pushes, opens a PR, and watches CI with a bounded repair loop (it does not merge, and it can finish with leftovers if the repair budget is hit). With no remote it stops at local commits. Start it after `/ce-brainstorm` so it plans against real requirements rather than a one-line prompt.\n\nStarting from a bug instead of a feature? Use [`/ce-debug`](docs/guides/ce-debug.md). Not sure what to build yet? Start with [`/ce-ideate`](docs/guides/ce-ideate.md).\n\n## Skills at a glance\n\n33 skills, grouped by what they are for. The full catalog, with a page per skill and how each one chains into the others, is in **[docs/guides](docs/guides/README.md)**.\n\n| Group | Skills | What it covers |\n|-------|--------|----------------|\n| [Core loop](docs/guides/README.md#the-core-loop) | `ce-brainstorm` `ce-plan` `ce-work` `ce-simplify-code` `ce-code-review` `ce-compound` | The six steps of every iteration |\n| [Around the loop](docs/guides/README.md#around-the-loop) | `ce-strategy` `ce-product-pulse` `ce-sweep` `ce-compound-refresh` | Anchors and feeds that keep the loop grounded |\n| [On demand](docs/guides/README.md#on-demand) | `ce-ideate` `ce-pov` `ce-debug` `ce-explain` `ce-doc-review` `ce-optimize` `ce-prototype` | Reached for when a specific need arises |\n| [Git workflow](docs/guides/README.md#git-workflow) | `ce-commit` `ce-commit-push-pr` `ce-babysit-pr` `ce-resolve-pr-feedback` `ce-worktree` | Committing, shipping, and shepherding PRs |\n| [Autonomous](docs/guides/README.md#autonomous-pipeline) | `lfg` | The whole pipeline, hands-off |\n| [Testing & design](docs/guides/README.md#frontend-design) | `ce-test-browser` `ce-test-xcode` `ce-polish` `ce-dogfood` | Verifying and polishing what you built |\n| [Collaboration](docs/guides/README.md#collaboration) | `ce-proof` `ce-handoff` `ce-promote` | Sharing work and handing it off |\n| [Utilities](docs/guides/README.md#workflow-utilities) | `ce-setup` `ce-retune` `ce-riffrec-feedback-analysis` | Setup and maintenance |\n\n**Learn more**\n\n- [Skill documentation catalog](docs/guides/README.md)\n- [Compound engineering: how Every codes with agents](https://every.to/chain-of-thought/compound-engineering-how-every-codes-with-agents)\n- [The story behind compounding engineering](https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it)\n\n---\n\n## More Install Options\n\n[Claude Code, Cursor, and Codex](#install) are at the top. Everything here is equally supported.\n\n### Kimi Code CLI\n\nKimi Code CLI can install Compound Engineering directly from this repository because the repo ships a native `.kimi-plugin/plugin.json` manifest:\n\n```text\n/plugins install https://github.com/EveryInc/compound-engineering-plugin\n```\n\nYou can also browse it through Kimi's custom marketplace flow:\n\n```text\n/plugins marketplace https://raw.githubusercontent.com/EveryInc/compound-engineering-plugin/main/.kimi-plugin/marketplace.json\n```\n\nAfter installing or updating, run `/reload` or start a new Kimi session so the plugin skills are loaded.\n\n### Cline\n\nCline loads CE skills from on-demand `SKILL.md` directories. Enable **Settings -> Features -> Enable Skills** in the Cline extension, then link this repository's skills globally or per project:\n\n```bash\ngit clone https://github.com/EveryInc/compound-engineering-plugin\n./compound-engineering-plugin/.cline/scripts/install-skills.sh --global\n```\n\nPer-project install from a checkout:\n\n```bash\n./compound-engineering-plugin/.cline/scripts/install-skills.sh --project\n```\n\nStart a new Cline task after installing or updating skills. See [`.cline/INSTALL.md`](.cline/INSTALL.md) for pinning, local development, and uninstall steps.\n\n### Grok Build CLI (`grok`)\n\nxAI's [Grok Build CLI](https://x.ai/cli) (`grok`) installs Compound Engineering directly from this repository — the repo root is a valid Grok plugin (`grok` reads the existing Claude-compatible manifests, and the repo also ships a native `.grok-plugin/plugin.json`):\n\n```bash\ngrok plugin install EveryInc/compound-engineering-plugin\n```\n\nThis tracks the repository; run `grok plugin update` to pull the latest. To browse it as a marketplace source instead, the repo ships a native `.grok-plugin/marketplace.json`:\n\n```bash\ngrok plugin marketplace add EveryInc/compound-engineering-plugin\ngrok plugin install compound-engineering\n```\n\nBoth paths track the repository directly (no commit pin). Add `--trust` to skip the install confirmation. `grok` stores config under `~/.grok`; start a new session after installing so the skills load.\n\nCompound Engineering is also being submitted to the official [xAI plugin marketplace](https://github.com/xai-org/plugin-marketplace); see [`docs/grok-marketplace-submission.md`](docs/grok-marketplace-submission.md) for the maintainer runbook.\n\n### Devin CLI\n\nDevin CLI can install Compound Engineering directly from GitHub because the repo ships a native `.devin-plugin/plugin.json` manifest:\n\n```bash\ndevin plugins install EveryInc/compound-engineering-plugin\n```\n\nVerify the install and inspect the skills:\n\n```bash\ndevin plugins list\ndevin plugins info compound-engineering\n```\n\nUpdate to the latest version with `devin plugins update compound-engineering`. Plugins load at session start, so start a new Devin session after installing or updating for the skills to appear (as `/compound-engineering:` slash commands).\n\nA few skills declare Claude-style `allowed-tools` names that Devin does not map (for example `Bash`); those skills still work, but some of their actions ask for permission instead of running auto-approved. See [`docs/specs/devin.md`](docs/specs/devin.md) for details.\n\n### GitHub Copilot\n\nFor **VS Code Copilot Agent Plugins**:\n\n1. Run `Chat: Install Plugin from Source` from the VS Code command palette\n2. Use `EveryInc/compound-engineering-plugin` for the repo\n3. Select `compound-engineering` when VS Code shows the plugins in this repository\n\nFor **Copilot CLI**, use:\n\nInside Copilot CLI:\n\n```text\n/plugin marketplace add EveryInc/compound-engineering-plugin\n/plugin install compound-engineering@compound-engineering-plugin\n```\n\nFrom a shell with the `copilot` binary:\n\n```bash\ncopilot plugin marketplace add EveryInc/compound-engineering-plugin\ncopilot plugin install compound-engineering@compound-engineering-plugin\n```\n\nCopilot CLI reads the existing Claude-compatible plugin manifests directly.\n\n### Factory Droid\n\nFrom a shell with the `droid` binary:\n\n```bash\ndroid plugin marketplace add https://github.com/EveryInc/compound-engineering-plugin\ndroid plugin install compound-engineering@compound-engineering-plugin\n```\n\nDroid uses `plugin@marketplace` plugin IDs; here `compound-engineering` is the plugin and `compound-engineering-plugin` is the marketplace name. Droid installs the existing Claude Code-compatible plugin and translates the format automatically.\n\n### Qwen Code\n\n```bash\nqwen extensions install EveryInc/compound-engineering-plugin:compound-engineering\n```\n\nQwen Code installs Claude Code-compatible plugins directly from GitHub and converts the plugin format during install.\n\n### OpenCode\n\nAdd Compound Engineering to the `plugin` array in your global or project `opencode.json`:\n\n```json\n{\n \"plugin\": [\"compound-engineering@git+https://github.com/EveryInc/compound-engineering-plugin.git\"]\n}\n```\n\nRestart OpenCode after changing the config. The OpenCode plugin registers the Compound Engineering skills directory directly; no Bun installer or generated skill copy is required. See [`.opencode/INSTALL.md`](.opencode/INSTALL.md) for pinning examples.\n\n### Pi\n\nInstall Compound Engineering as a Pi package from this repository:\n\n```bash\npi install git:github.com/EveryInc/compound-engineering-plugin\n```\n\nRequired companion for CE workflows that dispatch reviewer, research, or implementation subagents:\n\n```bash\npi install npm:pi-subagents\n```\n\nRecommended companion for richer blocking questions:\n\n```bash\npi install npm:pi-ask-user\n```\n\n### oh-my-pi (omp)\n\noh-my-pi (omp) installs Compound Engineering through its marketplace flow. The repo ships a native `.omp-plugin/marketplace.json` catalog whose plugin entry carries a release-managed `version`, so omp's update checker can see each new CE release:\n\n```text\nomp plugin marketplace add EveryInc/compound-engineering-plugin\nomp plugin install compound-engineering@compound-engineering-plugin\n```\n\nTo stay current automatically, enable auto-update:\n\n```bash\nomp config set marketplace.autoUpdate auto\n```\n\nThe default `notify` mode only writes update availability to the debug log — it does not prompt — so without `auto` you will not hear about new releases. To upgrade by hand instead, run `omp plugin upgrade compound-engineering@compound-engineering-plugin`.\n\n
\nOther install paths (pin-style and contributor development)\n\n`omp install https://github.com/EveryInc/compound-engineering-plugin` installs the repository as an npm-style plugin. That path has **no update mechanism** — treat it as pinning a snapshot, not as the recommended install.\n\nFor local development from a checkout, use a live symlink instead:\n\n```bash\nomp plugin link \"$PWD\"\n```\n\n
\n\nRun `/reload-plugins` or start a new omp session after installing so the skills load. omp's native deterministic command is `/skill:` (for example, `/skill:ce-plan`); ordinary `/skill-name` prompts can also model-route to visible skills, but manual-only or hidden skills require the native form. See [`docs/specs/omp.md`](docs/specs/omp.md) for details.\n\n### Antigravity CLI (`agy`)\n\nGoogle has replaced the consumer Gemini CLI with [Antigravity CLI](https://antigravity.google) (`agy`), which still runs on Gemini models. Install Compound Engineering directly from GitHub — no clone step required:\n\n```bash\nagy plugin install https://github.com/EveryInc/compound-engineering-plugin\n```\n\nVerify with `agy plugin list`. The repository root is the plugin package (`plugin.json` plus `skills/`).\n\nFor a local checkout or pinned release:\n\n```bash\ngit clone https://github.com/EveryInc/compound-engineering-plugin\nagy plugin install ./compound-engineering-plugin\n```\n\nThe bundled `.agy/` directory remains a compatibility entry point (`agy plugin install ./compound-engineering-plugin/.agy`). `agy` also loads `GEMINI.md` workspace context from the checkout.\n\nSee [`.agy/INSTALL.md`](.agy/INSTALL.md) for pinning, local development, uninstall, and legacy Gemini import.\n\n---\n\n## Upgrading an existing install\n\nCompound Engineering moved to a root-native, skills-only layout. If you installed before that move, refresh the cached marketplace **before** updating the plugin — order matters, and `/plugin update` alone keeps you on the old version.\n\nSee **[docs/install/upgrading.md](docs/install/upgrading.md)** for the per-host refresh commands, and for removing the obsolete Codex tool-map block left behind by pre-native Bun installs.\n\n## Limitations\n\nOpenCode, Pi, and oh-my-pi (omp) use native package/plugin loading from this repository. The Bun CLI remains for repository development and converter maintenance, not normal installation.\n\nRelease versions are owned by release automation. Routine feature PRs should not hand-bump plugin or marketplace manifest versions.\n\n## FAQ\n\n### Do I need Bun to install Compound Engineering?\n\nNo. Bun is only needed for repo development tasks and converter maintenance.\n\n### Where do I see all available skills?\n\nThe grouped overview is [above](#skills-at-a-glance); the full catalog with a page per skill is [`docs/guides/README.md`](docs/guides/README.md). Each skill's authoritative runtime spec lives in `skills//SKILL.md`.\n\n### Where is release history?\n\nGitHub Releases are the canonical release-notes surface. The root [`CHANGELOG.md`](CHANGELOG.md) points to that history.\n\n### How do I work on the plugin itself?\n\nSee [`CONTRIBUTING.md`](CONTRIBUTING.md) for setup, and [`docs/development.md`](docs/development.md) for loading a local checkout into each harness.\n\n## Documentation\n\n| | |\n|---|---|\n| [Skill catalog](docs/guides/README.md) | A page per skill, and how they chain together |\n| [Configuration](docs/guides/configuration.md) | `.compound-engineering/config.yaml` options |\n| [Installing](#install) · [Upgrading](docs/install/upgrading.md) | Per-host install and refresh |\n| [Contributing](CONTRIBUTING.md) · [Development](docs/development.md) | Working on the plugin itself |\n| [Security](SECURITY.md) · [Privacy](PRIVACY.md) | Reporting and data handling |\n\n## Contributing\n\nContributions are welcome. Issues, bug reports, and pull requests all help make this better, and we genuinely appreciate them — bug reports especially. Start with [`CONTRIBUTING.md`](CONTRIBUTING.md), which covers setup and what to do before opening a PR.\n\nA note on what to expect: Compound Engineering is opinionated by design. It's maintained by [@kieranklaassen](https://github.com/kieranklaassen) and [@tmchow](https://github.com/tmchow), and its direction reflects a specific point of view about how AI-assisted engineering should work. So while we welcome help, we can't promise to accept every change — some proposals won't fit that vision even when they're good ideas on their own.\n\nOpen an issue or send a PR, and we'll fold in what moves the plugin in the right direction. We just want to be upfront that not everything will land.\n\n## License\n\n[MIT](LICENSE)\n", "bytes": 22127, "sha": "bab13ecb9a3d8cdce2e74b66fa7b01661ecb00d6f366705f9e1d373d6953ae5d", "repo_slug": "everyinc/compound-engineering-plugin", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/skl_everyinc_compound_engineering_plugin_ce__430dbc5a/readme" }