Brings in 79 upstream commits via merge-upstream branch. Conflicts resolved
by taking the merge-upstream version, which contains all triaged fork-vs-upstream
decisions from the upstream-merge skill workflow.
See merge commit fe3b1ee for the detailed triage breakdown of the 15 both-changed
files (7 keep deleted, 1 keep local, 1 restore from upstream, 6 merge both).
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