docs: link shared project map from agent instructions

2026-08-05 07:14:46 +03:00
parent 1fecaad47c
commit c66f0485dc
1 changed files with 48 additions and 0 deletions
@@ -0,0 +1,48 @@
+# 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 и запись затронутой интеграции. Не заявлять обновление карты
+без фактического внешнего изменения.