🚀 Projetos Avancados

Arquivo markdown na raiz do projeto que Claude le automaticamente em cada sessao, fornecendo contexto sobre arquitetura, convencoes e regras do projeto.

Um CLAUDE.md bem escrito reduz drasticamente a necessidade de reexplicar contexto, economiza tokens e melhora a qualidade das respostas.

Memoria persistente, contexto automatico, hierarquia de arquivos (.claude/), sobrescrita de configuracoes.

Template otimizado com secoes para visao geral, stack tecnologico, estrutura de pastas, convencoes de codigo e comandos frequentes.

Uma estrutura consistente facilita a manutencao e garante que informacoes criticas estejam sempre acessiveis para Claude.

Secoes obrigatorias, ordem de prioridade, formato markdown, codigo de exemplo.

Tecnicas para transmitir maximo contexto com minimo de tokens, usando listas, tabelas e formatacao estrategica.

CLAUDE.md e lido em cada requisicao - um arquivo muito grande consome contexto valioso que poderia ser usado para a tarefa.

Densidade de informacao, eliminacao de redundancia, referencias a arquivos externos, lazy loading de contexto.

Sistema de heranca onde CLAUDE.md em subpastas pode complementar ou sobrescrever configuracoes do arquivo raiz.

Monorepos e projetos grandes precisam de contexto especifico por modulo sem poluir o arquivo principal.

Heranca de configuracao, merge de regras, isolamento de contexto, workspaces.

Estrategias para manter CLAUDE.md sincronizado com a evolucao do projeto, usando Git hooks e revisoes periodicas.

Um CLAUDE.md desatualizado pode levar Claude a tomar decisoes baseadas em informacoes obsoletas.

Changelog de contexto, triggers de atualizacao, revisao em PR, automacao de sync.

Exemplos reais de CLAUDE.md usados em projetos de diferentes portes e stacks tecnologicos.

Ver implementacoes reais inspira e acelera a criacao do seu proprio arquivo otimizado.

Templates por linguagem, padroes de projeto, integracao com documentacao existente.

Skills sao macros para prompts - encapsulam instrucoes complexas em comandos simples como /review ou /test.

Automatize tarefas repetitivas e garanta consistencia em fluxos de trabalho frequentes.

Comandos slash, arquivos markdown, $ARGUMENTS, skills globais vs projeto.

Skills ficam em ~/.claude/skills/ (globais) ou .claude/skills/ (projeto).

Organizar skills corretamente permite compartilhar com a equipe e manter consistencia.

Diretorios de skills, prioridade projeto sobre global, versionamento no Git.

Criar um skill de code review com checklist, formato de resposta e variaveis dinamicas.

Hands-on e a melhor forma de aprender - crie um skill funcional em minutos.

$ARGUMENTS, $SELECTION, $FILE, formato markdown, invocacao com /nome.

Skills que executam multiplas etapas sequenciais ou tomam decisoes baseadas em condicoes.

Fluxos complexos como TDD completo ou deploy com validacoes podem ser encapsulados.

Etapas sequenciais, logica condicional, composicao de skills.

Versionar skills de projeto no Git para toda equipe usar os mesmos fluxos.

Padronizacao acelera onboarding e garante qualidade consistente entre desenvolvedores.

.claude/skills/, README de skills, templates, seguranca de dados.

Colecao de skills prontos: /commit, /explain, /optimize e outros uteis.

Acelere sua produtividade com skills testados e aprovados pela comunidade.

Templates reutilizaveis, customizacao, melhores praticas.

Protocolo aberto que conecta Claude a fontes de dados externas de forma padronizada.

Expanda as capacidades do Claude alem do sistema de arquivos - acesse bancos, APIs e servicos.

Cliente (Claude), Server (bridge), Data Source, servidores disponiveis.

Configurar servidores MCP no arquivo ~/.claude/mcp.json com comandos e credenciais.

Setup correto e essencial para conectar Claude aos seus sistemas.

mcpServers, command, args, env, seguranca de credenciais.

Servidor MCP que permite Claude executar queries SQL no seu banco PostgreSQL.

Analise de dados, debugging e relatorios diretamente via conversa natural.

DATABASE_URL, usuarios read-only, queries seguras, casos de uso.

Conecte Claude ao GitHub para listar issues, analisar PRs e interagir com repositorios.

Gerencie seu workflow GitHub sem sair do terminal ou abrir o navegador.

GITHUB_TOKEN, operacoes de issues, operacoes de PRs, escopos de permissao.

Criar servidores MCP customizados em TypeScript para conectar a qualquer sistema interno.

Conecte Claude ao CRM, sistema de tickets, data warehouse ou qualquer API interna.

SDK MCP, tools/list, tools/call, StdioServerTransport.

Praticas de seguranca para MCP: usuarios read-only, tokens rotativos, auditoria.

MCP da acesso a dados sensiveis - seguranca e fundamental para evitar vazamentos.

Principio do menor privilegio, variaveis de ambiente, .gitignore, rotacao de tokens.

Pontos de extensao que executam scripts em momentos especificos: pre-edit, post-edit, pre-bash.

Automatize validacoes, backups, notificacoes e integracoes sem intervencao manual.

Pre-hooks (bloqueiam), post-hooks (notificam), eventos disponiveis.

Configurar hooks no settings.json ou criar scripts em .claude/hooks/ do projeto.

Entender a estrutura de configuracao permite criar hooks robustos e manutiveis.

command, timeout, failOnError, estrutura de diretorios.

Hook executado antes de editar arquivos - pode bloquear edicoes ou criar backups.

Proteja arquivos criticos como .env, schema.prisma, package-lock.json.

$CLAUDE_FILE, $CLAUDE_ACTION, exit codes, listas de protecao.

Hook executado apos edicoes - ideal para notificacoes, logs e integracoes externas.

Mantenha a equipe informada e tenha audit trail de todas mudancas.

Webhooks Slack, logs JSON, auto-format, git stage automatico.

Ultima linha de defesa antes de Claude executar comandos no terminal.

Bloqueie comandos destrutivos como rm -rf /, mkfs, dd antes que executem.

$CLAUDE_COMMAND, padroes bloqueados, alertas para sudo, camada extra.

Colecao de hooks prontos: auto-format com Prettier, git auto-stage, validacao TypeScript.

Use hooks testados pela comunidade e adapte para suas necessidades.

Organizacao modular, hooks.d/, orquestradores, composicao.

Instancias de Claude com system prompts especificos para tarefas especializadas.

Delegue tarefas complexas para especialistas sem poluir o contexto principal.

Especializacao, isolamento de contexto, delegacao, orquestracao.

Criar arquivos markdown em .claude/agents/ com name, description e system prompt.

Estruturar corretamente garante que o subagente tenha comportamento previsivel.

.claude/agents/, name, description, System Prompt, Regras, invocacao.

Subagente focado em gerar testes Jest seguindo padroes e convencoes do projeto.

Testes de alta qualidade gerados consistentemente, seguindo seu template.

Stack de testes, template de teste, checklist de cobertura, mocking.

Especialista em gerar READMEs, JSDoc, comentarios e guias de uso.

Documentacao clara e consistente em todo projeto, sem esforco manual.

Tipos de documentacao, template JSDoc, template README, exemplos.

Especialista em identificar vulnerabilidades e sugerir correcoes de seguranca.

Detecte SQL Injection, XSS, credenciais expostas antes de irem para producao.

OWASP Top 10, severidades, formato de relatorio, limitacoes (nao substitui pentest).

Diretrizes para criar e manter subagentes eficazes e organizados.

Evite armadilhas comuns como agentes muito genericos ou system prompts longos.

Foco, exemplos de output, versionamento, documentacao, templates.

Multiplas instancias de Claude trabalhando simultaneamente em partes diferentes do projeto.

Multiplique produtividade dividindo tarefas grandes em trabalho paralelo.

Paralelismo, isolamento, coordenacao, orquestrador, quando usar.

Diferentes formas de dividir trabalho: por pasta, por feature ou por tipo de tarefa.

Divisao correta evita conflitos e maximiza eficiencia do paralelismo.

Regra de ouro (nao editar mesmo arquivo), isolamento completo.

Usar Tmux para rodar multiplas sessoes Claude em paineis organizados.

Tmux e a forma mais simples de gerenciar varios agentes simultaneamente.

Script de setup, comandos tmux, layout de paineis, navegacao.

Estrategias para detectar e resolver conflitos quando surgem.

Conflitos mal gerenciados destroem o ganho de produtividade do paralelismo.

Branches por agente, commits frequentes, feature flags, interfaces antes.

Protocolo claro para comunicacao entre agentes e o orquestrador (voce).

Comunicacao estruturada evita confusao e garante coordenacao efetiva.

coordination.md, sinais (PAUSA, ESPERA, SYNC), status (DONE, BLOCKED).

Exemplo completo de refatoracao multi-agente: analise, divisao, execucao e integracao.

Ver um fluxo real de ponta a ponta consolida todos os conceitos.

Planejamento, divisao de tarefas, execucao paralela, merge, validacao.

Integrar Claude em CI/CD para automatizar code review, testes e analise de seguranca.

Automatize tarefas que antes exigiam intervencao humana em cada PR.

Triggers (push, PR), analise, feedback automatico, casos de uso.

Criar workflow que executa Claude em cada PR para code review automatico.

Setup pratico que voce pode usar imediatamente em seus repositorios.

Secrets (ANTHROPIC_API_KEY), permissoes, triggers, comentarios no PR.

Action que gera testes automaticamente quando label "needs-tests" e adicionada.

Nunca mais tenha PRs sem testes - Claude gera e abre novo PR com sugestoes.

Trigger por label, identificar arquivos sem teste, criar PR automatico.

Scan de seguranca que detecta vulnerabilidades e pode bloquear merge automaticamente.

Pegue SQL Injection, XSS e outras vulnerabilidades antes de irem para producao.

Output JSON, severidades, bloqueio automatico, branch protection.

Gerar changelog profissional baseado nos commits desde a ultima release.

Release notes claras e consistentes sem esforco manual.

Trigger on release, git log, categorizacao, Conventional Commits.

Estrategias para controlar custos de tokens em CI/CD: limitar arquivos, cache, throttle.

Claude em CI/CD pode consumir muitos tokens - otimize para manter custos controlaveis.

Apenas arquivos alterados, limite de linhas, monitoramento, estimativas.

Criar estrutura base do projeto TypeScript com CLAUDE.md otimizado.

Base solida e essencial - CLAUDE.md bem feito melhora todas as interacoes.

Estrutura de pastas, .claude/, template CLAUDE.md, convencoes.

Criar skills para as tarefas mais frequentes: review, teste e deploy.

Skills bem definidos padronizam qualidade e aceleram fluxos diarios.

Checklist, formato de resposta, variaveis, etapas condicionais.

Configurar subagente de seguranca focado em OWASP e vulnerabilidades de API.

Especialista em seguranca disponivel a qualquer momento para auditar codigo.

System prompt de seguranca, checklist OWASP, formato JSON de output.

Configurar hooks para proteger arquivos criticos e auto-formatar codigo.

Automacoes silenciosas que protegem e melhoram a qualidade do codigo.

Lista de protecao, backup automatico, auto-format, git stage.

Pipeline que roda lint, testes e Claude review em cada PR automaticamente.

Qualidade garantida em cada PR sem esforco manual da equipe.

Jobs sequenciais, diff de arquivos, comentario automatico, score.

Checklist completo para validar que todos componentes funcionam corretamente.

Garantir que o sistema esta pronto para uso em projetos reais.

Testes de integracao, validacao de hooks, verificacao de CI/CD.