Synced 79 commits from EveryInc/compound-engineering-plugin upstream while
preserving fork-specific customizations (Python/FastAPI pivot, Zoominfo-internal
review agents, deploy-wiring operational lessons, custom personas).
## Triage decisions (15 conflicts resolved)
Keep deleted (7) -- fork already removed these in prior cleanups:
- agents/design/{design-implementation-reviewer,design-iterator,figma-design-sync}
(no fork successor; backend-Python focus doesn't need UI/Figma agents)
- agents/docs/ankane-readme-writer (replaced by python-package-readme-writer)
- agents/review/{data-migration-expert,performance-oracle,security-sentinel}
(replaced by *-reviewer naming convention: data-migrations-reviewer,
performance-reviewer, security-reviewer)
Keep local (1):
- agents/workflow/lint.md (Python tooling: ruff/mypy/djlint/bandit; upstream
deleted the file). Fixed pre-existing duplicate "2." numbering bug.
Restore from upstream (1):
- agents/review/data-integrity-guardian.md (kept for GDPR/CCPA privacy
compliance angle not covered by data-migrations-reviewer)
Merge both (6) -- upstream structural wins layered with fork intent:
- agents/research/best-practices-researcher.md (upstream <examples> removal +
fork's Rails/Ruby -> Python/FastAPI translations)
- skills/ce-brainstorm/SKILL.md (universal-brainstorming routing + Slack
context + non-obvious angles + fork's Deploy wiring flag)
- skills/ce-plan/SKILL.md (universal-planning routing + planning-bootstrap +
fork's two Deploy wiring check bullets)
- skills/ce-review/SKILL.md (Run ID, model tiering haiku->sonnet, compact-JSON
artifact contract, file-type awareness, cli-readiness-reviewer + fork's
zip-agent-validator, design-conformance-reviewer, Stage 6 Zip Agent
Validation)
- skills/ce-review/references/persona-catalog.md (cli-readiness row + adversarial
refinement + fork's Language & Framework Conditional layer; 22 personas total)
- skills/ce-work/SKILL.md (Parallel Safety Check, parallel-subagent constraints,
Phase 3-4 compression + fork's deploy-values self-review row, with duplicate
checklist bullet collapsed to single occurrence)
## Auto-applied (no triage needed)
- 225 remote-only files: accepted as-is (new docs, brainstorms, plans,
upstream skills, tests, scripts)
- 70 local-only files: 46 preserved as-is (kieran-python, tiangolo-fastapi,
zip-agent-validator, design-conformance-reviewer, essay/proof commands,
excalidraw-png-export, etc.); 24 stayed deleted (dhh-rails-style,
andrew-kane-gem-writer, dspy-ruby Ruby skills no longer needed)
## README updated
- Removed Design section (3 deleted agents)
- Removed deleted Review entries (data-migration-expert, dhh-rails-reviewer,
kieran-rails-reviewer, performance-oracle, security-sentinel)
- Added new Review entries: design-conformance-reviewer, previous-comments-reviewer,
tiangolo-fastapi-reviewer, zip-agent-validator
- Workflow: added lint
- Docs: replaced ankane-readme-writer with python-package-readme-writer
## Known issues (not introduced by merge decisions)
- 9 detect-project-type.sh tests fail on macOS bash 3.2 (script uses
`declare -A` which requires bash 4+). Upstream regression in commit 070092d
(#568). Resolution: install bash 4+ via `brew install bash` locally;
upstream fix tracked separately.
- 2 review-skill-contract tests reference deleted agents (dhh-rails-reviewer,
data-migration-expert). Pre-existing fork inconsistency, not new.
bun run release:validate: passes (46 agents, 51 skills, 0 MCP servers)
Compounding Engineering Plugin
AI-powered development tools that get smarter with every use. Make each unit of engineering work easier than the last.
Getting Started
After installing, run /ce-setup in any project. It diagnoses your environment, installs missing tools, and bootstraps project config in one interactive flow.
Components
| Component | Count |
|---|---|
| Agents | 50+ |
| Skills | 42+ |
Skills
Core Workflow
The primary entry points for engineering work, invoked as slash commands:
| Skill | Description |
|---|---|
/ce:ideate |
Discover high-impact project improvements through divergent ideation and adversarial filtering |
/ce:brainstorm |
Explore requirements and approaches before planning |
/ce:plan |
Create structured plans for any multi-step task -- software features, research workflows, events, study plans -- with automatic confidence checking |
/ce:review |
Structured code review with tiered persona agents, confidence gating, and dedup pipeline |
/ce:work |
Execute work items systematically |
/ce-debug |
Systematically find root causes and fix bugs -- traces causal chains, forms testable hypotheses, and implements test-first fixes |
/ce:compound |
Document solved problems to compound team knowledge |
/ce:compound-refresh |
Refresh stale or drifting learnings and decide whether to keep, update, replace, or archive them |
/ce-optimize |
Run iterative optimization loops with parallel experiments, measurement gates, and LLM-as-judge quality scoring |
For /ce-optimize, see skills/ce-optimize/README.md for usage guidance, example specs, and links to the schema and workflow docs.
Research & Context
| Skill | Description |
|---|---|
/ce-sessions |
Ask questions about session history across Claude Code, Codex, and Cursor |
/ce-slack-research |
Search Slack for interpreted organizational context -- decisions, constraints, and discussion arcs |
Git Workflow
| Skill | Description |
|---|---|
ce-pr-description |
Write or regenerate a value-first PR title and body from the current branch or a specified PR; used directly or by other skills |
git-clean-gone-branches |
Clean up local branches whose remote tracking branch is gone |
git-commit |
Create a git commit with a value-communicating message |
git-commit-push-pr |
Commit, push, and open a PR with an adaptive description; also update an existing PR description (delegates title/body generation to ce-pr-description) |
git-worktree |
Manage Git worktrees for parallel development |
Workflow Utilities
| Skill | Description |
|---|---|
/changelog |
Create engaging changelogs for recent merges |
/ce-demo-reel |
Capture a visual demo reel (GIF demos, terminal recordings, screenshots) for PRs with project-type-aware tier selection |
/report-bug-ce |
Report a bug in the compound-engineering plugin |
/resolve-pr-feedback |
Resolve PR review feedback in parallel |
/sync |
Sync Claude Code config across machines |
/test-browser |
Run browser tests on PR-affected pages |
/test-xcode |
Build and test iOS apps on simulator using XcodeBuildMCP |
/onboarding |
Generate ONBOARDING.md to help new contributors understand the codebase |
/ce-setup |
Diagnose environment, install missing tools, and bootstrap project config |
/ce-update |
Check compound-engineering plugin version and fix stale cache (Claude Code only) |
/ce:release-notes |
Summarize recent compound-engineering plugin releases, or answer a question about a past release with a version citation |
/todo-resolve |
Resolve todos in parallel |
/todo-triage |
Triage and prioritize pending todos |
Development Frameworks
| Skill | Description |
|---|---|
agent-native-architecture |
Build AI agents using prompt-native architecture |
andrew-kane-gem-writer |
Write Ruby gems following Andrew Kane's patterns |
dhh-rails-style |
Write Ruby/Rails code in DHH's 37signals style |
dspy-ruby |
Build type-safe LLM applications with DSPy.rb |
frontend-design |
Create production-grade frontend interfaces |
Review & Quality
| Skill | Description |
|---|---|
document-review |
Review documents using parallel persona agents for role-specific feedback |
Content & Collaboration
| Skill | Description |
|---|---|
every-style-editor |
Review copy for Every's style guide compliance |
proof |
Create, edit, and share documents via Proof collaborative editor |
todo-create |
File-based todo tracking system |
Automation & Tools
| Skill | Description |
|---|---|
gemini-imagegen |
Generate and edit images using Google's Gemini API |
Beta / Experimental
| Skill | Description |
|---|---|
/ce:polish-beta |
Human-in-the-loop polish phase after /ce:review — verifies review + CI, starts a dev server from .claude/launch.json, generates a testable checklist, and dispatches polish sub-agents for fixes. Emits stacked-PR seeds for oversized work |
/lfg |
Full autonomous engineering workflow |
Agents
Agents are specialized subagents invoked by skills — you typically don't call these directly.
Review
| Agent | Description |
|---|---|
agent-native-reviewer |
Verify features are agent-native (action + context parity) |
api-contract-reviewer |
Detect breaking API contract changes |
cli-agent-readiness-reviewer |
Evaluate CLI agent-friendliness against 7 core principles |
cli-readiness-reviewer |
CLI agent-readiness persona for ce:review (conditional, structured JSON) |
architecture-strategist |
Analyze architectural decisions and compliance |
code-simplicity-reviewer |
Final pass for simplicity and minimalism |
correctness-reviewer |
Logic errors, edge cases, state bugs |
data-integrity-guardian |
Database migrations and data integrity (privacy/compliance angle) |
data-migrations-reviewer |
Migration safety with confidence calibration |
deployment-verification-agent |
Create Go/No-Go deployment checklists for risky data changes |
design-conformance-reviewer |
Review code for deviations from design intent and plan completeness |
julik-frontend-races-reviewer |
Review JavaScript/Stimulus code for race conditions |
kieran-python-reviewer |
Python code review with strict conventions |
kieran-typescript-reviewer |
TypeScript code review with strict conventions |
maintainability-reviewer |
Coupling, complexity, naming, dead code |
pattern-recognition-specialist |
Analyze code for patterns and anti-patterns |
performance-reviewer |
Runtime performance with confidence calibration |
previous-comments-reviewer |
Verify prior PR review feedback has been addressed |
reliability-reviewer |
Production reliability and failure modes |
schema-drift-detector |
Detect unrelated schema.rb changes in PRs |
security-reviewer |
Exploitable vulnerabilities with confidence calibration |
testing-reviewer |
Test coverage gaps, weak assertions |
tiangolo-fastapi-reviewer |
FastAPI code review from tiangolo's perspective (anti-patterns, conventions) |
project-standards-reviewer |
CLAUDE.md and AGENTS.md compliance |
zip-agent-validator |
Pressure-test zip-agent PR review comments against codebase context |
adversarial-reviewer |
Construct failure scenarios to break implementations across component boundaries |
Document Review
| Agent | Description |
|---|---|
coherence-reviewer |
Review documents for internal consistency, contradictions, and terminology drift |
design-lens-reviewer |
Review plans for missing design decisions, interaction states, and AI slop risk |
feasibility-reviewer |
Evaluate whether proposed technical approaches will survive contact with reality |
product-lens-reviewer |
Challenge problem framing, evaluate scope decisions, surface goal misalignment |
scope-guardian-reviewer |
Challenge unjustified complexity, scope creep, and premature abstractions |
security-lens-reviewer |
Evaluate plans for security gaps at the plan level (auth, data, APIs) |
adversarial-document-reviewer |
Challenge premises, surface unstated assumptions, and stress-test decisions |
Research
| Agent | Description |
|---|---|
best-practices-researcher |
Gather external best practices and examples |
framework-docs-researcher |
Research framework documentation and best practices |
git-history-analyzer |
Analyze git history and code evolution |
issue-intelligence-analyst |
Analyze GitHub issues to surface recurring themes and pain patterns |
learnings-researcher |
Search institutional learnings for relevant past solutions |
repo-research-analyst |
Research repository structure and conventions |
session-historian |
Search prior Claude Code, Codex, and Cursor sessions for related investigation context |
slack-researcher |
Search Slack for organizational context relevant to the current task |
web-researcher |
Perform iterative web research and return structured external grounding (prior art, adjacent solutions, market signals, cross-domain analogies) |
Workflow
| Agent | Description |
|---|---|
lint |
Run Python linting and code quality checks (ruff, mypy, djlint, bandit) |
pr-comment-resolver |
Address PR comments and implement fixes |
spec-flow-analyzer |
Analyze user flows and identify gaps in specifications |
Docs
| Agent | Description |
|---|---|
python-package-readme-writer |
Create READMEs following concise documentation style for Python packages |
Installation
claude /plugin install compound-engineering
Then run /ce-setup to check your environment and install recommended tools.
Version History
See the repo root CHANGELOG.md for canonical release history.
License
MIT