Crie seu primeiro artefato

Os artefatos Markdown ficam nos caminhos .drifts definidos pelo pacote. Adicione este PRD em um caminho como .drifts/vision/prd/product-vision-dashboard.md:

---
langdrift:
  type: prd
  schema_version: 1
  id: PRD-001
  title: Product Vision Dashboard
  owners:
    - user_42
  research:
    - RES-001
  vision_targets:
    - VT-001
---
 
# Product Vision Dashboard
 
## Purpose
 
Give leadership an auditable view of movement against recorded product intent.
 
## Open questions
 
- Which source observations support each change?
- Which decisions explain the movement?

O frontmatter langdrift é o envelope determinístico:

type e id estabelecem a identidade do artefato.
schema_version seleciona a versão do protocolo.
title e ao menos um identificador em owners são obrigatórios.
research relaciona explicitamente o PRD a RES-001.
vision_targets relaciona explicitamente o PRD a VT-001.

O corpo Markdown contém contexto detalhado para pessoas e aplicações consumidoras. O SDK o preserva como texto. Ele não infere identidade ou relações a partir de títulos, prosa, nomes de arquivos ou links.

O SDK rejeita campos desconhecidos no frontmatter, YAML malformado, chaves duplicadas, aliases e versões de esquema não compatíveis. Durante a resolução de referências, RES-001 deve corresponder a um artefato de pesquisa descoberto. VT-001 pode ser fornecido como uma identidade vision-target explicitamente conhecida; a resolução de referências não faz consultas remotas.

A seguir, leia Direção → Ciclo → Evidências ou acompanhe um registro até um evento de desvio.