mrkeyoor.com_
Tue 01 Sept 17:40 UTC
Dev Toolsevaluationupdated 27 Aug 2026

compound-engineering-plugin review

Compound Engineering is a set of 33 reusable instructions that gives AI coding agents a fixed loop for brainstorming, planning, implementation, review, and recording lessons. It is for teams that want an agent to follow a repeatable engineering process instead of improvising each task from a short prompt.

+185stars / 7d
Verdict

Our test command ran for 455 seconds and reported 177 failures at commit 26bf5b1, so Compound Engineering should earn trust in a trial repository before its autonomous workflow receives permission to commit or push. Use it if your team wants a strongly prescribed loop and will keep its plans and solution notes in the codebase. Skip it if you want a small set of independent prompts or need the measured commit to pass its full suite first.

We ran it

Lab card: what happened when we ran compound-engineering-pluginScreenshot of compound-engineering-plugin (every.to/guides/compound-engineering)
Install✓ · 47s256 packages · 75 MB
Buildn/ano build script
Tests✗ · 455s3447 passed · 177 failed · 1 skipped of 3624 (bun test)
Repo1031 files~109,569 lines of source · 15 MB · 3 CI workflows · tests dir

Answers from our run

Does compound-engineering-plugin build from source?

Dependencies installed in 47 seconds (256 packages), and the project has no separate build step. We cloned commit 26bf5b1 into a clean Debian container with 3 CPUs and no project-specific setup.

Do compound-engineering-plugin's tests pass?

Not all of them: 3447 of 3624 passed and 177 failed when we ran the project's own test command (bun test). Some failures need services or credentials a bare container does not have.

Who should not use compound-engineering-plugin?

Teams that require a green upstream test suite before adoption: our run ended with 177 failed tests at commit 26bf5b1.

What are the alternatives to compound-engineering-plugin?

Superpowers, Spec Kit, Anthropic Skills. Our test command ran for 455 seconds and reported 177 failures at commit 26bf5b1, so Compound Engineering should earn trust in a trial repository before its autonomous workflow receives permission to commit or push.

Setup3/547-second install, but host setup varies and tests failed
Docs5/533 skills, 14 hosts, upgrades, and limitations are documented
Community5/524,582 stars and same-day issue and pull request activity
Maturity3/5Frequent releases, but 177 tests failed in our run

Who it’s for

Teams using Claude Code, Codex, Cursor, or another supported coding agent that want one shared development method.
Maintainers who want plans and solved problems saved inside the repository for later agent sessions.
Developers willing to review permissions before an autonomous workflow commits, pushes, or opens a pull request.
Plugin authors who need examples of packaging the same skills for several agent hosts.

Who it’s NOT for

Teams that require a green upstream test suite before adoption: our run ended with 177 failed tests at commit 26bf5b1.
Developers who want a lightweight prompt collection with no prescribed process: the README assigns 80% of the method to planning and review and defines a six-step core loop.
Organizations that cannot let an agent create commits or push branches: the documented /lfg workflow can commit, push, open a pull request, and watch CI.
Pi users expecting every advertised agent path to work without extra checks: open issue 1507 reports that subagent discovery returns Unknown agent for CE agents.

Setup reality

Our sandbox install succeeded in 47 seconds, adding 256 packages and using 75 MB. The repository had 1,031 files and about 109,569 source lines in a 15 MB checkout. There was no build script or target, so we skipped build.

The full test command failed after 455 seconds with exit code 1. The supplied summary recorded 3,447 passed, 177 failed, and 1 skipped out of 3,624. The log tail shows several passing contract and workflow tests, then a truncated warm-checkout regression name, followed by the 177-failure summary; it does not show a cause for the failures.

Normal installation does not require Bun because supported hosts load the plugin directly, but repository development uses Bun. Setup differs by host, Codex needs a marketplace registration and restart, while Pi needs the pi-subagents companion for workflows that dispatch agents. Autonomous use also needs a Git remote before it can push and open a pull request.

33 skills impose a six-step engineering loop

Compound Engineering packages 33 skills around a simple idea: an agent should brainstorm, plan, work, simplify, review, and record what it learned. The saved plans and solution notes give later sessions repository-specific context. That is more useful than a bag of clever prompts when a team wants consistent behavior across repeated changes. It also means adopting a method, including its files and vocabulary, rather than installing an invisible helper.

The README says 80% of the method goes into planning and review and 20% into execution. That ratio tells you who will enjoy it. A developer who wants the agent to patch a small bug immediately may find the loop heavy. A team dealing with long-lived code, repeated mistakes, or handoffs between agent sessions has a clearer reason to accept the ceremony.

The autonomous workflow can push, so permission review comes first

The /lfg skill runs the sequence without waiting between every stage. According to the README, it plans, implements, simplifies, reviews, applies fixes, runs browser tests, and commits. If the checkout has a remote, it can also push, open a pull request, and watch CI through a bounded repair loop. It does not merge, and the repair loop may stop with work left over.

That behavior can save attention, but the boundary matters more than the feature count. Run it first in a disposable repository or a branch protected by normal review rules. Check which shell and Git actions the chosen host permits. A plugin that writes a plan is low risk; the same plugin holding credentials that can push a branch deserves the controls you would apply to any automated contributor.

What happened when we ran it

Our sandbox installed commit 26bf5b1 in 47 seconds. Bun added 256 packages, and dependencies occupied 75 MB on disk. The checkout itself was 15 MB, with 1,031 files and roughly 109,569 lines of source. There was no build script or target, so the build step was skipped rather than counted as a pass.

Tests were the serious finding. bun test ran for 455 seconds and exited with code 1. The supplied result listed 3,447 passed, 177 failed, and 1 skipped out of 3,624. Its final lines show passing checks around review wording, setup health, PR snapshots, and skill evaluation. The next visible test name is cut off, then the runner reports 177 failures across 139 files. That excerpt does not identify one shared cause, so we cannot responsibly reduce the result to a missing package or container quirk.

Three CI workflow files and a tests directory are present, while no Dockerfile was found. A fresh Debian container is not every supported editor environment, but a failed full suite is still a buying signal. Before enabling write-capable skills, reproduce the relevant host path and run the checks that cover the workflow you intend to use.

Fourteen hosts bring reach and setup differences

The project says it runs on 14 agent hosts, including Claude Code, Cursor, Codex, Pi, OpenCode, and several other CLIs. Normal users do not need Bun. Most hosts load skills through a plugin marketplace or directly from the GitHub repository, while repository contributors use Bun for tests and conversion work. The README gives separate commands because there is no single installation contract across all 14.

Codex users register a custom marketplace, install the plugin, and restart. Pi users install the repository plus pi-subagents when workflows dispatch reviewer, research, or implementation agents. Open issue 1507 says Pi's native extension exposed skills but did not register CE agent definitions, producing an Unknown agent error for paths such as ce-work and lfg. That issue was updated on August 26, 2026, so Pi adopters should verify their exact workflow rather than assuming skill discovery proves subagent discovery.

Repository memory is useful only if the team keeps it clean

The distinguishing feature is the return path from a completed change to the next one. /ce-compound writes lessons under docs/solutions/, while brainstorm and planning skills read prior material as grounding. Plans also live in the repository by default. A configuration file can relocate these artifacts when docs/ already contains product documentation.

This can turn an environment-specific fix into guidance that the next agent sees. It can also fill a repository with stale explanations if nobody reviews them. The project includes ce-compound-refresh and setup checks, but ownership stays with the team. Treat generated knowledge like code comments: keep claims tied to current files, remove obsolete advice, and make its review part of the pull request.

August 2026 activity is fast, while the measured suite is red

GitHub recorded the last push on August 27, 2026. The repository had 24,582 stars, an MIT license, and 85 combined open issues and pull requests when fetched. Release v3.23.4 was published on August 25, the same day as our sandbox run, with fixes for review configuration, skill behavior, retained concepts, Windows process handling, and cross-model cleanup. Those dates show active maintenance, not whether every host path works.

Compound Engineering is worth trying when a team wants one opinionated process across several coding agents. Start with the planning and review skills, inspect the files they add, and keep Git permissions narrow. The 47-second install makes that experiment cheap. The 177 failed tests make an unattended rollout hard to justify until your own chosen host and workflow pass the checks you depend on.

Alternatives

ProjectWhat it isPick it when
Superpowers gh↗A skills-based coding method centered on specification, test-driven work, and subagent review.pick this instead when you want skills to trigger automatically and prefer a stricter test-driven workflow.
Spec Kit gh↗A toolkit that turns specifications, plans, and task lists into an agent-guided implementation process.pick this instead when the specification is the main artifact and you want a narrower path from requirements to code.
Anthropic Skills gh↗A reference collection of self-contained skills and templates for Claude.pick this instead when you want examples for individual capabilities rather than one prescribed engineering loop.

What people are saying

  1. [github-trending] EveryInc/compound-engineering-plugin

Sources

  1. Compound Engineering README
  2. Compound Engineering repository facts
  3. Compound Engineering v3.23.4 release
  4. Pi subagent discovery issue 1507

More dev tools reviews

workmux · v2rayNG · SecLists · hashcat · eslint · fastfetch · the whole board →