Files
Trevin Chow 7e11ae274e fix: restore OPEN state check for existing PR detection
gh pr view can return CLOSED/MERGED PRs on reused branches.
Without the state gate, the skill skips PR creation or edits
the wrong PR. Restores the check in both the full workflow
(Step 3) and the description-update flow (DU-2).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 00:38:16 -07:00
..
2026-03-26 11:21:27 -07:00
2026-03-26 11:21:27 -07:00
2026-03-26 11:21:27 -07:00

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

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 Transform features into structured implementation plans grounded in repo patterns, 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: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

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
/feature-video Record video walkthroughs and add to PR description
/reproduce-bug Reproduce bugs using logs and console
/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
/onboarding Generate ONBOARDING.md to help new contributors understand the codebase
/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
setup Reserved for future project-level workflow configuration; code review agent selection is automatic

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
agent-browser CLI-based browser automation using Vercel's agent-browser
gemini-imagegen Generate and edit images using Google's Gemini API
orchestrating-swarms Comprehensive guide to multi-agent swarm orchestration
rclone Upload files to S3, Cloudflare R2, Backblaze B2, and cloud storage

Beta / Experimental

Skill Description
/lfg Full autonomous engineering workflow
/slfg Full autonomous workflow with swarm mode for parallel execution

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

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

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