Files
claude-engineering-plugin/plugins/compound-engineering
Dan Shipper 68aa93678c [2.23.0] Major update to agent-native-architecture skill (#70)
Align skill with canonical Agent-Native Architecture document:

## Core Changes
- Restructure SKILL.md with 5 named principles from canonical:
  - Parity: Agent can do whatever user can do
  - Granularity: Prefer atomic primitives
  - Composability: Features are prompts
  - Emergent Capability: Handle unanticipated requests
  - Improvement Over Time: Context accumulation

- Add "The test" for each principle
- Add "Why Now" section (Claude Code origin story)
- Update terminology from "prompt-native" to "agent-native"
- Add "The Ultimate Test" to success criteria

## New Reference Files
- files-universal-interface.md: Why files, organization patterns, context.md pattern, conflict model
- from-primitives-to-domain-tools.md: When to add domain tools, graduating to code
- agent-execution-patterns.md: Completion signals, partial completion, context limits
- product-implications.md: Progressive disclosure, latent demand discovery, approval matrix

## Updated Reference Files
- mobile-patterns.md: Add iOS storage architecture (iCloud-first), "needs validation" callouts, on-device vs cloud section
- architecture-patterns.md: Update overview to reference 5 principles and cross-link new files

## Anti-Patterns
- Add missing anti-patterns: agent as router, build-then-add-agent, request/response thinking, defensive tool design, happy path in code

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

Co-authored-by: Claude <noreply@anthropic.com>
2026-01-07 10:50:58 -06:00
..

Compounding Engineering Plugin

AI-powered development tools that get smarter with every use. Make each unit of engineering work easier than the last.

Components

Component Count
Agents 27
Commands 20
Skills 13
MCP Servers 2

Agents

Agents are organized into categories for easier discovery.

Review (14)

Agent Description
agent-native-reviewer Verify features are agent-native (action + context parity)
architecture-strategist Analyze architectural decisions and compliance
code-simplicity-reviewer Final pass for simplicity and minimalism
data-integrity-guardian Database migrations and data integrity
data-migration-expert Validate ID mappings match production, check for swapped values
deployment-verification-agent Create Go/No-Go deployment checklists for risky data changes
dhh-rails-reviewer Rails review from DHH's perspective
kieran-rails-reviewer Rails code review with strict conventions
kieran-python-reviewer Python code review with strict conventions
kieran-typescript-reviewer TypeScript code review with strict conventions
pattern-recognition-specialist Analyze code for patterns and anti-patterns
performance-oracle Performance analysis and optimization
security-sentinel Security audits and vulnerability assessments
julik-frontend-races-reviewer Review JavaScript/Stimulus code for race conditions

Research (4)

Agent Description
best-practices-researcher Gather external best practices and examples
framework-docs-researcher Research framework documentation and best practices
git-history-analyzer Analyze git history and code evolution
repo-research-analyst Research repository structure and conventions

Design (3)

Agent Description
design-implementation-reviewer Verify UI implementations match Figma designs
design-iterator Iteratively refine UI through systematic design iterations
figma-design-sync Synchronize web implementations with Figma designs

Workflow (5)

Agent Description
bug-reproduction-validator Systematically reproduce and validate bug reports
every-style-editor Edit content to conform to Every's style guide
lint Run linting and code quality checks on Ruby and ERB files
pr-comment-resolver Address PR comments and implement fixes
spec-flow-analyzer Analyze user flows and identify gaps in specifications

Docs (1)

Agent Description
ankane-readme-writer Create READMEs following Ankane-style template for Ruby gems

Commands

Workflow Commands

Core workflow commands use workflows: prefix to avoid collisions with built-in commands:

Command Description
/workflows:plan Create implementation plans
/workflows:review Run comprehensive code reviews
/workflows:work Execute work items systematically
/workflows:compound Document solved problems to compound team knowledge

Utility Commands

Command Description
/deepen-plan Enhance plans with parallel research agents for each section
/changelog Create engaging changelogs for recent merges
/create-agent-skill Create or edit Claude Code skills
/generate_command Generate new slash commands
/heal-skill Fix skill documentation issues
/plan_review Multi-agent plan review in parallel
/report-bug Report a bug in the plugin
/reproduce-bug Reproduce bugs using logs and console
/resolve_parallel Resolve TODO comments in parallel
/resolve_pr_parallel Resolve PR comments in parallel
/resolve_todo_parallel Resolve todos in parallel
/triage Triage and prioritize issues
/playwright-test Run browser tests on PR-affected pages
/xcode-test Build and test iOS apps on simulator
/feature-video Record video walkthroughs and add to PR description

Skills

Architecture & Design

Skill Description
agent-native-architecture Build AI agents using prompt-native architecture

Development Tools

Skill Description
andrew-kane-gem-writer Write Ruby gems following Andrew Kane's patterns
compound-docs Capture solved problems as categorized documentation
create-agent-skills Expert guidance for creating Claude Code skills
dhh-rails-style Write Ruby/Rails code in DHH's 37signals style
dspy-ruby Build type-safe LLM applications with DSPy.rb
frontend-design Create production-grade frontend interfaces
skill-creator Guide for creating effective Claude Code skills

Content & Workflow

Skill Description
every-style-editor Review copy for Every's style guide compliance
file-todos File-based todo tracking system
git-worktree Manage Git worktrees for parallel development

File Transfer

Skill Description
rclone Upload files to S3, Cloudflare R2, Backblaze B2, and cloud storage

Image Generation

Skill Description
gemini-imagegen Generate and edit images using Google's Gemini API

gemini-imagegen features:

  • Text-to-image generation
  • Image editing and manipulation
  • Multi-turn refinement
  • Multiple reference image composition (up to 14 images)

Requirements:

  • GEMINI_API_KEY environment variable
  • Python packages: google-genai, pillow

MCP Servers

Server Description
playwright Browser automation via @playwright/mcp
context7 Framework documentation lookup via Context7

Playwright

Tools provided:

  • browser_navigate - Navigate to URLs
  • browser_take_screenshot - Take screenshots
  • browser_click - Click elements
  • browser_fill_form - Fill form fields
  • browser_snapshot - Get accessibility snapshot
  • browser_evaluate - Execute JavaScript

Context7

Tools provided:

  • resolve-library-id - Find library ID for a framework/package
  • get-library-docs - Get documentation for a specific library

Supports 100+ frameworks including Rails, React, Next.js, Vue, Django, Laravel, and more.

MCP servers start automatically when the plugin is enabled.

Installation

claude /plugin install compound-engineering

Known Issues

MCP Servers Not Auto-Loading

Issue: The bundled MCP servers (Playwright and Context7) may not load automatically when the plugin is installed.

Workaround: Manually add them to your project's .claude/settings.json:

{
  "mcpServers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"],
      "env": {}
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Or add them globally in ~/.claude/settings.json for all projects.

Version History

See CHANGELOG.md for detailed version history.

License

MIT