claude-engineering-plugin/plugins/compound-engineering/README.md

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	41+

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
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
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)
/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
claude-permissions-optimizer	Optimize Claude Code permissions from session history
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
/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
data-migration-expert	Validate ID mappings match production, check for swapped values
data-migrations-reviewer	Migration safety with confidence calibration
deployment-verification-agent	Create Go/No-Go deployment checklists for risky data changes
dhh-rails-reviewer	Rails review from DHH's perspective
julik-frontend-races-reviewer	Review JavaScript/Stimulus code for race conditions
kieran-rails-reviewer	Rails code review with strict conventions
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-oracle	Performance analysis and optimization
performance-reviewer	Runtime performance with confidence calibration
reliability-reviewer	Production reliability and failure modes
schema-drift-detector	Detect unrelated schema.rb changes in PRs
security-reviewer	Exploitable vulnerabilities with confidence calibration
security-sentinel	Security audits and vulnerability assessments
testing-reviewer	Test coverage gaps, weak assertions
project-standards-reviewer	CLAUDE.md and AGENTS.md compliance
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

Design

Agent	Description
design-implementation-reviewer	Verify UI implementations match Figma designs
design-iterator	Iteratively refine UI through systematic design iterations
figma-design-sync	Synchronize web implementations with Figma designs

Workflow

Agent	Description
pr-comment-resolver	Address PR comments and implement fixes
spec-flow-analyzer	Analyze user flows and identify gaps in specifications

Docs

Agent	Description
ankane-readme-writer	Create READMEs following Ankane-style template for Ruby gems

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