# 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 | 27 | | Commands | 24 | | Skills | 15 | | MCP Servers | 1 | ## Agents Agents are organized into categories for easier discovery. ### Review (13) | Agent | Description | |-------|-------------| | `agent-native-reviewer` | Verify features are agent-native (action + context parity) | | `architecture-strategist` | Analyze architectural decisions and compliance | | `code-simplicity-reviewer` | Final pass for simplicity and minimalism | | `data-integrity-guardian` | Database migrations and data integrity | | `data-migration-expert` | Validate ID mappings match production, check for swapped values | | `deployment-verification-agent` | Create Go/No-Go deployment checklists for risky data changes | | `kieran-python-reviewer` | Python/FastAPI code review with strict conventions | | `kieran-typescript-reviewer` | TypeScript code review with strict conventions | | `tiangolo-fastapi-reviewer` | FastAPI review from Sebastián Ramírez's perspective | | `pattern-recognition-specialist` | Analyze code for patterns and anti-patterns | | `performance-oracle` | Performance analysis and optimization | | `security-sentinel` | Security audits and vulnerability assessments | | `julik-frontend-races-reviewer` | Review JavaScript/Stimulus code for race conditions | ### Research (5) | 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 | | `learnings-researcher` | Research and extract learnings from documentation | | `repo-research-analyst` | Research repository structure and conventions | ### Design (3) | 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 (5) | Agent | Description | |-------|-------------| | `bug-reproduction-validator` | Systematically reproduce and validate bug reports | | `every-style-editor` | Edit content to conform to Every's style guide | | `lint` | Run linting and code quality checks on Python files | | `pr-comment-resolver` | Address PR comments and implement fixes | | `spec-flow-analyzer` | Analyze user flows and identify gaps in specifications | ### Docs (1) | Agent | Description | |-------|-------------| | `python-package-readme-writer` | Create concise READMEs for Python packages | ## Commands ### Workflow Commands Core workflow commands use `workflows:` prefix to avoid collisions with built-in commands: | Command | Description | |---------|-------------| | `/workflows:brainstorm` | Explore requirements and approaches before planning | | `/workflows:plan` | Create implementation plans | | `/workflows:review` | Run comprehensive code reviews | | `/workflows:work` | Execute work items systematically | | `/workflows:compound` | Document solved problems to compound team knowledge | ### Utility Commands | Command | Description | |---------|-------------| | `/agent-native-audit` | Run comprehensive agent-native architecture review with scored principles | | `/changelog` | Create engaging changelogs for recent merges | | `/create-agent-skill` | Create or edit Claude Code skills | | `/deepen-plan` | Enhance plans with parallel research agents for each section | | `/deploy-docs` | Validate and prepare documentation for GitHub Pages deployment | | `/feature-video` | Record video walkthroughs and add to PR description | | `/generate_command` | Generate new slash commands | | `/heal-skill` | Fix skill documentation issues | | `/lfg` | Full autonomous engineering workflow | | `/plan_review` | Multi-agent plan review in parallel | | `/release-docs` | Build and update the documentation site with current plugin components | | `/report-bug` | Report a bug in the plugin | | `/reproduce-bug` | Reproduce bugs using logs and console | | `/resolve_parallel` | Resolve TODO comments in parallel | | `/resolve_pr_parallel` | Resolve PR comments in parallel | | `/resolve_todo_parallel` | Resolve todos in parallel | | `/test-browser` | Run browser tests on PR-affected pages | | `/triage` | Triage and prioritize issues | | `/xcode-test` | Build and test iOS apps on simulator | ## Skills ### Architecture & Design | Skill | Description | |-------|-------------| | `agent-native-architecture` | Build AI agents using prompt-native architecture | ### Development Tools | Skill | Description | |-------|-------------| | `compound-docs` | Capture solved problems as categorized documentation | | `create-agent-skills` | Expert guidance for creating Claude Code skills | | `dspy-python` | Build LLM applications with DSPy framework | | `fastapi-style` | Write FastAPI code following opinionated best practices | | `frontend-design` | Create production-grade frontend interfaces | | `python-package-writer` | Write Python packages following production-ready patterns | | `skill-creator` | Guide for creating effective Claude Code skills | ### Content & Workflow | Skill | Description | |-------|-------------| | `brainstorming` | Explore requirements and approaches before planning | | `every-style-editor` | Review copy for Every's style guide compliance | | `file-todos` | File-based todo tracking system | | `git-worktree` | Manage Git worktrees for parallel development | ### File Transfer | Skill | Description | |-------|-------------| | `rclone` | Upload files to S3, Cloudflare R2, Backblaze B2, and cloud storage | ### Browser Automation | Skill | Description | |-------|-------------| | `agent-browser` | CLI-based browser automation using Vercel's agent-browser | ### Image Generation | Skill | Description | |-------|-------------| | `gemini-imagegen` | Generate and edit images using Google's Gemini API | **gemini-imagegen features:** - Text-to-image generation - Image editing and manipulation - Multi-turn refinement - Multiple reference image composition (up to 14 images) **Requirements:** - `GEMINI_API_KEY` environment variable - Python packages: `google-genai`, `pillow` ## 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. ## Browser Automation This plugin uses **agent-browser CLI** for browser automation tasks. Install it globally: ```bash npm install -g agent-browser agent-browser install # Downloads Chromium ``` The `agent-browser` skill provides comprehensive documentation on usage. ## Installation ```bash 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`: ```json { "mcpServers": { "context7": { "type": "http", "url": "https://mcp.context7.com/mcp" } } } ``` Or add it globally in `~/.claude/settings.json` for all projects. ## Version History See [CHANGELOG.md](CHANGELOG.md) for detailed version history. ## License MIT