# Migrate: перенесіть проєкт Lagune на маніфесті на навички й плагіни

> Перенесіть проєкт Lagune на основі маніфесту на Lagune на основі навичок, зберігши принципи безпеки, артефакти, відстеження й власні спеціалізації.

Канонічна URL-адреса: https://lagune.ai/uk-UA/docs/commands/migrate
Мова: uk-UA
Оригінал: https://lagune.ai/docs/commands/migrate
Останнє оновлення: 2026-11-03

🔀 Перенесіть проєкт **Lagune** на основі маніфесту на **Lagune** на основі навичок, зберігши все, що ви написали.

**Повідомлення про застарілість**

Проєкт із маніфестом працюватиме як є до `v1.x`: `npx lagune` передає `init`, `pull`, `update`, `add`, `remove`, `list` і дашборд версії `lagune@0.15.0`, останній на основі маніфесту.

## Перенесення

1. Переконайтеся, що поточну роботу закомічено, а потім виконайте migrate з кореня проєкту:

   ```bash
   npx lagune migrate
   ```

2. Закомітьте зміни, які вона внесла, окремим комітом, щоб перенесення залишилося однією зміною, яку легко переглянути.
3. Встановіть команди для свого агента, як показано на [сторінці встановлення](https://lagune.ai/uk-UA/docs).
4. Якщо в проєкті вже є артефакт detect, plan чи harden, попросіть [`/lagune-repair`](https://lagune.ai/uk-UA/docs/commands/repair) узгодити старі посилання в них і у ваших власних спеціалізаціях:

   ```prompt
   /lagune-repair Узгодь застосовані спеціалізації (раніше sub-skills) в артефактах у `.lagune/memory/` (`detect.md`, `plan.md` і `harden.md`) з назвами, які наводить новий каталог, і перепиши кожен виклик, який мої власні спеціалізації в `.lagune/catalog/` роблять до старих хуків у `.lagune/hooks/`, як виклик інструмента `lagune_read` або `lagune_write`.
   ```

## Що змінюється

| До                                                                    | Після                                                                             |
| --------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `.lagune/templates/`, `.lagune/hooks/` і `.lagune/specializations.md` | Видалено: кожна навичка містить свій шаблон, а хуки виконує рушій                 |
| Копії вбудованих спеціалізацій у `.lagune/skills/`                    | Видалено: вбудовані спеціалізації надає рушій                                     |
| Ваші власні спеціалізації в `.lagune/skills/`                         | Переміщено в `.lagune/catalog/`                                                   |
| `.lagune/skills.json`, індекс ваших власних спеціалізацій             | Об'єднано з `.lagune/configs.json`                                                |
| Категорії маніфесту                                                   | Записано в `.lagune/configs.json`                                                 |
| Старі команди агента, як-от `/lagune.detect`                          | Видалено: [встановлення **Lagune**](https://lagune.ai/uk-UA/docs) приносить нові, як-от `/lagune-detect` |
| Блок **Lagune** у `.gitignore`                                        | Видалено разом із файлом, якщо в ньому більше нічого не було                      |
| `.lagune/proofs/`, який ігнорував цей блок                            | Не потрапляє в коміти завдяки власному `.gitignore`                               |
| `.lagune/manifest.json`                                               | Видалено останнім                                                                 |

Ваша робота з безпеки залишається як є: принципи безпеки, артефакт, створений кожною фазою, і карта відстеження зі шляхами, на які вказує кожна знахідка.

## Часті запитання

### Чи обов'язково мігрувати?

Так. Проєкти на основі маніфесту застаріли й працюватимуть лише до v1.x, тож виконайте npx lagune migrate, щоб перенести свій.

### Що зберігає migrate?

Ваші принципи безпеки, кожен артефакт фаз, карту відстеження, ваші категорії й власні спеціалізації. Спеціалізації переміщуються в .lagune/catalog/, а їхній індекс об'єднується з вашими категоріями в .lagune/configs.json.

### Коли встановлювати нові команди?

Після migrate, як показує сторінка встановлення для вашого агента. Встановити їх спершу теж можна, бо migrate зберігає нову /lagune.

### Колега вже мігрував. Що мені запустити?

Отримайте зміни з перенесенням, а потім один раз виконайте npx lagune migrate. Вона видаляє те, що Lagune на основі маніфесту залишив у вашому клоні і чого система контролю версій ніколи не переносила, а також не пускає ваші доведення в коміти.