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.

Components

Component	Count
Agents	27
Commands	24
Skills	15
MCP Servers	1

Agents

Agents are organized into categories for easier discovery.

Review (13)

Agent	Description
agent-native-reviewer	Verify features are agent-native (action + context parity)
architecture-strategist	Analyze architectural decisions and compliance
code-simplicity-reviewer	Final pass for simplicity and minimalism
data-integrity-guardian	Database migrations and data integrity
data-migration-expert	Validate ID mappings match production, check for swapped values
deployment-verification-agent	Create Go/No-Go deployment checklists for risky data changes
kieran-python-reviewer	Python/FastAPI code review with strict conventions
kieran-typescript-reviewer	TypeScript code review with strict conventions
tiangolo-fastapi-reviewer	FastAPI review from Sebastián Ramírez's perspective
pattern-recognition-specialist	Analyze code for patterns and anti-patterns
performance-oracle	Performance analysis and optimization
security-sentinel	Security audits and vulnerability assessments
julik-frontend-races-reviewer	Review JavaScript/Stimulus code for race conditions

Research (5)

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
learnings-researcher	Research and extract learnings from documentation
repo-research-analyst	Research repository structure and conventions

Design (3)

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 (5)

Agent	Description
bug-reproduction-validator	Systematically reproduce and validate bug reports
every-style-editor	Edit content to conform to Every's style guide
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 (1)

Agent	Description
python-package-readme-writer	Create concise READMEs for Python packages

Commands

Workflow Commands

Core workflow commands use workflows: prefix to avoid collisions with built-in commands:

Command	Description
/workflows:brainstorm	Explore requirements and approaches before planning
/workflows:plan	Create implementation plans
/workflows:review	Run comprehensive code reviews
/workflows:work	Execute work items systematically
/workflows:compound	Document solved problems to compound team knowledge

Utility Commands

Command	Description
/agent-native-audit	Run comprehensive agent-native architecture review with scored principles
/changelog	Create engaging changelogs for recent merges
/create-agent-skill	Create or edit Claude Code skills
/deepen-plan	Enhance plans with parallel research agents for each section
/deploy-docs	Validate and prepare documentation for GitHub Pages deployment
/feature-video	Record video walkthroughs and add to PR description
/generate_command	Generate new slash commands
/heal-skill	Fix skill documentation issues
/lfg	Full autonomous engineering workflow
/plan_review	Multi-agent plan review in parallel
/release-docs	Build and update the documentation site with current plugin components
/report-bug	Report a bug in the plugin
/reproduce-bug	Reproduce bugs using logs and console
/resolve_parallel	Resolve TODO comments in parallel
/resolve_pr_parallel	Resolve PR comments in parallel
/resolve_todo_parallel	Resolve todos in parallel
/test-browser	Run browser tests on PR-affected pages
/triage	Triage and prioritize issues
/xcode-test	Build and test iOS apps on simulator

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
create-agent-skills	Expert guidance for creating Claude Code skills
dspy-python	Build LLM applications with DSPy framework
fastapi-style	Write FastAPI code following opinionated best practices
frontend-design	Create production-grade frontend interfaces
python-package-writer	Write Python packages following production-ready patterns
skill-creator	Guide for creating effective Claude Code skills

Content & Workflow

Skill	Description
brainstorming	Explore requirements and approaches before planning
every-style-editor	Review copy for Every's style guide compliance
file-todos	File-based todo tracking system
git-worktree	Manage Git worktrees for parallel development

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.

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"
    }
  }
}

Or add it globally in ~/.claude/settings.json for all projects.

Version History

See CHANGELOG.md for detailed version history.

License

MIT