スキーマ

プロトコルバージョン 1 は JSON Schema Draft 2020-12 を使います。

https://json-schema.org/draft/2020-12/schema

標準モデルの柱は、次の 3 つだけです。

Vision — research、prd、context
Loop — triage、design-document、spec、ticket
Evidence — adr、audit、record、drift

Drift は Evidence の種別であり、柱ではありません。最初の 9 種類は Markdown 文書です。Record と Drift Event は JSON エンベロープです。

エクスポート

@langdrift/sdk/schema は次をエクスポートします。

SCHEMA_VERSION。現在はリテラル値 1
成果物の各種別に対応するスキーマを含む schemas
projectSchema
pillarSchemas.vision、.loop、.evidence
種別と柱の対応を示す artifactPillars

各柱のスキーマは、必要な定義と成果物の形式を内包するため、生成されたスキーマファイルは単独で完結します。

検証の動作

スキーマは明示的な schema_version: 1 を要求します。成果物 ID は空でなく、空白文字を含めてはいけません。 Markdown メタデータには type、schema_version、id、title、少なくとも 1 人の所有者が必要です。 Record、Drift Event、参照、actor、プロジェクトの各フィールドは個別に定義されます。

プロトコルが閉じた形式を定義しているオブジェクトは、未知のプロパティを拒否します。バリデーターは型変換、既定値の適用、フィールドの削除、未対応バージョンの移行を行いません。形式チェックには、日付、日時、プロトコル固有の文字列が含まれます。

x-langdrift は、標準 JSON Schema の制約に付随するプロトコルの指針です。文書種別、バージョン、パッケージが管理するソース glob、フロントマターの名前空間と必須フィールド、参照関係、柱、ペイロードリソースなどを記録します。一般的な JSON Schema バリデーターはこの拡張を無視できます。LangDrift は解釈を記述するために使います。

スキーマは、持ち運び可能な入力を定義します。 Product Vision の計算式を定義したり、バックエンド、連携、MCP サーバーの存在を証明したりするものではありません。