Danro-Jump/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.

Implementation Requests

• Если пользователь прямо не требует написать код, не нужно переходить к реализации в коде.
• В таких случаях нужно подготовить подробный гайд по реализации требований пользователя.
• Такой гайд нужно размещать в GUIDES в подходящем смысловом подразделе.

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-инструмент хуже подходит для конкретной задачи, недоступен или создаёт лишние ограничения, агент может использовать встроенные инструменты как запасной вариант.