10. Миграция на v1.0-draft¶

Для команд, которые уже вели требования «по-своему» или на ранних черновиках RENAR. Цель — без big-bang: сохранить неизменяемые ID, заменить deprecated конструкции, выпустить новый conformance manifest. Нормативная база — standard/04 §4.14, CHANGELOG §Migration.

Не путать с 02-transition-guide — там поэтапный вход в RENAR-1..5 с нуля; здесь — breaking rename и выравнивание схемы при переходе на текущую редакцию стандарта.

1. Когда нужна эта миграция¶

Ситуация	Действие
Проект без RENAR, но есть ТЗ + Jira	Сначала 02-transition-guide, не этот документ
Файлы с `INT-SR`, `INT-TC`, `AIC`, `UIC`, `TS`	Это руководство
`verifies[].version` без `requirement-version`	Обновить TC frontmatter (reference/02 §8)
Manifest `renar-version: 0.1-draft` или отсутствует	Выпустить новый manifest (reference/08)

2. Таблица замен типов (closed list v1.0-draft)¶

Deprecated	Canonical	Шаг миграции
`INT-SR`	`SR` + `constrained-by: [SPEC-INT-N]`	Переименовать type; создать/привязать SPEC-INT
`INT-TC`	`TC` + `tc-type: contract`	Добавить `type: TC`, `tc-type: contract`
`AIC`	`SPEC-AI`	Перенести body в SPEC-AI frontmatter
`UIC`	`SPEC-UI`	Перенести baselines в `specs/ui/baselines/`
`TS`	`SPEC-ARCH` или `SPEC-OPS`	По содержанию (архитектура vs ops runbook)
`TM` (module SR type)	`SR` + `level: module`	Убрать pseudo-type, задать level

ID не менять. Если filename содержит legacy prefix — допустимо поле legacy-id во frontmatter (informative traceability).

3. Пошаговый план (1–2 спринта)¶

Фаза A — инвентаризация (1–2 дня)¶

grep / search по носителю: INT-SR, INT-TC, AIC, UIC, type: system (ошибочный TC type).
Список артефактов с broken verifies / missing source.adapt.
Зафиксировать текущий RENAR-CONFORMANCE.yaml (если есть) как опорное состояние.

Фаза B — проход по схеме (3–5 дней)¶

Batch-rename типов по таблице §14 (один PR на тип или один atomic change-set на delta-ТЗ).
TC: type: TC, tc-type, verifies[].requirement-version, last-run.requirement-version.
SR: constrained-by[] на все используемые SPEC.
BR: source.adapt на approved ADAPT.

Фаза C — валидация (1–2 дня)¶

Hooks носителя / CI: frontmatter validator (reference/02).
Прогнать TC; обновить last-run.
Чек-лист самооценки — reference/08 §14.

Фаза D — manifest (1 день)¶

Bump renar-version: "1.0-draft".
Increment manifest-version; новый manifest-id.
Подпись Architect / Tech Lead (V6).

4. Частые ловушки¶

Ошибка	Последствие	Исправление
Переименовать `SR-05` → `SR-05-v2`	Нарушение V1 immutable ID	`deprecated` + новый ID с `replaces`
Оставить `type: system` на TC	Validator fail; KG drift	`type: TC` + `tc-type: system`
Мигрировать код раньше `.req`	SoT inversion нарушена	Сначала SR/SPEC/TC approved, потом TR
Skip ADAPT «только для новых ТЗ»	Non-conformant для legacy TZ	Ретроспективный ADAPT на каждое активное ТЗ

5. Откат¶

Миграция идёт через историю носителя (V1). Откат — revert change-set / PR, не delete артефактов. Deprecated артефакты остаются с status: deprecated для audit.

6. Связанные документы¶

Документ	Зачем
02-transition-guide	RENAR-1..5 без schema breaking changes
09-worked-examples	Эталонные frontmatter после миграции
reference/07	Внешнее заявление ISO 29148
standard/13 §13.7	Re-assessment после миграции

Guide RENAR 1.0-draft — renar.tech