# Knowledge YAML Validation

## チェック観点

### 1. 必須項目チェック

- `id` があるか
- `title` または `name` があるか
- `status` があるか
- `source_refs` があるか
- `related` があるか

### 2. 出典チェック

- `source_refs.path` が実在するか
- `source_refs.section` が本文中に存在するか（目視）
- `quote` が本文と矛盾していないか

### 3. トレーサビリティチェック

- 要件に紐づく業務ルールがあるか（機能要件）
- `traceability.yaml` と `requirements.yaml` の `related` が整合するか
- `open_questions.yaml` と `baseline-open-items.md` が一致するか

### 4. 未確定情報チェック

- `confidence: low` の項目一覧
- `status: draft` の項目一覧
- `open_questions` に残っている項目一覧

### 5. 矛盾チェック

- 同じ ID の重複
- 同じタイトルで別 ID になっている項目
- `related` の片方向リンク
- `confirmed` なのに `source_refs` がない項目

## 実行例

```bash
# 曖昧語（正本側）
python scripts/scan_ambiguous_words.py docs/requirements reference

# トレーサ CSV（テスト工程）
python scripts/validate_traceability.py docs/testing/traceability.csv
```

Knowledge YAML は上記に加え、本ファイルの観点で目視または AI レビューする。