# Knowledge YAML 運用ルール（AI品質安定化調査パック）

## 目的

`notes/` 章ノート（Markdown 正本）から、施策・KPI・スキル・ガバナンス・PoC テーマを構造化索引として管理する。

## 原則

- `notes/*.md` が正本（`ai_quality_research_html/*.html` は閲覧用生成物）
- **本章マスタ**: `notes/19_総評一覧.md` / `knowledge/` の KPI・スキル採否判断
- REQ/SCR/TBL スキーマは使わない（調査・提案ドメイン）
- 推測数値は `confidence: low`、PoC 実測後に差し替え

## ファイル

| ファイル | 内容 |
| --- | --- |
| `practices.yaml` | 職種×章の施策 |
| `metrics.yaml` | PoC KPI |
| `skills.yaml` | 公開・社内スキル |
| `risks.yaml` | ガバナンス・禁止事項 |
| `poc_themes.yaml` | PoC テーマ（bonus_kit と同期） |
| `traceability.yaml` | 施策 ↔ KPI ↔ スキル ↔ リスク |

## 更新

```bash
python tools/ai_quality_research_pack/export_notes.py
python tools/ai_quality_research_pack/build_pack.py
```

## 定着フェーズ

PoC 成功後は [dev_docs_guide](../dev_docs_guide/index.html) の `starter_kit/knowledge/` へ移行（フル版は output 直下）。