# AGENTS.md — Launcher Next

## Scope

Эти правила относятся только к Launcher Next. Работать с текущей веткой и
локальными test fixtures; не делать production deployment, не менять default
branches и не создавать новую ветку или worktree без прямого задания.

## Общая карта проекта

Каноническая общая карта проекта:
`https://drive.google.com/drive/folders/1avnR0V8q7y5pfWRYwB6LPBEEyfpN7PpV`.
Необязательный локальный доступ к синхронизированной копии возможен только
через `PHIM_PLANT3D_PROJECT_MAP_ROOT`; путь синхронизации не хардкодить.

Перед архитектурной, package-lifecycle или runtime работой читать доступные
индекс/обзор карты, запись Launcher architecture и migration status, package
activation/rollback contract, индекс runtime evidence и записи затронутой
интеграции. Сверять их с локальным AGENTS.md, tracked documentation, code,
tests, configuration, фактическим `git rev-parse HEAD` и runtime evidence.

Приоритет источников: фактическое runtime evidence; code/tests/configuration
на проверенном Git HEAD; tracked documentation; общая карта проекта. Внешняя
документация не является build/runtime dependency и не переопределяет текущий
код или runtime evidence. Недоступность карты фиксировать как
`PROJECT_MAP_UNAVAILABLE`; несовпадение её commit/runtime status с фактическими
данными — как `PROJECT_MAP_STALE`. В обоих случаях продолжать только по
доступным источникам и явно сообщать расхождение.

## Launcher invariants

Launcher использует versioned local package, проверяемый manifest и один
managed entry assembly; Autodesk DLL не включаются в package и не загружаются
с UNC. Headless automation требует явного NextPilot mode, не создаёт Foundation
UI, не ожидает ввода и не возвращается в Legacy/default route при ошибке.
Production route не создаёт pilot session или automation manifest и не
использует `/b`.

До hashing сохранять immutable manifest и initial evidence; session/progress,
terminal evidence, cancellation, rollback и package activation должны быть
проверяемыми. Runtime evidence определяет реальный статус запуска AutoCAD,
активации и cleanup — build и unit tests его не заменяют.

После изменения Launcher architecture, package activation/rollback либо
runtime-status в отчёте перечислять документы карты, которые требуют
обновления: Launcher architecture, package lifecycle, runtime evidence index,
migration status и запись затронутой интеграции. Не заявлять обновление карты
без фактического внешнего изменения.