Especificação Viva
Um contrato determinístico e legível por máquina que define o que construir, por que é importante e como verificar seu funcionamento.
Definição
Uma Especificação Viva é um projeto modular e versionado que substitui as histórias de usuário tradicionais por um contrato legível por máquina, preciso o suficiente para um agente implementar sem perguntas de esclarecimento. Ao contrário das descrições informais de tickets, uma Especificação Viva não deixa margem para interpretação e inclui tudo o que um agente precisa para verificar seu próprio trabalho em relação aos critérios de aceitação.
Cada Especificação Viva contém três ativos mínimos:
- Contrato Comportamental — a descrição precisa do que o sistema deve fazer, incluindo entradas, saídas, casos de borda e tratamento de erros.
- Constituição do Sistema — as regras arquitetônicas, padrões de codificação e restrições que a implementação deve respeitar.
- Mapa de Tarefas Acionáveis — as etapas decompostas que um agente segue para implementar a especificação, ordenadas por dependência.
Uma Especificação Viva não é um documento estático. Ela evolui junto com a base de código, é armazenada sob controle de versão e é atualizada sempre que os requisitos mudam ou novas restrições surgem. Essa natureza viva a distingue dos documentos de requisitos tradicionais que se tornam obsoletos após a criação inicial.