Recomendador de Automação Claude

O que Recomendador de Automação Claude faz?

Analise padrões de base de código para recomendar automações Claude Code personalizadas em todas as opções de extensibilidade.

Este skill é somente leitura. Ele analisa a base de código e gera recomendações. Ele NÃO cria nem modifica nenhum arquivo. Os usuários implementam as recomendações por conta própria ou pedem ajuda ao Claude separadamente para construí-las.

Diretrizes de Saída

• Recomende 1-2 de cada tipo: Não sobrecarregue - destaque as 1-2 automações mais valiosas por categoria
• Se o usuário pedir um tipo específico: Foque apenas nesse tipo e forneça mais opções (3-5 recomendações)
• Vá além das listas de referência: Os arquivos de referência contêm padrões comuns, mas use pesquisa na web para encontrar recomendações específicas para as ferramentas, frameworks e bibliotecas da base de código
• Diga aos usuários que podem pedir mais: Termine observando que eles podem solicitar mais recomendações para qualquer categoria específica

Visão Geral dos Tipos de Automação

Tipo	Melhor Para
Hooks	Ações automáticas em eventos de ferramenta (formatar ao salvar, lint, bloquear edições)
Subagentes	Revisores/analisadores especializados que executam em paralelo
Skills	Expertise empacotada, fluxos de trabalho e tarefas repetíveis (invocados pelo Claude ou pelo usuário via /nome-do-skill)
Plugins	Coleções de skills que podem ser instaladas
Servidores MCP	Integrações com ferramentas externas (bancos de dados, APIs, navegadores, documentação)

Fluxo de Trabalho

Fase 1: Análise da Base de Código

Reúna o contexto do projeto:

# Detecta o tipo de projeto e ferramentas
ls -la package.json pyproject.toml Cargo.toml go.mod pom.xml 2>/dev/null
cat package.json 2>/dev/null | head -50

# Verifica dependências para recomendações de servidores MCP
cat package.json 2>/dev/null | grep -E '"(react|vue|angular|next|express|fastapi|django|prisma|supabase|convex|stripe)"'

# Verifica configuração existente do Claude Code
ls -la .claude/ CLAUDE.md 2>/dev/null

# Analisa estrutura do projeto
ls -la src/ app/ lib/ tests/ components/ pages/ api/ 2>/dev/null

Indicadores-Chave a Capturar:

Categoria	O Que Procurar	Informa Recomendações Para
Linguagem/Framework	package.json, pyproject.toml, padrões de import	Hooks, servidores MCP
Stack frontend	React, Vue, Angular, Next.js	Playwright MCP, skills frontend
Stack backend	Express, FastAPI, Django	Ferramentas de documentação de API
Banco de dados	Prisma, Supabase, Convex, SQL puro	Servidores MCP de banco de dados / backend
APIs externas	Stripe, OpenAI, AWS SDKs	context7 MCP para documentação
Testes	Jest, pytest, configs Playwright	Hooks de teste, subagentes
CI/CD	GitHub Actions, CircleCI	GitHub MCP server
Rastreamento de issues	Linear, referências Jira	MCP de rastreador de issues
Padrões de doc	OpenAPI, JSDoc, docstrings	Skills de documentação

Fase 2: Gerar Recomendações

Com base na análise, gere recomendações em todas as categorias:

A. Recomendações de Servidores MCP

Consulte references/mcp-servers.md para padrões detalhados.

Sinal da Base de Código	Servidor MCP Recomendado
Usa bibliotecas populares (React, Express, etc.)	context7 - Consulta de documentação ao vivo
Frontend com necessidade de testes de UI	Playwright - Automação/testes de navegador
Usa Supabase	Supabase MCP - Operações diretas no banco de dados
Usa Convex	Convex MCP - Introspecção de implantação ao vivo, executar consultas/mutações, gerenciar variáveis de ambiente e logs
Banco de dados PostgreSQL/MySQL	Database MCP - Ferramentas de consulta e esquema
Repositório GitHub	GitHub MCP - Issues, PRs, actions
Usa Linear para issues	Linear MCP - Gerenciamento de issues
Infraestrutura AWS	AWS MCP - Gerenciamento de recursos na nuvem
Espaço de trabalho Slack	Slack MCP - Notificações de equipe
Persistência de memória/contexto	Memory MCP - Memória entre sessões
Rastreamento de erros Sentry	Sentry MCP - Investigação de erros
Contêineres Docker	Docker MCP - Gerenciamento de contêineres

B. Recomendações de Skills

Consulte references/skills-reference.md para detalhes.

Crie skills em .claude/skills/<nome>/SKILL.md. Alguns também estão disponíveis via plugins:

Sinal da Base de Código	Skill	Plugin
Construindo plugins	skill-development	plugin-dev
Commits Git	commit	commit-commands
React/Vue/Angular	frontend-design	frontend-design
Regras de automação	writing-rules	hookify
Planejamento de funcionalidades	feature-dev	feature-dev

Skills personalizados a criar (com templates, scripts, exemplos):

Sinal da Base de Código	Skill a Criar	Invocação
Rotas de API	api-doc (com template OpenAPI)	Ambos
Projeto de banco de dados	create-migration (com script de validação)	Somente usuário
Suíte de testes	gen-test (com exemplos de teste)	Somente usuário
Biblioteca de componentes	new-component (com templates)	Somente usuário
Fluxo de PR	pr-check (com checklist)	Somente usuário
Lançamentos	release-notes (com contexto git)	Somente usuário
Estilo de código	project-conventions	Somente Claude
Integração	setup-dev (com script de pré-requisitos)	Somente usuário

C. Recomendações de Hooks

Consulte references/hooks-patterns.md para configurações.

Sinal da Base de Código	Hook Recomendado
Prettier configurado	PostToolUse: auto-formatar ao editar
ESLint/Ruff configurado	PostToolUse: auto-lint ao editar
Projeto TypeScript	PostToolUse: verificação de tipos ao editar
Diretório de testes existe	PostToolUse: executar testes relacionados
Arquivos .env presentes	PreToolUse: bloquear edições de .env
Arquivos de lock presentes	PreToolUse: bloquear edições de arquivos de lock
Código sensível à segurança	PreToolUse: exigir confirmação

D. Recomendações de Subagentes

Consulte references/subagent-templates.md para templates.

Sinal da Base de Código	Subagente Recomendado
Base de código grande (>500 arquivos)	code-reviewer - Revisão de código em paralelo
Código de autenticação/pagamentos	security-reviewer - Auditorias de segurança
Projeto de API	api-documenter - Geração OpenAPI
Performance crítica	performance-analyzer - Detecção de gargalos
Foco em frontend	ui-reviewer - Revisão de acessibilidade
Precisa de mais testes	test-writer - Geração de testes

E. Recomendações de Plugins

Consulte references/plugins-reference.md para plugins disponíveis.

Sinal da Base de Código	Plugin Recomendado
Produtividade geral	anthropic-agent-skills - Pacote de skills principais
Fluxos de documentos	Instalar skills docx, xlsx, pdf
Desenvolvimento frontend	Plugin frontend-design
Construção de ferramentas de IA	mcp-builder para desenvolvimento MCP

Fase 3: Relatório de Recomendações de Saída

Formate as recomendações claramente. Inclua apenas 1-2 recomendações por categoria - as mais valiosas para esta base de código específica. Pule categorias que não são relevantes.

## Recomendações de Automação Claude Code

Analisei sua base de código e identifiquei as principais automações para cada categoria. Aqui estão minhas 1-2 principais recomendações por tipo:

### Perfil da Base de Código
- **Tipo**: [linguagem/runtime detectado]
- **Framework**: [framework detectado]
- **Principais Bibliotecas**: [bibliotecas relevantes detectadas]

---

### 🔌 Servidores MCP

#### context7
**Por que**: [motivo específico baseado nas bibliotecas detectadas]
**Instalar**: `claude mcp add context7`

---

### 🎯 Skills

#### [nome do skill]
**Por que**: [motivo específico]
**Criar**: `.claude/skills/[nome]/SKILL.md`
**Invocação**: Somente usuário / Ambos / Somente Claude
**Também disponível em**: plugin [nome-do-plugin] (se aplicável)
```yaml
---
name: [nome-do-skill]
description: [o que faz]
disable-model-invocation: true  # para somente usuário
---

---

⚡ Hooks

[nome do hook]

Por que: [motivo específico baseado na configuração detectada] Onde: .claude/settings.json

---

🤖 Subagentes

[nome do agente]

Por que: [motivo específico baseado nos padrões da base de código] Onde: .claude/agents/[nome].md

---

Quer mais? Peça recomendações adicionais para qualquer categoria específica (por exemplo, "mostre-me mais opções de servidores MCP" ou "quais outros hooks ajudariam?").

Quer ajuda para implementar algum destes? Basta pedir e posso ajudar você a configurar qualquer uma das recomendações acima.

## Estrutura de Decisão

### Quando Recomendar Servidores MCP
- Necessidade de integração com serviço externo (bancos de dados, APIs)
- Consulta de documentação para bibliotecas/SDKs
- Automação ou teste de navegador
- Integração com ferramentas de equipe (GitHub, Linear, Slack)
- Gerenciamento de infraestrutura em nuvem

### Quando Recomendar Skills

- Geração de documentos (docx, xlsx, pptx, pdf — também em plugins)
- Prompts ou fluxos de trabalho repetidos com frequência
- Tarefas específicas do projeto com argumentos
- Aplicar templates ou scripts a tarefas (skills podem empacotar arquivos de suporte)
- Ações rápidas invocadas com `/nome-do-skill`
- Fluxos de trabalho que devem ser executados em isolamento (`context: fork`)

**Controle de invocação:**
- `disable-model-invocation: true` — Somente usuário (para efeitos colaterais: implantar, commitar, enviar)
- `user-invocable: false` — Somente Claude (para conhecimento de fundo)
- Padrão (omitir ambos) — Ambos podem invocar

### Quando Recomendar Hooks
- Ações repetitivas após edição (formatação, lint)
- Regras de proteção (bloquear edições de arquivos sensíveis)
- Verificações de validação (testes, verificação de tipos)

### Quando Recomendar Subagentes
- Expertise especializada necessária (segurança, performance)
- Fluxos de revisão em paralelo
- Verificações de qualidade em segundo plano

### Quando Recomendar Plugins
- Necessidade de múltiplos skills relacionados
- Desejo de pacotes de automação pré-embalados
- Padronização em toda a equipe

---

## Dicas de Configuração

### Configuração do Servidor MCP

**Compartilhamento em equipe**: Inclua `.mcp.json` no repositório para que toda a equipe receba os mesmos servidores MCP

**Depuração**: Use a flag `--mcp-debug` para identificar problemas de configuração

**Pré-requisitos a recomendar:**
- GitHub CLI (`gh`) - habilita operações nativas do GitHub
- Puppeteer/Playwright CLI - para servidores MCP de navegador

### Modo Headless (para CI/Automação)

Recomende Claude headless para pipelines automatizados:

```bash
# Exemplo de hook de pré-commit
claude -p "corrigir erros de lint em src/" --allowedTools Edit,Write

# Pipeline de CI com saída estruturada
claude -p "<prompt>" --output-format stream-json | seu_comando

Permissões para Hooks

Configure as ferramentas permitidas em .claude/settings.json:

{
  "permissions": {
    "allow": ["Edit", "Write", "Bash(npm test:*)", "Bash(git commit:*)"]
  }
}