コンテンツにスキップ

ADR-0001 アーキテクチャ決定記録を残す

  • ステータス: 採用
  • 日付: 2026-06-20

背景

技術選定や設計判断の「なぜ」が失われると、後から参加する人間や AI が 同じ議論を繰り返したり、意図に反する変更をしてしまう。

決定

重要な技術的・構造的判断は ADR (Architecture Decision Record) として apps/docs/src/content/docs/adr/ に 1 件 1 ファイルで記録する。

書式は軽量に「背景 / 決定 / 影響」を基本とし、連番 + ケバブケースで命名する (例: 0002-monorepo-stack.md)。決定が覆った場合は新しい ADR を追加し、 古い ADR のステータスを「破棄」に更新する。

影響

  • 設計判断を伴う PR は ADR の追加・更新を伴う。
  • 決定の経緯がドキュメントサイトから検索・閲覧できる。