Danro/AGENTS.md

Agent Guidance

Documentation Language

• Write all project documentation in Russian by default.
• Apply this rule to guides, READMEs, setup notes, conventions, and other repository documentation unless the user explicitly asks for another language.

Git Commit Messages

• При создании коммитов первая строка сообщения должна быть кратким описанием изменений на английском языке.
• Начиная с третьей строки сообщения коммита следует указывать подробный список изменений на русском языке.

MCP Tool Preference

• При подходящих сценариях агенту следует по максимуму отдавать приоритет MCP-серверам claude-core, claude-explorer и claude-rag вместо встроенных инструментов.
• claude-core следует предпочитать для чтения и редактирования файлов, поиска по проекту, работы с задачами и базовых shell-операций, если его возможностей достаточно.
• claude-explorer следует предпочитать для изучения архитектуры, исходников, команд и внутренних инструментов Claude Code.
• claude-rag следует предпочитать для семантического поиска по проекту, анализа больших объёмов кода и ситуаций, где локальный индекс даёт преимущество над обычным текстовым поиском.
• Память о проекте, его договорённостях, архитектурных решениях, важных гайдах, кодовой базе и ранее выявленном контексте следует по возможности сохранять и повторно использовать через claude-rag.
• Кодовую базу проекта также следует по возможности индексировать и использовать через claude-rag, чтобы агент мог опираться на локальную семантическую память о структуре, модулях, связях и ранее изученных участках кода.
• При повторяющихся задачах, исследовании крупных подсистем, возвращении к старым решениям, поиске проектного контекста и анализе существующей кодовой базы агенту следует сначала опираться на claude-rag, если для этого подходит локальный индекс.
• Если MCP-инструмент хуже подходит для конкретной задачи, недоступен или создаёт лишние ограничения, агент может использовать встроенные инструменты как запасной вариант.

Unity MCP Workflow

• При работе с Unity-проектом агенту следует по возможности использовать MCP-сервер unityMCP как основной инструмент взаимодействия с Unity Editor.
• unityMCP следует предпочитать для задач, связанных со сценами, GameObject, компонентами, prefab, ассетами, материалами, камерами, настройками рендеринга, физикой, Build Settings, Unity Console, тестами и состоянием редактора.
• Перед изменениями внутри Unity желательно читать актуальное состояние редактора через mcpforunity://editor/state, а при необходимости также mcpforunity://project/info, mcpforunity://instances, mcpforunity://custom-tools и mcpforunity://tool-groups.
• Если доступно несколько Unity Editor-инстансов, агент должен сначала проверить mcpforunity://instances и выбрать нужный проект через set_active_instance, не выполняя изменения вслепую.
• Для массовых операций в Unity следует предпочитать batch_execute, чтобы уменьшать количество отдельных вызовов и сохранять изменения согласованными.
• Для создания, изменения и проверки C#-скриптов в Unity следует предпочитать инструменты unityMCP вроде create_script, script_apply_edits, apply_text_edits, validate_script, refresh_unity и read_console, если задача требует реакции Unity Editor или проверки компиляции.
• После изменений в скриптах, сценах, prefab, ассетах или настройках проекта агент должен по возможности обновить Unity через refresh_unity, проверить готовность редактора и прочитать read_console, чтобы выявить ошибки компиляции или импорта.
• Для проверки Unity API, сигнатур классов, методов и свойств перед написанием кода следует использовать unity_reflect и/или unity_docs, если соответствующая группа инструментов доступна.
• Для запуска EditMode/PlayMode-проверок следует использовать run_tests и get_test_job, если тестовая группа unityMCP доступна и это уместно для задачи.
• Если нужная группа возможностей unityMCP отключена, агент может включить её через manage_tools, когда это оправдано задачей.
• Если unityMCP недоступен, не видит активный Unity Editor, возвращает ошибку или хуже подходит для конкретной операции, агент может использовать файловые инструменты и обычные shell-команды как запасной путь, явно учитывая риск отсутствия проверки внутри Unity.

Git Console Output and Chat formatting

• Никогда не выводите сырой вывод консоли или логов терминала (особенно логи Git) в чат с пользователем.
• При выполнении фоновых или синхронных Git-команд перенаправляйте вывод потоков вывода и ошибок в пустоту (заглушайте вывод), чтобы избежать захламления чата системными логами и дублирования строк:
  • В PowerShell используйте перенаправление в пустоту: *>$null
  • В CMD используйте перенаправление в пустоту: >nul 2>&1
• Описывайте результаты работы Git понятным человеческим языком на русском языке, перечисляя только суть изменений и конечные статусы, без копирования отчетов терминала.