背景
PR #706 で docs/tools.md の目次を全 27 ツール網羅へ更新した。その際のレビューで指摘された改善提案を issue 化する。
現状 tests/meta/tools-docs-coverage.test.ts は src/data/tools.ts ↔ docs/tools.md の ### 見出しカバレッジ(欠落 / orphan / 重複)を CI で強制しているが、目次(目次セクション)のアンカーリンク自体の整合性は無保護。
そのため、将来見出しをリネーム・追加した際に目次の [...](#anchor) リンクが silent break しうる(PR #706 では全 31 リンクを github-slugger で機械照合し破損 0 件を確認済みだが、これは恒久的なガードではない)。
提案
docs/tools.md の目次内アンカーリンクが、実在の見出しから生成される GitHub slug と一致することを検証する meta テストを追加する。
- 本文の H2/H3 見出しから
github-slugger(GitHub と同一の slug 生成器。devDependency として追加要否を確認)で実アンカーを生成
- 目次セクションの
[...](#...) リンクを抽出し、生成アンカー集合と機械照合
- 破損リンク(参照先の見出しが存在しない)を fail として検出
test-gates 要件
これは「検知機構(validator)」の追加にあたるため、test-gates skill に従い 陽性対照(意図的に壊れたアンカーを注入すると検出される / 正常時は過検知しない)を必ず併設する。
スコープ
背景
PR #706 で
docs/tools.mdの目次を全 27 ツール網羅へ更新した。その際のレビューで指摘された改善提案を issue 化する。現状
tests/meta/tools-docs-coverage.test.tsはsrc/data/tools.ts↔docs/tools.mdの###見出しカバレッジ(欠落 / orphan / 重複)を CI で強制しているが、目次(目次セクション)のアンカーリンク自体の整合性は無保護。そのため、将来見出しをリネーム・追加した際に目次の
[...](#anchor)リンクが silent break しうる(PR #706 では全 31 リンクをgithub-sluggerで機械照合し破損 0 件を確認済みだが、これは恒久的なガードではない)。提案
docs/tools.mdの目次内アンカーリンクが、実在の見出しから生成される GitHub slug と一致することを検証する meta テストを追加する。github-slugger(GitHub と同一の slug 生成器。devDependency として追加要否を確認)で実アンカーを生成[...](#...)リンクを抽出し、生成アンカー集合と機械照合test-gates 要件
これは「検知機構(validator)」の追加にあたるため、
test-gatesskill に従い 陽性対照(意図的に壊れたアンカーを注入すると検出される / 正常時は過検知しない)を必ず併設する。スコープ