diff --git a/AGENTS.md b/AGENTS.md index afd4480..f931d3c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -127,3 +127,37 @@ formatting в одном commit. runtime-сценарий; записаны фактические результаты; выполнен rollback; fixture и production изолированы; механика документирована; ветка опубликована обычным push. + +## Общая карта проекта + +Каноническая общая карта проекта находится в Google Drive: +`https://drive.google.com/drive/folders/1avnR0V8q7y5pfWRYwB6LPBEEyfpN7PpV`. +Локальная синхронизированная копия, если она доступна, определяется только +переменной среды `PHIM_PLANT3D_PROJECT_MAP_ROOT`; её путь не хардкодить. + +Перед работой над архитектурой, миграцией или runtime-сценарием обязательно +прочитать доступные индекс/обзор карты, целевую архитектуру и migration status, +индекс runtime evidence, а также записи карты для затрагиваемых Launcher и +P_Rec_Annot. Затем сверить их с локальными AGENTS.md, релевантными tracked +документами, текущим кодом и тестами. + +Источники истины имеют следующий приоритет: фактическое runtime evidence; +текущий код, tests и tracked configuration на проверенном Git HEAD; tracked +документация репозитория; общая карта проекта. Внешняя карта описывает и +связывает работу, но не является build/runtime dependency и не переопределяет +текущий код или runtime evidence. + +Проверять свежесть каждой используемой записи карты по фактическим `git +rev-parse HEAD`, ветке и привязанному runtime evidence. Если карта или её +локальная копия недоступна, фиксировать `PROJECT_MAP_UNAVAILABLE`; если +зафиксированные commit/runtime status не совпадают с фактическими — +`PROJECT_MAP_STALE`. Эти статусы не разрешают выдумывать evidence: продолжать +по доступным локальным источникам и явно сообщать расхождение. + +Системные инварианты сохраняются: Launcher доставляет versioned local package +с одним managed entry assembly и без Autodesk DLL; P_Rec_Annot подтверждает +реальное Plant/Ortho/DataLinks поведение runtime evidence, а не только build +или tests. После изменения архитектуры либо runtime-статуса в отчёте указывать +конкретные документы общей карты, которые требуют обновления (архитектура, +статус миграции, evidence index и запись затронутой подсистемы); не заявлять, +что они уже обновлены, без фактического изменения. diff --git a/Plant3D2026/P_Rec_Annot/AGENTS.md b/Plant3D2026/P_Rec_Annot/AGENTS.md index 61eac30..95c1635 100644 --- a/Plant3D2026/P_Rec_Annot/AGENTS.md +++ b/Plant3D2026/P_Rec_Annot/AGENTS.md @@ -87,3 +87,33 @@ Autodesk properties по строковым именам. одного закрытого состояния проекта. Сравнивать нужно `control delta` с `DryRun delta`: одинаковые изменения классифицируются как baseline behavior Plant 3D, а plugin-only изменения блокируют дальнейшую работу. + +## Общая карта проекта + +Каноническая общая карта проекта: +`https://drive.google.com/drive/folders/1avnR0V8q7y5pfWRYwB6LPBEEyfpN7PpV`. +Необязательная локальная копия доступна только через +`PHIM_PLANT3D_PROJECT_MAP_ROOT`; локальный путь синхронизации не хардкодить. + +До изменения P_Rec_Annot читать доступные индекс карты, запись архитектуры и +статуса P_Rec_Annot, DryRun/Apply contract, карту Ortho/DataLinks и связанный +runtime evidence index. Сверять их с фактическим Git HEAD, текущими plugin +code/tests/configuration и runtime evidence конкретной fixture. + +Приоритет источников: runtime evidence, затем code/tests/configuration на +проверенном HEAD, затем tracked repository documentation, затем общая карта. +Карта не является build/runtime dependency и не заменяет фактический код либо +runtime evidence. Недоступную карту отмечать `PROJECT_MAP_UNAVAILABLE`; +несовпадение её commit/runtime status с фактическими данными — +`PROJECT_MAP_STALE`. + +Инварианты P_Rec_Annot: остаётся единственная NETLOAD entry assembly, aliases +и статусы команд не исчезают молча, Smoke/DryRun не пишут DWG, а Apply требует +явного разрешения, локальной fixture, ограниченной transaction, evidence и +проверяемого rollback/UNDO. Не ослаблять подтверждённый Ortho source/DataLinks +контракт и DCF control comparison ради сведений из карты. + +После изменения plugin architecture или runtime-status в отчёте перечислять +документы карты, требующие обновления: запись P_Rec_Annot, command/status, +Ortho/DataLinks contract, DryRun/Apply/UNDO evidence и migration status. Не +утверждать обновление внешней документации без фактического изменения.