filename-pattern — ADR ファイル名 4 桁連番形式

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

id: filename-pattern
severity: error
category: structure
since: 2026-05-14
status: active
fixable: false
description: ファイル名が 4 桁連番 + ハイフン区切り (NNNN-*.md) で命名されている
related_adrs: [ADR-0023, ADR-0038]

Rationale

ADR ファイル名は NNNN-<kebab-case-title>.md 形式でなければならない (NNNN は 4 桁 0 詰め連番)。これにより ls docs/adr/ でソート時に採択順が保たれ、Pipeline スクリプト (scripts/adr-renumber.mjs 等) が正規表現 ^(\d{4})- で番号抽出可能になる。違反するとファイルが意図しない位置にソートされ、ADR-0049 などの番号参照と実ファイル名が乖離する。

❌ FAIL Example

docs/adr/adr-0054-foo.md     # NNNN- で始まっていない
docs/adr/54-foo.md           # 4 桁ゼロ詰めでない
docs/adr/0054_foo.md         # ハイフンでなくアンダースコア

✅ PASS Example

docs/adr/0023-standardize-adr-structure-nygard-madr-minimal.md
docs/adr/0054-bizlp-lint-rule-reference-establish-document-structure.md

References

• ADR-0023: ADR フォーマット標準化
• ADR-0038: adr-lint.mjs にメタデータ rule 追加
• 外部 FW: MADR (Markdown Any Decision Records) の連番命名規約