mirror of
https://github.com/EveryInc/compound-engineering-plugin.git
synced 2026-06-19 15:41:46 +02:00
Trevin Chow
337c01ee38
The plugin convention places executable scripts in `scripts/` and reference prose/schemas in `references/`. resolve-base.sh was the only `.sh` file living in any `references/` directory across the plugin. Move it to the conventional location and update the four callsites in SKILL.md, the script's own usage comment, and the two test files that referenced the old path. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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 | 38+ |
Skills
Core Workflow
The primary entry points for engineering work, invoked as slash commands. ce-strategy skill anchors the loop upstream; ce-product-pulse skill closes it with a read on user outcomes.
| Skill | Description |
|---|---|
/ce-strategy |
Create or maintain STRATEGY.md — the product's target problem, approach, persona, key metrics, and tracks. Re-runnable to update. Read as grounding by /ce-ideate, /ce-brainstorm, and /ce-plan when present |
/ce-ideate |
Optional big-picture ideation: generate and critically evaluate grounded ideas, then route the strongest one into brainstorming |
/ce-brainstorm |
Interactive Q&A to think through a feature or problem and write a right-sized requirements doc 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 |
/ce-product-pulse |
Generate a single-page, time-windowed report on usage, performance, errors, and followups. Saves reports to docs/pulse-reports/ as a browseable timeline of what users experienced |
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-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, or generate a description on its own without committing |
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-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-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 |
Development Frameworks
| Skill | Description |
|---|---|
ce-agent-native-architecture |
Build AI agents using prompt-native architecture |
ce-dhh-rails-style |
Write Ruby/Rails code in DHH's 37signals style |
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 |
/ce-simplify-code |
Simplify recent code changes for reuse, quality, and efficiency — parallel reviewers find issues, fixes applied, behavior verified by tests |
Content & Collaboration
| Skill | Description |
|---|---|
ce-proof |
Create, edit, and share documents via Proof collaborative editor |
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-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-swift-ios-reviewer |
Swift and iOS code review -- SwiftUI state, retain cycles, concurrency, Core Data threading, accessibility |
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
See the repo root Install section for current installation instructions across Claude Code, Codex, Cursor, Copilot, Droid, Qwen, and converter-backed targets.
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