# Knowledge YAML 運用ルール（dev_docs_guide ガイド本体）

## 目的

`notes/` 配下の **Markdown 章ノート**を索引化し、章間参照・施策・成果物マップを AI・ツールで追えるようにする。

## 原則

- `notes/*.md` が章の正本（HTML は `build_pack.py` 生成物）
- 本 `knowledge/` はガイド内容の索引（REQ/SCR/TBL ではない）
- 実プロジェクト運用の Knowledge 索引は `starter_kit/knowledge/` をコピーして使う

## ファイル

| ファイル | 内容 |
| --- | --- |
| `chapters.yaml` | 章メタ・読者・HTML リンク |
| `deliverables.yaml` | 工程別成果物 |
| `practices.yaml` | Before/After 施策・推奨モデル |
| `open_questions.yaml` | ガイド自体の未決（あれば） |

## 更新

```bash
python tools/dev_docs_guide_pack/build_pack.py
```

`notes/` 再生成後、`tools/extract_guide_knowledge.md` に従い索引を更新する。