Tạo hiện vật đầu tiên

Hiện vật Markdown nằm trong các đường dẫn .drifts do gói quy định. Thêm PRD này tại một đường dẫn như .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?

Phần đầu tài liệu langdrift là vỏ bọc tất định:

type và id xác lập định danh hiện vật.
schema_version chọn phiên bản giao thức.
title và ít nhất một định danh trong owners là bắt buộc.
research liên kết tường minh PRD với RES-001.
vision_targets liên kết tường minh PRD với VT-001.

Phần nội dung Markdown mang ngữ cảnh phong phú cho con người và các ứng dụng sử dụng dữ liệu. SDK giữ nguyên phần này dưới dạng văn bản. Nó không suy ra định danh hay quan hệ từ tiêu đề, văn xuôi, tên tệp hoặc liên kết.

SDK từ chối trường không xác định trong phần đầu tài liệu, YAML sai định dạng, khóa trùng lặp, bí danh và phiên bản lược đồ không được hỗ trợ. Khi phân giải tham chiếu, RES-001 phải trỏ đến một hiện vật nghiên cứu đã được phát hiện. VT-001 có thể được cung cấp dưới dạng định danh vision-target đã biết một cách tường minh; việc phân giải tham chiếu không tra cứu từ xa.

Tiếp theo, đọc Định hướng → Chu trình → Bằng chứng hoặc theo dõi từ bản ghi đến sự kiện sai lệch.