A documentação que todo sistema sob medida deveria ter (e quase nunca tem)

Quando um sistema não tem documentação, a documentação existe mesmo assim — só que guardada na cabeça de uma ou duas pessoas. O problema aparece no dia em que essa pessoa sai de férias, muda de empresa, ou simplesmente esquece um detalhe que decidiu seis meses atrás.

Documentação, no contexto de um sistema sob medida, não precisa ser um manual de centenas de páginas. Precisa cobrir três coisas: como instalar e colocar o sistema no ar do zero, quais decisões técnicas importantes foram tomadas e por quê, e como cada integração externa (pagamento, WhatsApp, e-mail) foi configurada e com quais credenciais.

Por que isso é problema de negócio, não só técnico

Sem esse registro, trocar de fornecedor de desenvolvimento se torna muito mais caro, porque o novo time precisa "descobrir" o sistema do zero, muitas vezes lendo código para entender decisões que poderiam estar escritas em um parágrafo. Isso aumenta seu poder de negociação com qualquer fornecedor: você não fica preso a quem construiu o sistema.

Pedir documentação como parte formal da entrega — e não como um "extra se der tempo" — é uma das exigências mais baratas e mais ignoradas em contratos de desenvolvimento. O custo de pedir é quase zero. O custo de não ter aparece anos depois, exatamente quando você menos pode esperar por ele.