Você sabe qual é a diferença entre a software house que usa IA pra “ajudar a codar” e a que está faturando 3x mais com o mesmo time?
Não é o modelo. Não é o plano da Anthropic. Não é nem o nível técnico dos devs.
É como eles configuram e usam a ferramenta.
E um desenvolvedor de Karachi, no Paquistão, acabou de organizar tudo isso num repositório que explodiu: 36.670 stars no GitHub, trending #1 em março de 2026, e hoje ainda está no top 10 diário.
Estou falando do claude-code-best-practice, criado pelo Shayan Rais. E se você lidera uma software house e ainda não viu isso, você está perdendo dinheiro.
O Que É o claude-code-best-practice
Não é um framework. Não é uma ferramenta. Não é mais um plugin.
É um guia-referência vivo — uma living reference implementation — que cataloga, organiza e exemplifica tudo o que você pode fazer com o Claude Code. Desde o básico (como configurar seu CLAUDE.md) até o avançado (como orquestrar times de agentes autônomos que fazem code review, escrevem testes e deployam).
O tagline diz tudo: “from vibe coding to agentic engineering”.
Vibe coding é quando você pede pro Claude “arruma esse bug aí” e torce pra dar certo. Agentic engineering é quando você tem subagentes especializados, skills reutilizáveis, hooks automáticos e workflows que rodam sozinhos.
A diferença? Estrutura. E esse repo te dá exatamente isso.
Os Números Que Impressionam
Vamos aos fatos:
- 36.670 stars no GitHub (e subindo)
- 3.400 forks — gente usando de verdade, não só dando star
- 336 commits de manutenção contínua
- 69 dicas práticas organizadas em 13 categorias
- 10 workflows catalogados de projetos com 600K+ stars combinados
- Sempre atualizado com a versão mais recente do Claude Code (v2.1.101)
- #1 trending mensal no GitHub em março/2026
O Shayan é top 1% poster nos subreddits r/ClaudeAI e r/ClaudeCode. O cara não só documenta — ele vive isso todo dia.
O Que Tem Dentro (E Por Que Importa Pra Sua Software House)
10 Conceitos Arquiteturais
O repo documenta os 10 building blocks do Claude Code como ninguém mais fez:
- Subagents — Agentes autônomos com contexto isolado e ferramentas próprias
- Commands — Templates de prompt reutilizáveis que você invoca com /
- Skills — Módulos de conhecimento configuráveis com progressive disclosure
- Workflows — Sequências orquestradas combinando commands + agents + skills
- Hooks — Scripts que rodam fora do loop do agente (pre/post tool use)
- MCP Servers — Conexões com ferramentas externas via Model Context Protocol
- Plugins — Bundles distribuíveis de skills + hooks + MCP + subagents
- Settings — Configuração hierárquica de permissões, modelos e sandboxing
- Memory — Contexto persistente via CLAUDE.md e auto-memory
- Checkpointing — Tracking automático com rewind via git
Cada um com explicação, exemplo funcional e padrão de uso.
10 Workflows De Projetos Top
Aqui é onde fica absurdo. O Shayan catalogou os workflows dos 10 maiores projetos do ecossistema Claude Code:
| Workflow | Stars | Diferencial |
|---|---|---|
| Everything Claude Code | 148K | 47 agentes, instinct scoring, AgentShield |
| Superpowers | 143K | TDD-first, Iron Laws |
| Spec Kit | 87K | Spec-driven, 22+ tools |
| gstack | 68K | Role personas, parallel sprints |
| Get Shit Done | 50K | Wave execution, XML plans |
| BMAD-METHOD | 44K | Full SDLC, 22+ plataformas |
| OpenSpec | 39K | Delta specs, brownfield support |
| oh-my-claudecode | 27K | Team orchestration |
| Compound Engineering | 14K | Compound learning framework |
| HumanLayer | 10K | Context engineering, 300K+ LOC |
Todos convergem no mesmo padrão: Research → Plan → Execute → Review → Ship.
Você não precisa inventar a roda. Pega um desses, adapta pro seu time, e pronto.
69 Dicas Que Mudam Tudo
As dicas estão organizadas em 13 categorias. Algumas que me chamaram atenção:
Sobre CLAUDE.md:
- Mantenha abaixo de 200 linhas
- Use tags `
` para regras de domínio - Divida instruções grandes em `.claude/rules/`
Sobre Agentes:
- Crie subagentes específicos por feature com skills dedicados
- Use test-time compute com contextos separados para QA
Sobre Workflows:
- Evite a “agent dumb zone” — quando o contexto está 50% compactado, o agente perde qualidade
- Use `/rewind` pra corrigir curso sem perder contexto
Sobre Git/PR:
- PRs pequenos (p50: 118 linhas) — always squash merge
- Commit a cada hora quando usando coding agents
- Tag @claude nos PRs do time para auto-linting
Sobre Produtividade:
- Voice prompting = 10x mais produtivo (sim, falar com o agente)
- Atualize o Claude Code diariamente — as features mudam rápido
As Features do Claude Code Que Estão Matando Startups
Isso aqui me assustou. O repo identifica features nativas do Claude Code que substituíram startups inteiras:
- Code Review → Matou Greptile, CodeRabbit, Devin Review
- Voice Dictation → Matou Wispr Flow, SuperWhisper
- Browser Automation → Matou Playwright/Chrome DevTools MCPs
- Computer Use → Compete diretamente com OpenAI CUA
Se você está construindo produto numa dessas categorias, presta atenção.
E se você é dono de software house, isso significa que coisas que antes custavam licenças mensais agora são grátis e nativas no seu coding agent.
Quem É o Shayan Rais
Shayan Rais é um Software Engineer de Karachi, Paquistão. MS em Computer Science pela NUCES FAST University (2019), BE em Computer Information Systems pela NED University (2014). Trabalha na disrupt.com.
A bio dele no GitHub? “i use claude code in light mode”. O cara tem senso de humor.
Além do claude-code-best-practice, ele criou o claude-code-hooks (integração de voz via hooks) e o codex-cli-best-practice (581 stars). É reconhecido como Anthropic Community Ambassador e Certified Architect.
O que me impressiona: ele não é um pesquisador em Stanford ou um VP no Google. É um engenheiro em Karachi que dominou a ferramenta e documentou tudo. Isso é a democratização que a IA promete.
O Padrão Que Toda Software House Deveria Seguir
O repo demonstra um padrão de orquestração limpo: Command → Agent → Skill.
Na prática: você cria um command (ex: `/deploy`), que aciona um agent especializado (ex: deployment-agent), que usa skills específicos (ex: docker-skill, aws-skill, test-skill).
Isso transforma seu Claude Code de um assistente burro em um time de agentes especializados que segue processo.
E as 13 “Billion-Dollar Questions” que o repo levanta — sobre limites da memória, seleção de agentes, e capacidades emergentes — mostram que o Shayan não está só documentando. Ele está pensando criticamente sobre onde isso tudo vai parar.
O Que Eu Penso
Na minha experiência com 300+ software houses, o gap entre quem usa IA e quem realmente extrai valor da IA é enorme.
A maioria dos donos de SH que conheço instalou o Claude Code, usou por uma semana, e voltou a codar do jeito antigo porque “não viu diferença”. Sabe por quê? Porque usaram como autocomplete. Pediram coisas genéricas, não configuraram nada, e desistiram.
O claude-code-best-practice é a resposta pra isso. É o manual que deveria ter vindo na caixa.
69 dicas. 10 workflows testados. 13 categorias. Tudo organizado, tudo com exemplo, tudo gratuito.
Se você tem 5 devs usando Claude Code sem uma estratégia, você está desperdiçando dinheiro. Pega esse repo, implementa um dos workflows, padroniza o CLAUDE.md do time, e mede a diferença em 30 dias.
Sou Thulio, mentoro 300+ SHs desde 2016.
