最終更新: 2026/06/22 18:56
commonid: adr-lint-rule-references-sectiontype: how-tostatus: active

references-section — テンプレ正規構造の §参照 (References) 必須化

上位 doc: §6.10 in adr-lint_rules.md — Summary Table 集約参照

id: references-section
severity: error
category: structure
since: 2026-06-05
status: active
fixable: true
description: ADR-0019 以降の Standard/Critical mode ADR は §参照 (References) または §関連 ADR セクションを持つ。0001-0018 (テンプレ以前の grandfather) と Light mode (単一節記述が正規) は免除
related_adrs: [ADR-0024]

Rationale

body-generation prompt (テンプレ SSoT = prompts/production/body-generation/prompt.md) の正規構造は最終セクションに ## 参照 (References) (関連 ADR / 関連 PR/Issue / 外部資料 の bullet) を持つが、lint による機械強制がなく「あったりなかったり」の drift が許容されていた (2026-06-04 調査: 当時 118 件中、項番付き含め 99 件あり・なし 19 件は全て grandfather 世代)。関連 ADR の明示は Gate 2 consistency の人間レビュー・ADR 間依存の追跡 (ADR-0107 構想) の前提となるため、テンプレ確立後の ADR に対し存在を機械強制する。

❌ FAIL Example

# ADR-0150: t
- **Mode**: Standard
## コンテキスト
...
## Confirmation
...
(§参照なしで終わる)

✅ PASS Example

## 参照 (References)
- 関連 ADR: ADR-0042 (拡張元)
- 関連 PR/Issue: #1326
- 外部資料: -

項番付き (## 7. 参照 (References))・変名 (## 関連 ADR / ドキュメント — ADR-0020 形式) も許容。

Migration / Corrigendum

  • 導入時点で違反 0 件 (grandfather 0001-0018 は filenum gating で免除・0020 は変名許容で pass)
  • 既存 ADR に追記する場合は corrigendum 不要 (§参照は決定本文でないため direct 追記可)

References