Uma lista de 69 itens encontrou requisitos só no papel.

O que se repete merece uma decisão comum

Na continuação de arrumar a casa em 48 horas, conferi 69 itens de alinhamento e encontrei requisitos que só existiam no papel. Provedores, banco, e-mail, release, observabilidade, backoffice, nomes de recursos e documentação de operação entram nessa conversa.

Uma decisão comum reduz a necessidade de redescobrir o mesmo caminho a cada produto. Ela também torna mais fácil comparar o que foi documentado com o que está em operação. O Garfim serve de referência, e onde outro produto já corrigiu a referência, vale a versão corrigida.

Isso não obriga produtos diferentes a terem a mesma resposta para tudo. Mercado, lei, meio de pagamento ou plataforma podem exigir outra escolha. Nesses casos, registro a divergência e o motivo, para que ela continue compreensível depois.

O estado precisa apontar para uma evidência

No alinhamento de um produto que ainda não apresentei aqui, a lista tinha 69 itens. Desses, 61 estavam feitos, 2 faltavam e 6 não se aplicavam. A contagem ajuda a enxergar o andamento, mas cada linha precisa dizer por que recebeu aquele estado.

Um item feito aponta para o arquivo que demonstra a implementação. Um item que não se aplica traz o motivo. Um item pendente permanece visível até que o trabalho correspondente seja concluído.

Essa diferença importa porque um documento pode registrar uma intenção sem mostrar que ela foi implementada. Conferir o arquivo associado aproxima a lista do comportamento real do produto.

A revisão também encontrou o que não estava na lista

A rodada encontrou requisitos que existiam apenas no papel. Uma checagem de segredos exigida no CI não estava presente, e quatro alertas previstos também não existiam. Em outro achado, erros de uma interface de chamadas não chegavam ao Sentry.

Esses casos não estavam resolvidos simplesmente por constarem em requisitos. A revisão precisou procurar a evidência e comparar a expectativa com a operação. O resultado foi ampliar o olhar para além dos itens previstos originalmente.

Uma lista ajuda a organizar a conferência, mas não define tudo o que a conferência pode descobrir. Os achados alimentam decisões posteriores e dão mais contexto para revisar o padrão usado como referência.

A divergência registrada conserva o contexto

Quando um produto pede uma escolha diferente, eu quero conseguir reencontrar a razão. A plataforma pode impor uma condição própria, ou uma lei pode mudar o que se aplica. O registro evita tratar diferenças necessárias como esquecimentos.

O mesmo cuidado vale quando a referência melhora. Se outro produto já corrigiu um ponto do Garfim, reproduzir a versão antiga preservaria o problema. A referência útil é a que incorpora a correção.

Observabilidade é a capacidade de acompanhar o comportamento de um sistema por sinais como erros e alertas. Padronizar essa parte ajuda quando preciso investigar um produto: sei onde procurar e posso perceber uma configuração ausente antes de depender dela.

A mesma lógica se aplica ao release. Se cada produto tiver um procedimento comum documentado, a conferência começa por uma expectativa conhecida. O arquivo que comprova o item continua necessário, porque uma regra escrita no contexto central não altera por conta própria o repositório de cada produto.

Eu separo a decisão comum da situação de cada implementação. A primeira diz qual caminho seguir; a segunda mostra se aquele produto já o percorreu. Essa separação impede que uma lista de padrões pareça um retrato de trabalho concluído em todos os lugares.

Para copiar a abordagem, eu começaria pelas categorias que se repetem e criaria uma linha por decisão conferível. Em cada linha, registraria o estado e o local da evidência. Quando uma regra não couber, escreveria o motivo junto dela, de forma que outra revisão consiga distinguir uma exceção deliberada de uma tarefa esquecida.

A revisão precisa abrir espaço para descobertas fora da lista. Nos achados de alertas e da checagem de segredos, por exemplo, a pergunta era se o requisito previsto existia na operação. Olhar apenas para a contagem de itens não teria respondido a isso. A lista organiza o exame; a evidência sustenta o estado atribuído.

A lista de 69 itens deixou um retrato com pendências explícitas e evidências para conferência. Para outro exemplo de padrão acompanhado de riscos e critérios de revisão, contei como passei a publicar da minha máquina.