# Plans Maintenance

最終更新: 2026-03-06

`Plans.md` は正本ですが、長期間そのまま伸ばし続けると「過去の完了表現」と「現在の repo 状態」がずれやすくなります。
この文書は drift を減らすための最小運用ルールです。

## Lightweight Rule

1. 新しい大きな改善フェーズを始める前に、直近 1〜2 phase だけを active zone として扱う
2. それより古い完了フェーズは、必要なら `docs/plans-history/` などの履歴置き場へ退避する
3. 「削除」「移行完了」など current tree と衝突しやすい文言は、後続フェーズで状態が変わった時点で補正文を入れる
4. README / docs / `.gitignore` / build scripts の扱いを変えたときは、同じ commit で `Plans.md` の表現も直す

## When to Archive

次のどれかを満たしたら、古い完了フェーズのアーカイブを検討する。

- `Plans.md` の主要作業対象が 3 phase 以上前まで見に行かないと分からない
- 「削除済み」「統合済み」などの語が current repo と誤解を生む
- sync-status のたびに過去履歴の読み込みコストが気になる

## Recommended Shape

- `Plans.md`: 現在の active phase と、直近の完了 phase のみ
- `docs/plans-history/`: 過去 phase の固定スナップショット
- `docs/distribution-scope.md`: 残置物や配布境界の current truth

## Phase 21 Decision

- 今回は archive までは実施せず、まずは **誤解を生む完了表現の補正** を優先した
- 次の大きな phase 追加前に、Phase 17 以前の完了履歴を `docs/plans-history/` へ退避するのが推奨