Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
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 are skills invoked with slash syntax:
| Skill | Description |
|---|---|
/ce-ideate |
Optional big-picture ideation: generate and critically evaluate grounded ideas, then route the strongest one into brainstorming |
/ce-brainstorm |
Interactive Q&A to think through a feature or problem and write a right-sized requirements doc before planning |
/ce-plan |
Create structured plans for any multi-step task -- software features, research workflows, events, study plans -- with automatic confidence checking |
/ce-code-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 |
ce-clean-gone-branches |
Clean up local branches whose remote tracking branch is gone |
ce-commit |
Create a git commit with a value-communicating message |
ce-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) |
ce-worktree |
Manage Git worktrees for parallel development |
Workflow Utilities
| Skill | Description |
|---|---|
/ce-demo-reel |
Capture a visual demo reel (GIF demos, terminal recordings, screenshots) for PRs with project-type-aware tier selection |
/ce-report-bug |
Report a bug in the compound-engineering plugin |
/ce-resolve-pr-feedback |
Resolve PR review feedback in parallel |
/ce-test-browser |
Run browser tests on PR-affected pages |
/ce-test-xcode |
Build and test iOS apps on simulator using XcodeBuildMCP |
/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 |
Development Frameworks
| Skill | Description |
|---|---|
ce-agent-native-architecture |
Build AI agents using prompt-native architecture |
ce-dhh-rails-style |
Write Ruby/Rails code in DHH's 37signals style |
ce-frontend-design |
Create production-grade frontend interfaces |
Review & Quality
| Skill | Description |
|---|---|
ce-doc-review |
Review documents using parallel persona agents for role-specific feedback |
Content & Collaboration
| Skill | Description |
|---|---|
ce-proof |
Create, edit, and share documents via Proof collaborative editor |
Automation & Tools
| Skill | Description |
|---|---|
ce-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-code-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 |
|---|---|
ce-agent-native-reviewer |
Verify features are agent-native (action + context parity) |
ce-api-contract-reviewer |
Detect breaking API contract changes |
ce-cli-agent-readiness-reviewer |
Evaluate CLI agent-friendliness against 7 core principles |
ce-cli-readiness-reviewer |
CLI agent-readiness persona for ce-code-review (conditional, structured JSON) |
ce-architecture-strategist |
Analyze architectural decisions and compliance |
ce-code-simplicity-reviewer |
Final pass for simplicity and minimalism |
ce-correctness-reviewer |
Logic errors, edge cases, state bugs |
ce-data-integrity-guardian |
Database migrations and data integrity |
ce-data-migration-expert |
Validate ID mappings match production, check for swapped values |
ce-data-migrations-reviewer |
Migration safety with confidence calibration |
ce-deployment-verification-agent |
Create Go/No-Go deployment checklists for risky data changes |
ce-dhh-rails-reviewer |
Rails review from DHH's perspective |
ce-julik-frontend-races-reviewer |
Review JavaScript/Stimulus code for race conditions |
ce-kieran-rails-reviewer |
Rails code review with strict conventions |
ce-kieran-python-reviewer |
Python code review with strict conventions |
ce-kieran-typescript-reviewer |
TypeScript code review with strict conventions |
ce-maintainability-reviewer |
Coupling, complexity, naming, dead code |
ce-pattern-recognition-specialist |
Analyze code for patterns and anti-patterns |
ce-performance-oracle |
Performance analysis and optimization |
ce-performance-reviewer |
Runtime performance with confidence calibration |
ce-reliability-reviewer |
Production reliability and failure modes |
ce-schema-drift-detector |
Detect unrelated schema.rb changes in PRs |
ce-security-reviewer |
Exploitable vulnerabilities with confidence calibration |
ce-security-sentinel |
Security audits and vulnerability assessments |
ce-swift-ios-reviewer |
Swift and iOS code review -- SwiftUI state, retain cycles, concurrency, Core Data threading, accessibility |
ce-testing-reviewer |
Test coverage gaps, weak assertions |
ce-project-standards-reviewer |
CLAUDE.md and AGENTS.md compliance |
ce-adversarial-reviewer |
Construct failure scenarios to break implementations across component boundaries |
Document Review
| Agent | Description |
|---|---|
ce-coherence-reviewer |
Review documents for internal consistency, contradictions, and terminology drift |
ce-design-lens-reviewer |
Review plans for missing design decisions, interaction states, and AI slop risk |
ce-feasibility-reviewer |
Evaluate whether proposed technical approaches will survive contact with reality |
ce-product-lens-reviewer |
Challenge problem framing, evaluate scope decisions, surface goal misalignment |
ce-scope-guardian-reviewer |
Challenge unjustified complexity, scope creep, and premature abstractions |
ce-security-lens-reviewer |
Evaluate plans for security gaps at the plan level (auth, data, APIs) |
ce-adversarial-document-reviewer |
Challenge premises, surface unstated assumptions, and stress-test decisions |
Research
| Agent | Description |
|---|---|
ce-best-practices-researcher |
Gather external best practices and examples |
ce-framework-docs-researcher |
Research framework documentation and best practices |
ce-git-history-analyzer |
Analyze git history and code evolution |
ce-issue-intelligence-analyst |
Analyze GitHub issues to surface recurring themes and pain patterns |
ce-learnings-researcher |
Search institutional learnings for relevant past solutions |
ce-repo-research-analyst |
Research repository structure and conventions |
ce-session-historian |
Search prior Claude Code, Codex, and Cursor sessions for related investigation context |
ce-slack-researcher |
Search Slack for organizational context relevant to the current task |
ce-web-researcher |
Perform iterative web research and return structured external grounding (prior art, adjacent solutions, market signals, cross-domain analogies) |
Design
| Agent | Description |
|---|---|
ce-design-implementation-reviewer |
Verify UI implementations match Figma designs |
ce-design-iterator |
Iteratively refine UI through systematic design iterations |
ce-figma-design-sync |
Synchronize web implementations with Figma designs |
Workflow
| Agent | Description |
|---|---|
ce-pr-comment-resolver |
Address PR comments and implement fixes |
ce-spec-flow-analyzer |
Analyze user flows and identify gaps in specifications |
Docs
| Agent | Description |
|---|---|
ce-ankane-readme-writer |
Create READMEs following Ankane-style template for Ruby gems |
Installation
See the repo root Install section for current installation instructions across Claude Code, Codex, Cursor, Copilot, Droid, Qwen, and converter-backed targets.
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