diff --git a/plugins/compounding-engineering/CHANGELOG.md b/plugins/compounding-engineering/CHANGELOG.md index 15563ef..e90ca87 100644 --- a/plugins/compounding-engineering/CHANGELOG.md +++ b/plugins/compounding-engineering/CHANGELOG.md @@ -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 diff --git a/plugins/compounding-engineering/README.md b/plugins/compounding-engineering/README.md index 91026f0..fb2445d 100644 --- a/plugins/compounding-engineering/README.md +++ b/plugins/compounding-engineering/README.md @@ -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