mirror of
https://github.com/EveryInc/compound-engineering-plugin.git
synced 2026-06-19 15:41:46 +02:00
Trevin Chow
d19546985a
Mirror the ce-brainstorm requirements-capture.md legibility convention: horizontal rules (---) between top-level sections in Standard and Deep plans. Improves scannability of dense plans where many H2 sections sit close together. Omit for Lightweight plans. Adds the convention to Phase 4.3 Planning Rules and inserts separators throughout the core template and the optional Deep-extension template. Refs PR #629 (originated the convention in the brainstorm template).
Compounding Engineering Plugin
AI-powered development tools that get smarter with every use. Make each unit of engineering work easier than the last.
Getting Started
After installing, run /ce-setup in any project. It diagnoses your environment, installs missing tools, and bootstraps project config in one interactive flow.
Components
| Component | Count |
|---|---|
| Agents | 50+ |
| Skills | 42+ |
Skills
Core Workflow
The primary entry points for engineering work are skills invoked with slash syntax:
| 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 |
Create structured plans for any multi-step task -- software features, research workflows, events, study plans -- with automatic confidence checking |
/ce-code-review |
Structured code review with tiered persona agents, confidence gating, and dedup pipeline |
/ce-work |
Execute work items systematically |
/ce-debug |
Systematically find root causes and fix bugs -- traces causal chains, forms testable hypotheses, and implements test-first fixes |
/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 |
/ce-optimize |
Run iterative optimization loops with parallel experiments, measurement gates, and LLM-as-judge quality scoring |
For /ce-optimize, see skills/ce-optimize/README.md for usage guidance, example specs, and links to the schema and workflow docs.
Research & Context
| Skill | Description |
|---|---|
/ce-sessions |
Ask questions about session history across Claude Code, Codex, and Cursor |
/ce-slack-research |
Search Slack for interpreted organizational context -- decisions, constraints, and discussion arcs |
Git Workflow
| Skill | Description |
|---|---|
ce-pr-description |
Write or regenerate a value-first PR title and body from the current branch or a specified PR; used directly or by other skills |
ce-clean-gone-branches |
Clean up local branches whose remote tracking branch is gone |
ce-commit |
Create a git commit with a value-communicating message |
ce-commit-push-pr |
Commit, push, and open a PR with an adaptive description; also update an existing PR description (delegates title/body generation to ce-pr-description) |
ce-worktree |
Manage Git worktrees for parallel development |
Workflow Utilities
| Skill | Description |
|---|---|
/ce-demo-reel |
Capture a visual demo reel (GIF demos, terminal recordings, screenshots) for PRs with project-type-aware tier selection |
/ce-changelog |
Create engaging changelogs for recent merges |
/ce-report-bug |
Report a bug in the compound-engineering plugin |
/ce-resolve-pr-feedback |
Resolve PR review feedback in parallel |
/ce-test-browser |
Run browser tests on PR-affected pages |
/ce-test-xcode |
Build and test iOS apps on simulator using XcodeBuildMCP |
/ce-onboarding |
Generate ONBOARDING.md to help new contributors understand the codebase |
/ce-setup |
Diagnose environment, install missing tools, and bootstrap project config |
/ce-update |
Check compound-engineering plugin version and fix stale cache (Claude Code only) |
/ce-release-notes |
Summarize recent compound-engineering plugin releases, or answer a question about a past release with a version citation |
/ce-todo-resolve |
Resolve todos in parallel |
/ce-todo-triage |
Triage and prioritize pending todos |
Development Frameworks
| Skill | Description |
|---|---|
ce-agent-native-architecture |
Build AI agents using prompt-native architecture |
ce-andrew-kane-gem-writer |
Write Ruby gems following Andrew Kane's patterns |
ce-dhh-rails-style |
Write Ruby/Rails code in DHH's 37signals style |
ce-dspy-ruby |
Build type-safe LLM applications with DSPy.rb |
ce-frontend-design |
Create production-grade frontend interfaces |
Review & Quality
| Skill | Description |
|---|---|
ce-doc-review |
Review documents using parallel persona agents for role-specific feedback |
Content & Collaboration
| Skill | Description |
|---|---|
ce-every-style-editor |
Review copy for Every's style guide compliance |
ce-proof |
Create, edit, and share documents via Proof collaborative editor |
ce-todo-create |
File-based todo tracking system |
Automation & Tools
| Skill | Description |
|---|---|
ce-gemini-imagegen |
Generate and edit images using Google's Gemini API |
Beta / Experimental
| Skill | Description |
|---|---|
/ce-polish-beta |
Human-in-the-loop polish phase after /ce-code-review — verifies review + CI, starts a dev server from .claude/launch.json, generates a testable checklist, and dispatches polish sub-agents for fixes. Emits stacked-PR seeds for oversized work |
/lfg |
Full autonomous engineering workflow |
Agents
Agents are specialized subagents invoked by skills — you typically don't call these directly.
Review
| Agent | Description |
|---|---|
ce-agent-native-reviewer |
Verify features are agent-native (action + context parity) |
ce-api-contract-reviewer |
Detect breaking API contract changes |
ce-cli-agent-readiness-reviewer |
Evaluate CLI agent-friendliness against 7 core principles |
ce-cli-readiness-reviewer |
CLI agent-readiness persona for ce-code-review (conditional, structured JSON) |
ce-architecture-strategist |
Analyze architectural decisions and compliance |
ce-code-simplicity-reviewer |
Final pass for simplicity and minimalism |
ce-correctness-reviewer |
Logic errors, edge cases, state bugs |
ce-data-integrity-guardian |
Database migrations and data integrity |
ce-data-migration-expert |
Validate ID mappings match production, check for swapped values |
ce-data-migrations-reviewer |
Migration safety with confidence calibration |
ce-deployment-verification-agent |
Create Go/No-Go deployment checklists for risky data changes |
ce-dhh-rails-reviewer |
Rails review from DHH's perspective |
ce-julik-frontend-races-reviewer |
Review JavaScript/Stimulus code for race conditions |
ce-kieran-rails-reviewer |
Rails code review with strict conventions |
ce-kieran-python-reviewer |
Python code review with strict conventions |
ce-kieran-typescript-reviewer |
TypeScript code review with strict conventions |
ce-maintainability-reviewer |
Coupling, complexity, naming, dead code |
ce-pattern-recognition-specialist |
Analyze code for patterns and anti-patterns |
ce-performance-oracle |
Performance analysis and optimization |
ce-performance-reviewer |
Runtime performance with confidence calibration |
ce-reliability-reviewer |
Production reliability and failure modes |
ce-schema-drift-detector |
Detect unrelated schema.rb changes in PRs |
ce-security-reviewer |
Exploitable vulnerabilities with confidence calibration |
ce-security-sentinel |
Security audits and vulnerability assessments |
ce-testing-reviewer |
Test coverage gaps, weak assertions |
ce-project-standards-reviewer |
CLAUDE.md and AGENTS.md compliance |
ce-adversarial-reviewer |
Construct failure scenarios to break implementations across component boundaries |
Document Review
| Agent | Description |
|---|---|
ce-coherence-reviewer |
Review documents for internal consistency, contradictions, and terminology drift |
ce-design-lens-reviewer |
Review plans for missing design decisions, interaction states, and AI slop risk |
ce-feasibility-reviewer |
Evaluate whether proposed technical approaches will survive contact with reality |
ce-product-lens-reviewer |
Challenge problem framing, evaluate scope decisions, surface goal misalignment |
ce-scope-guardian-reviewer |
Challenge unjustified complexity, scope creep, and premature abstractions |
ce-security-lens-reviewer |
Evaluate plans for security gaps at the plan level (auth, data, APIs) |
ce-adversarial-document-reviewer |
Challenge premises, surface unstated assumptions, and stress-test decisions |
Research
| Agent | Description |
|---|---|
ce-best-practices-researcher |
Gather external best practices and examples |
ce-framework-docs-researcher |
Research framework documentation and best practices |
ce-git-history-analyzer |
Analyze git history and code evolution |
ce-issue-intelligence-analyst |
Analyze GitHub issues to surface recurring themes and pain patterns |
ce-learnings-researcher |
Search institutional learnings for relevant past solutions |
ce-repo-research-analyst |
Research repository structure and conventions |
ce-session-historian |
Search prior Claude Code, Codex, and Cursor sessions for related investigation context |
ce-slack-researcher |
Search Slack for organizational context relevant to the current task |
ce-web-researcher |
Perform iterative web research and return structured external grounding (prior art, adjacent solutions, market signals, cross-domain analogies) |
Design
| Agent | Description |
|---|---|
ce-design-implementation-reviewer |
Verify UI implementations match Figma designs |
ce-design-iterator |
Iteratively refine UI through systematic design iterations |
ce-figma-design-sync |
Synchronize web implementations with Figma designs |
Workflow
| Agent | Description |
|---|---|
ce-pr-comment-resolver |
Address PR comments and implement fixes |
ce-spec-flow-analyzer |
Analyze user flows and identify gaps in specifications |
Docs
| Agent | Description |
|---|---|
ce-ankane-readme-writer |
Create READMEs following Ankane-style template for Ruby gems |
Installation
claude /plugin install compound-engineering
Then run /ce-setup to check your environment and install recommended tools.
Version History
See the repo root CHANGELOG.md for canonical release history.
License
MIT