Design Notes
決定が批准される前に書かれる、将来を見据えた設計ドキュメント — ロードマップ、スライス分割の決定、機能スケッチです。問題空間を探索し、選択肢を比較検討し、方向性を提案します。
これらのドキュメントは非規範的です。ここでの設計が採用されると、ADR(根拠)や型仕様/内部仕様(拘束力のある挙動)へと昇格します。拘束力を持つのは仕様とADRであり、設計ノートには拘束力はありません。ノートは部分的に置き換えられたり、陳腐化したり、一度もスライスされないこともあります — 依拠する前に、各ノート冒頭のStatus行を読んでください。
ファイル名はYYYYMMDD-<slug>.mdで、執筆日を日付とします。
設計ノートの追加
Section titled “設計ノートの追加”- 執筆日を使ってファイルを
YYYYMMDD-<slug>.mdと名付けます。 - 種別(Draft/Design note/Research/Investigation/Planning)と何がそれを置き換えるかを述べる
Status:行で始めます。 - 上記の索引テーブルに行を追加します。
- 設計が批准されたら、ADRを起こすか仕様を改訂し、ノートのStatusを拘束力のあるドキュメントを指すよう更新します。
© 2026 TypedDuck. Licensed under CC BY-SA 4.0.