john/claude-engineering-plugin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Update README and CHANGELOG for v2.0.0

Browse Source 
- Complete rewrite of README with categorized agents, commands, and skills
- Detailed CHANGELOG documenting v1.0.0, v1.1.0, and v2.0.0 changes
- Summary tables showing component growth (17→24 agents, 6→15 commands, 1→11 skills)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Kieran Klaassen
2025-11-24 11:52:14 -08:00
parent 8cc99ab483
commit e262127d3a
2 changed files with 227 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

126
plugins/compounding-engineering/CHANGELOG.md
View File

@@ -1,14 +1,82 @@
# Changelog
All notable changes to the compounding-engineering plugin will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [2.0.0] - 2024-11-24
Major reorganization consolidating agents, commands, and skills from multiple sources into a single, well-organized plugin.
### Added
**New Agents (7)**
- `design-iterator` - Iteratively refine UI components through systematic design iterations
- `design-implementation-reviewer` - Verify UI implementations match Figma design specifications
- `figma-design-sync` - Synchronize web implementations with Figma designs
- `bug-reproduction-validator` - Systematically reproduce and validate bug reports
- `spec-flow-analyzer` - Analyze user flows and identify gaps in specifications
- `lint` - Run linting and code quality checks on Ruby and ERB files
- `ankane-readme-writer` - Create READMEs following Ankane-style template for Ruby gems
**New Commands (9)**
- `/changelog` - Create engaging changelogs for recent merges
- `/plan_review` - Multi-agent plan review in parallel
- `/resolve_parallel` - Resolve TODO comments in parallel
- `/resolve_pr_parallel` - Resolve PR comments in parallel
- `/reproduce-bug` - Reproduce bugs using logs and console
- `/prime` - Prime/setup command
- `/create-agent-skill` - Create or edit Claude Code skills
- `/heal-skill` - Fix skill documentation issues
- `/workflows:codify` - Document solved problems for knowledge base
**New Skills (10)**
- `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
- `every-style-editor` - Review copy for Every's style guide compliance
- `file-todos` - File-based todo tracking system
- `frontend-design` - Create production-grade frontend interfaces
- `git-worktree` - Manage Git worktrees for parallel development
- `skill-creator` - Guide for creating effective Claude Code skills
### Changed
**Agents Reorganized by Category**
- `review/` (10 agents) - Code quality, security, performance reviewers
- `research/` (4 agents) - Documentation, patterns, history analysis
- `design/` (3 agents) - UI/design review and iteration
- `workflow/` (6 agents) - PR resolution, bug validation, linting
- `docs/` (1 agent) - README generation
**Commands Restructured**
- Workflow commands moved to `commands/workflows/` subdirectory
- `/plan`, `/review`, `/work` now accessed as `/workflows:plan`, `/workflows:review`, `/workflows:work`
### Summary
| Component | v1.1.0 | v2.0.0 | Change |
|-----------|--------|--------|--------|
| Agents | 17 | 24 | +7 |
| Commands | 6 | 15 | +9 |
| Skills | 1 | 11 | +10 |
---
## [1.1.0] - 2024-11-22
### Added
- **gemini-imagegen skill** - Generate and edit images using Google's Gemini API
- Text-to-image generation
- Image editing and manipulation
- Multi-turn refinement via chat
- Multiple reference image composition (up to 14 images)
- Supports both `gemini-2.5-flash-image` and `gemini-3-pro-image-preview` models
**gemini-imagegen Skill**
- Text-to-image generation with Google's Gemini API
- Image editing and manipulation
- Multi-turn refinement via chat interface
- Multiple reference image composition (up to 14 images)
- Model support: `gemini-2.5-flash-image` and `gemini-3-pro-image-preview`
- Python scripts: `generate_image.py`, `edit_image.py`, `multi_turn_chat.py`, `compose_images.py`
### Fixed
- Corrected component counts in documentation (17 agents, not 15)
@@ -16,10 +84,52 @@
### Documentation
- Added comprehensive README with all components listed
- Added this changelog
- Added `requirements.txt` for Python dependencies
---
## [1.0.0] - 2024-10-09
Initial release of the compounding-engineering plugin.
### Added
- Initial release with 17 specialized agents
- 6 slash commands for common workflows
**17 Specialized Agents**
*Code Review (5)*
- `kieran-rails-reviewer` - Rails code review with strict conventions
- `kieran-python-reviewer` - Python code review with quality standards
- `kieran-typescript-reviewer` - TypeScript code review
- `dhh-rails-reviewer` - Rails review from DHH's perspective
- `code-simplicity-reviewer` - Final pass for simplicity and minimalism
*Analysis & Architecture (4)*
- `architecture-strategist` - Architectural decisions and compliance
- `pattern-recognition-specialist` - Design pattern analysis
- `security-sentinel` - Security audits and vulnerability assessments
- `performance-oracle` - Performance analysis and optimization
- `data-integrity-guardian` - Database migrations and data integrity
*Research (4)*
- `framework-docs-researcher` - Framework documentation research
- `best-practices-researcher` - External best practices gathering
- `git-history-analyzer` - Git history and code evolution analysis
- `repo-research-analyst` - Repository structure and conventions
*Workflow (3)*
- `every-style-editor` - Every's style guide compliance
- `pr-comment-resolver` - PR comment resolution
- `feedback-codifier` - Feedback pattern codification
**6 Slash Commands**
- `/plan` - Create implementation plans
- `/review` - Comprehensive code reviews
- `/work` - Execute work items systematically
- `/triage` - Triage and prioritize issues
- `/resolve_todo_parallel` - Resolve TODOs in parallel
- `/generate_command` - Generate new slash commands
**Infrastructure**
- MIT license
- Plugin manifest (`plugin.json`)
- Pre-configured permissions for Rails development

149
plugins/compounding-engineering/README.md
View File

@@ -4,73 +4,142 @@ AI-powered development tools that get smarter with every use. Make each unit of
## Components
- **17 Agents** - Specialized AI agents for code review, research, and analysis
- **6 Commands** - Slash commands for common workflows
- **1 Skill** - Image generation with Gemini API
| Component | Count |
|-----------|-------|
| Agents | 24 |
| Commands | 15 |
| Skills | 11 |
## Agents
### Code Review
- **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
- **dhh-rails-reviewer** - Rails review from DHH's perspective
- **code-simplicity-reviewer** - Final pass for simplicity and minimalism
Agents are organized into categories for easier discovery.
### Analysis & Research
- **framework-docs-researcher** - Research framework documentation and best practices
- **best-practices-researcher** - Gather external best practices and examples
- **pattern-recognition-specialist** - Analyze code for patterns and anti-patterns
- **repo-research-analyst** - Research repository structure and conventions
- **git-history-analyzer** - Analyze git history and code evolution
### Review (10)
### Architecture & Security
- **architecture-strategist** - Analyze architectural decisions and compliance
- **security-sentinel** - Security audits and vulnerability assessments
- **performance-oracle** - Performance analysis and optimization
- **data-integrity-guardian** - Database migrations and data integrity
| 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 |
### Workflow
- **every-style-editor** - Edit content to conform to Every's style guide
- **pr-comment-resolver** - Address PR comments and implement fixes
- **feedback-codifier** - Codify feedback patterns into reviewer agents
### 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 (6)
| Agent | Description |
|-------|-------------|
| `bug-reproduction-validator` | Systematically reproduce and validate bug reports |
| `every-style-editor` | Edit content to conform to Every's style guide |
| `feedback-codifier` | Codify feedback patterns into reviewer agents |
| `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
- **/review** - Run a comprehensive code review
- **/plan** - Create an implementation plan
- **/work** - Execute work items systematically
- **/triage** - Triage issues and prioritize work
- **/resolve_todo_parallel** - Resolve todos in parallel
- **/generate_command** - Generate new slash commands
### Workflow Commands
Access via `/workflows:command`:
| Command | Description |
|---------|-------------|
| `/workflows:plan` | Create implementation plans |
| `/workflows:review` | Run comprehensive code reviews |
| `/workflows:work` | Execute work items systematically |
| `/workflows: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 |
| `/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
### gemini-imagegen
Generate and edit images using Google's Gemini API.
### Development Tools
**Features:**
| 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
- Multiple reference image composition (up to 14 images)
**Requirements:**
- `GEMINI_API_KEY` environment variable
- Python packages: `google-genai`, `pillow`
**Usage:**
```bash
python scripts/generate_image.py "A cat wearing a wizard hat" output.png
python scripts/edit_image.py input.png "Add a rainbow" output.png
```
## Installation
```bash
claude /plugin install compounding-engineering
```
## Version History
See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
## License
MIT