---
name: traceability
description: Aplicar rastreabilidade ponta a ponta no fluxo Spec-Driven Development. Use ao criar ou revisar artefatos que precisam ligar ideia, PRD, Tech Spec, Tasks, Refinement, código, PR, revisão e memória; ao mapear links entre Jira, Confluence e Bitbucket; ou ao validar se uma entrega preserva origem, estado e evidências.
---

# Rastreabilidade SDD

## Regra central

Todo artefato deve apontar para o artefato que o originou. Não copie conteúdo entre sistemas; grave o ponteiro certo: sistema, identificador, link e estado.

Quando Jira, Confluence, Git provider ou outra integração não estiverem configurados por completo, use o artifact store local como fonte canônica: `docs/<slug-da-orquestracao>/`. Inicialize com `sdd init "<nome-da-orquestracao>"` em projetos instalados.

## Matriz mínima

Use esta cadeia como checklist:

- Ideia: origem humana ou canal de entrada.
- PRD: link para a Ideia e epic/story que rastreia o produto.
- Tech Spec: link para PRD, ADRs e trechos relevantes do codebase.
- Tasks: link para Tech Spec, critérios de aceite e dependências.
- Refinement: link para backlog de Tasks, Tech Spec e decisões abertas.
- Execução: branch, commits e PR apontam para a task.
- ADR: decisões arquiteturais pós-execução apontam para Execution, Tech Spec, Tasks, PR/commits, testes e ADRs anteriores quando existirem.
- Review: achados apontam para critérios de aceite, arquivos e linhas.
- Memória: resume decisões e aponta para PRD, Tech Spec, ADRs, PRs e revisões.

## Artifact store local

Arquivos mínimos por orquestração:

- `00-project-discovery.md`
- `00-risk-classification.md`
- `01-idea.md`
- `02-prd.md`
- `03-techspec.md`
- `04-tasks.md`
- `05-refinement.md`
- `06-execution.md`
- `06-adr.md`
- `07-review.md`
- `08-memory.md`
- `traceability-map.yaml`

Salve etapas informativas como `recorded`; salve PRD, Tech Spec, Refinement e Review como `approved` somente depois do checkpoint humano.

## Campos recomendados

Ao produzir qualquer documento, inclua uma seção curta:

```md
## Rastreabilidade
- Origem: <artefato anterior + link/id>
- Estado atual: <draft | aprovado | em execução | em review | concluído>
- Dono humano: <papel ou pessoa, se houver>
- Evidências: <links para PR, CI, review, decisão, log>
- Próximo artefato: <o que esta etapa deve gerar>
```

## Validação

Antes de avançar uma etapa, confirme:

- O artefato atual cita explicitamente a origem.
- O artefato aprovado está salvo no caminho local esperado quando não há link externo canônico.
- Não há duas fontes de verdade para o mesmo conteúdo.
- Links externos são ponteiros, não duplicações.
- A review consegue provar qual requisito cada mudança atende.
- A memória final contém decisões, não transcrições completas.
