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 (SDD) funciona quando a especificação é um fluxo de trabalho, não um documento que você arquiva após o início do projeto. O objetivo não é produzir um grande documento de requisitos de produto.
A especificação como fonte de verdade, não um documento secundário.
Desenvolvimento Orientado por Especificação é uma daquelas ideias que os engenheiros de software buscaram anteriormente e depois abandonaram quando o esforço deixou de gerar retorno.
Mantenha a intenção próxima ao código.
Registros de decisão são a camada de memória faltante no desenvolvimento de software assistido por IA. Eles capturam não apenas o que foi construído, mas o porquê — e essa distinção torna-se crítica quando ferramentas de IA estão escrevendo o seu código.
