80% contexto, 20% execução: nossa filosofia com IA

Na LYPES, a gente usa IA todo dia. Pra escrever teste, pra gerar boilerplate, pra refatorar trecho que ninguém queria mexer. Mas tem uma coisa que a gente aprendeu na prática: o código que a IA gera é a parte fácil. O difícil — e onde mora 80% do valor — é o contexto que a gente dá pra ela.

O pulo do gato não é o prompt, é o contexto

Muita gente acha que desenvolvimento assistido por IA se resume a saber pedir. Escrever o prompt certo, com os detalhes certos. Em 2025, isso virou quase uma disciplina — prompt engineering, context engineering, um monte de termo novo. Mas a verdade é mais simples: se você não tem um projeto bem estruturado, com arquitetura definida e regras de negócio claras, não existe prompt que salve. A IA vai gerar código que compila, passa no lint, e faz a coisa errada com confiança.

Na LYPES, a gente separa em dois blocos. 80% é contexto: documentação de arquitetura, contratos de API, regras de qualidade, casos de borda mapeados, histórico de decisões. Os outros 20% é a execução: a IA escrevendo o código propriamente dito. Inverter essa proporção é garantia de retrabalho.

Código gerado sem arquitetura vira passivo técnico

Esse é o ponto que a gente mais alerta cliente. Uma IA bem intencionada gera código novo a cada prompt — e cada bloco gerado pode ignorar padrões que já existem no sistema. O resultado é uma base com três estilos diferentes de resolver o mesmo problema, nenhum seguindo as convenções do projeto.

É o equivalente digital de contratar um pedreiro novo toda semana sem passar o projeto. Cada um constrói um pedaço do jeito que sabe, e no final a parede não se alinha com a fundação. Com IA, a diferença é que o código funciona nos primeiros 80% dos casos — o que esconde o problema até o dia em que alguém precisa mexer naquela parte.

Como a gente estrutura o contexto na prática

Antes de qualquer sessão de desenvolvimento com IA, a equipe da LYPES prepara três coisas:

• Mapa do sistema: quais módulos existem, como se relacionam, onde estão os contratos de interface
• Regras do projeto: estilo de código, padrões aprovados, bibliotecas preferenciais, o que evitar
• Casos de borda conhecidos: o que já deu errado antes, o que o sistema não deve fazer

Esses três documentos viram o contexto inicial do assistente de IA. Não é um prompt de três linhas — é uma base de conhecimento que o modelo consulta antes de gerar qualquer linha. O resultado é código que parece ter sido escrito por alguém que conhece o projeto.

O papel do dev sênior na era da IA

Se a IA executa 20% do trabalho (a parte de escrever código), o dev sênior cuida dos 80% que realmente importam: decidir o que construir, em que ordem, com quais trade-offs, e se o código gerado é bom o bastante. O julgamento técnico virou o recurso escasso — não a capacidade de digitar.

Na LYPES, um dev sênior gastava 60% do tempo escrevendo código e 40% pensando. Com IA, a proporção inverteu: 20% revisando código gerado, 80% definindo contexto, validando arquitetura e tomando decisões. A produtividade subiu, mas o valor do profissional experiente subiu mais ainda.

Na prática: um exemplo real

Um cliente nosso precisava de uma integração com um gateway de pagamento. O código da integração em si — chamadas HTTP, parsing de resposta, tratamento de erros — a IA gerou em 15 minutos. O que levou dois dias foi levantar o contexto correto: regras de negócio do cliente (parcelamento, split de pagamento, regras de estorno), comportamento esperado em cada cenário de erro, e a arquitetura existente que a integração precisava respeitar.

O código foi a cereja do bolo. O bolo era o contexto.

Quer aplicar isso no seu projeto?

Se você está considerando IA no desenvolvimento do seu sistema, o primeiro passo não é escolher a ferramenta. É estruturar o contexto: documentação, arquitetura, regras de negócio. A LYPES pode ajudar a preparar esse terreno. Fala com a gente .