feat(commands): add /compound-engineering-setup for configurable agents

.claude-plugin/marketplace.json

@@ -11,8 +11,8 @@
   "plugins": [
     {
       "name": "compound-engineering",
-      "description": "AI-powered development tools that get smarter with every use. Make each unit of engineering work easier than the last. Includes 28 specialized agents, 24 commands, and 15 skills.",
-      "version": "2.28.0",
+      "description": "AI-powered development tools that get smarter with every use. Make each unit of engineering work easier than the last. Includes 28 specialized agents, 25 commands, and 15 skills.",
+      "version": "2.29.0",
       "author": {
         "name": "Kieran Klaassen",
         "url": "https://github.com/kieranklaassen",

plugins/compound-engineering/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "compound-engineering",
-  "version": "2.28.0",
-  "description": "AI-powered development tools. 28 agents, 24 commands, 15 skills, 1 MCP server for code review, research, design, and workflow automation.",
+  "version": "2.29.0",
+  "description": "AI-powered development tools. 28 agents, 25 commands, 15 skills, 1 MCP server for code review, research, design, and workflow automation.",
   "author": {
     "name": "Kieran Klaassen",
     "email": "kieran@every.to",

plugins/compound-engineering/CHANGELOG.md

@@ -5,6 +5,50 @@ All notable changes to the compound-engineering plugin will be documented in thi
 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.29.0] - 2026-01-25
+
+### Added
+
+- **`/compound-engineering-setup` command** - Configure plugin agents and preferences
+  - Multi-step onboarding with AskUserQuestion for easy setup
+  - Auto-detects project type (Rails, Python, TypeScript, etc.)
+  - Three setup modes: Quick (smart defaults), Advanced (manual selection), Minimal
+  - Creates `.claude/compound-engineering.json` config file
+  - Supports global config (`~/.claude/`) or project-specific (`.claude/`)
+  - **Custom agent discovery**: Auto-detects agents in `.claude/agents/` and `~/.claude/agents/`
+  - **Modify flow**: Re-run setup to add/remove agents from existing config
+  - **Custom agent guide**: Instructions for creating your own review agents
+
+### Changed
+
+- **`/workflows:review`** - Now reads review agents from config file instead of hardcoding
+- **`/plan_review`** - Now reads plan review agents from config file
+- **`/workflows:work`** - References config for optional reviewer agents
+- **`/workflows:compound`** - References config for specialized agent invocation
+
+### Configuration
+
+New config file format (`.claude/compound-engineering.json`):
+```json
+{
+  "version": "1.0",
+  "projectType": "rails",
+  "reviewAgents": ["kieran-rails-reviewer", "code-simplicity-reviewer", "my-custom-reviewer"],
+  "planReviewAgents": ["kieran-rails-reviewer", "code-simplicity-reviewer"],
+  "customAgents": {
+    "my-custom-reviewer": ".claude/agents/my-custom-reviewer.md"
+  },
+  "conditionalAgents": {
+    "migrations": ["data-migration-expert", "deployment-verification-agent"],
+    "frontend": ["julik-frontend-races-reviewer"],
+    "architecture": ["architecture-strategist"],
+    "data": ["data-integrity-guardian"]
+  }
+}
+```
+
+---
+
 ## [2.28.0] - 2026-01-21
 
 ### Added

plugins/compound-engineering/README.md

@@ -6,9 +6,9 @@ AI-powered development tools that get smarter with every use. Make each unit of
 
 | Component | Count |
 |-----------|-------|
-| Agents | 27 |
-| Commands | 20 |
-| Skills | 14 |
+| Agents | 28 |
+| Commands | 25 |
+| Skills | 15 |
 | MCP Servers | 1 |
 
 ## Agents
@@ -90,6 +90,7 @@ Core workflow commands use `workflows:` prefix to avoid collisions with built-in
 | `/create-agent-skill` | Create or edit Claude Code skills |
 | `/generate_command` | Generate new slash commands |
 | `/heal-skill` | Fix skill documentation issues |
+| `/compound-engineering-setup` | Configure plugin agents and preferences |
 | `/plan_review` | Multi-agent plan review in parallel |
 | `/report-bug` | Report a bug in the plugin |
 | `/reproduce-bug` | Reproduce bugs using logs and console |

plugins/compound-engineering/commands/plan_review.md

@@ -4,4 +4,78 @@ description: Have multiple specialized agents review a plan in parallel
 argument-hint: "[plan file path or plan content]"
 ---
 
-Have @agent-dhh-rails-reviewer @agent-kieran-rails-reviewer @agent-code-simplicity-reviewer review this plan in parallel.
+# Plan Review
+
+Review a plan using configured agents from `.claude/compound-engineering.json`.
+
+## Load Configuration (Auto-Setup if Missing)
+
+<config_loading>
+
+**Step 1: Check for configuration file:**
+
+```bash
+test -f .claude/compound-engineering.json && echo "project" || \
+test -f ~/.claude/compound-engineering.json && echo "global" || echo "none"
+```
+
+**Step 2: If config exists** → Read `planReviewAgents` array and proceed.
+
+**Step 3: If NO config exists** → Run inline quick setup:
+
+```
+AskUserQuestion:
+  questions:
+    - question: "No agent configuration found. How would you like to configure plan review agents?"
+      header: "Quick Setup"
+      options:
+        - label: "Quick Setup - Use smart defaults (Recommended)"
+          description: "Auto-detect project type and use appropriate agents."
+        - label: "Full Setup - Customize everything"
+          description: "Run /compound-engineering-setup for detailed configuration."
+        - label: "Skip - Use defaults just this once"
+          description: "Use general defaults for this review only."
+```
+
+**If "Quick Setup":**
+1. Detect project type
+2. Create `.claude/compound-engineering.json` with smart defaults
+3. Continue with plan review using new config
+
+**If "Full Setup":**
+1. Run `/compound-engineering-setup`
+2. After setup, continue with plan review
+
+**If "Skip":**
+1. Use defaults: `code-simplicity-reviewer`, `architecture-strategist`
+
+</config_loading>
+
+## Execute Review
+
+For each agent in `planReviewAgents`:
+
+```
+Task {agent-name}("Review this plan: {plan content}")
+```
+
+Run all agents in parallel using multiple Task tool calls in a single message.
+
+## Example Config
+
+```json
+{
+  "planReviewAgents": [
+    "kieran-rails-reviewer",
+    "code-simplicity-reviewer"
+  ]
+}
+```
+
+## Fallback Defaults
+
+If no config and user wants defaults:
+- **Rails projects**: `kieran-rails-reviewer`, `code-simplicity-reviewer`
+- **Python projects**: `kieran-python-reviewer`, `code-simplicity-reviewer`
+- **TypeScript projects**: `kieran-typescript-reviewer`, `code-simplicity-reviewer`
+- **General**: `code-simplicity-reviewer`, `architecture-strategist`