- Move plans from `plans/` to `docs/plans/` for consistency with other artifacts
- Add date prefix (YYYY-MM-DD) to both plans and brainstorms for chronological sorting
- Add self-documenting suffixes: `-plan` and `-brainstorm` to identify artifact type
- Update filename derivation to extract title from content, not filename
- Clarify deepened plan naming: append `-deepened` after `-plan` suffix
New conventions:
- Brainstorms: `docs/brainstorms/YYYY-MM-DD-<topic>-brainstorm.md`
- Plans: `docs/plans/YYYY-MM-DD-<type>-<name>-plan.md`
- Deepened: `docs/plans/YYYY-MM-DD-<type>-<name>-plan-deepened.md`
* feat(workflows:plan): Add smart research decision logic
Previously, /workflows:plan always ran all 3 research agents (repo-research,
best-practices, framework-docs) regardless of task complexity. This wasted
tokens and time for simple tasks like UI tweaks or bug fixes with clear causes.
Now the workflow:
- Always runs repo research first (fast, local)
- Makes an informed decision about external research based on:
- Signals gathered during idea refinement (familiarity, intent, risk)
- Repo research findings (existing patterns, CLAUDE.md guidance)
- High-risk topics (security, payments, external APIs) always trigger research
- Strong local context allows skipping external research
- Announces the decision and proceeds, user can redirect if needed
This makes the planning workflow smarter about when web research adds value.
* feat: Add /workflows:brainstorm command and skill
Add brainstorming workflow to explore requirements and approaches
before planning implementation:
- New `/workflows:brainstorm` command for collaborative dialogue
- New `brainstorming` skill with process knowledge and techniques
- Update `/workflows:plan` to detect brainstorm output and skip
idea refinement when relevant brainstorm exists
- Add brainstorm to README workflow commands table
The brainstorm → plan flow enables:
- Phase 0: Assess requirement clarity
- Phase 1: Understand the idea via repo research + dialogue
- Phase 2: Explore 2-3 approaches with trade-offs
- Phase 3: Capture design to docs/brainstorms/
- Phase 4: Handoff to /workflows:plan
Add two new phases to improve plan quality through user collaboration:
- Phase 0: Idea Refinement - Refines feature ideas through dialogue
before running research agents. Asks questions one at a time,
prefers multiple choice, focuses on purpose/constraints/success
criteria. Skip option for detailed descriptions.
- Research Validation - After research completes, summarizes findings
and validates alignment before drafting the full plan.
Both phases are optional and can be skipped, ensuring the workflow
remains lightweight while catching misunderstandings early.
- Add branch detection at start of Setup Environment step
- Support continuing on existing feature branch or creating new
- Require explicit confirmation to commit to default branch
- Add incremental commit guidance with decision criteria table
- Include heuristic: "Can I write a meaningful commit message?"
- Generalize test commands to be framework-agnostic
- Renamed every-marketplace to compound-marketplace
- Updated all EveryInc references to kieranklaassen
- Updated owner info in marketplace.json
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added step to update original plan document with completed checkboxes
([ ] → [x]) after each task is finished. Keeps the plan as a living
document showing progress.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Updated PR template to include badge at bottom linking to plugin repo
- Added badge requirement to quality checklist
- Badge provides attribution and link to the plugin
Co-Authored-By: Claude <noreply@anthropic.com>
- Remove Playwright MCP server from plugin
- Add new agent-browser skill for CLI-based browser automation
- Rename /playwright-test to /test-browser command
- Update all commands and agents to use agent-browser CLI
- Update README and plugin.json
agent-browser is Vercel's headless browser CLI designed for AI agents.
It uses ref-based selection (@e1, @e2) from accessibility snapshots
and provides a simpler CLI interface compared to MCP tools.
Key benefits:
- No MCP server required
- Simpler Bash-based workflow
- Same ref-based element selection
- Better for quick automation tasks
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
The /workflows:plan skill was producing inconsistent plan filenames
(sometimes gibberish, sometimes descriptive) because it lacked explicit
rules for converting issue titles to filenames.
Changes:
- Step 2: Added instruction to convert title to kebab-case filename
with example transformation (feat: Add User Auth → feat-add-user-auth.md)
- Output Format: Replaced vague <issue_title> placeholder with clear
pattern and good/bad examples
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
- Add /deepen-plan command that enhances plans with parallel research agents
- Each plan section gets its own sub-agent for best practices, performance, UI research
- Update /workflows:plan to offer /deepen-plan as option 2 after plan creation
- Auto-run /deepen-plan when using ultrathink mode for maximum depth
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- New `/playwright-test` command for end-to-end browser tests on PR-affected pages
- Uses Playwright MCP to navigate, snapshot, check console errors
- Supports human-in-the-loop for OAuth/email/payment flows
- Creates P1 todos for failures and retries until passing
- Added Section 7 to `/workflows:review` - optional Playwright testing as subagent
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
New review agents for validating database migrations and risky data deployments:
- data-migration-expert: Validates ID mappings match production reality, checks
for swapped values, verifies rollback safety, provides SQL verification snippets
- deployment-verification-agent: Produces Go/No-Go deployment checklists with
pre/post-deploy SQL queries, data invariants, rollback procedures, monitoring
Updated /workflows:review to conditionally run these agents when PRs contain
database migrations (db/migrate/*.rb), data backfills, or ID/enum mappings.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Fixes#42
Workflow commands now use `workflows:` prefix to avoid collisions with
Claude Code's built-in commands:
- `/workflows:plan` (was `/plan`)
- `/workflows:review` (was `/review`)
- `/workflows:work` (was `/work`)
- `/workflows:compound` (was `/compound`)
To upgrade: Update to latest plugin version. If you see duplicate `/plan`
commands, the new namespaced commands avoid this collision.
Also fixed in this release:
- Added missing `name:` field to heal-skill.md and create-agent-skill.md
- Rewrote corrupted prime.md
- Shortened Playwright MCP alias from `playwright` to `pw`
- Removed deprecated codify.md
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add agent-native-reviewer agent to verify features are agent-accessible
- Add agent-native-architecture skill for prompt-native design patterns
- Add agent-native-reviewer to /review command parallel agents
- Move agent-native skill to correct plugin folder
- Update component counts (25 agents, 12 skills)
- Include mermaid dark mode fix from PR #45🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Made capturing screenshots REQUIRED for any UI changes
- Updated to use imgup skill with pixhost as default host
- Clarified what to capture: new screens, before/after, Figma matches
- Removed outdated curl/0x0.st reference
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added "Open plan in editor" as the first option in post-generation menu
- Opens plan file in user's default editor for review before next steps
- Reordered options: open → review → work → work remote → create issue → simplify
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added step to capture before/after screenshots for UI changes
- Use Playwright MCP tools for screenshots
- Upload via 0x0.st (imgup skill)
- Updated PR template with before/after table format
- Updated quality checklist
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Reorder options: Review first, Work locally second, Work on remote third
- Add "Work on remote" option with `&` for background execution on Claude Code web
- Remove separate "Rework" option since "Other" handles custom changes
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
BREAKING: Plugin renamed from compounding-engineering to compound-engineering.
Users will need to reinstall with the new name:
claude /plugin install compound-engineering
Changes:
- Renamed plugin directory and all references
- Updated documentation counts (24 agents, 19 commands)
- Added julik-frontend-races-reviewer to docs
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
