FIELD NOTES FOR SYSTEM MAINTAINERS

保守運用ノート

動いて当たり前のシステムを、ひとりで守る人のための実務メディア

無料ツール|印刷用チェックリスト

設計判断の経緯を残すチェックリスト

書いた1枚を、この項目で見直してみてください。全部そろわなくても大丈夫です。

  • 「理由」が、事情や天秤(何と何を比べたか)まで書けているか
  • 検討してやめた案と、やめた理由を1つ以上書いたか
  • どうなったら見直していいか(見直すきっかけ)を書いたか
  • 日付と状態(採用/置き換え済み)が入っているか
  • 置き場所は決めた1か所(docs/decisions/ など)になっているか
  • コードや設定のそばから、記録にたどり着ける1行を足したか
  • 考えが変わったとき、古い記録を消さずに新しい1枚を足す運用になっているか
  • 理由が分からない過去の設計は、「分からなかった」ことを記録できているか

この内容は記事「設計判断の経緯を残す|「なぜこうしたか」を1枚に書く記録術」のチェックリストです。印刷してそのままお使いいただけます。 / 無料ツール一覧へ