4b2820bdce
Update all documentation to show the correct command syntax: - `/plan`, `/review`, `/work`, `/codify` (short form, autocompletes) Previously showed `/workflows:plan` etc. which doesn't work. The `name:` field in frontmatter determines the short command name. Fixes #19 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
201 lines
6.2 KiB
Markdown
201 lines
6.2 KiB
Markdown
# 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 | 23 |
|
|
| Commands | 16 |
|
|
| Skills | 11 |
|
|
| MCP Servers | 2 |
|
|
|
|
## Agents
|
|
|
|
Agents are organized into categories for easier discovery.
|
|
|
|
### Review (10)
|
|
|
|
| Agent | Description |
|
|
|-------|-------------|
|
|
| `architecture-strategist` | Analyze architectural decisions and compliance |
|
|
| `code-simplicity-reviewer` | Final pass for simplicity and minimalism |
|
|
| `data-integrity-guardian` | Database migrations and data integrity |
|
|
| `dhh-rails-reviewer` | Rails review from DHH's perspective |
|
|
| `kieran-rails-reviewer` | Rails code review with strict conventions |
|
|
| `kieran-python-reviewer` | Python code review with strict conventions |
|
|
| `kieran-typescript-reviewer` | TypeScript code review with strict conventions |
|
|
| `pattern-recognition-specialist` | Analyze code for patterns and anti-patterns |
|
|
| `performance-oracle` | Performance analysis and optimization |
|
|
| `security-sentinel` | Security audits and vulnerability assessments |
|
|
|
|
### Research (4)
|
|
|
|
| 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 |
|
|
| `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 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 (1)
|
|
|
|
| Agent | Description |
|
|
|-------|-------------|
|
|
| `ankane-readme-writer` | Create READMEs following Ankane-style template for Ruby gems |
|
|
|
|
## Commands
|
|
|
|
### Workflow Commands
|
|
|
|
Core workflow commands (use the short form for autocomplete):
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/plan` | Create implementation plans |
|
|
| `/review` | Run comprehensive code reviews |
|
|
| `/work` | Execute work items systematically |
|
|
| `/codify` | Document solved problems for knowledge base |
|
|
|
|
### Utility Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/changelog` | Create engaging changelogs for recent merges |
|
|
| `/create-agent-skill` | Create or edit Claude Code skills |
|
|
| `/generate_command` | Generate new slash commands |
|
|
| `/heal-skill` | Fix skill documentation issues |
|
|
| `/plan_review` | Multi-agent plan review in parallel |
|
|
| `/prime` | Prime/setup command |
|
|
| `/report-bug` | Report a bug in the compounding-engineering 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 |
|
|
| `/triage` | Triage and prioritize issues |
|
|
|
|
## Skills
|
|
|
|
### Development Tools
|
|
|
|
| Skill | Description |
|
|
|-------|-------------|
|
|
| `andrew-kane-gem-writer` | Write Ruby gems following Andrew Kane's patterns |
|
|
| `codify-docs` | Capture solved problems as categorized documentation |
|
|
| `create-agent-skills` | Expert guidance for creating Claude Code skills |
|
|
| `dhh-ruby-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 |
|
|
| `skill-creator` | Guide for creating effective Claude Code skills |
|
|
|
|
### Content & Workflow
|
|
|
|
| Skill | Description |
|
|
|-------|-------------|
|
|
| `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 |
|
|
|
|
### 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 |
|
|
|--------|-------------|
|
|
| `playwright` | Browser automation via `@playwright/mcp` |
|
|
| `context7` | Framework documentation lookup via Context7 |
|
|
|
|
### Playwright
|
|
|
|
**Tools provided:**
|
|
- `browser_navigate` - Navigate to URLs
|
|
- `browser_take_screenshot` - Take screenshots
|
|
- `browser_click` - Click elements
|
|
- `browser_fill_form` - Fill form fields
|
|
- `browser_snapshot` - Get accessibility snapshot
|
|
- `browser_evaluate` - Execute JavaScript
|
|
|
|
### 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.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
claude /plugin install compounding-engineering
|
|
```
|
|
|
|
## Known Issues
|
|
|
|
### MCP Servers Not Auto-Loading
|
|
|
|
**Issue:** The bundled MCP servers (Playwright and Context7) may not load automatically when the plugin is installed.
|
|
|
|
**Workaround:** Manually add them to your project's `.claude/settings.json`:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"playwright": {
|
|
"type": "stdio",
|
|
"command": "npx",
|
|
"args": ["-y", "@playwright/mcp@latest"],
|
|
"env": {}
|
|
},
|
|
"context7": {
|
|
"type": "http",
|
|
"url": "https://mcp.context7.com/mcp"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Or add them globally in `~/.claude/settings.json` for all projects.
|
|
|
|
## Version History
|
|
|
|
See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
|
|
|
|
## License
|
|
|
|
MIT
|