本文へ移動
ドキュメントを探す

最初の成果物を作成する

Markdown 成果物は、パッケージが定義する .drifts 配下に置きます。 次の PRD を .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?

langdrift フロントマターは決定論的なエンベロープです。

  • type と id が成果物の識別情報を定めます。
  • schema_version がプロトコルのバージョンを選択します。
  • title と、少なくとも 1 つの owners 識別子が必要です。
  • research は PRD と RES-001 を明示的に関連付けます。
  • vision_targets は PRD と VT-001 を明示的に関連付けます。

Markdown 本文には、人や後続のアプリケーションが使う豊富な背景情報を記述します。 SDK は本文をテキストとして保持します。見出し、文章、ファイル名、リンクから識別情報や関係を推測しません。

SDK は、未知のフロントマターフィールド、不正な YAML、重複キー、エイリアス、未対応のスキーマバージョンを拒否します。 参照解決時、RES-001 は検出済みの research 成果物に解決される必要があります。 VT-001 は、明示的に登録された vision-target 識別情報として渡せます。参照解決ではリモート検索を行いません。

続いて Vision → Loop → Evidence を読むか、 Record から Drift Event をたどってください。

GitHub でこのページを編集