Modelo de Live Spec
Um modelo estruturado para escrever Live Specs legíveis por máquina que agentes podem implementar e verificar de forma autônoma.
Visão Geral
Este modelo fornece uma estrutura abrangente para a criação de documentos Live Spec — o principal artefato de entrada no Spec Driven Development. Uma Live Spec define três ativos mínimos para qualquer unidade de trabalho do agente: um Contrato Comportamental (o que construir), uma Constituição do Sistema (quais regras seguir) e um Mapa de Tarefas Acionável (como o sucesso é medido e verificado).
O Context Architect usa este modelo ao especificar novos trabalhos para execução por agentes. Cada especificação concluída alimenta o Fluxo de Trabalho Triangular: Especificar (criar a especificação usando este modelo), Executar (o agente constrói com base na especificação com seu Context Packet), Avaliar (o Eval Harness valida a saída em relação aos critérios de aceitação).
Este modelo difere do modelo Live Spec Authoring em termos de escopo. O modelo de criação fornece um formato de especificação YAML para consumo por máquina. Este modelo fornece um documento de planejamento abrangente que inclui contexto de negócios, gatilhos de escalonamento e portas de revisão humana — uma especificação completa que um Context Architect preenche antes de traduzir as seções críticas para o formato YAML para execução pelo agente.
Quando Usar
Use this template when:
- Starting a new feature, component, or significant refactoring that an agent will implement
- A team is transitioning from ad-hoc prompting to Spec Driven Development and needs a structured planning format
- Work involves security-critical, high-blast-radius, or architecturally significant changes that require explicit governance gates
- Multiple agents will work on related tasks and need consistent, self-contained specifications
- A Rescue Mission revealed that the previous spec was underspecified, and a more thorough approach is needed
Before writing a spec, ensure the relevant Context Packet exists and is current. Run a staleness check on referenced files. If the project does not yet have context packets for the domain in question, create them first — the spec references context but does not replace it.