cue-ai 0.3.0 → 0.4.1

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

@@ -1,226 +0,0 @@
-# Hooks Recommendations
-
-Hooks automatically run commands in response to Claude Code events. They're ideal for enforcement and automation that should happen consistently.
-
-**Note**: These are common patterns. Use web search to find hooks for tools/frameworks not listed here to recommend the best hooks for the user.
-
-## 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 |
-
----
-
-## Notification Hooks
-
-Notification hooks run when Claude Code sends notifications. Use matchers to filter by notification type.
-
-### Permission Alerts
-| Matcher | Use Case |
-|---------|----------|
-| `permission_prompt` | Alert when Claude requests permissions |
-
-**Recommend**: Play sound, send desktop notification, or log permission requests
-**Value**: Never miss permission prompts when multitasking
-
-### Idle Notifications
-| Matcher | Use Case |
-|---------|----------|
-| `idle_prompt` | Alert when Claude is waiting for input (60+ seconds idle) |
-
-**Recommend**: Play sound or send notification when Claude needs attention
-**Value**: Know when Claude is ready for your input
-
-### Example Configuration
-
-```json
-{
-  "hooks": {
-    "Notification": [
-      {
-        "matcher": "permission_prompt",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "afplay /System/Library/Sounds/Ping.aiff"
-          }
-        ]
-      },
-      {
-        "matcher": "idle_prompt",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "osascript -e 'display notification \"Claude is waiting\" with title \"Claude Code\"'"
-          }
-        ]
-      }
-    ]
-  }
-}
-```
-
-### Available Matchers
-
-| Matcher | Triggers When |
-|---------|---------------|
-| `permission_prompt` | Claude needs permission for a tool |
-| `idle_prompt` | Claude waiting for input (60+ seconds) |
-| `auth_success` | Authentication succeeds |
-| `elicitation_dialog` | MCP tool needs input |
-
----
-
-## 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 |
-| Multitasking workflow | Notification hooks for alerts |
-
----
-
-## Hook Placement
-
-Hooks go in `.claude/settings.json`:
-
-```
-.claude/
-└── settings.json  ← Hook configurations here
-```
-
-Recommend creating the `.claude/` directory if it doesn't exist.

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

@@ -1,263 +0,0 @@
-# MCP Server Recommendations
-
-MCP (Model Context Protocol) servers extend Claude's capabilities by connecting to external tools and services.
-
-**Note**: These are common MCP servers. Use web search to find MCP servers specific to the codebase's services and integrations.
-
-## 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 |

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

@@ -1,98 +0,0 @@
-# Plugin Recommendations
-
-Plugins are installable collections of skills, commands, agents, and hooks. Install via `/plugin install`.
-
-**Note**: These are plugins from the official repository. Use web search to discover additional community plugins.
-
----
-
-## Official Plugins
-
-### Development & Code Quality
-
-| Plugin | Best For | Key Features |
-|--------|----------|--------------|
-| **plugin-dev** | Building Claude Code plugins | Skills for creating skills, hooks, commands, agents |
-| **pr-review-toolkit** | PR review workflows | Specialized review agents (code, tests, types) |
-| **code-review** | Automated code review | Multi-agent review with confidence scoring |
-| **code-simplifier** | Code refactoring | Simplify code while preserving functionality |
-| **feature-dev** | Feature development | End-to-end feature workflow with agents |
-
-### Git & Workflow
-
-| Plugin | Best For | Key Features |
-|--------|----------|--------------|
-| **commit-commands** | Git workflows | /commit, /commit-push-pr commands |
-| **hookify** | Automation rules | Create hooks from conversation patterns |
-
-### Frontend
-
-| Plugin | Best For | Key Features |
-|--------|----------|--------------|
-| **frontend-design** | UI development | Production-grade UI, avoids generic aesthetics |
-
-### Learning & Guidance
-
-| Plugin | Best For | Key Features |
-|--------|----------|--------------|
-| **explanatory-output-style** | Learning | Educational insights about code choices |
-| **learning-output-style** | Interactive learning | Requests contributions at decision points |
-| **security-guidance** | Security awareness | Warns about security issues when editing |
-
-### Language Servers (LSP)
-
-| Plugin | Language |
-|--------|----------|
-| **typescript-lsp** | TypeScript/JavaScript |
-| **pyright-lsp** | Python |
-| **gopls-lsp** | Go |
-| **rust-analyzer-lsp** | Rust |
-| **clangd-lsp** | C/C++ |
-| **jdtls-lsp** | Java |
-| **kotlin-lsp** | Kotlin |
-| **swift-lsp** | Swift |
-| **csharp-lsp** | C# |
-| **php-lsp** | PHP |
-| **lua-lsp** | Lua |
-
----
-
-## Quick Reference: Codebase → Plugin
-
-| Codebase Signal | Recommended Plugin |
-|-----------------|-------------------|
-| Building plugins | plugin-dev |
-| PR-based workflow | pr-review-toolkit |
-| Git commits | commit-commands |
-| React/Vue/Angular | frontend-design |
-| Want automation rules | hookify |
-| TypeScript project | typescript-lsp |
-| Python project | pyright-lsp |
-| Go project | gopls-lsp |
-| Security-sensitive code | security-guidance |
-| Learning/onboarding | explanatory-output-style |
-
----
-
-## Plugin Management
-
-```bash
-# Install a plugin
-/plugin install <plugin-name>
-
-# List installed plugins
-/plugin list
-
-# View plugin details
-/plugin info <plugin-name>
-```
-
----
-
-## When to Recommend Plugins
-
-**Recommend plugin installation when:**
-- User wants to install Claude Code automations from Anthropic's official repository or another shared marketplace
-- User needs multiple related capabilities
-- Team wants standardized workflows
-- First-time Claude Code setup