compound-engineering-plugin-mirror/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.

Components

Component	Count
Agents	35+
Skills	40+
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-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

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

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

Commands

Autopilot Workflow

Run a complete engineering workflow from feature description to PR:

Command	Description
/lfg [description]	Right-sized autopilot workflow: routes to direct edit, lightweight execution, or the full pipeline based on task complexity, and can resume from the current workflow gate when work is already in progress
/slfg [description]	Deprecated compatibility wrapper that routes to /lfg with swarm mode enabled

/lfg assesses task complexity and chooses the right amount of ceremony. Trivial fixes (typos, renames) execute directly. Bounded tasks with clear requirements skip planning and multi-agent review. Complex or ambiguous tasks run the full pipeline in autopilot mode: brainstorm → plan → work → review → resolve todos → test → video. Autopilot skips workflow menus, but it still asks content questions when it would otherwise need to invent product behavior, scope, or success criteria. All three routes are resumable: direct and lightweight runs create lightweight manifests that intentionally mark requirements/plan as skipped, while full-pipeline runs attach durable requirements and plan artifacts. /lfg resumes from the first unmet workflow gate using that manifest when present and falls back to conservative reconstruction from durable artifacts, repo state, PR state, and todos when it is not. Review, browser verification, and wrap-up completions are revalidated conservatively against the current HEAD so stale late-stage state does not get reused after code changes. Browser testing and feature-video remain best-effort by default: if the environment is unavailable, /lfg records the skip and continues instead of failing the whole run. Swarm is now an execution mode behind /lfg; /slfg remains only as a migration path.

When lfg reaches implementation, explicit user requests for swarm/agent teams win. Otherwise it may read implementation_mode: standard | swarm from compound-engineering.local.md. If that flag is absent, lfg assumes standard.

Step-by-Step Workflow

Use individual commands when you want control over specific phases. Core workflow commands use the ce: prefix:

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

Step-by-step is useful when you want to brainstorm now and plan later, build a plan from an existing requirements doc, run just a review, or document a fix.

Utility Commands

Command	Description
/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
andrew-kane-gem-writer	Write Ruby gems following Andrew Kane's patterns
compound-docs	Capture solved problems as categorized documentation
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

Content & Workflow

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
todo-create	File-based todo tracking system
git-worktree	Manage Git worktrees for parallel development
proof	Create, edit, and share documents via Proof collaborative editor
claude-permissions-optimizer	Optimize Claude Code permissions from session history
resolve-pr-parallel	Resolve PR review comments in parallel
setup	Configure which review agents run for your project

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

Skill	Description
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