<omh-perguntas-frequentes />
As perguntas que vão aparecer na sala.
Cada resposta traz o argumento e, quando existe, a fonte. Use como roteiro para defender o ecossistema em uma apresentação.
Isso não é burocracia? Vamos escrever mais do que programar.
O ritmo encolhe com o pedido: um typo não tem PRD, e a maioria dos pedidos usa dois tempos. O que se escreve é o que a IA precisaria perguntar — e sem isso ela supõe.
Fonte: Stack Overflow 2025: 66% recebem respostas “quase certas”
Os modelos estão melhorando. Isso não fica obsoleto?
Modelos maiores não melhoraram em segurança, e a IA amplifica o que a organização já é. Modelo melhor com contexto ruim entrega o erro mais rápido.
Fonte: Veracode 2025
Fonte: DORA 2025
Por que não basta um bom prompt ou um CLAUDE.md?
Em 58% dos ensaios o agente ignorou a ferramenta disponível. O que funciona é o que está no caminho dele: ofícios, regras, a estrutura de pastas e um hook no instante certo.
Fonte: Paipuru, CodeCompass, 2026
Quanto isso custa em tokens?
Multiagente usa mais tokens — cerca de 15x uma conversa. Por isso existe a rota Direto e o escopo fechado: cada ofício lê só o que precisa, e pedido pequeno não aciona ninguém.
Fonte: Anthropic Engineering, 2025
Funciona em sistema legado?
É onde mais ajuda. O research começa lendo o que existe; specs/ nasce documentando o sistema atual; src/ migra fatia a fatia, só quando alguém precisa mexer ali.
Fonte: METR 2025: o maior atrito foi em repositórios maduros
Precisamos reorganizar o src/ inteiro?
Não. Escolha a capacidade com mais dor, migre uma fatia, trave o padrão com verificação automática e siga por pressão de mudança. Nada de big bang.
E se o time não usar Claude Code?
specs/, changes/ e src/ são agnósticos: servem a qualquer agente e a qualquer pessoa. .claude/ é a camada que se adapta à ferramenta.
Como medimos se funcionou?
As métricas do DORA (frequência, lead time, falha de mudança, recuperação), o tempo de revisão de PR, a cobertura de diff e quantos diretórios uma correção abre.
Fonte: DORA 2024
Fonte: Faros AI, 2025
Quem mantém specs/ atualizado?
O próprio fluxo. O verify só fecha com specs/ refletindo o que a mudança tornou verdade — na mesma MR, pelo writer. Documentação não fica para depois.
Fonte: DORA: documentação multiplica o efeito das práticas técnicas
Isso tira a autonomia do desenvolvedor?
Não. Você entra em qualquer tempo, nomeia o ofício que quiser e o push sempre pede sua confirmação. O harness organiza; quem decide é você.
E a segurança do código gerado?
Regras nomeiam defeitos, o reviewer julga as 34 que nenhuma ferramenta pega, os quatro checks rodam antes de qualquer “pronto” e o push é sempre manual.
Por onde começamos amanhã?
Copie o .claude/, crie specs/ e changes/, e escreva o primeiro pedido em linguagem natural. O roteamento cuida do resto.
Pronto para apresentar?
Comece pelo paradoxo, mostre as quatro peças e feche com o fluxo.