decisiondecided

更新運用 種別ごとに使い分け

Context

  • 人間が運用すれば重複や結論の反転は必ず起きる
  • 完璧な統合を目指すと続かない
  • 認知負荷を耐えられる範囲に保つのが最重要

Options

案認知負荷トレーサビリティ継続性合計
全て追記型(Baseline)0000
全て上書き型+—+0
種別ごとに使い分け++++3

Decision

種別ごとに使い分ける。

種別更新方式参照パラダイム
Decision追記型(supersede、旧文不変)ADR 原典
Reference上書き型(last_updated 記載)Wiki / DG
Page (info)上書き型Wiki
Page (legal)追記型(revision++)法的文書管理
Log不変(誤字修正のみ)ログの定義

Rationale

  • 判断は「当時なぜそう決めたか」が価値、書き換えると失われる
  • 事実・技術情報は最新版が読まれるべき
  • 法的文書は発効日保全が必須
  • Log は書き換えると「生」の意味を失う

重複・矛盾への対処

  • 気づいた時点で片方を deprecated、→ R-XXXX に統合済み の1行を冒頭に追加
  • 本文は消さない
  • 完璧を目指さない

月次レビュー

  • 毎月1回、15分だけ decisions/ を眺める
  • backlink 0、同一タグ内の重複候補を目視確認
  • 対処は「気づいたら」で可

Consequences

  • Positive: 種別に最適化された運用、認知負荷最小化
  • Negative: 更新時にも種別判断が必要(許容)
  • Follow-up: backlink 0 検出スクリプトは Deferred