PJR-0146 履歴蓄積ファイル（plan/result/pjr-NNNN-<topic>等）はMarkdownリンクを禁止し[[id]]/パス表記に統一するルール化
1. 概要
plan/result/pjr-NNNN-<topic>等の履歴として蓄積されるファイルは、リンク先のファイル名変更時に修正が発生してしまうため、Markdownリンク[]()を使わず、docs/配下の参照は[[id]]、docs/外の参照・外部URLはパス表記/URLのままとするルールを定め、関連する記述ルール文書（例: markdown.instructions.md等）へ反映する
plan/result/pjr-NNNN-<topic> 等、履歴として蓄積される成果物には、リンク先ファイル名変更のたびに追従修正が発生する Markdown リンク（[]()）を含めない。docs/ 配下の文書を参照する場合は id を正とする [[id]]（wikilink）に統一し、docs/ 外のファイル（.github/instructions/ 等）や外部URLはリポジトリルートからの相対パス表記／URLそのままで記述するルールを定める。加えて、ルール違反（Markdownリンクの使用）を自動検知できるよう validation / lint チェックの仕組みを整備する。
[[id]] は specdojo index build の doc-index を介して id から解決するため、specdojo:id-and-file-naming-standard の「ファイル名を変更しても id は変更しない」原則の下では、参照先ファイルがリネームされても参照側の修正が不要になる。id が未解決の場合もビルドエラーにはならず [[id]] の文字列表示に留まる（src/doc-index.ts の replaceDocIndexRefs、.vitepress/config.mts の wikilink 変換ルールで確認済み）。
2. 完了条件
- 対象となる成果物種別（plan/result/pjr-NNNN-
<topic>等の履歴ファイル）が明文化されている。 docs/配下の参照は[[id]]、docs/外の参照・外部URLはパス表記／URLのまま、Markdownリンク（[]()）は使わない、という記述ルールが.github/instructions/配下のルール文書へ反映されている。- 既存の履歴ファイル内リンクの扱い（移行要否）について方針が決まっている。
- 対象ファイル種別に対して、Markdownリンク（
[]()）の使用を検知する validation / lint チェックが導入されている。 - 上記チェックが CI もしくは
npm run lint:md等の既存検証コマンドに組み込まれている。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 対象ファイル種別の洗い出し | ARC | done | plan / result / 個票（pjr-<NNNN>-<topic>）。pjr-index.md は対象外 |
| 2 | ルール文書への追記（[[id]]/パス表記の使い分け含む） | ARC | wip | ルール本文を確定。SSOT の instructions への反映は human 適用（申し送り） |
| 3 | 既存ファイルへの遡及要否の判断 | ARC | done | 既存に Markdown リンクなし。発見時に置換、一括遡及移行は不要と決定 |
| 4 | 対象ファイル種別に対するMarkdownリンク使用検知の validation / lint チェック設計・実装 | ARC | done | tools/docs/src/validate-history-links.ts（unit test 付き）を追加 |
| 5 | 検証コマンド（CI / npm scripts）への組み込み | ARC | wip | package.json / lefthook.yml への配線は human 適用（申し送り） |
4. 対応結果
確定したリンク記法ルール（履歴蓄積ファイル向け）:
- 対象は plan（
docs/ja/projects/**/exec/plans/）、result（docs/ja/projects/**/exec/results/）、個票（docs/ja/projects/**/controls/project-register/pjr-*.md）。登録簿本体pjr-index.mdは個票セルを Markdown リンクで参照するため対象外。 docs/配下の参照はidを正とする wikilink（[[id]]/[[id|表示名]]）に統一する。ファイルをリネームしてもidは変えない運用のため、参照側の追従修正が不要になる。docs/外のファイル（.github/instructions/など）はリポジトリルートからの相対パス表記、外部URLは URL そのまま（bare URL / autolink）で書く。- Markdown リンク（
[表示名](パス)）と参照リンク（[表示名][ラベル]+ 定義）は書かない。画像とページ内アンカー[..](#..)は対象外。
移行方針:
- 既存の plan / result / 個票に Markdown リンクは 0 件（調査済み）。一括の遡及移行は行わず、検査で検出された時点で上記記法へ置き換える方針とする。
導入した検査（validation / lint チェック）:
- 検出モジュール
tools/docs/src/history-links.tsと CLItools/docs/src/validate-history-links.tsを追加。[]()/ 参照リンクを検出したら exit 1。wikilink・bare URL・autolink・画像・アンカーは誤検知しない。 - unit test
tests/tools/docs/src/history-links.test.ts（11 ケース）で挙動を固定。npx eslint/npx tsc --noEmit/npx vitest runは成功。
human 適用が必要な残作業（sensitive file のため本 exec では未反映。詳細な差分は result の申し送りに記載）:
- 記述ルール SSOT
.github/instructions/markdown.instructions.mdへの節追加（本ルールの反映）。 package.jsonのcheckへのvalidate:history-links組み込み、またはlefthook.ymlpre-commit への検査追加。
5. 関連ドキュメント
- .github/instructions/markdown.instructions.md
- .github/instructions/specdojo-exec-workflow.instructions.md
- ドキュメントIDおよびファイル命名標準
- docs/外へのwikilink解決範囲拡張の要否検討