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

MIGRATE — Эволюционная миграция файлов
---------------------------------------

КОНЦЕПЦИЯ
-------
Для переименования файлов или изменения пути:
Вместо изменения всех ссылок одновременно используйте файл-оболочку.
Ссылки корректируются органически при ежедневном использовании.

ПОЧЕМУ?
------
- Никаких резких перерывов.
- Ссылки будут обновляться постепенно.
- Каждый партнёр исправляет то, что ему прислали
- Никаких забытых ссылок

ПРОЦЕДУРА
--------
1. Переименовать файл:
   mv старый_файл.md новый_файл.md

2. Создайте обертку (old_file.md):
   - Сообщение о статусе «перенаправлено»
   - Журнал регистрации посетителей
   - Инструкция: Проверить + исправить происхождение
   - Ссылка на новый файл

3. НЕМЕДЛЕННО исправьте критические ссылки:
   - docs/help/*.txt (основная документация)
   - Системный код, который использует путь напрямую
   - Обработчик CLI

4. Другие эволюционные мигранты мигрируют:
   - Правильные партнёры при использовании
   - Path Healer находит автоматически
   - Обнаружение вручную

ШАБЛОН WRAPPER
----------------
# OLD_FILE - REDIVERTED

Состояние: Этот файл был переименован в `new_file.md`

## Migration-Log

| Дата | Кто | Происхождение | Ссылка исправлена? |
|-------|-----|----------|---------------------|
| | | |

|## Инструкции

1. Оставить запись в журнале
2. Проверьте свое происхождение (что привело вас сюда?)
3. Исправьте там ссылку
4. Перейдите к фактическому файлу

**Целевой файл:** [new_file.md](new_file.md)

WHEN WRAPPER?
-------------
ДА (оболочка имеет смысл):
  - Множество потенциальных рефералов
  - Названы различными партнерами.
  - Нет критического системного файла

НЕТ (изменить все напрямую):
  - Мало известных упоминаний
  - Критические системные файлы
  - Критические пути производительности

ОЧИСТКА
-------
Через 30 дней или когда журнал пуст:
  bach trash delete <wrapper>

АВТОМАТИЧЕСКАЯ ПОДДЕРЖКА
---------------------------
  bach --maintain heal       Автоматически находит устаревшие пути
  bach --maintain docs       Обнаруживает устаревшую документацию

ПРИМЕР
--------
ROADMAP_ADVANCED.md → ROADMAP.md (2026-01-24):

  1. мв ROADMAP_ADVANCED.md ROADMAP.md
  2. Создана оболочка ROADMAP_ADVANCED.md.
  3. docs/help/formats.txt исправлен (критично)
  4. Более 20 других ссылок → эволюционные

СМОТРИТЕ ТАКЖЕ
----------
  навыки/рабочие процессы/migrate-rename.md Подробный рабочий процесс
  docs/help/practices.txt Принцип № 3: Эволюционная миграция
  bach --maintain heal                  Автоматическая коррекция пути
  bach --maintain docs                  Обнаруживает устаревшую документацию
