Composition Rewrite Runbook
1. Операционный обзор
Функция:
-
даёт AI-assisted rewrite через preview/apply;
-
не должна ломать source composition при сбоях;
-
при недоступности должна уступать место ручному composition editing.
Критичность:
-
средняя
2. Владение и модель поддержки
Основной владелец:
-
владелец rewriter / AI adapter layer
Смежные владельцы:
-
владелец composition editor workflow
-
владелец engine preview/apply integration
3. Ключевые сигналы и наблюдаемость
На что смотреть:
-
repeated preview failures;
-
provider errors;
-
high rate of rejected previews;
-
placeholder validation failures at apply stage;
-
inconsistencies between preview and apply behavior.
4. Типовые сбои
Типовые failure modes:
-
stale or invalid composition selection Preview cannot start.
-
no configured rewriter Rewrite workflow unavailable.
-
overly aggressive patch set Preview exists, but user cannot safely apply it.
-
placeholder breakage Apply blocked by engine validation.
5. Реакция на инцидент
Порядок действий:
-
Проверить rewrite configuration.
-
Проверить выбранную composition и version.
-
Сравнить preview output с expected representative case.
-
Если apply ломается, проверить placeholder validation path.
-
При необходимости перевести пользователя на manual composition editing.
6. Режимы деградации
Допустимые режимы деградации:
-
отключить rewrite workflow;
-
оставить preview disabled;
-
продолжать ручное composition editing.
7. Восстановление и проверка
После исправления:
-
Повторно получить preview на representative composition.
-
Убедиться, что preview inspectable и не пустой там, где ожидаются изменения.
-
Проверить apply на безопасном representative case.
-
Убедиться, что published new versions соответствуют preview intent.