logo
0
0
WeChat Login
Trevin Chow<trevin@trevinchow.com>
fix: harden git workflow skills with better state handling (#406)

Compounding Engineering Plugin

AI-powered development tools that get smarter with every use. Make each unit of engineering work easier than the last.

Components

ComponentCount
Agents35+
Skills40+
MCP Servers1

Skills

Core Workflow

The primary entry points for engineering work, invoked as slash commands:

SkillDescription
/ce:ideateDiscover high-impact project improvements through divergent ideation and adversarial filtering
/ce:brainstormExplore requirements and approaches before planning
/ce:planTransform features into structured implementation plans grounded in repo patterns, with automatic confidence checking
/ce:reviewStructured code review with tiered persona agents, confidence gating, and dedup pipeline
/ce:workExecute work items systematically
/ce:compoundDocument solved problems to compound team knowledge
/ce:compound-refreshRefresh stale or drifting learnings and decide whether to keep, update, replace, or archive them

Git Workflow

SkillDescription
git-clean-gone-branchesClean up local branches whose remote tracking branch is gone
git-commitCreate a git commit with a value-communicating message
git-commit-push-prCommit, push, and open a PR with an adaptive description; also update an existing PR description
git-worktreeManage Git worktrees for parallel development

Workflow Utilities

SkillDescription
/changelogCreate engaging changelogs for recent merges
/feature-videoRecord video walkthroughs and add to PR description
/reproduce-bugReproduce bugs using logs and console
/report-bug-ceReport a bug in the compound-engineering plugin
/resolve-pr-feedbackResolve PR review feedback in parallel
/syncSync Claude Code config across machines
/test-browserRun browser tests on PR-affected pages
/test-xcodeBuild and test iOS apps on simulator
/onboardingGenerate ONBOARDING.md to help new contributors understand the codebase
/todo-resolveResolve todos in parallel
/todo-triageTriage and prioritize pending todos

Development Frameworks

SkillDescription
agent-native-architectureBuild AI agents using prompt-native architecture
andrew-kane-gem-writerWrite Ruby gems following Andrew Kane's patterns
dhh-rails-styleWrite Ruby/Rails code in DHH's 37signals style
dspy-rubyBuild type-safe LLM applications with DSPy.rb
frontend-designCreate production-grade frontend interfaces

Review & Quality

SkillDescription
claude-permissions-optimizerOptimize Claude Code permissions from session history
document-reviewReview documents using parallel persona agents for role-specific feedback
setupReserved for future project-level workflow configuration; code review agent selection is automatic

Content & Collaboration

SkillDescription
every-style-editorReview copy for Every's style guide compliance
proofCreate, edit, and share documents via Proof collaborative editor
todo-createFile-based todo tracking system

Automation & Tools

SkillDescription
agent-browserCLI-based browser automation using Vercel's agent-browser
gemini-imagegenGenerate and edit images using Google's Gemini API
orchestrating-swarmsComprehensive guide to multi-agent swarm orchestration
rcloneUpload files to S3, Cloudflare R2, Backblaze B2, and cloud storage

Beta / Experimental

SkillDescription
/lfgFull autonomous engineering workflow
/slfgFull autonomous workflow with swarm mode for parallel execution

Agents

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

Review

AgentDescription
agent-native-reviewerVerify features are agent-native (action + context parity)
api-contract-reviewerDetect breaking API contract changes
cli-agent-readiness-reviewerEvaluate CLI agent-friendliness against 7 core principles
architecture-strategistAnalyze architectural decisions and compliance
code-simplicity-reviewerFinal pass for simplicity and minimalism
correctness-reviewerLogic errors, edge cases, state bugs
data-integrity-guardianDatabase migrations and data integrity
data-migration-expertValidate ID mappings match production, check for swapped values
data-migrations-reviewerMigration safety with confidence calibration
deployment-verification-agentCreate Go/No-Go deployment checklists for risky data changes
dhh-rails-reviewerRails review from DHH's perspective
julik-frontend-races-reviewerReview JavaScript/Stimulus code for race conditions
kieran-rails-reviewerRails code review with strict conventions
kieran-python-reviewerPython code review with strict conventions
kieran-typescript-reviewerTypeScript code review with strict conventions
maintainability-reviewerCoupling, complexity, naming, dead code
pattern-recognition-specialistAnalyze code for patterns and anti-patterns
performance-oraclePerformance analysis and optimization
performance-reviewerRuntime performance with confidence calibration
reliability-reviewerProduction reliability and failure modes
schema-drift-detectorDetect unrelated schema.rb changes in PRs
security-reviewerExploitable vulnerabilities with confidence calibration
security-sentinelSecurity audits and vulnerability assessments
testing-reviewerTest coverage gaps, weak assertions
project-standards-reviewerCLAUDE.md and AGENTS.md compliance
adversarial-reviewerConstruct failure scenarios to break implementations across component boundaries

Document Review

AgentDescription
coherence-reviewerReview documents for internal consistency, contradictions, and terminology drift
design-lens-reviewerReview plans for missing design decisions, interaction states, and AI slop risk
feasibility-reviewerEvaluate whether proposed technical approaches will survive contact with reality
product-lens-reviewerChallenge problem framing, evaluate scope decisions, surface goal misalignment
scope-guardian-reviewerChallenge unjustified complexity, scope creep, and premature abstractions
security-lens-reviewerEvaluate plans for security gaps at the plan level (auth, data, APIs)
adversarial-document-reviewerChallenge premises, surface unstated assumptions, and stress-test decisions

Research

AgentDescription
best-practices-researcherGather external best practices and examples
framework-docs-researcherResearch framework documentation and best practices
git-history-analyzerAnalyze git history and code evolution
issue-intelligence-analystAnalyze GitHub issues to surface recurring themes and pain patterns
learnings-researcherSearch institutional learnings for relevant past solutions
repo-research-analystResearch repository structure and conventions

Design

AgentDescription
design-implementation-reviewerVerify UI implementations match Figma designs
design-iteratorIteratively refine UI through systematic design iterations
figma-design-syncSynchronize web implementations with Figma designs

Workflow

AgentDescription
bug-reproduction-validatorSystematically reproduce and validate bug reports
lintRun linting and code quality checks on Ruby and ERB files
pr-comment-resolverAddress PR comments and implement fixes
spec-flow-analyzerAnalyze user flows and identify gaps in specifications

Docs

AgentDescription
ankane-readme-writerCreate READMEs following Ankane-style template for Ruby gems

MCP Servers

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