Commit Graph

33 Commits

Author SHA1 Message Date
Kieran Klaassen
d1defc2e57 [2.26.2] Clarify test-browser to use agent-browser CLI only
- Add explicit warning: DO NOT use Chrome MCP tools
- Add Step 0: Verify agent-browser installation
- Add full CLI reference section
- Add Next.js route mapping patterns

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:04:26 -08:00
Kieran Klaassen
67eb8473a2 feat: add /lfg command for full autonomous engineering workflow
- Orchestrates: plan → deepen-plan → work → review → resolve todos → test-browser → feature-video
- Uses ralph-loop for autonomous completion
- Migrated from local command
- Updated to use /test-browser instead of /playwright-test

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-14 16:24:00 -08:00
Kieran Klaassen
43f6804b17 feat: add headed/headless mode option to test-browser
- Add Step 0 asking user if they want to watch browser tests
- Headed mode opens visible browser window
- Headless mode runs faster in background
- Bump version to 2.25.0

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-14 16:21:39 -08:00
Kieran Klaassen
31bd85f60b feat: Replace Playwright MCP with agent-browser CLI
- 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>
2026-01-14 16:21:21 -08:00
mlissen
012a638d31 fix: Add explicit plan filename naming guidance (#76)
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>
2026-01-14 18:20:27 -06:00
Kieran Klaassen
c06f7e889f feat(reproduce-bug): Add Playwright visual reproduction instructions
Enhanced /reproduce-bug command with browser automation:
- Added Phase 2 for visual bug reproduction using Playwright MCP
- Step-by-step guide for navigating to affected areas
- Screenshot capture at each reproduction step
- Console error checking
- User flow reproduction with clicks, typing, snapshots
- Better documentation structure with 4 clear phases

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-09 08:07:35 -08:00
Kieran Klaassen
8c4ed0d458 [2.23.0] Add /agent-native-audit command
- New command for comprehensive agent-native architecture review
- Launches 8 parallel sub-agents, one per core principle
- Principles: Action Parity, Tools as Primitives, Context Injection,
  Shared Workspace, CRUD Completeness, UI Integration, Capability
  Discovery, Prompt-Native Features
- Each agent produces specific score (X/Y format with percentage)
- Generates summary report with overall score and top 10 recommendations
- Supports single principle audit via argument

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-08 08:49:04 -08:00
Kieran Klaassen
be30002bbe [2.22.1] Improve feature-video with GitHub embed learnings
- Add low-quality preview GIF creation (640px, 128 colors)
- Use --s3-no-check-bucket flag for rclone uploads
- Document GitHub limitation: external MP4s don't embed
- Use clickable GIF linking to video for PR descriptions

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-05 11:10:53 -08:00
Kieran Klaassen
84890f1e16 [2.22.0] Add rclone skill and enhance feature-video command
- Add rclone skill for uploading to S3, Cloudflare R2, Backblaze B2
- Update /feature-video with better ffmpeg commands (proper scaling)
- Add rclone integration for cloud uploads in feature-video
- 27 agents, 20 commands, 13 skills, 2 MCP servers

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-05 11:07:02 -08:00
Kieran Klaassen
141bbb42cb [2.16.0] Consolidate DHH styles and add /feature-video command
- Merge dhh-ruby-style into dhh-rails-style for comprehensive Rails conventions
- Add testing.md reference covering Rails testing patterns
- Add /feature-video command for recording PR demo videos
- Update docs and component counts

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-05 10:25:32 -08:00
tschier
d6b8cbc5db Update year and improve markdown formatting in plan.md (#64)
Updated the current year from 2025 to 2026 in the plan documentation and improved markdown formatting for code examples.
2026-01-03 01:09:39 -06:00
Kieran Klaassen
14512fe980 [2.19.0] Filter learnings by frontmatter before spawning sub-agents
- Read frontmatter (title, category, tags, module, symptom) of each learning
- Compare against plan to determine relevance
- SKIP learnings that are clearly not applicable
- SPAWN sub-agents only for learnings that MIGHT apply
- Example: 15 files found → filter to 3 relevant → spawn 3 sub-agents

Smarter than spawning 50 sub-agents when only 5 are relevant.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 16:26:47 -08:00
Kieran Klaassen
e2979b60ec [2.19.0] Make learnings location crystal clear
- Show exact folder structure: docs/solutions/[category]/*.md
- Clear step-by-step: find files → list them → spawn sub-agent per file
- Explicit bash commands to discover learning files
- Concrete example showing 3 files → 3 parallel sub-agents
- PRIMARY location is docs/solutions/ (from /workflows:compound)

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 16:25:22 -08:00
Kieran Klaassen
1603fa5f39 [2.19.0] Add learnings discovery - spawn sub-agent per learning
- Discover documented learnings from /workflows:compound
  - Project docs/solutions/
  - User ~/.claude/docs/
  - Plugin docs/
- Spawn sub-agent for EACH learning to check if relevant to plan
- All learning sub-agents run in parallel
- Categories: performance-issues, debugging-patterns, config-fixes, etc.
- Added learnings to synthesis sources
- Fixed section numbering (now 1-9)

Institutional knowledge - prevents repeating past mistakes.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 16:24:25 -08:00
Kieran Klaassen
4a1093702f [2.19.0] Skip workflow agents, use review/research/design/docs only
For compound-engineering plugin:
- USE: agents/review/* (all reviewers)
- USE: agents/research/* (all researchers)
- USE: agents/design/* (design agents)
- USE: agents/docs/* (documentation agents)
- SKIP: agents/workflow/* (workflow orchestrators, not reviewers)

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 13:41:34 -08:00
Kieran Klaassen
e3572fd1d7 [2.19.0] Clarify skill sub-agent spawning and synthesis
- Spawn a separate sub-agent for EVERY matched skill
- Each sub-agent reads and USES its assigned skill's SKILL.md
- All skill sub-agents run in parallel (10, 20, 30 is fine)
- Enhanced synthesis step to collect from ALL sources:
  - Skill sub-agent outputs
  - Research agents
  - Review agents
  - Context7 queries
  - Web searches
- Deduplicate and prioritize findings before enhancing plan

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 13:41:11 -08:00
Kieran Klaassen
bfbf480b7f [2.19.0] Enhance /deepen-plan with dynamic discovery
- Dynamically discover ALL skills from all sources:
  - Project .claude/skills/
  - User ~/.claude/skills/
  - compound-engineering plugin
  - ALL other installed plugins

- Dynamically discover ALL agents from all sources:
  - Project .claude/agents/
  - User ~/.claude/agents/
  - All installed plugins (not just compound-engineering)
  - Local plugins

- Run ALL discovered agents in parallel (40+ is fine)
- No filtering by "relevance" - use everything available
- Match skills to plan sections and spawn sub-agents

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 13:39:17 -08:00
Kieran Klaassen
a473c67a71 [2.19.0] Add /deepen-plan command for power plan enhancement
- 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>
2025-12-31 13:28:38 -08:00
Kieran Klaassen
3fc2358e1f [2.15.1] Smart project detection for end-to-end testing in /review
- Review command now detects project type from PR files
- Web projects → offers /playwright-test
- iOS projects → offers /xcode-test
- Hybrid projects (Rails + Hotwire Native) → offers both options

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-18 10:38:07 -08:00
Kieran Klaassen
6955914f6c [2.15.0] Add /xcode-test command for iOS simulator testing
- New `/xcode-test` command for building and testing iOS apps
- Uses XcodeBuildMCP to discover projects, build, install, launch
- Takes screenshots and captures console logs
- Supports human verification for Sign in with Apple, push, IAP
- Checks for XcodeBuildMCP installation before proceeding

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-18 10:35:28 -08:00
Kieran Klaassen
f619e261c4 [2.14.0] Add /playwright-test command for browser testing
- 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>
2025-12-18 10:26:43 -08:00
Kieran Klaassen
3c6aa1144b feat(agents): Add data-migration-expert and deployment-verification-agent
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>
2025-12-15 11:26:55 -08:00
Kieran Klaassen
92770b5fa4 Fix heal-skill description to avoid false matches
Make description more specific to SKILL.md fixes, less likely to
trigger when running /workflows:compound

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-10 19:04:42 -08:00
Kieran Klaassen
f0a49f5b18 [2.11.1] Remove /prime command from plugin
Fixes #41

The /prime command was a personal setup command that shouldn't have been
included in the distributed plugin. It caused confusion when users had
hooks that auto-invoked it on session start.

Users who want a prime command can add it to their personal ~/.claude/commands/

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-10 19:02:24 -08:00
Kieran Klaassen
2a8f19936a [2.11.0] Namespace workflow commands to avoid collision with built-in /plan
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>
2025-12-10 18:59:58 -08:00
Kieran Klaassen
5bcbc1aadf [2.10.2] Rename workflow commands to ce: prefix
- /compound:plan → /ce:plan
- /compound:review → /ce:review
- /compound:work → /ce:work
- /compound:codify → /ce:compound

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-10 18:43:13 -08:00
Kieran Klaassen
35b39ddc10 [2.10.1] Fix command collisions and bugs
Fixes:
- #40: Add missing `name:` field to heal-skill.md and create-agent-skill.md
- #41: Rewrite corrupted prime.md (was containing CLAUDE.md text)
- #42: Namespace workflow commands as `compound:*` to avoid collision with built-in `/plan`
- #36: Shorten Playwright MCP alias from `playwright` to `pw` (64 char limit)

Command renames:
- /plan → /compound:plan
- /review → /compound:review
- /work → /compound:work
- /compound → /compound:codify

Removed:
- Deprecated /codify command (use /compound:codify)

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-10 18:38:31 -08:00
Kieran Klaassen
4ea9f52ba9 [2.10.0] Add agent-native reviewer and architecture skill
- 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>
2025-12-10 11:26:02 -08:00
Kieran Klaassen
514e984aef [2.9.4] Improve /work command screenshot documentation
- 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>
2025-12-08 21:58:38 -08:00
Kieran Klaassen
5febbf11d4 [2.9.3] Add "Open plan in editor" option to /plan command
- 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>
2025-12-05 19:43:07 -08:00
Kieran Klaassen
6ed1aae8f1 [2.9.2] Add screenshot documentation step to /work command
- 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>
2025-12-04 09:14:54 -08:00
Kieran Klaassen
a165503ec6 [2.9.1] Improve /plan command post-generation options
- 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>
2025-12-04 08:52:05 -08:00
Kieran Klaassen
6c5b3e40db [2.9.0] Rename plugin to compound-engineering
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>
2025-12-02 17:32:16 -08:00