Saiba quais recursos do Markdown são compatíveis
O Markdown parece uma única linguagem até que o mesmo arquivo seja renderizado de forma diferente no GitHub, Hugo, Obsidian ou Pandoc. E o problema não é que o Markdown seja instável.
Evite que agentes de IA se desviem das especificações, testes e código.
Agentes de codificação com IA entregam funcionalidades rapidamente, mas especificações, testes e código se afastam silenciosamente uns dos outros. Este guia aborda um modelo de rastreabilidade, mapeamento de especificação para teste e de especificação para código, e as verificações de CI que detectam esse desvio antes de um merge.
Mantenha o conhecimento compilado confiável
Uma Wiki de LLM falha quando fatos antigos permanecem plausíveis, contradições ficam polidas e resumos gerados se afastam de suas fontes.
Cinco fases, da intenção ao código verificado.
O Desenvolvimento Orientado por Especificação funciona quando a especificação é um fluxo de trabalho, e não um documento que você arquivará após a reunião de abertura. O objetivo não é produzir um grande documento de requisitos de produto.
“A especificação como fonte da verdade, não um documento secundário.”
O Desenvolvimento Orientado por Especificação (Spec-Driven Development) é uma daquelas ideias para as quais engenheiros de software já se voltaram no passado e depois abandonaram quando o esforço deixou de se pagar.
Mantenha a intenção próxima do código.
Registros de decisão são a camada de memória ausente no desenvolvimento de software assistido por IA. Eles capturam não apenas o que foi construído, mas o porquê — e essa distinção se torna crítica quando ferramentas de IA estão escrevendo seu código.
