claude-engineering-plugin/plugins/compound-engineering

Compounding Engineering Plugin

AI-powered development tools that get smarter with every use. Make each unit of engineering work easier than the last.

Components

Component	Count
Agents	36
Skills	48
Commands	7
MCP Servers	1

Agents

Agents are organized into categories for easier discovery.

Review

Agent	Description
agent-native-reviewer	Verify features are agent-native (action + context parity)
api-contract-reviewer	Detect breaking API contract changes
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-migrations-reviewer	Migration safety with confidence calibration
deployment-verification-agent	Create Go/No-Go deployment checklists for risky data changes
design-conformance-reviewer	Verify implementations match design documents
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
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

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)

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

Workflow

Agent	Description
bug-reproduction-validator	Systematically reproduce and validate bug reports
lint	Run linting and code quality checks on Python files
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

Commands

Workflow Commands

Core workflow commands use ce: prefix to unambiguously identify them as compound-engineering commands:

Command	Description
/ce:ideate	Discover high-impact project improvements through divergent ideation and adversarial filtering
/ce:brainstorm	Explore requirements and approaches before planning
/ce:plan	Transform features into structured implementation plans grounded in repo patterns
/ce:review	Structured code review with tiered persona agents, confidence gating, and dedup pipeline
/ce:work	Execute work items systematically
/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

Writing Commands

Command	Description
/essay-outline	Transform a brain dump into a story-structured essay outline
/essay-edit	Expert essay editor for line-level editing and structural review

PR & Todo Commands

Command	Description
/pr-comments-to-todos	Fetch PR comments and convert them into todo files for triage
/resolve_todo_parallel	Resolve all pending CLI todos using parallel processing

Deprecated Workflow Aliases

Command	Forwards to
/workflows:plan	/ce:plan
/workflows:review	/ce:review
/workflows:work	/ce:work

Utility Commands

Command	Description
/lfg	Full autonomous engineering workflow
/slfg	Full autonomous workflow with swarm mode for parallel execution
/deepen-plan	Stress-test plans and deepen weak sections with targeted research
/changelog	Create engaging changelogs for recent merges
/generate_command	Generate new slash commands
/sync	Sync Claude Code config across machines
/report-bug-ce	Report a bug in the compound-engineering plugin
/reproduce-bug	Reproduce bugs using logs and console
/resolve-pr-parallel	Resolve PR comments in parallel
/todo-resolve	Resolve todos in parallel
/todo-triage	Triage and prioritize pending todos
/test-browser	Run browser tests on PR-affected pages
/test-xcode	Build and test iOS apps on simulator
/feature-video	Record video walkthroughs and add to PR description

Skills

Architecture & Design

Skill	Description
agent-native-architecture	Build AI agents using prompt-native architecture

Development Tools

Skill	Description
compound-docs	Capture solved problems as categorized documentation
fastapi-style	Write Python/FastAPI code following opinionated best practices
frontend-design	Create production-grade frontend interfaces
python-package-writer	Write Python packages following production-ready patterns

Content & Writing

Skill	Description
document-review	Review documents using parallel persona agents for role-specific feedback
every-style-editor	Review copy for Every's style guide compliance
john-voice	Write content in John Lamb's authentic voice across all venues
proof	Create, edit, and share documents via Proof collaborative editor
proof-push	Push markdown documents to a running Proof server
story-lens	Evaluate prose quality using George Saunders's craft framework

Workflow & Process

Skill	Description
claude-permissions-optimizer	Optimize Claude Code permissions from session history
git-worktree	Manage Git worktrees for parallel development
jira-ticket-writer	Create Jira tickets with pressure-testing for tone and AI-isms
resolve-pr-parallel	Resolve PR review comments in parallel
setup	Configure which review agents run for your project
ship-it	Ticket, branch, commit, and open a PR in one shot
sync-confluence	Sync local markdown documentation to Confluence Cloud
todo-create	File-based todo tracking system
upstream-merge	Structured workflow for incorporating upstream changes into a fork
weekly-shipped	Summarize recently shipped work across the team

Multi-Agent Orchestration

Skill	Description
orchestrating-swarms	Comprehensive guide to multi-agent swarm orchestration

File Transfer

Skill	Description
rclone	Upload files to S3, Cloudflare R2, Backblaze B2, and cloud storage

Browser Automation

Skill	Description
agent-browser	CLI-based browser automation using Vercel's agent-browser

Image Generation & Diagrams

Skill	Description
excalidraw-png-export	Create hand-drawn style diagrams and export as PNG
gemini-imagegen	Generate and edit images using Google's Gemini API

gemini-imagegen features:

• Text-to-image generation
• Image editing and manipulation
• Multi-turn refinement
• Multiple reference image composition (up to 14 images)

Requirements:

• GEMINI_API_KEY environment variable
• Python packages: google-genai, pillow

MCP Servers

Server	Description
context7	Framework documentation lookup via Context7

Context7

Tools provided:

• resolve-library-id - Find library ID for a framework/package
• get-library-docs - Get documentation for a specific library

Supports 100+ frameworks including Rails, React, Next.js, Vue, Django, Laravel, and more.

MCP servers start automatically when the plugin is enabled.

Authentication: To avoid anonymous rate limits, set the CONTEXT7_API_KEY environment variable with your Context7 API key. The plugin passes this automatically via the x-api-key header. Without it, requests go unauthenticated and will quickly hit the anonymous quota limit.

Browser Automation

This plugin uses agent-browser CLI for browser automation tasks. Install it globally:

npm install -g agent-browser
agent-browser install  # Downloads Chromium

The agent-browser skill provides comprehensive documentation on usage.

Installation

claude /plugin install compound-engineering

Known Issues

MCP Servers Not Auto-Loading

Issue: The bundled Context7 MCP server may not load automatically when the plugin is installed.

Workaround: Manually add it to your project's .claude/settings.json:

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "x-api-key": "${CONTEXT7_API_KEY:-}"
      }
    }
  }
}

Set CONTEXT7_API_KEY in your environment to authenticate. Or add it globally in ~/.claude/settings.json for all projects.

Version History

See the repo root CHANGELOG.md for canonical release history.

License

MIT