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	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
hugo-blog-publisher	Publish posts to a Hugo blog via SSH — supports links (pull-quote + commentary) and blog (original essays) post types
john-voice	Write content in John Lamb's voice — applies core voice, venue guides, signature moves, and a revision checklist
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