# Правила работы с 1С через MCP:RSV

## Главное правило — файлы 1С не трогать напрямую

Файлы 1С в проекте EDT (`.bsl`, `.mdo`, `.form`, `.dcs`, XML конфигурации) **нельзя** читать и править файловыми инструментами (`Read`/`Edit`/`Write`/`Grep`, скрипты, переименование папок). Прямая правка ломает проект: рвутся внутренние связи модели, у пользователя зависают синхронизация с базой и выгрузка.

Вся работа с 1С — **только инструментами MCP `1c-rsv`**: код, метаданные, формы, запросы, макеты, поиск. Обычные файлы (JSON, скрипты, документация) — обычными инструментами.

## Если инструмент отказал или результат неожиданный

1. **СТОП.** Не обходи отказ правкой файлов 1С напрямую — это хуже невыполненной задачи.
2. Перечитай ответ: в нём обычно есть подсказка, что делать (`helpHint`, поле `important`).
3. Решения нет — доложи пользователю: какая операция, какие параметры, какой ответ. Обход — только с его явного разрешения.

## Как работать эффективно

- Общайся с пользователем **на русском** (если он сам не перешёл на другой язык).
- Не знаешь операцию или параметры — сначала `operation=help` инструмента (у `edit_metadata` — ещё и `topic=<имя>` с деталями и сценариями), не угадывай.
- Знакомство с объектом — один вызов `ai_context` вместо серии мелких запросов; из модуля читай нужный метод, а не весь текст.
- Перед правкой формы посмотри её: `get_form_image`.
- Запись кода (`write_module_source`): режим указывай явно — `replaceMethod` для одного метода, `append`/`insertBefore`/`insertAfter` для добавления; сначала `dryRun: true`, проверь, что заменяется именно то. Результат проверки кода приходит прямо в ответе записи.
- Пиши код в стиле конфигурации: найди поиском 3–5 похожих мест и повторяй их паттерны — обёртки общих модулей (`ОбщегоНазначения.СообщитьПользователю` и т. п.) вместо платформенных примитивов.
- Открыто несколько EDT — просто передавай `projectName`: вызов сам уйдёт в тот EDT, где открыт проект. При совпадении имён ответ перечислит кандидатов — уточни `edtWorkspace` из `list_workspace_projects`.

## Память проекта — папка `.ai/`

- `.ai/project-knowledge.md` — краткие знания о конфигурации: тип и версия, ключевые общие модули, паттерны. Прочитай в начале сессии, пополняй находками — это экономит токены в следующих сессиях.
- `.ai/current-task.md` — план текущей многошаговой задачи: обновляй по ходу, очищай по завершении.

## Профили доступа

Набор инструментов зависит от тарифа: Аналитик (чтение и анализ) → Разработчик (+ код, отладка) → Архитектор (+ метаданные, формы) → Архитектор Про (+ обновление конфигураций, журнал версий, обычные формы). Отказ «нужен профиль X» — сообщи пользователю и предложи переключить профиль, не пытайся обойти.
