コンテンツにスキップ

意思決定

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

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

Decisionは、何を決めたかだけでなく、なぜその判断をしたのかを残すために使います。

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

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

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

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