Ângulo

O repositório de código sempre deu fé sobre o que o produto faz; ainda assim, era a especificação que tinha autoridade, porque só ela era lida em reunião. Um artefato, portanto, não governa uma cadeia de produto pela confiabilidade, e sim pela facilidade com que dele se tiram os outros — e essa facilidade é uma questão de acesso, nunca de natureza. Quando ler um repositório, cruzar os merge requests dele e regerar uma documentação de suporte deixa de exigir um desenvolvedor, a especificação perde o que a mantinha no lugar: ela nunca foi mais verdadeira, ela era mais acessível. A autoridade passa então para o código, com as suas duas condições — um repositório legível e alguém que saiba interrogá-lo — e com o seu buraco: ele diz o que o produto faz, nunca por que ele faz assim.

Síntese

Tomadas separadamente, essas ideias parecem um relato de experiência sobre documentos de produto mal cuidados. Emendadas, descrevem como a autoridade se distribui entre os artefatos de um produto, e o que a desloca.

O ponto de partida é um descompasso entre duas propriedades que se confundem. O código detém o estado real: um comportamento presente no repositório existe, um comportamento escrito numa especificação e ausente do repositório não existe para ninguém. Mas deter o estado real nunca bastou para governar a cadeia, porque quem produz os documentos — product managers, suporte, comercial — não lê o repositório. A camada em linguagem natural ocupou o lugar que ficou vago, não pela qualidade da informação, mas pela qualidade do acesso.

Essa camada, uma vez instalada, começou a divergir, e a divergência não é relaxo. Dois mecanismos se somam: as arbitragens feitas durante o desenvolvimento não sobem de forma sistemática, e ressincronizar especificação, protótipo, changelog e documentação de suporte custa, a cada evolução, mais do que o tempo disponível. A documentação vencida é o resultado acumulado de arbitragens todas razoáveis quando tomadas uma a uma.

O que muda não é a confiabilidade do código, que já estava ali. É o preço do acesso a ele. Assim que um repositório pode ser interrogado sem saber programar, a especificação, o changelog, a documentação de suporte e até o design system podem ser regerados a partir dele, em vez de corrigidos a partir de si mesmos — e um artefato regerado não vence, ele é refeito ou não é. A virada chega até a etapa que se imaginava a mais distante do código: um protótipo composto de elementos que existem de verdade deixa de ser uma representação.

Esse deslocamento tem um preço, e ele é pago em competência. Ele pressupõe um repositório legível, o que faz da qualidade do código uma variável de produto, e não um conforto de time. Pressupõe também alguém capaz de cruzar código, histórico, merge requests e regras de negócio — coisa que nenhuma ferramenta vertical faz, porque cada uma vê só uma face. E abre uma armadilha: produzir rápido blocos corretos um a um e pagar depois pela articulação entre eles.

O que o conjunto deixa ver: a posição de um artefato acompanha o custo de acesso ao que ele contém, e a hierarquia tida por natural numa cadeia de produto era apenas o mapa dos leitores disponíveis.

Tensões / contradições

A tensão principal opõe duas notas deste lote. Uma fundamenta a posição do product manager no fato de que nenhuma ferramenta vertical vê várias faces do produto ao mesmo tempo; a outra anuncia um protocolo que dá justamente a cada ferramenta acesso aos perímetros vizinhos. Se o segundo movimento vingar, a vantagem do primeiro se apaga — e nada aqui permite dizer em que prazo.

Segunda tensão, com uma ideia escrita em outro lugar: a IA foi apresentada como o que finalmente torna rentável uma camada de conhecimento neutra entre as fontes e os entregáveis. Aqui, ela serve antes para dispensar uma camada intermediária, regerando a partir da fonte. As duas coisas podem se sustentar — a camada que se mantém carrega a intenção, a que se joga fora carregava o estado —, mas o critério que separa os dois casos não está estabelecido.

Por fim, o ângulo supõe que a acessibilidade explica a posição. Dá para objetar que uma especificação também tinha autoridade porque era assinada: ela comprometia alguém, coisa que um artefato regerado não faz.

Questões

• Onde registrar a intenção de uma decisão de produto, que nem o repositório nem uma especificação regerada carregam?
• O que substitui o compromisso carregado por um documento validado, quando o artefato é regerado sob demanda?
• A demonstração se sustenta num produto de software: o que acontece com ela numa cadeia de produto cujo objeto real não é legível como um repositório?