Modelo de Autoria de Live Spec
Um modelo estruturado para a elaboração de Live Specs que definem contratos comportamentais, critérios de aceitação e referências de contexto para o trabalho executado por agentes.
Visão Geral
Este modelo fornece uma estrutura padronizada para a elaboração de documentos Live Spec — o principal artefato de entrada em Spec Driven Development. Uma Live Spec substitui prompts ad-hoc por uma especificação versionada e legível por máquina que define o que um agente deve construir, como o sucesso é medido e de qual contexto o agente precisa para realizar o trabalho corretamente.
O Context Architect utiliza este modelo para criar especificações antes de atribuir o trabalho aos agentes. Cada especificação alimenta o Fluxo de Trabalho Triangular: Especificar (elaborar a especificação), Executar (o agente constrói com base na especificação) e Avaliar (o Eval Harness valida a saída em relação aos critérios de aceitação).
Especificações bem elaboradas produzem três benefícios mensuráveis: saída do agente reproduzível, avaliação automatizada e conhecimento institucional acumulado que sobrevive através de sessões, desenvolvedores e versões de modelos.
Quando Usar
Use this template when:
- A Context Architect is defining a new unit of agent work (feature, component, refactor, migration)
- A team is transitioning from ad-hoc prompting to Spec Driven Development
- An existing spec needs to be restructured to include proper acceptance criteria and context references
- Work is being parallelized across multiple agents and each agent needs a self-contained specification
The template produces a YAML-structured spec document that can be stored in version control (typically in a specs/ directory), reviewed in pull requests, and consumed by agent orchestration tooling and the Eval Harness.
Before writing a spec, ensure the relevant Context Packet exists. 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.