diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..aa2b96b --- /dev/null +++ b/AGENTS.md @@ -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 и запись затронутой интеграции. Не заявлять обновление карты +без фактического внешнего изменения.