Context
- 人間が運用すれば重複や結論の反転は必ず起きる
- 完璧な統合を目指すと続かない
- 認知負荷を耐えられる範囲に保つのが最重要
Options
| 案 | 認知負荷 | トレーサビリティ | 継続性 | 合計 |
|---|
| 全て追記型(Baseline) | 0 | 0 | 0 | 0 |
| 全て上書き型 | + | — | + | 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