From 71fff41568e2b0711157e30048b2479b5fa4046c Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 10:47:51 +0200 Subject: [PATCH] docs: add project-specific AGENTS.md under 4FusionLab standards --- AGENTS.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..5280c0f --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,21 @@ +# Разработка Planara + +Planara — проектируемый аддон Autodesk Fusion для развёртки выбранных граней Solid Body в плоскую геометрию. + +## Общие правила 4FusionLab + +- Общие стандарты: https://github.com/4FusionLab/.github/blob/main/AGENTS.md; модель общего CI: https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md. +- Общайся и составляй планы на русском, код и UI Fusion — на английском. Сохраняй независимые README.md и README.ru.md. +- Перед изменениями изучай текущие файлы и Git-статус. Conventional Commits; предпочтительно PR с успешными проверками, прямой push в main допускается. +- Не меняй UUID Fusion manifest, IDs команд, поддержку ОС и формат пакета без миграционного плана. Не коммить секреты, токены или личные CAD-файлы. +- Где есть runtime, релиз создаёт push или merge в main только для файлов из .github/release-paths.txt после успешного CI. GitVersion.Tool 6.8.2, неизменяемый автоматический тег и GitHub Release; теги вручную не создавай. +- Изменение docs, README, тестов, AGENTS.md или CI само по себе не должно выпускать релиз. Общие Actions подключай только по конкретному commit SHA. +- Unit-тесты и ZIP не заменяют нативную проверку Autodesk Fusion. Сохраняй существующие ограничения и доказательства совместимости. + +## Текущий статус + +- Пока репозиторий содержит только концепцию и документацию: готового распространяемого аддона и релизного pipeline нет. Не утверждай обратное. +- MVP нацелен на результат в виде плоских Surface Bodies; деформацию на неразвёртываемых поверхностях измеряй, а не скрывай. +- Оригинальная геометрия модели должна оставаться неповреждённой. Проверяй реальные ограничения Autodesk Fusion API и разделяй проверенные алгоритмы и гипотезы. +- Перед первым выпуском нужны отдельный уникальный Fusion manifest, runtime-код, воспроизводимые тесты, native CAD acceptance, .github/release-paths.txt, версия, проверенный ZIP и автоматический CI release workflow. +- При появлении пользовательских возможностей обновляй английский и русский README.