Skip to content

README.md

Latest commit

 

History

History
228 lines (169 loc) · 8.53 KB

README.md

File metadata and controls

228 lines (169 loc) · 8.53 KB

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+

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 using XcodeBuildMCP
/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

Reviewer Personas

Reviewer personas are pluggable — they live in external Git repos and are synced into the plugin via /ce:refresh. This lets you customize your review team without forking the plugin.

Setup

/ce:refresh

On first run, this creates ~/.config/compound-engineering/reviewer-sources.yaml with a default source and syncs all reviewer files. Run it again anytime to pull updates.

How it works

  • Each reviewer is a self-contained .md file with frontmatter defining its category (always-on, conditional, stack, etc.) and select_when criteria
  • The orchestrator reads frontmatter to decide which reviewers to spawn for a given diff
  • A _template-reviewer.md ships with the plugin as a starting point for writing your own

Configuring sources

Edit ~/.config/compound-engineering/reviewer-sources.yaml:

sources:
  # Your reviewers (higher priority -- listed first)
  - name: my-team
    repo: myorg/our-reviewers
    branch: main
    path: .

  # Default reviewers
  - name: ce-default
    repo: JumpstartLab/ce-reviewers
    branch: main
    path: .
    except:
      - kieran-python-reviewer
  • Sources listed first win on filename conflicts
  • except skips specific reviewers from a source
  • branch lets one repo host multiple reviewer sets

Creating a custom reviewer

  1. Copy _template-reviewer.md from agents/review/
  2. Fill in the persona, hunting targets, confidence calibration, and output format
  3. Set category and select_when in frontmatter
  4. Add to your reviewer repo and run /ce:refresh

Categories

Category When spawned
always-on Every review
conditional When the diff touches the reviewer's domain
stack Like conditional, scoped to a language/framework
plan-review During plan review phases
synthesis After other reviewers, to merge findings

Agents

Agents are specialized subagents invoked by skills — you typically don't call these directly.

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

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

Version History

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

License

MIT