Ideia

Um repositório completo sobre um escopo serve a todas as áreas dele, um repositório pela metade em cinco escopos não serve a ninguém

Info

Escrito originalmente em francês. Traduzido por IA — o sentido foi preservado, não a prosa.

Ideia principal

O retorno de uma descrição de produto não acompanha o número de fichas escritas, ele acompanha a completude de um escopo. Uma área inteiramente descrita — o faturamento, digamos — responde às perguntas do suporte, do pré-vendas, do treinamento e dos desenvolvedores que mexem ali, e responde sem que ninguém precise conferir em outro lugar. Cinco áreas descritas pela metade não dispensam nenhuma dessas conferências: a cada pergunta, é preciso reabrir o código para saber se a resposta que falta falta de verdade.

A razão é assimétrica. Uma descrição parcial só entrega valor se você sabe por onde passa a fronteira dela; caso contrário, quem a usa precisa sempre considerar que ela pode ser muda, e o custo de verificação volta inteiro.

Daí a condição de uso: terminar uma área antes de abrir outra. Ela contraria a inclinação natural desse tipo de trabalho, que é sobrevoar tudo para mostrar uma cobertura bonita.

Por que isso importa

Isso dá uma regra de sequenciamento que você pode opor à pressão de mostrar avanço: o marco útil é "este escopo está pronto", nunca "n por cento do produto está coberto".

Vale também para outros projetos de conhecimento — uma documentação, um glossário, uma base de testes — cujo uso só começa no momento em que alguém pode parar de duvidar sobre uma zona inteira.

Nuances e limites

O raciocínio pressupõe escopos realmente separáveis. Em um produto onde tudo depende de tudo, nenhuma área termina sem transbordar, e a regra vira uma ordem de parada arbitrária em vez de uma condição de retorno.

E uma cobertura ampla, mesmo parcial, tem utilidade própria: serve para comparar os ângulos entre si e para identificar onde o produto é mal conhecido.

Questões em aberto

  • Como anunciar a fronteira de um escopo descrito para que o leitor saiba, sem pensar, se a pergunta dele cai dentro ou fora?