Правила работы над проектом

Описание проекта и целей пользователя

Проект: Fresco — неофициальный BOINC Manager, десктопное приложение на Tauri v2 + Vue 3 + Pinia
Цели: создать современную, лёгкую альтернативу официальному BOINC Manager с упором на UX и кроссплатформенность
Как используется: пользователи подключаются к локальному или удалённому BOINC-клиенту, управляют задачами, проектами, настройками вычислений
Контекст и ограничения: один портативный бинарник без установщика; поддержка Windows/macOS/Linux (x86_64 + ARM64); взаимодействие с BOINC через XML RPC по TCP

AGENTS.md содержит только универсальные правила, применимые ко всем задачам.
Специфические инструкции хранить в профильных документах agent_docs/ или уточнять у пользователя; не раздувать AGENTS.md.
Все проектные документы хранить в agent_docs/, кроме README.md, AGENTS.md и CLAUDE.md.

Следовать существующим паттернам, правилам и соглашениям проекта.
Не использовать AGENTS.md как стайлгайд или список команд; для стиля полагаться на линтеры/форматтеры и существующий код.
Документы держать краткими; вместо копирования кода ссылаться на файлы и модули.
Если планируются большие изменения — сначала кратко согласовать подход.
Обновлять затронутую документацию.

Проверить, что выполнены требования задачи и изменения соответствуют ожидаемому поведению.
Обновить релевантные документы и при необходимости запись в agent_docs/development-history.md.
Если принято важное решение — добавить запись в agent_docs/adr.md.
Свериться с agent_docs/guides/dod.md и убедиться, что критерии DoD выполнены или зафиксированы причины.
Зафиксировать причины, если тесты не запускались или не добавлены новые (если это ожидается).