docs: link shared project map from agent instructions
This commit is contained in:
@@ -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 и запись затронутой интеграции. Не заявлять обновление карты
|
||||||
|
без фактического внешнего изменения.
|
||||||
Reference in New Issue
Block a user