numbered-header — ADR ヘッダー番号採番済

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

id: numbered-header
severity: error
category: structure
since: 2026-05-12
status: active
fixable: false
description: ADR ファイル冒頭に "# ADR-NNNN: " 形式の H1 見出しが存在 (番号が ??? でない)
related_adrs: [ADR-0023]

Rationale

ADR ファイルの先頭は # ADR-NNNN: <title> 形式の H1 見出しでなければならない。これにより GitHub UI / docs サイト検索 / Pipeline 自動採番 (ADR-??? → 番号置換) が正しく動作する。違反すると番号未確定状態の draft が main にマージされ、参照整合性 (Refines ADR-NNNN / Supersedes ADR-NNNN) が破壊される。

❌ FAIL Example

# ADR-???: 未採番ドラフト

# 未採番ドラフト
（# ADR-NNNN: 形式ではない）

✅ PASS Example

# ADR-0054: bizlp Lint Rule Reference 文書構造の確立 (Standard)

References

• ADR-0023: ADR フォーマット標準化 (Nygard / MADR ハイブリッド最小形)
• 外部 FW: markdownlint MD025 (single-title) — H1 単一性ルールと類似 (本 rule は番号付き H1 を要求)