<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.

Fonte: Veracode 2025: 45% falham em segurança

?

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.

Voltar ao inícioVer evidências