Lastro de evidência: como ler [A], [P] e [?]

O lastro é o grau de evidência que sustenta uma afirmação. Ele não mede a confiança de quem escreve — mede o que ancora a afirmação na realidade do código. Uma afirmação só sobe de nível quando ganha evidência citável, nunca quando o autor “fica mais seguro”.

Os três níveis

• [A] Ancorado — evidência direta e citável: arquivo e linha, teste verde, uma migration ou um hash de commit. A obrigação é citar a evidência na mesma linha. Um [A] sem citação é inválido e o sensor o rebaixa para [P].
• [P] Presumido — inferido de padrões, nomes ou convenções de framework. É plausível, não provado. A obrigação é gerar um item de validação rastreado — é dívida explícita, não certeza.
• [?] Aberto — não determinável pelos artefatos disponíveis. Bloqueia marcar a unidade como pronta e vira uma pergunta para um humano responder.

Por que tags ASCII

Marcadores como [A] são greppáveis: um sensor consegue varrer o texto e checar, de forma determinística, se todo [A] traz citação e se nenhuma unidade marcada como pronta ainda carrega um [?]. Emoji colorido serve só como apoio visual em relatórios — nunca como o dado que a máquina verifica.

A regra de ouro

Na dúvida, use o nível mais baixo. Um [?] honesto vale mais que um [P] enganoso, porque a engenharia começa quando se assume o que ainda não se sabe — e o sistema deixa de pretender saber o que não sabe.