161 Commits

Author SHA1 Message Date
Julik Tarkhanov
80fa2e3d82 Add a specialized JS reviewer agent
who focuses on UI races with maniacal obsession.
2025-11-28 00:59:16 +00:00
Kieran Klaassen
dbdd9c6676 Rename /codify to /compound and codify-docs to compound-docs
The new names better reflect the compounding engineering philosophy:
each documented solution compounds your team's knowledge.

- /codify → /compound (old command shows deprecation notice)
- codify-docs → compound-docs skill
- Updated all docs, philosophy sections, and references

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 14:13:00 -08:00
Kieran Klaassen
852b0b8920 Merge branch 'fix/flatten-workflow-commands' 2025-11-27 08:45:05 -08:00
Kieran Klaassen
59c55cb9bb Add year note (2025) to research agents for accurate date awareness
Added "The current year is 2025" note to all 4 research agents so they
don't assume outdated dates when searching for documentation:
- best-practices-researcher
- framework-docs-researcher
- git-history-analyzer
- repo-research-analyst

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 07:32:18 -08:00
Kieran Klaassen
eaf3cd9d4d Improve /plan command with clear post-generation options
Replace vague "keep asking questions until user is happy" ending with
AskUserQuestion tool presenting structured options. Users now see 4
explicit choices after plan generation: Start /work, Run /plan_review,
Simplify, or Rework.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 07:28:29 -08:00
Kieran Klaassen
9341872823 Merge pull request #22 from EveryInc/fix/flatten-workflow-commands
docs: fix workflow command documentation to use correct syntax
2025-11-26 21:08:39 -08:00
Kieran Klaassen
4b2820bdce docs: fix workflow command documentation to use correct syntax
Update all documentation to show the correct command syntax:
- `/plan`, `/review`, `/work`, `/codify` (short form, autocompletes)

Previously showed `/workflows:plan` etc. which doesn't work.
The `name:` field in frontmatter determines the short command name.

Fixes #19

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 21:03:22 -08:00
Kieran Klaassen
ff9fd7cb0f Fix landing page component counts and formatting
Critical fixes:
- Commands: 16 → 18 (added missing deploy-docs, release-docs)
- Agents: Fixed "24 specialized agents" → "23"
- Numbers: Standardized format (four → 4, three → 3, etc.)

Verified counts:
- 23 agents ✓
- 18 commands ✓
- 11 skills ✓
- 2 MCP servers ✓

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 20:39:00 -08:00
Kieran Klaassen
d367b2574d Rewrite all docs copy in Pragmatic Technical Writing style
Applied Hunt/Thomas and Joel Spolsky writing principles:
- Concrete before abstract (stories and examples first)
- Physical analogies for technical concepts
- Conversational voice with "you" and contractions
- Removed passive voice and weasel words
- Added memorable metaphors and hooks

Pages updated:
- index.html: New hero, philosophy section with N+1 query story
- agents.html: Each agent described with concrete scenarios
- commands.html: Action-oriented descriptions
- getting-started.html: Direct, conversational guide
- skills.html: Clear "when to use this" for each skill
- mcp-servers.html: Concrete examples of what each tool does

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 15:50:29 -08:00
Kieran Klaassen
13d317029f Merge branch 'claude/add-devtool-docs-01VWyrYPfQr5o2zAtZzYXhvu' 2025-11-26 15:42:17 -08:00
Kieran Klaassen
c05708162c Move docs to /docs for GitHub Pages
GitHub Pages is configured to serve from /docs in main branch.
Moved documentation site from plugins/compounding-engineering/docs/
to repository root /docs folder.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 15:40:37 -08:00
Kieran Klaassen
3c729b3baf Merge pull request #21 from EveryInc/claude/add-devtool-docs-01VWyrYPfQr5o2zAtZzYXhvu
Add DevTool template documentation to repo
2025-11-26 15:30:43 -08:00
Kieran Klaassen
f63dab9fc0 Simplify CSS design to match LaunchKit minimal aesthetic
Removed over-styled elements that were added during design iterations:
- Remove pulse, icon-float, badge-pulse, server-pulse animations
- Remove diamond-spin and slide-in animations
- Remove scanline repeating-linear-gradient effects
- Simplify hover transforms from -4px/-6px to -2px
- Simplify complex multi-layer box shadows to single shadows
- Remove shine effect on primary buttons
- Clean up duplicate/corrupted CSS rules

Net result: -205 lines of CSS, cleaner and more minimal design
following LaunchKit's "purposeful restraint" philosophy.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 12:55:37 -08:00
Kieran Klaassen
2f73463110 Remove The Compounding Effect section from landing page
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 12:47:15 -08:00
Kieran Klaassen
05303d42f5 chore: Remove screenshot artifacts and backup files
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 12:44:51 -08:00
Kieran Klaassen
1808f901eb [docs] Comprehensive design refresh of landing page
Design iterations (10x each) on all 10 sections:
- Hero: Gradient headlines, animated eyebrow, enhanced buttons with shimmer
- Stats: Icon system, gradient numbers, hover animations, layered shadows
- Philosophy: Pillar cards with gradient borders, animated timeline, tool tags
- Agents: Category headers with gradients, badge styling, code block enhancements
- Commands: Terminal aesthetic with $ prompts, scanlines, CORE/UTIL badges
- Skills: Knowledge module feel, feature pills, category theming
- MCP Servers: Server-specific theming (teal/amber), ACTIVE badges, tool counts
- Installation: Terminal-style code blocks, step progress indicators
- FAQ: Card-based accordion, question/checkmark icons, smooth animations
- CTA: Benefit-focused copy, animated badge, trust indicators, glass morphism

Design inspired by Evil Martians devtool-template patterns.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 12:44:36 -08:00
Kieran Klaassen
7901ef2241 Update docs theme and landing page styles
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 12:24:31 -08:00
Kieran Klaassen
b503a3ecb3 Add GitHub Pages deployment workflow
Adds automated deployment of documentation to GitHub Pages when
changes are pushed to the docs directory on the main branch.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 12:23:59 -08:00
Kieran Klaassen
733e59a7a5 [2.6.0] Remove feedback-codifier agent, update docs theme and style
- Remove feedback-codifier agent from workflow agents (24 → 23 agents)
- Update all component counts across plugin.json, README, and docs site
- Update docs CSS theme (hue: 243, saturation: 1, contrast: 0.71)
- Apply Every style guide fixes (number formatting: "2" → "two", etc.)
- Add v2.6.0 changelog entry to docs site

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 11:58:42 -08:00
Claude
1da08afa00 Add /deploy-docs command for GitHub Pages deployment
- Validates documentation files exist
- Checks JSON validity
- Provides GitHub Pages setup instructions
- Includes workflow file content for manual addition

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 19:34:47 +00:00
Kieran Klaassen
6721f051fb Delete plugins/compounding-engineering/commands/README.md 2025-11-26 11:27:10 -06:00
Claude
92d0e23768 docs: Add /release-docs command, changelog page, and build instructions
- Add /release-docs command for regenerating documentation site
- Add commands/README.md with usage instructions for all commands
- Add changelog.html page rendering CHANGELOG.md in HTML format
- Add changelog CSS styles to docs.css
- Update navigation in all docs pages to include changelog link
- Fix command count from 16 to 13 in navigation
- Update CLAUDE.md with:
  - Documentation Site section explaining structure
  - /release-docs command in update checklist
  - Instructions for keeping docs up-to-date

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 16:39:54 +00:00
Claude
53ba12f0ca docs: Add complete reference pages and enhanced philosophy section
- Add agents.html with full documentation for all 24 agents
- Add commands.html with full documentation for all 16 commands
- Add skills.html with full documentation for all 11 skills
- Add mcp-servers.html with Playwright and Context7 documentation
- Enhance landing page philosophy section with four pillars and compounding effect timeline
- Add CSS styles for philosophy section components

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 16:03:33 +00:00
Claude
91bd7e812f docs: Add comprehensive documentation site for compounding-engineering plugin
- Create landing page with Evil Martians devtool-template styling
- Add dark theme with accent colors and responsive design
- Document all 24 agents, 16 commands, 11 skills, and 2 MCP servers
- Add Getting Started guide with installation and configuration
- Include FAQ section, philosophy explanation, and code examples
- Add CSS with mobile-responsive layouts and smooth animations
- Include JavaScript for mobile nav, smooth scroll, and copy code

Built with LaunchKit template from Evil Martians.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 15:46:16 +00:00
Kieran Klaassen
531cfe7c06 [2.5.0] Add /report-bug command for plugin bug reporting
- New slash command that guides users through structured bug reporting
- Collects bug category, component, actual vs expected behavior, repro steps
- Auto-gathers environment info (plugin version, Claude Code version, OS)
- Creates GitHub issues in EveryInc/every-marketplace via gh CLI
- Includes privacy notice and error handling

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-25 07:53:44 -08:00
Kieran Klaassen
364b3f5d65 [2.4.1] Improve design-iterator with focused screenshots and skill loading
- Add focused screenshot guidance: always capture target element, not full page
- Include browser_resize recommendations for different component sizes
- Add element-targeted screenshot workflow using browser_snapshot refs
- Add step to load relevant design skills before starting iterations

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-24 15:15:25 -08:00
Kieran Klaassen
39e41f4332 docs: Add known issue about MCP servers not auto-loading 2025-11-24 14:32:16 -08:00
Kieran Klaassen
be1e957219 [2.4.0] Fix MCP configuration - use plugin.json not .mcp.json 2025-11-24 14:29:24 -08:00
Kieran Klaassen
bf00391d42 [2.3.1] Fix .mcp.json format - remove mcpServers wrapper 2025-11-24 14:24:37 -08:00
Kieran Klaassen
66e35bbc40 [2.3.0] Move MCP servers to .mcp.json file 2025-11-24 14:17:56 -08:00
Kieran Klaassen
e3e7640c64 [2.2.1] Fix Playwright MCP - add missing type field
- Add required "type": "stdio" to playwright MCP server config
- MCP servers require explicit type declaration to load properly

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-24 14:08:59 -08:00
Kieran Klaassen
a1cc81ce33 [2.2.0] Add Context7 MCP server for framework documentation
- Bundle Context7 MCP (SSE) for instant docs lookup
- Supports Rails, React, Next.js, Vue, Django, Laravel, and 100+ frameworks
- Tools: resolve-library-id, get-library-docs

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-24 14:04:12 -08:00
Kieran Klaassen
bd4a659f35 [2.1.0] Add Playwright MCP server and replace Puppeteer references
- Bundle @playwright/mcp for browser automation across all plugin users
- Replace all Puppeteer references with Playwright in agents and commands:
  - bug-reproduction-validator
  - design-iterator
  - design-implementation-reviewer
  - figma-design-sync
  - generate_command
- Document Playwright tools: browser_navigate, browser_take_screenshot,
  browser_click, browser_fill_form, browser_snapshot, browser_evaluate

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-24 14:02:07 -08:00
Kieran Klaassen
5a7bcc5afb [2.0.2] Improve design-iterator agent for proactive usage
- Update description to emphasize proactive use when design work isn't coming together
- Add examples showing how to suggest 5x or 10x iterations after initial changes fail
- Include guidance for when colors feel wrong or layouts aren't balanced

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-24 13:30:21 -08:00
Kieran Klaassen
bd2a19dc95 docs: Add versioning requirements for plugin development
- Add CLAUDE.md with versioning checklist and pre-commit requirements
- Add docs/solutions/plugin-versioning-requirements.md with detailed workflow
- Bump version to 2.0.1
- Update CHANGELOG with v2.0.1 entry

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-24 12:01:11 -08:00
Kieran Klaassen
6a9188da6e Merge pull request #17 from EveryInc/feat/plugin-v2-reorganization
feat(plugin): reorganize compounding-engineering v2.0.0
2025-11-24 11:53:34 -08:00
Kieran Klaassen
e262127d3a docs: Update README and CHANGELOG for v2.0.0
- Complete rewrite of README with categorized agents, commands, and skills
- Detailed CHANGELOG documenting v1.0.0, v1.1.0, and v2.0.0 changes
- Summary tables showing component growth (17→24 agents, 6→15 commands, 1→11 skills)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-24 11:52:14 -08:00
Kieran Klaassen
8cc99ab483 feat(plugin): reorganize compounding-engineering v2.0.0
Major restructure of the compounding-engineering plugin:

## Agents (24 total, now categorized)
- review/ (10): architecture-strategist, code-simplicity-reviewer,
  data-integrity-guardian, dhh-rails-reviewer, kieran-rails-reviewer,
  kieran-python-reviewer, kieran-typescript-reviewer,
  pattern-recognition-specialist, performance-oracle, security-sentinel
- research/ (4): best-practices-researcher, framework-docs-researcher,
  git-history-analyzer, repo-research-analyst
- design/ (3): design-implementation-reviewer, design-iterator,
  figma-design-sync
- workflow/ (6): bug-reproduction-validator, every-style-editor,
  feedback-codifier, lint, pr-comment-resolver, spec-flow-analyzer
- docs/ (1): ankane-readme-writer

## Commands (15 total)
- Moved workflow commands to commands/workflows/ subdirectory
- Added: changelog, create-agent-skill, heal-skill, plan_review,
  prime, reproduce-bug, resolve_parallel, resolve_pr_parallel

## Skills (11 total)
- Added: andrew-kane-gem-writer, codify-docs, create-agent-skills,
  dhh-ruby-style, dspy-ruby, every-style-editor, file-todos,
  frontend-design, git-worktree, skill-creator
- Kept: gemini-imagegen

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-24 11:42:18 -08:00
Kieran Klaassen
8cd694c518 feat(gemini-imagegen): add requirements.txt for dependencies
Adds pip installable dependencies for the gemini-imagegen skill:
- google-genai>=1.0.0
- Pillow>=10.0.0

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-23 22:08:20 -08:00
Kieran Klaassen
d44804fc39 Update CLAUDE.md with plugin update checklist and skill docs
- Add comprehensive checklist for updating plugin components
- Add instructions for adding new skills
- Fix repository structure diagram (17 agents, skills folder)
- Add learning about fixing component counts

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-22 13:49:01 -08:00
Kieran Klaassen
15e07637d5 Add gemini-imagegen skill and fix component counts
- Add gemini-imagegen skill for image generation with Gemini API
- Fix component counts: 17 agents (was 15), 6 commands, 1 skill
- Add comprehensive README documenting all components
- Add CHANGELOG tracking version history
- Bump version to 1.1.0

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-22 13:48:01 -08:00
Kieran Klaassen
4e2a828117 Update README.md to add Droid quick start and clarify marketplace usage
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
2025-10-30 20:54:14 -07:00
Kieran Klaassen
a230b2b791 Delete plugins/compounding-engineering/CHANGELOG.md 2025-10-30 22:39:55 -05:00
Kieran Klaassen
b1284a226c Merge pull request #7 from EveryInc/claude/update-readme-documentation-011CUKE4vw4wMDkhR1u7E4gQ
Claude/update readme documentation 011 cuke4vw4w m dkh r1u7 e4g q
2025-10-20 15:34:40 -07:00
Claude
4d6632037a Fix command prefixes and remove plugin README
Two corrections based on feedback:

1. Remove plugin README - only the marketplace README is needed
2. Update all command references to use correct prefix format:
   - /plan → /compounding-engineering:plan
   - /work → /compounding-engineering:work
   - /review → /compounding-engineering:review
   - All other commands updated similarly

This ensures the documentation accurately reflects how users actually invoke the commands.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 22:32:54 +00:00
Claude
daf3afc997 Update marketplace README with comprehensive plugin documentation
Expand the marketplace README to include the full compounding engineering plugin documentation. This makes it immediately clear to visitors what the plugin does and how to use it.

Key additions:
- Detailed explanation of the three-step workflow (Plan → Work → Review)
- Practical examples for each core command
- Complete list of all six commands and 17 agents
- Philosophy and benefits of compounding engineering
- Clear getting started guide

Kept the original installation instructions and added the detailed documentation below, making the marketplace README a comprehensive resource.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 22:22:58 +00:00
Claude
b87934c4eb Add comprehensive README for compounding-engineering plugin
Create a new README that clearly explains how to use the plugin with focus on the three core commands: /plan, /work, and /review. The README:

- Explains the compounding engineering philosophy
- Provides clear workflow guidance (Plan → Work → Review)
- Includes practical quick start examples
- Lists all 17 agents and six commands
- Follows Every's style guide conventions

This makes it much easier for new users to understand how to use the plugin effectively.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 22:21:36 +00:00
Kieran Klaassen
e9885eefa2 Merge pull request #6 from Kamalnrf/patch-1
Add one-command installation option via Claude Plugins CLI
2025-10-15 15:43:46 -05:00
Kamal
0a90f25c17 docs: add one-command installation option via Claude Plugins CLI
Adds alternative installation method that combines marketplace addition and plugin installation into a single npx command for improved UX.
2025-10-15 15:42:08 +05:30
Kieran Klaassen
1c180dcb9e Update README.md to clarify features of AI-powered development tools
- Revised description of specialized agents and commands for conciseness
- Removed specific counts of agents and commands to streamline information presentation

This update enhances clarity and focuses on the core functionalities of the plugin.
2025-10-09 14:32:54 -07:00