ドキュメントマップ

最終更新サマリー（v0.6.22）: FOLLOWUP9 セッションクローズ（C1〜C7）。 ①過去プロンプト漏れ調査=実体漏れゼロ（06-10 の 🔄 2件は FOLLOWUP7 完遂済の状態ラベル更新漏れ→✅是正・06-11 のフォールバックウェイクアップ→⏭️）。②QA-UAT-FOLLOWUP9 v1.0.0 新規登録（ISS-035/041/045＋index 生成の UAT・ユースケース4/シナリオ6/セキュリティ4・総合 379 passed/1 skipped）・build_html_docs.py DOCS に追加・HTML 33→34（＋index）。③公開サイト最新化（再デプロイ・root 200／DOCUMENT-MAP 308→200）。frontmatter PASS。 最終更新サマリー（v0.6.21）: FOLLOWUP9（F9-1 外部認証＋デプロイ）。 ①ISS-035 解決（gcloud 再認証→keepalive を Qdrant REST 直叩き化・HTTP 200・派生 ISS-045 鍵ローテーション起票）。②ISS-041 公開: docs/_html 34件を https://rag-docs.pages.dev/ へ Cloudflare Pages デプロイ（プライベート判断・Access 設定のみユーザー残）。PM-HOST 1.0.0→1.1.0（§8 URL・§8.1 Access 手順）・scripts/build_html_docs.py に index.html 生成追加（HTML 33+index）。③ISS-030 配線バグ判明（未実行起票）。PM-001（backlog）4.23.0→4.24.0・PM CHANGELOG 5.14.0・全体 CHANGELOG 1.26.0。frontmatter 2/2 PASS。コミットは 01_Recipe/（keepalive スクリプト）のみ・push なし。 最終更新サマリー（v0.6.20）: FOLLOWUP8（FUT-52/53/54＝bi-gram Sparse の ingest パイプライン統合）。 OPS-001 0.11.0→0.12.0（§2.13 ingest 末尾の Sparse 自動再索引・既定 OFF・Qdrant 1.10+・並列時スキップ）・MAN-002 1.5.0→1.6.0（ENABLE_INGEST_SPARSE）・DES-002 0.17.0→0.18.0（新規 ingest/sparse_corpus.py）・REQ-002 0.3.6→0.3.7（FR-303 運用拡張）。新規 ingest/sparse_corpus.py（全量再計算を正・in-place 全量再索引＝add_sparse_index と同値）・config.enable_ingest_sparse（既定 OFF・core upsert 無改変）・copy_collection の Sparse 消失 WARN ガード／--with-sparse 忠実コピー。テスト 357→379 passed/1 skipped（+22・mock 課金ゼロ）。計画 Plan/PLAN-FOLLOWUP8-FUT525354-2026-06-11.md v0.2.0・レビュー Review/REV-FOLLOWUP8-2026-06-11_plan-independent.md／Review/REV-FOLLOWUP8-2026-06-11_impl-independent.md（G2/G3 Fable5）を登録。PM-001（backlog）4.22.0→4.23.0。FUT-52/53/54 解決。 最終更新サマリー（v0.6.19）: FOLLOWUP7 セッションクローズ。 過去プロンプト漏れ調査＝06-07〜06-10 の状態ラベルは全て解決済み（🔄カウントは本文絵文字の誤カウント・漏れなし）。QA-UAT-FOLLOWUP7 v1.0.0 新規登録（ISS-044＋F4-1 のユースケース4/シナリオ10/セキュリティ5・総合 357 passed/1 skipped・test_hybrid_security.py に bigram セキュリティ5件追加・実データ E2E 全7項目）。quality CHANGELOG 1.13.0・HTML 32→33。backlog v4.21.0→v4.22.0。ISS-041（doc ホスティング）は外部認証待ちのため伴走手順を引き継ぎ（FOLLOWUP8）に整理。 最終更新サマリー（v0.6.18）: FOLLOWUP7（F7-1 ISS-044 解決 ＋ F7-2 F4-1 bi-gram BM25 Sparse）。 DES-001 0.11.0→0.12.0（§4.2.5 ISS-044 修正・§3.2 bi-gram エンコーダ）・DES-002 0.16.0→0.17.0（sparse_method・Sparse 方式選択）・DES-003 0.8.0→0.9.0（named Sparse text-sparse）・MAN-002 1.4.0→1.5.0（SPARSE_METHOD・索引再付与運用）・OPS-001 0.10.0→0.11.0（§7.4 コーパス統計鮮度・copy 後再実行）。本番 recipe 1554→1581点/49file（part06/part13 補完・bi-gram Sparse 付与・bench20クエリ非空100%）。テスト 346 passed。計画 Plan/PLAN-FOLLOWUP7-2026-06-10.md v0.2.0・レビュー Review/REV-FOLLOWUP7-2026-06-10_plan-independent.md／Review/REV-FOLLOWUP7-2026-06-10_impl-review.md を登録。PM-001（backlog）4.20.0→4.21.0。FUT-52/53/54 起票。ISS-044 解決（オープン ISS=030/035/041）。 最終更新サマリー（v0.6.17）: ISS-043 段階2 完了（FOLLOWUP6）。 本番 recipe を 576点単一「中華/メイン」→ 1554点/47file/7genre に再構築（案C'＝recipe_dev 非破壊・統合版 file_id 除外 copy・classifier の dev 削除拒否を受けた設計改善）。file_bytes 未定義バグ修正（回帰テスト3件・332 passed）・copy_collection.py 索引欠落（tags_scene/mood/ingredients）＋--exclude-file-id。PM-001（backlog）4.18.0→4.19.0。計画 Plan/PLAN-FOLLOWUP6-2026-06-10.md v0.3.0・レビュー Review/REV-FOLLOWUP6-2026-06-10_plan-selfreview.md を登録。ISS-044 起票（rank C OCR フォールバックで extract_text(PDF) 誤渡し→part06/part13 未収録）。E2E 全合格。QA-UAT-FOLLOWUP6 v1.0.0（UAT・シナリオ7/セキュリティ1/総合 336 passed）登録・test_copy_collection.py 新規・HTML 31→32・quality CHANGELOG 1.12.0。 最終更新サマリー（v0.6.16）: ISS-043 段階1 のコミット＋UAT 受入＋HTML 同期。 QA-UAT-ISS-043 v1.0.0 を新規登録（ユースケース5・シナリオ5・セキュリティ/堅牢性4・総合 329 passed/1 skipped）。セキュリティテスト2件を追加実装（敵対的大量チャンクの課金頭打ち・API 失敗縮退の堅牢性）。PM-001（backlog）本文版を 4.10.0→4.18.0 へドリフト是正（ISS-043 段階2＝本番再 ingest をユーザー承認済・次セッション実施として明記）。HTML 一括再生成を 31 件化（QA-UAT-ISS-043 追加）。 最終更新サマリー（v0.6.15）: ISS-043 段階1（コード修正）反映。 DES-003 0.7.0→0.8.0（§5.4 チャンク整合タグ付与）・MAN-002 1.3.0→1.4.0（環境変数 TAG_WINDOW_CHARS/MAX_TAG_CLASSIFY_PER_FILE）。ingest のタグ付与を「PDF 全体 1 回分類→全チャンクへブロードキャスト」から classify_tags_per_chunk（ウィンドウ単位グループ分類でチャンク整合タグ・N+1 課金ガード）へ修正。ページメタはファイル代表値集約・chunk_tags キャッシュ。test_tagger.py +5（計8 PASS）・課金ゼロ・後方互換。段階2（本番 recipe 再 ingest・破壊的・$2.47 で FUT-45 束ね）はユーザー判断待ち。 最終更新サマリー（v0.6.14）: QA-UAT-FOLLOWUP4 v1.0.0 を新規登録（FOLLOWUP4 実装＝FUT-48/FUT-51/HTML フィルタ/非対話認証のユースケース5件・シナリオ・セキュリティ7件・総合テストを実施し受入）。tests/test_followup4_security.py（SQL インジェクション耐性・issue ドラフト注入非実行・パス安全・クエリ書換堅牢＝322 passed）。HTML 一括再生成を 30 件化（QA-UAT-FOLLOWUP4 追加）。 v0.6.13: F4-4 非対話認証を実装（対話 OAuth ログインを鍵/トークンで自動化）。deploy_docs_site.sh＝CLOUDFLARE_API_TOKEN（keyring/env・wrangler login 不要）、setup_qdrant_keepalive_scheduler.sh／setup_ingest_scheduler.sh＝SA 鍵 activate（GOOGLE_APPLICATION_CREDENTIALS・gcloud auth login 不要）。OPS-001 0.9.0→0.10.0（§2.12）。Playwright での OAuth ログイン代行は自動化検知・2FA で非推奨＝鍵/トークン方式が正解。 v0.6.12: FUT-51 週次バッチを実装（weekly_failure_report.py＝失敗分析→JSON レポート/履歴を docs/quality/failure-reports/ 出力・閾値超過時に backlog 起票用 issue ドラフト生成＝backlog 非編集・テスト+5＝315 passed）。REQ-002 0.3.5→0.3.6（FR-307）・DES-002 0.15.0→0.16.0・OPS-001 0.8.0→0.9.0（§7.5）。 v0.6.11: FUT-51 失敗クエリ自動分析の中核を実装（failure_analysis.py＋CLI・query_logs を 3分類・SQLite 読取のみ・課金ゼロ・テスト+10＝310 passed）。DES-002 0.14.0→0.15.0・REQ-002 0.3.4→0.3.5（FR-307）。 v0.6.10: FUT-48 クエリ書き換えを search に統合配線（既定 OFF・後方互換・mock 安全・統合テスト+7＝300 passed）。DES-002 0.13.0→0.14.0・REQ-002 0.3.3→0.3.4。MAN-001/MAN-003 ステータスを承認状態（確定）へ整合是正・QA-REPORT-JPSPARSE v1.1.0・REV-FOLLOWUP4-DELIVERABLE 登録（成果物独立レビュー反映）。 v0.6.9: F4-2／F4-3 実行（FOLLOWUP4）。新規登録 QA-REPORT-JPSPARSE v1.0.0（F4-2 日本語 Sparse 評価＝bi-gram BM25 が BM42 より有意優位・p=0.026・本番投入は ISS-043 後を推奨）。F4-3 鮮度6件の版更新: REQ-002 0.3.2→0.3.3／MAN-003 1.3.0→1.4.0／DES-001 0.10.0→0.11.0／MAN-001 1.2.0→1.3.0／OPS-001 0.7.0→0.8.0／COST-PHASE-3.0 0.3.1→0.3.2。FOLLOWUP4 計画群（PLAN-FOLLOWUP4・REV-FOLLOWUP4-plan-independent）起票。frontmatter 72/72。 v0.6.8: セッションクローズ（FOLLOWUP4）。HTML 主要27→28件（QA-UAT-HYBRID 追加・DES-004〜008/QA-001/002/QA-VERIFY/CORP-002/PM-CST/DEC/HOST も新規 HTML 化）。ドキュメント鮮度監査（Workflow 3並列）の must-update を是正: MAN-002 v1.3.0（v3.0 環境変数フラグ・requirements-rerank・add_sparse_index・Cloud Run 4GB）/ DES-009 v0.2.0（実装反映ノート・P95・BM42日本語弱知見・status review）/ QA-001 v1.2.0（§8 実装済み化）/ QA-002 v1.2.0（TST-09 新設）/ PM-CST v1.4.0（v3.0 コスト$0・4GB注記）。QA-UAT-HYBRID v1.0.0（総合293 passed・セキュリティ11件受入）。nice-to-update（REQ-002/MAN-003/DES-001/MAN-001/OPS-001/COST）は次セッション残課題化（flag-OFF・低リスク）。 v0.6.7: v3.0 ハイブリッド検索を実 OSS モデル・実 Qdrant データで実効化（課金ゼロ・非破壊）。新規登録 QA-VERIFY-HYBRID v1.0.0（実 BM42/bge-reranker・新規 recipe_hybrid_test 576点で検証）。知見: BM42 日本語弱・bge-reranker Cross-encoder 日本語優秀。scripts/add_sparse_index.py・tests/conftest.py（実モデル非ロード分離）追加。PM-001 v4.14.0（FUT-47 70%/FUT-50 80%・テスト282）・quality CHANGELOG v1.5.0。 v0.6.6: v3.0 ローカル精度機能を search に統合配線（課金ゼロ・既定OFF・後方互換）。DES-002 v0.13.0（Settings フラグ・処理順序・crag 応答・グレースフル縮退）。PM-001 v4.13.0（FUT-47/49/50 を 70%・テスト 270→281・カバレッジ 66.0%）。独立レビュー（Workflow 4観点）で Major 3件是正（WARN-4 instructions 明記／Sparse 厳格化／Cross-encoder 最終ランカー化）。qdrant_search.sparse_search・config フラグ・server.py instructions ガード追加。 v0.6.5: v3.0 ローカル精度機能（課金ゼロ・mock 安全）実装に伴う同期。REQ-002 v0.3.2（NFR-308 ライセンス確認済＝bge-reranker/fastembed Apache-2.0・FlagEmbedding MIT）・PM-001 backlog v4.12.0（FUT-47/49/50 着手・テスト 231→270・カバレッジ 65.3%）。新規モジュール hybrid_search.py（FUT-47 RRF+Sparse）・crag.py（FUT-49・FR-305 WARN-4 遵守）・cross_encoder.py（FUT-50・N≤5）は全て mock 安全。4レンズ独立レビュー（Workflow）で確定 Critical/Major ゼロ。 v0.6.4: FOLLOWUP3 自律実行。M10 テスト基盤完遂（FUT-26/27/28/29: pytest ハング解消＝sleep モック化で 50s→18s・test_recommender 決定論化・CI/CD 01_Recipe/.github/workflows/ci.yml・カバレッジ 56%→63.9%（ゲート60%）・E2E test_mcp_response_format.py・テスト 183→231）。ISS-038 解決（SCR-001/002 を v0.2.0 approved へ近代化＝v2.0 実装 UI 5系統反映・HTML 化 13→15）。ISS-036 解決（prompt-log 自動同期 PoC ~/.claude/scripts/promptlog_sync.py・実データ適用）。ISS-030 設計反映（OPS-001 v0.7.0 §2.11 Ingest 自動運用・setup_ingest_scheduler.sh）。FUT-48 着手（query_rewriter.py HyDE/Step-back/Decompose・10テスト）。E 軽微（CHANGELOG 注記統一・docmap_link_check.py ゲート化）。SCR-001/002 0.1.0→0.2.0・OPS-001 0.6.0→0.7.0。 v0.6.3: FOLLOWUP2 P8（独立レビュー指摘対応＋コミット前整合）。①DES-002 を v0.11.0→v0.12.0（ISS-032 の extractor 内部 API＝pdf_page_count/page_range/バッチ分割 Note を反映）。②ステータスドリフト是正: DES-001/002/003 は frontmatter が approved だが本表が「ドラフト」表記だった不整合を「承認済」に統一。③QA-UAT-MD2HTML を v1.0.1（変換器の制御文字難読化耐性補強）。④独立レビュー記録 REV-FOLLOWUP2-INDEPENDENT 実体作成（前倒し登録リンク切れ是正）。⑤PM-001（backlog）v4.10.0 同期（ISS-031/032/037/039/040/042 解決・オープン 11→5）。 v0.6.2: FOLLOWUP2 P3（ISS-041 Web ホスティング準備）。ホスティング計画書 PM-HOST（docs/pm/doc-hosting-plan.md）を新規登録。Cloudflare Pages + Access（無料・プライベート可） を推奨主案に選定。機密スキャンで L4 秘密ゼロ確認（L2 内部情報のためプライベート公開推奨）。md→html→deploy パイプライン（scripts/build_html_docs.py → scripts/deploy_docs_site.sh・dry-run 既定）整備。公開操作（公開範囲・認証要否）のみユーザー判断。 v0.6.1: FOLLOWUP2 P2（ISS-040 主要ドキュメント HTML 化）。scripts/build_html_docs.py（md_to_html.py の一括バッチ＋--verify 同期検証）を新設し、主要13ドキュメント（REQ-001/002・DES-001〜003/009・MAN-001〜003・OPS-001・CORP-001・DOCUMENT-MAP・backlog）の HTML 版を docs/_html/ に生成。md↔html 同期は見出し数・テーブル行数パリティで 13/13 PASS。本「HTML ビュー」索引を全13件へ拡充。 v0.6.0: FOLLOWUP2 P1（ISS-039 全ドキュメント最新化）の集約反映。版同期: REQ-001 0.9.0/draft→1.0.0/承認済（Phase 2.1-D の +4 MCP ツール要件 F-MCP-015〜018 追記し実装一致を確認・approved 昇格）、REQ-002 0.3.0→0.3.1（Turso 無料枠数値を本文で 5GB/500M rows read に統一・整合是正）、DES-004 0.2.0→0.3.0/承認済（Phase 3.0 Turso 環境分離節追加）、QA-001/QA-002 1.0.0→1.1.0（新 MCP 4種の検証計画・チェック項目 TST-05〜08・gho_ 追記）、PM-CST 1.2.0→1.3.0（Phase 2.1-D 実績・Phase 3.0 コスト参照・frontmatter 逆転是正）、CORP-001 1.4.1→1.4.2・CORP-002 1.0.0→1.1.0（休眠明示）。各 CHANGELOG（requirements×2・design・quality・pm・corporate）同期・欠落補填。新規登録: QA-UAT-MD2HTML（ISS-042 md_to_html ユースケース・46テストPASS）・PLAN-FOLLOWUP2（本セッションマスター計画）。frontmatter_check 全 PASS。 v0.5.7: 次セッション準備（FOLLOWUP2）。PM-001（backlog）を v4.9.0 に同期（ISS-039〜042 起票＝全ドキュメント最新化／主要HTML化／Webホスティング／md_to_html 正式テスト）。過去 prompt-logs 未更新状態 94件クローズ。次セッション引き継ぎは LLM-work-logs/next-session-prompt-FOLLOWUP2-2026-06-06.md。HTML 版（backlog.html）も v4.9.0 反映で再生成。

v0.5.6: 前セッション引き継ぎ完遂（PLAN-SESSION-CLOSE-FOLLOWUP）。①SCR-001/002 誤記是正: 「実体欠落・要精査」は誤判定で、実体は 01_Recipe/docs/screen/screen-design.md・screen-transition.md（共に v0.1.0 draft）に存在＝正本明示・内容近代化は ISS-038 へ。②死リンク是正: manual/operation/screen の CHANGELOG と REQ-001 を ../01_Recipe/docs/ 正本へ修正（RAG root に実体なし）・「要件定義」二重見出しを横断系/固有系に分離・全55リンク実在を検証。③docs/_html/ 索引新設（DOCUMENT-MAP・backlog の HTML 版・scripts/md_to_html.py 生成）。④配置判定ルール明示（横断系=RAG root／固有系=01_Recipe・doc-management.md §配置判定 へ追記）。⑤PM-001（backlog）を v4.8.0 に同期（ISS-038 起票）・PM管理に FOLLOWUP 計画/レビューを登録・PM-DEC を v1.4.0 に同期。

v0.5.4: PLAN-SESSION-CLOSE-2026-06-06 の A-1/B-2 反映。①PM管理に REV-ISS-035-REDEPLOY-PARALLEL（v1.0.0）・PLAN-SESSION-CLOSE（v1.1.0）・REV-SESSION-CLOSE-PLAN-INDEPENDENT（v1.0.0）を追加登録、PLAN-ISS-035 を v1.2.2 に同期。②ドキュメントドリフト是正: DES-001〜003 / MAN-001〜003 のバージョンを実体（01_Recipe/docs/）に同期（DES-001 0.9.0→0.10.0・DES-002 0.10.0→0.11.0・DES-003 0.6.0→0.7.0・MAN-001/002 1.1.0→1.2.0・MAN-003 1.2.0→1.3.0）。③パス参照是正: DES-001〜004 / OPS-001 / MAN-001〜003 のリンクを実体 ../01_Recipe/docs/ に修正（正本明示）。④SCR-001/002 は実体欠落のため「未作成・要精査」に是正（引き継ぎ）。

v0.5.3: 並列レビュー指摘対応。PM管理セクションに PLAN-ISS-035-REDEPLOY（v1.2.1）・REV-ISS-035-REDEPLOY-INDEPENDENT（v2.0.0）を索引登録（従来未登録の是正）。

v0.5.2: ISS-035 予備経路の恒久対応を再評価（option(b) Qdrant REST 直叩きを推奨主案に格上げ・機構自律実証・即実行スクリプト追加）。PM-DEC を v1.3.0、PM-001（backlog）を v4.6.0 に同期。

v0.5.1: ISS-035（Qdrant keepalive）の根本原因特定・恒久対応を反映。PM-DEC（意思決定ログ）を v1.2.0 に更新（DEC-009 追加）。

v0.5.0: Phase 3.0 上流確定を反映。DES-009（Phase 3.0 基本設計書）を新規追加・索引登録。REQ-002 / PM-PHASE-3.0 / COST-PHASE-3.0 の3文書を status: review → approved へ昇格。Sprint A-1（FUT-46 Turso PoC）・Sprint A-2（FUT-45 構造化抽出 PoC）の実装着手を Phase 3.0 上流条件の確定として記録。

v0.4.0: Phase 2.1-D（FUT-41〜44）対応のドキュメント追加を反映。設計書索引に DES-005（コース料理組立）・DES-006（生成レシピ取込）・DES-007（定期重複検出）・DES-008（検索高速化研究サイクル）を追加。PM 系索引に plan-phase-2.1-D.md を追加。OPS-001 を v0.6.0 に更新。

v0.3.2: 人間領域ディレクトリを .human/ → _human/ にリネーム（Obsidian 互換性のため）に伴い、関連文書のバージョンを更新。MIG-001 v0.3.1、MIG-001-PHASE4-REPORT v1.1.0、PM-001 v4.2.7、全体 CHANGELOG v0.4.0 ([1.7.0])。Strict-MD 領域は 54/54 PASS を維持。

v0.3.1: MIG-001 フェーズ4 完了に伴い反映。migration/ カテゴリに MIG-001-PHASE4-REPORT v1.0.0 を追加、MIG-001 を v0.3.0（クローズ）へ更新。Strict-MD 領域に PDF/PDF_merge/docs/ 12 ファイルを正式組入（53/53 PASS）。PM-001 のバージョンを 4.2.5 へ反映。

v0.3.0: MIG-001 フェーズ3 ステップ3-7 で migration/ カテゴリ追加（MIG-001 v0.2.3 / MIG-SAMPLE-001 v0.1.0）。ID 採番ルール表に PM / CORP / QA / MIG プレフィックスを追記。PM-001 のバージョン整合修正（4.2.3 → 4.2.4）。

本ファイルはプロジェクトの全ドキュメントの索引である。 ドキュメントの追加・削除・移動時に必ず更新すること。

---

ドキュメント一覧

要件定義（固有系・正本: 01_Recipe/docs/requirements/）

Phase 3.0 横断要件 REQ-002 は横断系（RAG root）として後掲「要件定義（横断系）」に別掲する。

基本設計（DES-001〜008 正本: 01_Recipe/docs/design/ ／ DES-009: docs/design/）

画面設計（SCR-001〜002 正本: 01_Recipe/docs/screen/）

注（2026-06-07・ISS-038 解決）: SCR-001/002 を v0.2.0（approved） に近代化。v0.1.0 の「専用 Web UI は構築しない」記述を撤回し、v2.0 実装済みの UI 5系統（MCP チャット／MCP Apps レシピカード ui://recipe/card.html／Web UI static/index.html（音声入力）／モニタリング /api/stats／管理 CLI）を反映。v3.0 UI 方針（UI 不変）も追記。HTML 版（_html/SCR-001.html・_html/SCR-002.html）も生成。

運用設計（OPS-001 正本: 01_Recipe/docs/operation/）

マニュアル（MAN-001〜003 正本: 01_Recipe/docs/manual/）

PM管理（docs/pm/）

要件定義（横断系・Phase 3.0 上流: docs/requirements/）

※ REQ-001（v1.0〜v2.1 機能要件）は固有系（前掲「要件定義（固有系）」・正本 01_Recipe/docs/requirements/）。本セクションは Phase 3.0 横断要件のみ。

廃止: progress.md, issues.md → backlog.md に統合 / quality-gate-log.md → docs/quality/gate-results/ に移行

コーポレート管理（docs/corporate/）

サブディレクトリ:

• corporate/agent-evaluations/ — MBO評価結果
• corporate/audit-reports/ — @auditor監査レポート

移行・再編プロジェクト（docs/migration/）

品質管理（docs/quality/）

品質ゲート実施結果: docs/quality/gate-results/ 配下に蓄積

変更履歴（各ディレクトリの CHANGELOG.md）

二系統構造に対応し、CHANGELOG も横断系（RAG root）と固有系（01_Recipe）に分かれる。下表は実体所在を正確に示す（v0.5.6 で manual/operation/screen の死リンクを是正）。

RAG root docs/（横断系）:

01_Recipe/docs/（固有系・正本）:

HTML ビュー（docs/_html/・scripts/md_to_html.py 自動生成・ISS-040）

主要ドキュメントの HTML 版を scripts/build_html_docs.py（md_to_html.py の薄いバッチ）で一括再生成する。md↔html 同期は見出し数（H2-H6）・テーブル行数のパリティで検証する（--verify）。

# 一括再生成（30件）
PYTHONUTF8=1 python scripts/build_html_docs.py
# md↔html 同期検証（見出し・テーブル行パリティ）
PYTHONUTF8=1 python scripts/build_html_docs.py --verify

HTML は読み取り用ビュー。正本は .md。.md 更新後は build_html_docs.py で再生成する（外部依存なし・1ファイル完結・決定論的）。対象一覧と link-prefix は同スクリプトの DOCS で管理する。新規ドキュメントを HTML 化する場合は DOCS に1行追加する。

廃止ドキュメント（docs/archived/）

---

ドキュメント ID 採番ルール

連番は各カテゴリ内で 001 から昇順に付与する。