feat: add claude-code-setup and claude-md-management plugins

plugins/claude-code-setup/skills/claude-automation-recommender/references/hooks-patterns.md

@@ -0,0 +1,147 @@
+# Hooks Recommendations
+
+Hooks automatically run commands in response to Claude's tool usage. They're ideal for enforcement and automation that should happen consistently.
+
+## Auto-Formatting Hooks
+
+### Prettier (JavaScript/TypeScript)
+| Detection | File Exists |
+|-----------|-------------|
+| `.prettierrc`, `.prettierrc.json`, `prettier.config.js` | ✓ |
+
+**Recommend**: PostToolUse hook on Edit/Write to auto-format
+**Value**: Code stays formatted without thinking about it
+
+### ESLint (JavaScript/TypeScript)
+| Detection | File Exists |
+|-----------|-------------|
+| `.eslintrc`, `.eslintrc.json`, `eslint.config.js` | ✓ |
+
+**Recommend**: PostToolUse hook on Edit/Write to auto-fix
+**Value**: Lint errors fixed automatically
+
+### Black/isort (Python)
+| Detection | File Exists |
+|-----------|-------------|
+| `pyproject.toml` with black/isort, `.black`, `setup.cfg` | ✓ |
+
+**Recommend**: PostToolUse hook to format Python files
+**Value**: Consistent Python formatting
+
+### Ruff (Python - Modern)
+| Detection | File Exists |
+|-----------|-------------|
+| `ruff.toml`, `pyproject.toml` with `[tool.ruff]` | ✓ |
+
+**Recommend**: PostToolUse hook for lint + format
+**Value**: Fast, comprehensive Python linting
+
+### gofmt (Go)
+| Detection | File Exists |
+|-----------|-------------|
+| `go.mod` | ✓ |
+
+**Recommend**: PostToolUse hook to run gofmt
+**Value**: Standard Go formatting
+
+### rustfmt (Rust)
+| Detection | File Exists |
+|-----------|-------------|
+| `Cargo.toml` | ✓ |
+
+**Recommend**: PostToolUse hook to run rustfmt
+**Value**: Standard Rust formatting
+
+---
+
+## Type Checking Hooks
+
+### TypeScript
+| Detection | File Exists |
+|-----------|-------------|
+| `tsconfig.json` | ✓ |
+
+**Recommend**: PostToolUse hook to run tsc --noEmit
+**Value**: Catch type errors immediately
+
+### mypy/pyright (Python)
+| Detection | File Exists |
+|-----------|-------------|
+| `mypy.ini`, `pyrightconfig.json`, pyproject.toml with mypy | ✓ |
+
+**Recommend**: PostToolUse hook for type checking
+**Value**: Catch type errors in Python
+
+---
+
+## Protection Hooks
+
+### Block Sensitive File Edits
+| Detection | Presence Of |
+|-----------|-------------|
+| `.env`, `.env.local`, `.env.production` | Environment files |
+| `credentials.json`, `secrets.yaml` | Secret files |
+| `.git/` directory | Git internals |
+
+**Recommend**: PreToolUse hook that blocks Edit/Write to these paths
+**Value**: Prevent accidental secret exposure or git corruption
+
+### Block Lock File Edits
+| Detection | Presence Of |
+|-----------|-------------|
+| `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml` | JS lock files |
+| `Cargo.lock`, `poetry.lock`, `Pipfile.lock` | Other lock files |
+
+**Recommend**: PreToolUse hook that blocks direct edits
+**Value**: Lock files should only change via package manager
+
+---
+
+## Test Runner Hooks
+
+### Jest (JavaScript/TypeScript)
+| Detection | Presence Of |
+|-----------|-------------|
+| `jest.config.js`, `jest` in package.json | Jest configured |
+| `__tests__/`, `*.test.ts`, `*.spec.ts` | Test files exist |
+
+**Recommend**: PostToolUse hook to run related tests after edit
+**Value**: Immediate test feedback on changes
+
+### pytest (Python)
+| Detection | Presence Of |
+|-----------|-------------|
+| `pytest.ini`, `pyproject.toml` with pytest | pytest configured |
+| `tests/`, `test_*.py` | Test files exist |
+
+**Recommend**: PostToolUse hook to run pytest on changed files
+**Value**: Immediate test feedback
+
+---
+
+## Quick Reference: Detection → Recommendation
+
+| If You See | Recommend This Hook |
+|------------|-------------------|
+| Prettier config | Auto-format on Edit/Write |
+| ESLint config | Auto-lint on Edit/Write |
+| Ruff/Black config | Auto-format Python |
+| tsconfig.json | Type-check on Edit |
+| Test directory | Run related tests on Edit |
+| .env files | Block .env edits |
+| Lock files | Block lock file edits |
+| Go project | gofmt on Edit |
+| Rust project | rustfmt on Edit |
+
+---
+
+## Hook Placement
+
+Hooks go in `.claude/settings.json`:
+
+```
+.claude/
+└── settings.json  ← Hook configurations here
+```
+
+Recommend creating the `.claude/` directory if it doesn't exist.

plugins/claude-code-setup/skills/claude-automation-recommender/references/mcp-servers.md

@@ -0,0 +1,261 @@
+# MCP Server Recommendations
+
+MCP (Model Context Protocol) servers extend Claude's capabilities by connecting to external tools and services.
+
+## Setup & Team Sharing
+
+**Connection methods:**
+1. **Project config** (`.mcp.json`) - Available only in that directory
+2. **Global config** (`~/.claude.json`) - Available across all projects
+3. **Checked-in `.mcp.json`** - Available to entire team (recommended!)
+
+**Tip**: Check `.mcp.json` into git so your whole team gets the same MCP servers.
+
+**Debugging**: Use `claude --mcp-debug` to identify configuration issues.
+
+## Documentation & Knowledge
+
+### context7
+**Best for**: Projects using popular libraries/SDKs where you want Claude to code with up-to-date documentation
+
+| Recommend When | Examples |
+|----------------|----------|
+| Using React, Vue, Angular | Frontend frameworks |
+| Using Express, FastAPI, Django | Backend frameworks |
+| Using Prisma, Drizzle | ORMs |
+| Using Stripe, Twilio, SendGrid | Third-party APIs |
+| Using AWS SDK, Google Cloud | Cloud SDKs |
+| Using LangChain, OpenAI SDK | AI/ML libraries |
+
+**Value**: Claude fetches live documentation instead of relying on training data, reducing hallucinated APIs and outdated patterns.
+
+---
+
+## Browser & Frontend
+
+### Playwright MCP
+**Best for**: Frontend projects needing browser automation, testing, or screenshots
+
+| Recommend When | Examples |
+|----------------|----------|
+| React/Vue/Angular app | UI component testing |
+| E2E tests needed | User flow validation |
+| Visual regression testing | Screenshot comparisons |
+| Debugging UI issues | See what user sees |
+| Form testing | Multi-step workflows |
+
+**Value**: Claude can interact with your running app, take screenshots, fill forms, and verify UI behavior.
+
+### Puppeteer MCP
+**Best for**: Headless browser automation, web scraping
+
+| Recommend When | Examples |
+|----------------|----------|
+| PDF generation from HTML | Report generation |
+| Web scraping tasks | Data extraction |
+| Headless testing | CI environments |
+
+---
+
+## Databases
+
+### Supabase MCP
+**Best for**: Projects using Supabase for backend/database
+
+| Recommend When | Examples |
+|----------------|----------|
+| Supabase project detected | `@supabase/supabase-js` in deps |
+| Auth + database needs | User management apps |
+| Real-time features | Live data sync |
+
+**Value**: Claude can query tables, manage auth, and interact with Supabase storage directly.
+
+### PostgreSQL MCP
+**Best for**: Direct PostgreSQL database access
+
+| Recommend When | Examples |
+|----------------|----------|
+| Raw PostgreSQL usage | No ORM layer |
+| Database migrations | Schema management |
+| Data analysis tasks | Complex queries |
+| Debugging data issues | Inspect actual data |
+
+### Neon MCP
+**Best for**: Neon serverless Postgres users
+
+### Turso MCP
+**Best for**: Turso/libSQL edge database users
+
+---
+
+## Version Control & DevOps
+
+### GitHub MCP
+**Best for**: GitHub-hosted repositories needing issue/PR integration
+
+| Recommend When | Examples |
+|----------------|----------|
+| GitHub repository | `.git` with GitHub remote |
+| Issue-driven development | Reference issues in commits |
+| PR workflows | Review, merge operations |
+| GitHub Actions | CI/CD pipeline access |
+| Release management | Tag and release automation |
+
+**Value**: Claude can create issues, review PRs, check workflow runs, and manage releases.
+
+### GitLab MCP
+**Best for**: GitLab-hosted repositories
+
+### Linear MCP
+**Best for**: Teams using Linear for issue tracking
+
+| Recommend When | Examples |
+|----------------|----------|
+| Linear workspace | Issue references like `ABC-123` |
+| Sprint planning | Backlog management |
+| Issue creation from code | Auto-create issues for TODOs |
+
+---
+
+## Cloud Infrastructure
+
+### AWS MCP
+**Best for**: AWS infrastructure management
+
+| Recommend When | Examples |
+|----------------|----------|
+| AWS SDK in dependencies | `@aws-sdk/*` packages |
+| Infrastructure as code | Terraform, CDK, SAM |
+| Lambda development | Serverless functions |
+| S3, DynamoDB usage | Cloud data services |
+
+### Cloudflare MCP
+**Best for**: Cloudflare Workers, Pages, R2, D1
+
+| Recommend When | Examples |
+|----------------|----------|
+| Cloudflare Workers | Edge functions |
+| Pages deployment | Static site hosting |
+| R2 storage | Object storage |
+| D1 database | Edge SQL database |
+
+### Vercel MCP
+**Best for**: Vercel deployment and configuration
+
+---
+
+## Monitoring & Observtic
+
+### Sentry MCP
+**Best for**: Error tracking and debugging
+
+| Recommend When | Examples |
+|----------------|----------|
+| Sentry configured | `@sentry/*` in deps |
+| Production debugging | Investigate errors |
+| Error patterns | Group similar issues |
+| Release tracking | Correlate deploys with errors |
+
+**Value**: Claude can investigate Sentry issues, find root causes, and suggest fixes.
+
+### Datadog MCP
+**Best for**: APM, logs, and metrics
+
+---
+
+## Communication
+
+### Slack MCP
+**Best for**: Slack workspace integration
+
+| Recommend When | Examples |
+|----------------|----------|
+| Team uses Slack | Send notifications |
+| Deployment notifications | Alert channels |
+| Incident response | Post updates |
+
+### Notion MCP
+**Best for**: Notion workspace for documentation
+
+| Recommend When | Examples |
+|----------------|----------|
+| Notion for docs | Read/update pages |
+| Knowledge base | Search documentation |
+| Meeting notes | Create summaries |
+
+---
+
+## File & Data
+
+### Filesystem MCP
+**Best for**: Enhanced file operations beyond built-in tools
+
+| Recommend When | Examples |
+|----------------|----------|
+| Complex file operations | Batch processing |
+| File watching | Monitor changes |
+| Advanced search | Custom patterns |
+
+### Memory MCP
+**Best for**: Persistent memory across sessions
+
+| Recommend When | Examples |
+|----------------|----------|
+| Long-running projects | Remember context |
+| User preferences | Store settings |
+| Learning patterns | Build knowledge |
+
+**Value**: Claude remembers project context, decisions, and patterns across conversations.
+
+---
+
+## Containers & DevOps
+
+### Docker MCP
+**Best for**: Container management
+
+| Recommend When | Examples |
+|----------------|----------|
+| Docker Compose file | Container orchestration |
+| Dockerfile present | Build images |
+| Container debugging | Inspect logs, exec |
+
+### Kubernetes MCP
+**Best for**: Kubernetes cluster management
+
+| Recommend When | Examples |
+|----------------|----------|
+| K8s manifests | Deploy, scale pods |
+| Helm charts | Package management |
+| Cluster debugging | Pod logs, status |
+
+---
+
+## AI & ML
+
+### Exa MCP
+**Best for**: Web search and research
+
+| Recommend When | Examples |
+|----------------|----------|
+| Research tasks | Find current info |
+| Competitive analysis | Market research |
+| Documentation gaps | Find examples |
+
+---
+
+## Quick Reference: Detection Patterns
+
+| Look For | Suggests MCP Server |
+|----------|-------------------|
+| Popular npm packages | context7 |
+| React/Vue/Next.js | Playwright MCP |
+| `@supabase/supabase-js` | Supabase MCP |
+| `pg` or `postgres` | PostgreSQL MCP |
+| GitHub remote | GitHub MCP |
+| `.linear` or Linear refs | Linear MCP |
+| `@aws-sdk/*` | AWS MCP |
+| `@sentry/*` | Sentry MCP |
+| `docker-compose.yml` | Docker MCP |
+| Slack webhook URLs | Slack MCP |
+| `@anthropic-ai/sdk` | context7 for Anthropic docs |

plugins/claude-code-setup/skills/claude-automation-recommender/references/plugins-reference.md

@@ -0,0 +1,89 @@
+# Plugin Recommendations
+
+Plugins are installable collections of skills that extend Claude's capabilities. They bundle related skills, reference materials, and workflows together.
+
+## Available Plugins
+
+### anthropic-agent-skills
+**The comprehensive skills bundle from Anthropic**
+
+| Recommend When | Examples |
+|----------------|----------|
+| General productivity | Default recommendation |
+| Document workflows | docx, xlsx, pptx, pdf |
+| Frontend development | frontend-design, webapp-testing |
+| Building AI tools | mcp-builder, skill-creator |
+| Creative work | canvas-design, algorithmic-art |
+
+**Includes**: docx, xlsx, pptx, pdf, frontend-design, canvas-design, algorithmic-art, mcp-builder, skill-creator, webapp-testing, doc-coauthoring, internal-comms, brand-guidelines, theme-factory, slack-gif-creator, web-artifacts-builder
+
+**Install**: This plugin is commonly pre-installed. Check with `claude plugins list`.
+
+---
+
+### frontend-design
+**Specialized frontend UI development**
+
+| Recommend When | Examples |
+|----------------|----------|
+| React/Vue/Angular work | Component development |
+| Landing pages | Marketing sites |
+| Dashboard UI | Admin interfaces |
+| Design system | Component libraries |
+
+**Value**: Creates distinctive, production-grade UI avoiding generic AI aesthetics.
+
+---
+
+## Plugin vs Individual Skills
+
+### When to Recommend Plugin Installation
+- User needs multiple related skills
+- Team standardization desired
+- First-time Claude Code setup
+- Comprehensive capability needed
+
+### When to Recommend Individual Skill Usage
+- Specific one-time task
+- Already have plugin installed
+- Just need one capability
+
+---
+
+## Checking Installed Plugins
+
+```bash
+# List installed plugins
+claude plugins list
+
+# Check available skills
+claude skills list
+```
+
+---
+
+## Custom Plugin Development
+
+For teams wanting to bundle their own skills:
+
+| Recommend When | Examples |
+|----------------|----------|
+| Company-specific workflows | Internal processes |
+| Team best practices | Shared patterns |
+| Domain expertise | Industry knowledge |
+| Tool integrations | Internal tools |
+
+Use the **skill-creator** skill to build individual skills, then bundle them into a plugin for team distribution.
+
+---
+
+## Quick Reference
+
+| Need | Recommended Plugin/Skill |
+|------|-------------------------|
+| General productivity | anthropic-agent-skills (full bundle) |
+| Document creation | docx, xlsx, pptx, pdf skills |
+| Frontend work | frontend-design plugin |
+| Testing | webapp-testing skill |
+| Building tools | mcp-builder skill |
+| Custom workflows | skill-creator skill |

plugins/claude-code-setup/skills/claude-automation-recommender/references/skills-reference.md

@@ -0,0 +1,216 @@
+# Skills Recommendations
+
+Skills are packaged expertise with workflows, reference materials, and best practices that Claude can invoke for specialized tasks.
+
+## Built-in Agents
+
+### Plan Agent
+**Best for**: Complex implementations needing architectural planning
+
+| Recommend When | Examples |
+|----------------|----------|
+| Multi-file changes needed | New feature development |
+| Architectural decisions | System design |
+| Unknown scope | Needs investigation first |
+| Multiple valid approaches | Trade-off analysis |
+
+**Value**: Thinks through implementation before coding, identifies files to change, considers edge cases.
+
+### Explore Agent
+**Best for**: Understanding large or unfamiliar codebases
+
+| Recommend When | Examples |
+|----------------|----------|
+| Large codebase (>500 files) | Navigate efficiently |
+| New to the project | Understand structure |
+| Finding patterns | How is X done? |
+| Debugging | Trace execution paths |
+
+**Value**: Quickly searches, reads, and synthesizes information across many files.
+
+---
+
+## Document Creation Skills
+
+### docx (Word Documents)
+**Best for**: Creating and editing Word documents
+
+| Recommend When | Examples |
+|----------------|----------|
+| Report generation | Technical reports |
+| Contract templates | Legal documents |
+| Documentation export | Share with non-developers |
+| Tracked changes | Review workflows |
+
+### xlsx (Spreadsheets)
+**Best for**: Creating and analyzing Excel files
+
+| Recommend When | Examples |
+|----------------|----------|
+| Data analysis | Process CSV/Excel data |
+| Report generation | Formatted tables |
+| Financial models | Formulas and calculations |
+| Data transformation | Clean and reshape data |
+
+### pptx (Presentations)
+**Best for**: Creating PowerPoint presentations
+
+| Recommend When | Examples |
+|----------------|----------|
+| Technical presentations | Architecture diagrams |
+| Project updates | Status slides |
+| Demo decks | Feature walkthroughs |
+| Training materials | Educational content |
+
+### pdf (PDF Documents)
+**Best for**: PDF manipulation and creation
+
+| Recommend When | Examples |
+|----------------|----------|
+| Form filling | Complete PDF forms |
+| Document merging | Combine files |
+| Text extraction | Parse PDF content |
+| PDF generation | Create from data |
+
+---
+
+## Frontend & Design Skills
+
+### frontend-design
+**Best for**: Creating polished, production-ready UI components
+
+| Recommend When | Examples |
+|----------------|----------|
+| UI component work | React, Vue, Angular |
+| Landing pages | Marketing sites |
+| Dashboard design | Data visualization |
+| Design system work | Component libraries |
+
+**Value**: Creates distinctive, high-quality UI instead of generic AI aesthetics.
+
+### canvas-design
+**Best for**: Creating visual art and static designs
+
+| Recommend When | Examples |
+|----------------|----------|
+| Poster creation | Marketing materials |
+| Visual diagrams | Architecture visuals |
+| Infographics | Data visualization |
+
+### algorithmic-art
+**Best for**: Generative art with p5.js
+
+| Recommend When | Examples |
+|----------------|----------|
+| Interactive visuals | Creative coding |
+| Generative patterns | Flow fields, particles |
+| Data art | Algorithmic visualization |
+
+### theme-factory
+**Best for**: Applying themes to artifacts
+
+| Recommend When | Examples |
+|----------------|----------|
+| Brand consistency | Apply company colors |
+| Document styling | Professional look |
+| Presentation themes | Consistent decks |
+
+### brand-guidelines
+**Best for**: Applying Anthropic brand styling
+
+| Recommend When | Examples |
+|----------------|----------|
+| Anthropic materials | Official branding |
+| Partner materials | Co-branded content |
+
+---
+
+## Development Skills
+
+### mcp-builder
+**Best for**: Creating MCP servers to extend Claude
+
+| Recommend When | Examples |
+|----------------|----------|
+| Custom tool needs | Internal APIs |
+| API integrations | Third-party services |
+| Workflow automation | Custom tooling |
+
+**Value**: Guides creation of well-designed MCP servers in Python (FastMCP) or TypeScript.
+
+### webapp-testing
+**Best for**: Testing web applications with Playwright
+
+| Recommend When | Examples |
+|----------------|----------|
+| UI testing needs | Verify functionality |
+| Visual debugging | Screenshot issues |
+| Browser automation | Interactive testing |
+| Console log analysis | Debug JS errors |
+
+### skill-creator
+**Best for**: Creating new skills for Claude
+
+| Recommend When | Examples |
+|----------------|----------|
+| Repeatable workflows | Standardize processes |
+| Domain expertise | Package knowledge |
+| Team patterns | Share best practices |
+
+---
+
+## Collaboration Skills
+
+### doc-coauthoring
+**Best for**: Co-authoring documentation with users
+
+| Recommend When | Examples |
+|----------------|----------|
+| Technical specs | RFC documents |
+| Decision docs | ADRs |
+| Proposals | Feature proposals |
+| Documentation | User guides |
+
+**Value**: Structured workflow for iterative document refinement.
+
+### internal-comms
+**Best for**: Writing internal communications
+
+| Recommend When | Examples |
+|----------------|----------|
+| Status reports | Project updates |
+| Announcements | Team comms |
+| Incident reports | Post-mortems |
+| FAQs | Knowledge sharing |
+
+---
+
+## Multimedia Skills
+
+### slack-gif-creator
+**Best for**: Creating animated GIFs for Slack
+
+| Recommend When | Examples |
+|----------------|----------|
+| Team celebrations | Achievements |
+| Demo animations | Feature previews |
+| Fun reactions | Custom emoji-style GIFs |
+
+---
+
+## Quick Reference: Detection Patterns
+
+| Look For | Suggests Skill |
+|----------|---------------|
+| Complex task, multiple files | Plan agent |
+| "How does X work?" | Explore agent |
+| `.docx` files or doc requests | docx skill |
+| `.xlsx` files or spreadsheet work | xlsx skill |
+| Presentation needs | pptx skill |
+| PDF files to process | pdf skill |
+| React/Vue/Angular components | frontend-design |
+| UI design requests | canvas-design |
+| Testing local web app | webapp-testing |
+| "Build an MCP server" | mcp-builder |
+| Documentation writing | doc-coauthoring |
+| Internal announcement | internal-comms |

plugins/claude-code-setup/skills/claude-automation-recommender/references/slash-command-examples.md

@@ -0,0 +1,251 @@
+# Slash Command Recommendations
+
+Slash commands are quick, repeatable prompts with optional arguments. They're ideal for frequently used workflows that don't need the overhead of a subagent.
+
+## Code Review Commands
+
+### /pr-review
+**Best for**: Reviewing current branch changes
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Git-based workflow | `.git/` directory |
+| PR-driven development | GitHub/GitLab remote |
+| Regular code reviews | Team process |
+
+**Value**: Quick review of PR changes with actionable feedback
+
+---
+
+### /quick-review
+**Best for**: Fast review of a specific file
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Single file review needs | Ad-hoc reviews |
+| Pre-commit checks | Before committing |
+
+**Value**: Focused review without full PR context
+
+---
+
+## Testing Commands
+
+### /test
+**Best for**: Running tests for a specific file or pattern
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Jest configured | `jest.config.js`, package.json |
+| pytest configured | `pytest.ini`, pyproject.toml |
+| vitest configured | `vitest.config.js` |
+| Test directory exists | `tests/`, `__tests__/` |
+
+**Value**: Quick test runs with failure analysis
+
+---
+
+### /test-file
+**Best for**: Generating tests for a specific file
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Test framework present | Testing deps installed |
+| Source files without tests | Missing test coverage |
+
+**Value**: Generates tests following project conventions
+
+---
+
+## Documentation Commands
+
+### /doc
+**Best for**: Generating documentation for code
+
+| Recommend When | Detection |
+|----------------|-----------|
+| JSDoc/docstring patterns | Existing doc style |
+| API code | Public functions/classes |
+
+**Value**: Consistent documentation format
+
+---
+
+### /api-doc
+**Best for**: Documenting API endpoints
+
+| Recommend When | Detection |
+|----------------|-----------|
+| REST endpoints | Express, FastAPI routes |
+| OpenAPI/Swagger | Existing spec files |
+| Undocumented APIs | Routes without docs |
+
+**Value**: Generates endpoint docs with examples
+
+---
+
+### /changelog
+**Best for**: Updating changelog with recent changes
+
+| Recommend When | Detection |
+|----------------|-----------|
+| CHANGELOG.md exists | Changelog present |
+| Release workflow | Semantic versioning |
+
+**Value**: Categorized changelog entries
+
+---
+
+## Debugging Commands
+
+### /debug
+**Best for**: Investigating issues in code
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Bug reports common | Active development |
+| Complex codebase | Many files/dependencies |
+
+**Value**: Systematic debugging approach
+
+---
+
+### /ci-fix
+**Best for**: Debugging CI/CD failures
+
+| Recommend When | Detection |
+|----------------|-----------|
+| CI configured | `.github/workflows/`, `.circleci/` |
+| Frequent CI failures | Active CI pipeline |
+
+**Value**: Reproduces and fixes CI issues
+
+---
+
+## Refactoring Commands
+
+### /refactor
+**Best for**: Improving code structure
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Legacy code | Old patterns detected |
+| Code smells | Long files, complex functions |
+
+**Value**: Guided refactoring with explanations
+
+---
+
+### /extract
+**Best for**: Extracting reusable code
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Code duplication | Similar patterns |
+| Long functions | Needs decomposition |
+
+**Value**: Creates clean extractions with proper types
+
+---
+
+## Project Commands
+
+### /init-claude
+**Best for**: Setting up Claude Code configuration
+
+| Recommend When | Detection |
+|----------------|-----------|
+| No `.claude/` directory | New project setup |
+| No CLAUDE.md | Missing context |
+
+**Value**: Creates complete Claude Code setup
+
+---
+
+### /setup
+**Best for**: Developer environment setup
+
+| Recommend When | Detection |
+|----------------|-----------|
+| New developer onboarding | README instructions |
+| Complex setup | Multiple steps needed |
+
+**Value**: Automated environment setup
+
+---
+
+## Utility Commands
+
+### /explain
+**Best for**: Understanding code
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Complex codebase | New to project |
+| Legacy code | Undocumented patterns |
+
+**Value**: Clear explanations without jargon
+
+---
+
+### /find
+**Best for**: Locating code by description
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Large codebase | Many files |
+| Unfamiliar structure | New to project |
+
+**Value**: Finds code by concept, not just text
+
+---
+
+## Quick Reference: Detection → Recommendation
+
+| If You See | Recommend Command |
+|------------|------------------|
+| Git repository | /pr-review |
+| Test framework | /test |
+| Test gaps | /test-file |
+| API routes | /api-doc |
+| CHANGELOG.md | /changelog |
+| CI/CD config | /ci-fix |
+| Complex code | /explain |
+| Large codebase | /find |
+| No .claude/ | /init-claude |
+
+---
+
+## Slash Command Placement
+
+Commands go in `.claude/commands/`:
+
+```
+.claude/
+└── commands/
+    ├── test.md
+    ├── pr-review.md
+    └── explain.md
+```
+
+---
+
+## Argument Patterns
+
+| Pattern | Meaning | Example |
+|---------|---------|---------|
+| `<arg>` | Required | `<file-path>` |
+| `[arg]` | Optional | `[branch-name]` |
+| `$ARGUMENTS` | All args as string | Full input |
+| `$1`, `$2` | Positional args | First, second arg |
+
+---
+
+## Tool Restrictions Guide
+
+| Use Case | Restrict To |
+|----------|------------|
+| Read-only | Read, Grep, Glob |
+| Can edit | + Write |
+| Can run commands | + Bash |
+| Full access | Omit restriction |

plugins/claude-code-setup/skills/claude-automation-recommender/references/subagent-templates.md

@@ -0,0 +1,179 @@
+# Subagent Recommendations
+
+Subagents are specialized Claude instances that run in parallel, each with their own context window and tool access. They're ideal for focused reviews, analysis, or generation tasks.
+
+## Code Review Agents
+
+### code-reviewer
+**Best for**: Automated code quality checks on large codebases
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Large codebase (>500 files) | File count |
+| Frequent code changes | Active development |
+| Team wants consistent review | Quality focus |
+
+**Value**: Runs code review in parallel while you continue working
+**Model**: sonnet (balanced quality/speed)
+**Tools**: Read, Grep, Glob, Bash
+
+---
+
+### security-reviewer
+**Best for**: Security-focused code review
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Auth code present | `auth/`, `login`, `session` patterns |
+| Payment processing | `stripe`, `payment`, `billing` patterns |
+| User data handling | `user`, `profile`, `pii` patterns |
+| API keys in code | Environment variable patterns |
+
+**Value**: Catches OWASP vulnerabilities, auth issues, data exposure
+**Model**: sonnet
+**Tools**: Read, Grep, Glob (read-only for safety)
+
+---
+
+### test-writer
+**Best for**: Generating comprehensive test coverage
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Low test coverage | Few test files vs source files |
+| Test suite exists | `tests/`, `__tests__/` present |
+| Testing framework configured | jest, pytest, vitest in deps |
+
+**Value**: Generates tests matching project conventions
+**Model**: sonnet
+**Tools**: Read, Write, Grep, Glob
+
+---
+
+## Specialized Agents
+
+### api-documenter
+**Best for**: API documentation generation
+
+| Recommend When | Detection |
+|----------------|-----------|
+| REST endpoints | Express routes, FastAPI paths |
+| GraphQL schema | `.graphql` files |
+| OpenAPI exists | `openapi.yaml`, `swagger.json` |
+| Undocumented APIs | Routes without docs |
+
+**Value**: Generates OpenAPI specs, endpoint documentation
+**Model**: sonnet
+**Tools**: Read, Write, Grep, Glob
+
+---
+
+### performance-analyzer
+**Best for**: Finding performance bottlenecks
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Database queries | ORM usage, raw SQL |
+| High-traffic code | API endpoints, hot paths |
+| Performance complaints | User reports slowness |
+| Complex algorithms | Nested loops, recursion |
+
+**Value**: Finds N+1 queries, O(n²) algorithms, memory leaks
+**Model**: sonnet
+**Tools**: Read, Grep, Glob, Bash
+
+---
+
+### ui-reviewer
+**Best for**: Frontend accessibility and UX review
+
+| Recommend When | Detection |
+|----------------|-----------|
+| React/Vue/Angular | Frontend framework detected |
+| Component library | `components/` directory |
+| User-facing UI | Not just API project |
+
+**Value**: Catches accessibility issues, UX problems, responsive design gaps
+**Model**: sonnet
+**Tools**: Read, Grep, Glob
+
+---
+
+## Utility Agents
+
+### dependency-updater
+**Best for**: Safe dependency updates
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Outdated deps | `npm outdated` has results |
+| Security advisories | `npm audit` warnings |
+| Major version behind | Significant version gaps |
+
+**Value**: Updates dependencies incrementally with testing
+**Model**: sonnet
+**Tools**: Read, Write, Bash, Grep
+
+---
+
+### migration-helper
+**Best for**: Framework/version migrations
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Major upgrade needed | Framework version very old |
+| Breaking changes coming | Deprecation warnings |
+| Refactoring planned | Architectural changes |
+
+**Value**: Plans and executes migrations incrementally
+**Model**: opus (complex reasoning needed)
+**Tools**: Read, Write, Grep, Glob, Bash
+
+---
+
+## Quick Reference: Detection → Recommendation
+
+| If You See | Recommend Subagent |
+|------------|-------------------|
+| Large codebase | code-reviewer |
+| Auth/payment code | security-reviewer |
+| Few tests | test-writer |
+| API routes | api-documenter |
+| Database heavy | performance-analyzer |
+| Frontend components | ui-reviewer |
+| Outdated packages | dependency-updater |
+| Old framework version | migration-helper |
+
+---
+
+## Subagent Placement
+
+Subagents go in `.claude/agents/`:
+
+```
+.claude/
+└── agents/
+    ├── code-reviewer.md
+    ├── security-reviewer.md
+    └── test-writer.md
+```
+
+---
+
+## Model Selection Guide
+
+| Model | Best For | Trade-off |
+|-------|----------|-----------|
+| **haiku** | Simple, repetitive checks | Fast, cheap, less thorough |
+| **sonnet** | Most review/analysis tasks | Balanced (recommended default) |
+| **opus** | Complex migrations, architecture | Thorough, slower, more expensive |
+
+---
+
+## Tool Access Guide
+
+| Access Level | Tools | Use Case |
+|--------------|-------|----------|
+| Read-only | Read, Grep, Glob | Reviews, analysis |
+| Writing | + Write | Code generation, docs |
+| Full | + Bash | Migrations, testing |