コンテンツにスキップ

意思決定

正本文書: decisions/ja/README.md / 編集を提案

このディレクトリには、重要な意思決定の記録を置きます。

意思決定は、何を決めたかだけでなく、なぜその判断をしたのかを残すために使います。通常は 提案 やレビュー文脈から生まれ、採用後は docs/jamodules/jaglossary に反映します。

flowchart LR
  Context["文脈<br/>Issue / 提案 / Review"]
  意思決定["意思決定<br/>決定・理由・影響"]
  Docs["docs / modules<br/>反映先"]
  Future["将来の変更<br/>再検討・更新・撤回"]

  Context --> 意思決定
  意思決定 --> Docs
  意思決定 --> Future
  Future --> Context
  • 重要な設計方針
  • 採用したアーキテクチャ
  • 却下した案と理由
  • ガバナンス上の判断
  • 用語や思想の定義

初期は 0001-short-title.md のような連番形式を推奨します。

意思決定は将来の参加者が背景を追えるよう、結論だけでなく文脈、理由、影響も書きます。