Wiki-only _Sidebar.md cannot be updated by source PRs, so nav drift blocks release sync

[liplus-lin-lay]

目的

docs/ に新しい文書を追加する PR が wiki のナビゲーションを更新できず、ドリフトがリリース同期の時点で初めて表面化して流れを止める。検出は設計どおり効いているが、捕まえる位置が遅い。

確認済みの事実

v1.19.13 (tag build-2026-08-02.1) の post-release wiki sync が、必須の整合性アサーションのうちサイドバー整合性で STOP した。commit / push は行われていない。

• _Sidebar.md に L.-Hop-Count-Instrument への参照が無い (大小無視の生 grep で 0 ヒット)
• 節見出しは **参考文書 (A-K)** のまま。最後の英字項目は K. Source File Format
• docs/L.-Hop-Count-Instrument.md は 34a8394 (Pin hop-count instrument, close self-eval zero-path, drop two restatements [rules, skills, adapter, docs] #1592、2026-07-28 merge) で追加済み
• _Sidebar.md はソースリポジトリに存在しない (git ls-files に無し)。wiki 専用ファイル

つまり #1592 は、自分が追加した文書をサイドバーに載せることが構造的にできなかった。ソース側の PR から触れないファイルだからである。

v1.19.12 は 2026-07-26 リリースで #1592 より前のため、本件が #1592 後の最初の同期機会だった。検出自体は最初の機会で作動している。

問題の位置

ドリフトの検出は効いている。問題は検出のタイミング:

• 発生する瞬間 = docs/ に英字文書を足す PR (安く直せる)
• 検出される瞬間 = 次のリリースの wiki sync (リリース完了ゲートが止まる)

さらに wiki sync skill は「サイドバードリフトは以前の PR の未整備を意味し、リリース同期は修復レイヤではない」として同期層での修復を明示的に禁止している。この禁止自体は妥当 (同期が黙って繕うとドリフトが不可視になる) だが、結果としてリリースが止まり、人間または親 AI が別途修復してから再実行するという経路しか残らない。

前提

• _Sidebar.md が wiki 専用であること自体は現行の設計。判断構造エントリ 59 件も wiki 側で直接オーサリングされており、docs/ = source of truth の例外として docs/Decision-Structure.md が索引のみを持つ構造と対応している
• 同期層で修復させない方針は維持する。可視性が下がるため

検討の方向 (いずれも未決。設計が要る)

1. PR 時点の CI チェック — docs/[A-Z].-*.md の追加を検出したら、対応するサイドバー更新が別途必要である旨を PR で警告 / 失敗させる。安い瞬間に寄せる方向
2. サイドバーの英字節をソース側から生成 — 節の英字部分だけを docs/ の実ファイル一覧から導出する。判断構造節は wiki オーサリングのまま残す。「同期が繕う」のではなく「生成物である」という位置づけに変える
3. サイドバーのソース・オブ・トゥルースをソース側に置く — wiki へは mirror する。判断構造エントリの扱いとの整合を要検討

1 と 2 は排他ではない。

完了条件

• docs/ に英字文書を追加した PR が、サイドバー未更新のままリリース同期まで到達しない (どの経路を採るかは設計次第)
• 同期層でのサイドバー修復禁止は維持されている
• 判断構造エントリの wiki オーサリング経路は壊れていない

対象ファイル (想定、設計により変動)

• skills/operations-on-wiki-sync/SKILL.md
• .github/workflows/ (CI 経路を採る場合)
• docs/6.-Adapter.md または該当する要求仕様書

参照

• Pin hop-count instrument, close self-eval zero-path, drop two restatements [rules, skills, adapter, docs] #1592 (34a8394) — 当該文書を追加した PR
• v1.19.13 の post-release wiki sync で表面化