# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

MIGRATE - 進化的なファイル移行
---------------------------------------

コンセプト
-------
ファイルの名前変更またはパス変更の場合:
すべての参照を一度に変更する代わりに、ラッパー ファイルを使用します。
参考資料は毎日使用することで自然に修正されます。

なぜですか?
------
- 難しい中断は必要ありません。
- 参考資料は徐々に更新されます
- 各パートナーは送信された内容を修正します
- 忘れた参照はありません

手順
--------
1。ファイルの名前を変更します:
   mv old_file.md new_file.md

2.ラッパー (old_file.md) を作成します。
   - ステータスメッセージ「リダイレクトされました」
   - 訪問者用ログテーブル
   - 手順: 原点の確認 + 修正
   - 新しいファイルへのリンク

3.重要な参照を直ちに修正します。
   - docs/help/*.txt (一次ドキュメント)
   - パスを直接使用するシステムコード
   - CLI ハンドラー

4。他の進化的移民は次のように移動します。
   - 使用時にパートナーを修正する
   - パスヒーラーが自動的に検索します
   - 手動検出

WRAPPER-TEMPLATE
----------------
# OLD_FILE - REDIVERTED

ステータス: このファイルは `new_file.md` に名前変更されました

## Migration-Log

|日付 |誰 |由来 |参照は修正されましたか? |
|----------|-----|----------|----------|
| | | |

|## 指示

1.ログエントリを残す
2. あなたの出身地を確認してください (何があなたをここに送り込んだのですか?)
3. そこの参照を修正します
4. 実際のファイルに移動します

**ターゲット ファイル:** [new_file.md](new_file.md)

WHEN WRAPPER?
-------------
YES (ラッパーは意味があります):
  - 多くの潜在的な紹介者
  - さまざまなパートナーから参照されています
  - 重要なシステム ファイルがありません

いいえ (すべてを直接変更します):
  - 既知の参考文献がほとんどない
  - 重要なシステム ファイル
  - パフォーマンス クリティカル パス

クリーンアップ
-------
30 日後またはログが空の場合:
  bach trash delete <wrapper>

自動サポート
---------------------------
  bach --maintain heal       古いパスを自動的に検索
  bach --maintain docs       古いドキュメントを検出

例
--------
ROADMAP_ADVANCED.md → ROADMAP.md (2026-01-24):

  1. mv ROADMAP_ADVANCED.md ROADMAP.md
  2. ラッパーROADMAP_ADVANCED.mdを作成しました
  3. docs/help/formats.txt を修正 (重大)
  4. 20 以上のその他の参考文献 → 進化的

関連項目
----------
  スキル/ワークフロー/移行-rename.md 詳細なワークフロー
  docs/help/practices.txt 原則 3: 進化的な移行
  bach --maintain heal                  自動パス修正
  bach --maintain docs                  古いドキュメントを検出
