diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index c435b2f5..0457ba8a 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -24,7 +24,7 @@ }, { "name": "compound-engineering-core", - "description": "Core compounding engineering workflow. 17 agents, 14 commands, 8 skills for research, review, and workflow automation. Framework-agnostic foundation.", + "description": "Core compounding engineering workflow. 14 agents, 4 commands, 5 skills. The essential plan-review-work-compound cycle.", "version": "1.0.0", "author": { "name": "Kieran Klaassen", @@ -32,9 +32,35 @@ "email": "kieran@every.to" }, "homepage": "https://github.com/EveryInc/compound-engineering-plugin", - "tags": ["compound-engineering", "workflow-automation", "code-review", "research"], + "tags": ["compound-engineering", "code-review", "research"], "source": "./plugins/compound-engineering-core" }, + { + "name": "workflow-automation", + "description": "Automation helpers for resolving PRs, todos, bugs, and generating changelogs. 3 agents, 7 commands, 1 skill.", + "version": "1.0.0", + "author": { + "name": "Kieran Klaassen", + "url": "https://github.com/kieranklaassen", + "email": "kieran@every.to" + }, + "homepage": "https://github.com/EveryInc/compound-engineering-plugin", + "tags": ["automation", "workflow", "pr-review"], + "source": "./plugins/workflow-automation" + }, + { + "name": "plugin-dev", + "description": "Tools for developing Claude Code plugins. 3 commands, 2 skills for creating commands and skills.", + "version": "1.0.0", + "author": { + "name": "Kieran Klaassen", + "url": "https://github.com/kieranklaassen", + "email": "kieran@every.to" + }, + "homepage": "https://github.com/EveryInc/compound-engineering-plugin", + "tags": ["plugin-development", "meta"], + "source": "./plugins/plugin-dev" + }, { "name": "rails-dev", "description": "Ruby/Rails development with DHH/37signals style. 4 agents, 4 skills for opinionated Rails code review and style conventions.", diff --git a/plugins/compound-engineering-core/.claude-plugin/plugin.json b/plugins/compound-engineering-core/.claude-plugin/plugin.json index 3219c047..dd2f2efb 100644 --- a/plugins/compound-engineering-core/.claude-plugin/plugin.json +++ b/plugins/compound-engineering-core/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "compound-engineering-core", "version": "1.0.0", - "description": "Core compounding engineering workflow. 17 agents, 14 commands, 8 skills for research, review, and workflow automation. Framework-agnostic foundation.", + "description": "Core compounding engineering workflow. 14 agents, 4 commands, 5 skills. The essential plan-review-work-compound cycle.", "author": { "name": "Kieran Klaassen", "email": "kieran@every.to", diff --git a/plugins/compound-engineering-core/README.md b/plugins/compound-engineering-core/README.md index c5aca250..15d03c39 100644 --- a/plugins/compound-engineering-core/README.md +++ b/plugins/compound-engineering-core/README.md @@ -1,6 +1,6 @@ # compound-engineering-core -Core compounding engineering workflow. Framework-agnostic foundation for AI-powered development. +The essential workflow cycle: **plan → review → work → compound**. ## Installation @@ -8,67 +8,37 @@ Core compounding engineering workflow. Framework-agnostic foundation for AI-powe claude /plugin install compound-engineering-core ``` +> **Get the full experience:** Core provides the foundation, but the real power comes from combining plugins. See [Recommended Combinations](#recommended-combinations) below. + ## What's Included -### Commands (14) +### Commands (4) + +The core workflow cycle: -**Workflow Commands:** - `/workflows:plan` - Create implementation plans -- `/workflows:review` - Comprehensive code review -- `/workflows:work` - Execute work items -- `/workflows:compound` - Document solved problems +- `/workflows:review` - Comprehensive code review with 14 specialized agents +- `/workflows:work` - Execute plans systematically +- `/workflows:compound` - Document solutions for future reference -**Review Commands:** -- `/plan_review` - Review plans with multiple agents -- `/resolve_pr_parallel` - Resolve PR comments in parallel +### Agents (14) -**Automation Commands:** -- `/resolve_parallel` - Resolve TODOs in parallel -- `/resolve_todo_parallel` - Resolve CLI todos in parallel -- `/reproduce-bug` - Reproduce and validate bugs -- `/triage` - Triage findings -- `/changelog` - Generate changelogs +**Research agents** for understanding codebases: +- `repo-research-analyst`, `best-practices-researcher`, `framework-docs-researcher` +- `spec-flow-analyzer`, `git-history-analyzer` -**Plugin Development:** -- `/generate_command` - Create new commands -- `/heal-skill` - Fix broken skills -- `/create-agent-skill` - Create new skills +**Review agents** for code quality: +- `code-simplicity-reviewer`, `pattern-recognition-specialist`, `architecture-strategist` +- `performance-oracle`, `security-sentinel`, `data-integrity-guardian` +- `data-migration-expert`, `deployment-verification-agent`, `agent-native-reviewer` -### Agents (17) +### Skills (5) -**Research:** -- `repo-research-analyst` - Analyze repositories -- `best-practices-researcher` - Research best practices -- `framework-docs-researcher` - Research framework docs -- `spec-flow-analyzer` - Analyze specifications -- `git-history-analyzer` - Analyze git history - -**Review:** -- `code-simplicity-reviewer` - Review for simplicity -- `pattern-recognition-specialist` - Identify patterns -- `architecture-strategist` - Review architecture -- `performance-oracle` - Review performance -- `security-sentinel` - Security review -- `data-integrity-guardian` - Data integrity review -- `data-migration-expert` - Migration review -- `deployment-verification-agent` - Deployment verification -- `agent-native-reviewer` - Agent accessibility review - -**Workflow:** -- `bug-reproduction-validator` - Validate bug reports -- `pr-comment-resolver` - Resolve PR comments -- `every-style-editor` - Style editing - -### Skills (8) - -- `compound-docs` - Document solutions +- `compound-docs` - Document solutions with YAML frontmatter - `file-todos` - File-based todo tracking - `git-worktree` - Git worktree management -- `skill-creator` - Create new skills -- `create-agent-skills` - Agent skill creation -- `gemini-imagegen` - Gemini image generation -- `agent-native-architecture` - Agent-native patterns -- `every-style-editor` - Every style guide +- `gemini-imagegen` - Image generation with Gemini +- `agent-native-architecture` - Build agent-native features ### MCP Servers @@ -76,8 +46,6 @@ claude /plugin install compound-engineering-core ## Usage -After installing, use the workflow commands: - ```bash # Plan a feature claude /workflows:plan "Add user authentication" @@ -88,15 +56,50 @@ claude /workflows:review 123 # Execute a plan claude /workflows:work plans/my-plan.md -# Document a solution +# Document what you learned claude /workflows:compound ``` +## Recommended Combinations + +Core is just the beginning. Install additional plugins based on your stack: + +### For Rails Developers +```bash +claude /plugin install compound-engineering-core rails-dev workflow-automation +``` +Adds DHH/37signals style guides, Rails-specific reviewers, and automation helpers. + +### For Full-Stack (Rails + TypeScript) +```bash +claude /plugin install compound-engineering-core rails-dev typescript-dev frontend-design workflow-automation +``` +Complete coverage for Rails backends with TypeScript frontends and design tools. + +### For Python Developers +```bash +claude /plugin install compound-engineering-core python-dev workflow-automation +``` + +### For Plugin Developers +```bash +claude /plugin install compound-engineering-core plugin-dev +``` +Add tools for creating your own commands and skills. + +### Everything (Meta-Package) +```bash +claude /plugin install compound-engineering +``` +Installs all plugins at once. + ## Related Plugins -For framework-specific tools, install additional plugins: - -- `rails-dev` - Ruby/Rails style and review -- `python-dev` - Python review -- `typescript-dev` - TypeScript/JS review -- `frontend-design` - Design tools with Playwright +| Plugin | What it adds | +|--------|--------------| +| `rails-dev` | DHH/37signals style, Rails reviewers | +| `python-dev` | Python code review | +| `typescript-dev` | TypeScript/JS review, race condition detection | +| `frontend-design` | Figma sync, design iteration, Playwright | +| `workflow-automation` | PR resolution, batch operations, changelog | +| `plugin-dev` | Create your own commands and skills | diff --git a/plugins/frontend-design/README.md b/plugins/frontend-design/README.md index f27a6aab..731f5de8 100644 --- a/plugins/frontend-design/README.md +++ b/plugins/frontend-design/README.md @@ -5,11 +5,11 @@ Design implementation, iteration, and Figma sync. ## Installation ```bash -# Requires core plugin -claude /plugin install compound-engineering-core +# Install with core (recommended) +claude /plugin install compound-engineering-core frontend-design -# Install design tools -claude /plugin install frontend-design +# Full frontend stack +claude /plugin install compound-engineering-core typescript-dev frontend-design workflow-automation ``` ## What's Included @@ -60,3 +60,11 @@ claude "Review if this implementation matches the Figma design" - Node.js (for Playwright MCP) - Playwright is installed automatically via `npx` + +## Works Best With + +| Plugin | Why | +|--------|-----| +| `compound-engineering-core` | Base workflow | +| `typescript-dev` | TypeScript/JS review for frontend code | +| `workflow-automation` | Batch operations | diff --git a/plugins/plugin-dev/.claude-plugin/plugin.json b/plugins/plugin-dev/.claude-plugin/plugin.json new file mode 100644 index 00000000..3aba0cda --- /dev/null +++ b/plugins/plugin-dev/.claude-plugin/plugin.json @@ -0,0 +1,19 @@ +{ + "name": "plugin-dev", + "version": "1.0.0", + "description": "Tools for developing Claude Code plugins. 3 commands, 2 skills for creating commands and skills.", + "author": { + "name": "Kieran Klaassen", + "email": "kieran@every.to", + "url": "https://github.com/kieranklaassen" + }, + "homepage": "https://github.com/EveryInc/compound-engineering-plugin", + "repository": "https://github.com/EveryInc/compound-engineering-plugin", + "license": "MIT", + "keywords": [ + "plugin-development", + "commands", + "skills", + "meta" + ] +} diff --git a/plugins/plugin-dev/README.md b/plugins/plugin-dev/README.md new file mode 100644 index 00000000..1bf430c0 --- /dev/null +++ b/plugins/plugin-dev/README.md @@ -0,0 +1,42 @@ +# plugin-dev + +Tools for developing Claude Code plugins, commands, and skills. + +## Installation + +```bash +# Install with core (recommended) +claude /plugin install compound-engineering-core plugin-dev +``` + +## What's Included + +### Commands (3) + +- `/generate_command` - Create new slash commands +- `/heal-skill` - Fix broken or outdated skills +- `/create-agent-skill` - Create new skills with guidance + +### Skills (2) + +- `skill-creator` - Comprehensive skill creation guide +- `create-agent-skills` - Agent-assisted skill creation + +## Usage + +```bash +# Create a new command +claude /generate_command "deploy to staging" + +# Fix a broken skill +claude /heal-skill my-skill + +# Create a new skill with expert guidance +claude /create-agent-skill "Rails testing patterns" +``` + +## Works Best With + +| Plugin | Why | +|--------|-----| +| `compound-engineering-core` | Base workflow for planning and documenting | diff --git a/plugins/compound-engineering-core/commands/create-agent-skill.md b/plugins/plugin-dev/commands/create-agent-skill.md similarity index 100% rename from plugins/compound-engineering-core/commands/create-agent-skill.md rename to plugins/plugin-dev/commands/create-agent-skill.md diff --git a/plugins/compound-engineering-core/commands/generate_command.md b/plugins/plugin-dev/commands/generate_command.md similarity index 100% rename from plugins/compound-engineering-core/commands/generate_command.md rename to plugins/plugin-dev/commands/generate_command.md diff --git a/plugins/compound-engineering-core/commands/heal-skill.md b/plugins/plugin-dev/commands/heal-skill.md similarity index 100% rename from plugins/compound-engineering-core/commands/heal-skill.md rename to plugins/plugin-dev/commands/heal-skill.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/SKILL.md b/plugins/plugin-dev/skills/create-agent-skills/SKILL.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/SKILL.md rename to plugins/plugin-dev/skills/create-agent-skills/SKILL.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/api-security.md b/plugins/plugin-dev/skills/create-agent-skills/references/api-security.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/api-security.md rename to plugins/plugin-dev/skills/create-agent-skills/references/api-security.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/be-clear-and-direct.md b/plugins/plugin-dev/skills/create-agent-skills/references/be-clear-and-direct.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/be-clear-and-direct.md rename to plugins/plugin-dev/skills/create-agent-skills/references/be-clear-and-direct.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/common-patterns.md b/plugins/plugin-dev/skills/create-agent-skills/references/common-patterns.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/common-patterns.md rename to plugins/plugin-dev/skills/create-agent-skills/references/common-patterns.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/core-principles.md b/plugins/plugin-dev/skills/create-agent-skills/references/core-principles.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/core-principles.md rename to plugins/plugin-dev/skills/create-agent-skills/references/core-principles.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/executable-code.md b/plugins/plugin-dev/skills/create-agent-skills/references/executable-code.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/executable-code.md rename to plugins/plugin-dev/skills/create-agent-skills/references/executable-code.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/iteration-and-testing.md b/plugins/plugin-dev/skills/create-agent-skills/references/iteration-and-testing.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/iteration-and-testing.md rename to plugins/plugin-dev/skills/create-agent-skills/references/iteration-and-testing.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/recommended-structure.md b/plugins/plugin-dev/skills/create-agent-skills/references/recommended-structure.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/recommended-structure.md rename to plugins/plugin-dev/skills/create-agent-skills/references/recommended-structure.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/skill-structure.md b/plugins/plugin-dev/skills/create-agent-skills/references/skill-structure.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/skill-structure.md rename to plugins/plugin-dev/skills/create-agent-skills/references/skill-structure.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/use-xml-tags.md b/plugins/plugin-dev/skills/create-agent-skills/references/use-xml-tags.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/use-xml-tags.md rename to plugins/plugin-dev/skills/create-agent-skills/references/use-xml-tags.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/using-scripts.md b/plugins/plugin-dev/skills/create-agent-skills/references/using-scripts.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/using-scripts.md rename to plugins/plugin-dev/skills/create-agent-skills/references/using-scripts.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/using-templates.md b/plugins/plugin-dev/skills/create-agent-skills/references/using-templates.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/using-templates.md rename to plugins/plugin-dev/skills/create-agent-skills/references/using-templates.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/references/workflows-and-validation.md b/plugins/plugin-dev/skills/create-agent-skills/references/workflows-and-validation.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/references/workflows-and-validation.md rename to plugins/plugin-dev/skills/create-agent-skills/references/workflows-and-validation.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/templates/router-skill.md b/plugins/plugin-dev/skills/create-agent-skills/templates/router-skill.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/templates/router-skill.md rename to plugins/plugin-dev/skills/create-agent-skills/templates/router-skill.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/templates/simple-skill.md b/plugins/plugin-dev/skills/create-agent-skills/templates/simple-skill.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/templates/simple-skill.md rename to plugins/plugin-dev/skills/create-agent-skills/templates/simple-skill.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/workflows/add-reference.md b/plugins/plugin-dev/skills/create-agent-skills/workflows/add-reference.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/workflows/add-reference.md rename to plugins/plugin-dev/skills/create-agent-skills/workflows/add-reference.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/workflows/add-script.md b/plugins/plugin-dev/skills/create-agent-skills/workflows/add-script.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/workflows/add-script.md rename to plugins/plugin-dev/skills/create-agent-skills/workflows/add-script.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/workflows/add-template.md b/plugins/plugin-dev/skills/create-agent-skills/workflows/add-template.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/workflows/add-template.md rename to plugins/plugin-dev/skills/create-agent-skills/workflows/add-template.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/workflows/add-workflow.md b/plugins/plugin-dev/skills/create-agent-skills/workflows/add-workflow.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/workflows/add-workflow.md rename to plugins/plugin-dev/skills/create-agent-skills/workflows/add-workflow.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/workflows/audit-skill.md b/plugins/plugin-dev/skills/create-agent-skills/workflows/audit-skill.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/workflows/audit-skill.md rename to plugins/plugin-dev/skills/create-agent-skills/workflows/audit-skill.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/workflows/create-domain-expertise-skill.md b/plugins/plugin-dev/skills/create-agent-skills/workflows/create-domain-expertise-skill.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/workflows/create-domain-expertise-skill.md rename to plugins/plugin-dev/skills/create-agent-skills/workflows/create-domain-expertise-skill.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/workflows/create-new-skill.md b/plugins/plugin-dev/skills/create-agent-skills/workflows/create-new-skill.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/workflows/create-new-skill.md rename to plugins/plugin-dev/skills/create-agent-skills/workflows/create-new-skill.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/workflows/get-guidance.md b/plugins/plugin-dev/skills/create-agent-skills/workflows/get-guidance.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/workflows/get-guidance.md rename to plugins/plugin-dev/skills/create-agent-skills/workflows/get-guidance.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/workflows/upgrade-to-router.md b/plugins/plugin-dev/skills/create-agent-skills/workflows/upgrade-to-router.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/workflows/upgrade-to-router.md rename to plugins/plugin-dev/skills/create-agent-skills/workflows/upgrade-to-router.md diff --git a/plugins/compound-engineering-core/skills/create-agent-skills/workflows/verify-skill.md b/plugins/plugin-dev/skills/create-agent-skills/workflows/verify-skill.md similarity index 100% rename from plugins/compound-engineering-core/skills/create-agent-skills/workflows/verify-skill.md rename to plugins/plugin-dev/skills/create-agent-skills/workflows/verify-skill.md diff --git a/plugins/compound-engineering-core/skills/skill-creator/SKILL.md b/plugins/plugin-dev/skills/skill-creator/SKILL.md similarity index 100% rename from plugins/compound-engineering-core/skills/skill-creator/SKILL.md rename to plugins/plugin-dev/skills/skill-creator/SKILL.md diff --git a/plugins/compound-engineering-core/skills/skill-creator/scripts/init_skill.py b/plugins/plugin-dev/skills/skill-creator/scripts/init_skill.py similarity index 100% rename from plugins/compound-engineering-core/skills/skill-creator/scripts/init_skill.py rename to plugins/plugin-dev/skills/skill-creator/scripts/init_skill.py diff --git a/plugins/compound-engineering-core/skills/skill-creator/scripts/package_skill.py b/plugins/plugin-dev/skills/skill-creator/scripts/package_skill.py similarity index 100% rename from plugins/compound-engineering-core/skills/skill-creator/scripts/package_skill.py rename to plugins/plugin-dev/skills/skill-creator/scripts/package_skill.py diff --git a/plugins/compound-engineering-core/skills/skill-creator/scripts/quick_validate.py b/plugins/plugin-dev/skills/skill-creator/scripts/quick_validate.py similarity index 100% rename from plugins/compound-engineering-core/skills/skill-creator/scripts/quick_validate.py rename to plugins/plugin-dev/skills/skill-creator/scripts/quick_validate.py diff --git a/plugins/python-dev/README.md b/plugins/python-dev/README.md index e4ef86ee..4465eb67 100644 --- a/plugins/python-dev/README.md +++ b/plugins/python-dev/README.md @@ -5,11 +5,11 @@ Python development and code review. ## Installation ```bash -# Requires core plugin -claude /plugin install compound-engineering-core +# Install with core (recommended) +claude /plugin install compound-engineering-core python-dev -# Install Python tools -claude /plugin install python-dev +# Add automation for the full experience +claude /plugin install compound-engineering-core python-dev workflow-automation ``` ## What's Included @@ -20,7 +20,7 @@ claude /plugin install python-dev ## Usage -The Python reviewer is automatically used by `/workflows:review` when reviewing Python code: +The Python reviewer integrates with `/workflows:review` from core: ```bash claude /workflows:review 123 @@ -34,3 +34,10 @@ This plugin is small but growing. Planned additions: - FastAPI/Django patterns - Type hint reviewer - Testing patterns + +## Works Best With + +| Plugin | Why | +|--------|-----| +| `compound-engineering-core` | Required for `/workflows:review` | +| `workflow-automation` | Batch PR resolution | diff --git a/plugins/rails-dev/README.md b/plugins/rails-dev/README.md index f807d0dd..358aad2c 100644 --- a/plugins/rails-dev/README.md +++ b/plugins/rails-dev/README.md @@ -5,11 +5,11 @@ Ruby/Rails development with DHH/37signals style conventions. ## Installation ```bash -# Requires core plugin -claude /plugin install compound-engineering-core +# Install with core (recommended) +claude /plugin install compound-engineering-core rails-dev -# Install Rails tools -claude /plugin install rails-dev +# Add automation helpers for the full experience +claude /plugin install compound-engineering-core rails-dev workflow-automation ``` ## What's Included @@ -30,16 +30,13 @@ claude /plugin install rails-dev ## Usage -### Code Review - -The Rails reviewers are automatically used by `/workflows:review` when reviewing Rails code: +The Rails reviewers integrate with `/workflows:review` from core: ```bash +# Review a Rails PR with DHH-style feedback claude /workflows:review 123 ``` -### Style Skills - Invoke skills directly for style guidance: ```bash @@ -60,3 +57,11 @@ This plugin embodies the 37signals approach: - **Records as state** - Not boolean columns - **Database-backed** - No Redis, use Solid Queue/Cache/Cable - **Build before gem** - Understand your code + +## Works Best With + +| Plugin | Why | +|--------|-----| +| `compound-engineering-core` | Required for `/workflows:review` | +| `workflow-automation` | Batch PR resolution, changelog generation | +| `frontend-design` | If doing Rails + Hotwire frontends | diff --git a/plugins/typescript-dev/README.md b/plugins/typescript-dev/README.md index 5a3e55d5..220f3c77 100644 --- a/plugins/typescript-dev/README.md +++ b/plugins/typescript-dev/README.md @@ -5,11 +5,11 @@ TypeScript/JavaScript development and code review. ## Installation ```bash -# Requires core plugin -claude /plugin install compound-engineering-core +# Install with core (recommended) +claude /plugin install compound-engineering-core typescript-dev -# Install TypeScript tools -claude /plugin install typescript-dev +# Add design tools for frontend work +claude /plugin install compound-engineering-core typescript-dev frontend-design workflow-automation ``` ## What's Included @@ -21,7 +21,7 @@ claude /plugin install typescript-dev ## Usage -The TypeScript reviewers are automatically used by `/workflows:review` when reviewing TypeScript/JavaScript code: +The TypeScript reviewers integrate with `/workflows:review` from core: ```bash claude /workflows:review 123 @@ -35,3 +35,11 @@ The `julik-frontend-races-reviewer` specifically looks for: - Race conditions in async operations - Event handler timing issues - State update races + +## Works Best With + +| Plugin | Why | +|--------|-----| +| `compound-engineering-core` | Required for `/workflows:review` | +| `frontend-design` | Design iteration with Playwright | +| `workflow-automation` | Batch PR resolution | diff --git a/plugins/workflow-automation/.claude-plugin/plugin.json b/plugins/workflow-automation/.claude-plugin/plugin.json new file mode 100644 index 00000000..effa20cf --- /dev/null +++ b/plugins/workflow-automation/.claude-plugin/plugin.json @@ -0,0 +1,19 @@ +{ + "name": "workflow-automation", + "version": "1.0.0", + "description": "Automation helpers for resolving PRs, todos, bugs, and generating changelogs. 3 agents, 7 commands, 1 skill.", + "author": { + "name": "Kieran Klaassen", + "email": "kieran@every.to", + "url": "https://github.com/kieranklaassen" + }, + "homepage": "https://github.com/EveryInc/compound-engineering-plugin", + "repository": "https://github.com/EveryInc/compound-engineering-plugin", + "license": "MIT", + "keywords": [ + "automation", + "workflow", + "pr-review", + "todo" + ] +} diff --git a/plugins/workflow-automation/README.md b/plugins/workflow-automation/README.md new file mode 100644 index 00000000..6bec5759 --- /dev/null +++ b/plugins/workflow-automation/README.md @@ -0,0 +1,55 @@ +# workflow-automation + +Automation helpers for batch operations, PR resolution, and utility tasks. + +## Installation + +```bash +# Install with core (recommended) +claude /plugin install compound-engineering-core workflow-automation +``` + +## What's Included + +### Commands (7) + +- `/resolve_pr_parallel` - Resolve PR comments in parallel +- `/plan_review` - Review plans with multiple agents +- `/resolve_parallel` - Resolve TODOs in parallel +- `/resolve_todo_parallel` - Resolve CLI todos in parallel +- `/reproduce-bug` - Reproduce and validate bugs +- `/triage` - Triage findings by severity +- `/changelog` - Generate changelogs from commits + +### Agents (3) + +- `bug-reproduction-validator` - Validate bug reports +- `pr-comment-resolver` - Resolve PR comments +- `every-style-editor` - Style editing + +### Skills (1) + +- `every-style-editor` - Every style guide for writing + +## Usage + +```bash +# After /workflows:review finds issues, resolve them in parallel +claude /resolve_pr_parallel 123 + +# Review a plan with multiple specialized agents +claude /plan_review plans/my-feature.md + +# Generate a weekly changelog +claude /changelog weekly + +# Triage findings by severity +claude /triage +``` + +## Works Best With + +| Plugin | Why | +|--------|-----| +| `compound-engineering-core` | Required - provides the base workflow | +| `rails-dev` / `python-dev` / `typescript-dev` | Framework-specific reviewers | diff --git a/plugins/compound-engineering-core/agents/workflow/bug-reproduction-validator.md b/plugins/workflow-automation/agents/bug-reproduction-validator.md similarity index 100% rename from plugins/compound-engineering-core/agents/workflow/bug-reproduction-validator.md rename to plugins/workflow-automation/agents/bug-reproduction-validator.md diff --git a/plugins/compound-engineering-core/agents/workflow/every-style-editor.md b/plugins/workflow-automation/agents/every-style-editor.md similarity index 100% rename from plugins/compound-engineering-core/agents/workflow/every-style-editor.md rename to plugins/workflow-automation/agents/every-style-editor.md diff --git a/plugins/compound-engineering-core/agents/workflow/pr-comment-resolver.md b/plugins/workflow-automation/agents/pr-comment-resolver.md similarity index 100% rename from plugins/compound-engineering-core/agents/workflow/pr-comment-resolver.md rename to plugins/workflow-automation/agents/pr-comment-resolver.md diff --git a/plugins/compound-engineering-core/commands/changelog.md b/plugins/workflow-automation/commands/changelog.md similarity index 100% rename from plugins/compound-engineering-core/commands/changelog.md rename to plugins/workflow-automation/commands/changelog.md diff --git a/plugins/compound-engineering-core/commands/plan_review.md b/plugins/workflow-automation/commands/plan_review.md similarity index 100% rename from plugins/compound-engineering-core/commands/plan_review.md rename to plugins/workflow-automation/commands/plan_review.md diff --git a/plugins/compound-engineering-core/commands/reproduce-bug.md b/plugins/workflow-automation/commands/reproduce-bug.md similarity index 100% rename from plugins/compound-engineering-core/commands/reproduce-bug.md rename to plugins/workflow-automation/commands/reproduce-bug.md diff --git a/plugins/compound-engineering-core/commands/resolve_parallel.md b/plugins/workflow-automation/commands/resolve_parallel.md similarity index 100% rename from plugins/compound-engineering-core/commands/resolve_parallel.md rename to plugins/workflow-automation/commands/resolve_parallel.md diff --git a/plugins/compound-engineering-core/commands/resolve_pr_parallel.md b/plugins/workflow-automation/commands/resolve_pr_parallel.md similarity index 100% rename from plugins/compound-engineering-core/commands/resolve_pr_parallel.md rename to plugins/workflow-automation/commands/resolve_pr_parallel.md diff --git a/plugins/compound-engineering-core/commands/resolve_todo_parallel.md b/plugins/workflow-automation/commands/resolve_todo_parallel.md similarity index 100% rename from plugins/compound-engineering-core/commands/resolve_todo_parallel.md rename to plugins/workflow-automation/commands/resolve_todo_parallel.md diff --git a/plugins/compound-engineering-core/commands/triage.md b/plugins/workflow-automation/commands/triage.md similarity index 100% rename from plugins/compound-engineering-core/commands/triage.md rename to plugins/workflow-automation/commands/triage.md diff --git a/plugins/compound-engineering-core/skills/every-style-editor/SKILL.md b/plugins/workflow-automation/every-style-editor/SKILL.md similarity index 100% rename from plugins/compound-engineering-core/skills/every-style-editor/SKILL.md rename to plugins/workflow-automation/every-style-editor/SKILL.md diff --git a/plugins/compound-engineering-core/skills/every-style-editor/references/EVERY_WRITE_STYLE.md b/plugins/workflow-automation/every-style-editor/references/EVERY_WRITE_STYLE.md similarity index 100% rename from plugins/compound-engineering-core/skills/every-style-editor/references/EVERY_WRITE_STYLE.md rename to plugins/workflow-automation/every-style-editor/references/EVERY_WRITE_STYLE.md