Definição curta

Documento curto que registra uma regra de decisão de produto transversal, com seu contexto, as alternativas descartadas, as consequências aceitas e as condições que poderiam fazê-la evoluir. Abreviado como PDR.

Definição detalhada

A expressão é decalcada do Architecture Decision Record da engenharia de software, e não pertence a nenhum corpus metodológico de produto estabelecido: ela circula por imitação do vocabulário técnico, e não por uma definição compartilhada.

Nos artigos deste blog, o termo designa um objeto delimitado por três restrições, e não por um modelo de documento. Sua altitude: ele enuncia o que se aplica a um tipo de situação, nunca o que é preciso construir. Sua raridade: algumas entradas por ano, de cinco a umas vinte conforme o tamanho da organização. Sua imutabilidade: um PDR validado não é reescrito; mudar de posição produz um novo PDR que substitui o antigo, e o antigo continua onde está.

Sua forma habitual é uma sequência de seções curtas — status, data, decisão, contexto, alternativas consideradas, razões da escolha, consequências, condições de reavaliação, quem decidiu e quem foi consultado. O modelo exato varia; o que não varia é a presença do porquê e a ausência da execução.

Uso no domínio

O termo aparece nas discussões sobre a memória decisória de uma empresa de produto, sobre a divisão dos artefatos entre decisão, especificação, roadmap e backlog, e sobre as causas das rediscussões repetidas com vendas e suporte.

Sinônimos e variantes

"Registro de decisões de produto", "diário de decisões", "decisão documentada". Nas organizações que não usam a sigla, a coisa às vezes existe sob os nomes de "nota de doutrina", "princípio de produto" ou "regra de arbitragem".

Não confundir com

• Architecture Decision Record — Architecture Decision Record — mesmo gesto aplicado a uma escolha de arquitetura técnica; o PDR retoma sua estrutura deslocando o objeto para a regra de produto.
• PRD — Product Requirements Document, que descreve o que se quer construir e com que comportamento esperado; ele pode ser restringido por um PDR, mas não o substitui.
• Roadmap — visão de intenção num horizonte dado, que diz o que a empresa faz, prepara ou recusa; ela comunica uma direção, enquanto o PDR dá uma regra aplicável a casos não previstos.
• Backlog — Backlog — espaço coletivo dos assuntos prontos para serem trabalhados; ele carrega a ação, o PDR carrega o motivo que autoriza ou proíbe a ação.
• Ata de reunião — registro do que foi dito numa sessão; ela guarda um andamento, o PDR guarda uma regra descolada da sessão que a produziu.

Exemplos

"Em caso de conflito, priorizamos o cliente." — a forma mínima de uma decisão de PDR num marketplace: nenhuma funcionalidade, mas dezenas de decisões influenciadas.

"O produto é suportado por padrão em francês e em inglês. Qualquer outro idioma exige um patamar mínimo de faturamento anual assinado." — o uso numa questão comercial recorrente num SaaS.

Ambiguidades / debates

A palavra "record" carrega a ambiguidade principal: ela sugere um registro, logo uma exaustividade. O uso adotado aqui vai no sentido inverso — o valor do dispositivo diminui conforme o número de entradas aumenta.

Não estabilizado: o patamar de raridade. "Alguns por ano" se transpõe mal de uma estrutura de dez pessoas para um grupo com vários produtos, e nenhum critério diz a partir de que volume o registro deixa de ser consultável.