3.4 KiB
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 и запись затронутой интеграции. Не заявлять обновление карты без фактического внешнего изменения.