- Os desenvolvedores agora estão na fase de aprender como colaborar com IA, e o valor do Claude é maximizado quando ele é usado não como um simples chatbot, mas como um framework
- Na comunidade, seguem surgindo várias tentativas sobre como configurar e usar o Claude, a ponto de isso ser chamado de Claude Code Framework Wars, tamanho o nível de experimentação
- Com isso, está se formando um fluxo em que o Claude é usado em vários papéis, como gerente de projeto, arquiteto, desenvolvedor e revisor
- O design de um framework exige 8 decisões principais, incluindo gestão de tarefas, fornecimento de diretrizes, colaboração entre agentes, operação de sessões, acesso a ferramentas, desenvolvimento de código, entrega e preservação de contexto
- A principal lição é que a IA não substitui o desenvolvedor, mas se consolida como uma colega de equipe que multiplica a produtividade por meio de regras e papéis estruturados
Introdução
- Ideia central: considerar o Claude não como uma simples ferramenta de conversa, mas como um framework, gerando resultados previsíveis e valiosos por meio de regras claras e fluxos de trabalho
- O desenvolvedor deixa de focar em codificação e passa para papéis de maior valor agregado (gestão de projeto, design, arquitetura)
- O framework do Claude Code funciona com prompts estruturados sem necessidade de escrever código
- Claude Code Framework Wars: a comunidade de desenvolvedores está experimentando várias abordagens para usar IA de forma produtiva
- Dezenas de projetos open source competem definindo fluxos de trabalho e estruturas de papéis
- Ex.: Agent OS, Claude-Flow
Principais escolhas a considerar ao projetar um framework
1. Onde gerenciar as tarefas
- É necessário definir a fonte de tarefas que o Claude poderá consultar
- Backlog em Markdown: gerenciar tarefas como listas de afazeres em Markdown
- Texto estruturado: converter especificações de produto em tarefas
- Issues/tickets: armazenar especificações em GitHub Issues ou tickets do Jira, conectando com revisão de código
- Essencial: as tarefas precisam estar armazenadas em um local acessível e rastreável pelo Claude
2. Como fornecer guias ao Claude
- Em vez de prompts vagos, fornecer instruções ao Claude com uma estrutura clara
- Biblioteca de comandos: comandos slash predefinidos, como /create-tasks e /review
- Padrões de codificação: explicitar a stack técnica e as diretrizes de código
- Definição de concluído: codificar os critérios de conclusão de uma tarefa
- Hooks de validação por gatilho: forçar lint e testes em toda mudança
- Claude como revisor: o Claude executa desenvolvimento e revisão ao mesmo tempo
- Essencial: regras claras e repetíveis melhoram a qualidade do trabalho do Claude
3. Estrutura de colaboração entre agentes
- Ao usar vários agentes Claude, a coordenação acontece por meio de papéis e planejamento
- Simulação de papéis: a IA atua como PM, arquiteto, desenvolvedor e testador
- Processamento paralelo em swarm: execução simultânea de vários agentes em um fluxo estruturado que vai de especificação → pseudocódigo → código → testes
- Artefatos nativos do repositório: armazenar tarefas, logs e registros de decisão (ADR) no codebase para manter a memória
- Essencial: a coordenação evita conflitos entre vários trabalhadores de IA
4. Como operar sessões
- Para evitar confusão na saída da IA, definir sessões como ambiente de trabalho
- Orquestração de terminal: o Claude controla comandos, janelas e logs
- Worktrees em paralelo: executar várias branches em paralelo com Git Worktrees
- Containers em paralelo: executar o Claude em containers independentes para evitar conflitos
- Essencial: o trabalho paralelo maximiza a produtividade sem conflitos
4. Como executar sessões
- Para evitar confusão na saída da IA, definir sessões como ambiente de trabalho
- Orquestração de terminal: o Claude controla comandos, janelas e logs
- Worktrees em paralelo: executar várias branches em paralelo com Git Worktrees
- Containers em paralelo: executar o Claude em containers independentes para evitar conflitos
- Essencial: o trabalho paralelo maximiza a produtividade sem conflitos
5. Acesso do Claude a ferramentas
- Configurar o Claude para aproveitar conhecimento sobre toda a stack técnica
- Integração MCP: conectar navegador, banco de dados, runner de testes e framework de automação de UI
- Biblioteca de ferramentas personalizadas: construída com shell scripts e comandos
- Acessor de banco de dados: ferramenta poderosa de acesso a banco de dados
- Hooks de teste e validação: executar testes com Vitest, Jest etc. antes de concluir a tarefa
- Essencial: a integração com ferramentas transforma o Claude de simples autocompletar em um membro ativo da equipe
6. Como desenvolver código
- O Claude pode assumir diferentes papéis conforme a necessidade
- Gerente de projeto (PM): converter especificações de produto em tarefas e backlog
- Arquiteto: projetar a estrutura geral, definir interfaces e estabelecer regras antes da codificação
- Implementador: escrever código de acordo com testes e padrões
- QA: revisar problemas nas tarefas
- Revisor: auditar qualidade do PR, legibilidade e riscos
- Essencial: usar IA em todo o ciclo de vida do software
7. Como entregar o código
- Definir como o código chega ao repositório
- Pequenos diffs: a IA processa tickets e cria PRs pequenos, sempre com revisão
- Experimentos: implantar mudanças atrás de feature flags
- Scaffold de app completo: construir e implantar um app inteiro a partir de prompts de alto nível
- Essencial: escolher entre iteração segura para produção ou scaffold para protótipos
8. Como preservar contexto
- Resolver o problema de esquecimento do Claude com memória do framework
- Documentos e diário: manter atualizados CLAUDE.md, notas de arquitetura e diário do projeto
- Memória persistente e checkups: resumir trabalhos recentes, verificar a saúde do projeto e salvar decisões
- Essencial: sem memória, a IA repete erros; com memória, o progresso se torna cumulativo
Caminhos de integração
- Tratar as opções como um menu, sem necessidade de configurar tudo de uma vez
- Configuração iniciante: backlog em Markdown + diffs por ticket
- Equipe estruturada: especificações de produto + padrões + simulação de papéis
- Foco em experimentação: artefatos no repositório + sessões paralelas
- Modo protótipo: app builder + scaffold de documentação
Conclusão e implicações
- Lição principal: o Claude entrega seu melhor desempenho em um ambiente estruturado
- Em vez de substituir o papel do desenvolvedor, ele reduz trabalho boilerplate e permite foco em definição de especificações, revisão de design e definição de arquitetura
- Se o trabalho sai dos trilhos, pode descarrilar rapidamente; gestão estrutural é essencial
- Ainda estamos em estágio inicial, mas os frameworks fazem a IA convergir de uma caixa mágica para um conjunto de membros de equipe gerenciáveis
- Quanto mais estrutura se fornece, maior o valor retornado
- Por meio de projetos open source, a comunidade experimenta vários frameworks e busca formas produtivas de usar IA
- Os desenvolvedores podem usar o Claude de forma sistemática para focar em trabalhos de maior valor agregado e integrar a IA como membro da equipe, maximizando a produtividade
Ainda não há comentários.