Regras de Validação de Artefatos

Regras gerais de validação

Aplicam-se a todos os artefatos, independentemente do ponto de vista:

1. Todo artefato deve ter cabeçalho YAML com id, tipo, status, autor e data.
2. Histórias (ESP) devem ter critérios de aceite mensuráveis.
3. Decisões (ADR/DEC) devem registrar contexto, alternativas e justificativa.
4. Evidências (EVD) devem vincular ao artefato de origem.
5. Nenhum artefato pode ser publicado em 08-publicado/ sem evidência de revisão.

---

Cabeçalho YAML mínimo

---
id: ESP-HNI-0001
tipo: HNI
titulo: "Título descritivo do artefato"
status: rascunho      # rascunho | refinado | aprovado | implementado | cancelado
autor: fulano.de.tal
data: 2026-04-11
versao: "1.0"
---

Artefatos de decisão (ADR, RFC) exigem campos adicionais — ver páginas específicas de GTI e PDP.

---

Status do ciclo de vida

Status	Quem move	Significado
rascunho	Autor	Em elaboração — não revisado
refinado	Time + PO	Revisado com o time — aguardando aprovação
aprovado	PO ou GTI	Aprovado formalmente — pode ser consumido
implementado	IMP	Consumido e implementado pelo ponto de vista correspondente
cancelado	PO ou GTI	Descartado — mantido no repositório para registro histórico

Artefatos cancelados nunca são excluídos

Um artefato cancelado deve ter o campo motivo-cancelamento preenchido e ser mantido no repositório. Excluir artefatos cancela a rastreabilidade histórica.

---

← Convenção de Nomenclatura · ESP — Subpastas & Regras →