Quality
品質の主張を、契約・生成物・来歴まで遡って確認します。
brief から画面ができるまでの各段階(FlowSpec → SelectionSpec → BuildReport)は、それぞれ「契約」として内容が固定されています。契約は JSON Schemaで書かれ、ajvという検証ツールが次の段階へ進む前に機械的に形式を確認するため、ルールから外れた内容が途中で紛れ込むことはありません。
さらに生成物には provenance sidecarという記録が添えられます。これは入力ファイルの digest(内容から計算した指紋のようなもの)を保存する仕組みで、後から入力が書き換えられていないかを機械的に照合できます。「この画面はこのbriefと選定結果から作られた」という対応関係を、見た目ではなく検証可能な形で示します。
各段階を固定する4つの契約スキーマの内容を確認します。
FlowSpec
Source of truthResponsibilityユーザー意図、状態、遷移を固定する入力契約
InputBrief（上流の人間+AI）
OutputSelectionSpec（選定レイヤーへ）
Schemadocs/contracts/ai-flowspec.schema.json
{
"$schema": "docs/contracts/ai-flowspec.schema.json",
"required": [
"flowId",
"steps"
]
}SelectionSpec
Source of truthResponsibilityScreenType・pattern・blockの選定根拠を固定する契約
InputFlowSpec + registry inventory
OutputBuildReport（実装レイヤーへ）
Schemadocs/contracts/ai-selectionspec.schema.json
{
"$schema": "docs/contracts/ai-selectionspec.schema.json",
"required": [
"flowId",
"screens",
"unresolved"
]
}BuildReport
Source of truthResponsibility作成物と自動チェックの結果を記録する出力契約
InputSelectionSpec + build/check 実行
Outputprovenance sidecar・検証記録
Schemadocs/contracts/ai-buildreport.schema.json
{
"$schema": "docs/contracts/ai-buildreport.schema.json",
"required": [
"flowId",
"generatedAt",
"screens",
"checks",
"iterations",
"status"
]
}Facets
Source of truthResponsibility在庫を比較可能にする語彙とメタデータ
Inputregistry item の meta.aiDesignSystem
Output全契約が参照する共有語彙
Schemadocs/contracts/ai-design-facets.schema.json
{
"$schema": "docs/contracts/ai-design-facets.schema.json",
"required": [
"assetKind",
"maturity",
"source",
"evidence"
]
}