意思決定

原文: GitHubで原文を見る / 編集を提案

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

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

位置づけ

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

  Context --> 意思決定
  意思決定 --> Docs
  意思決定 --> Future
  Future --> Context

  click Context "/proposals/" "Issue / 提案 / Review"
  click 意思決定 "/decisions/" "意思決定"
  click Docs "/docs/" "docs / modules"
  click Future "https://github.com/acecore-systems/world-foundation/issues" "再検討・更新・撤回"

書くべきもの

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

命名

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

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

意思決定一覧