Как подготовить AGENTS.md для проекта 1С

Файл задаёт целевые версии, безопасные каталоги, обязательные источники, допустимые команды проверки и запреты. Он также определяет форму ответа: отделять факт от предположения, указывать источник и останавливать изменение при недостатке данных.

Не стоит копировать туда всю документацию. Большой текст быстро устаревает и расходует контекст. Правило должно направлять агента к актуальному библиотечному корпусу или проектному источнику.

Глобальные правила задают общую дисциплину: не раскрывать секреты, не выдавать гипотезу за факт, проверять изменения и не выполнять опасные действия без разрешения. Они действуют во всех рабочих папках.

Проектные правила уточняют конкретную конфигурацию: целевую версию платформы, команды тестов, разрешённые каталоги, координату библиотеки и способ проверки BSL. Чем ближе файл к рабочему коду, тем конкретнее он может быть.

Каркас ниже не содержит адресов и токенов. Его нужно адаптировать под реальные команды и версию, а не вставлять без проверки.

# Правила проекта 1С

- Целевая платформа: укажите подтверждённую версию.
- До изменения отдели библиотечные знания от фактов проекта.
- Для каждого вывода укажи источник и класс доказательства.
- Если версия или область влияния неизвестна — остановись и перечисли пробелы.
- Не выводи токены, персональные данные и закрытый код.
- После изменения выполни разрешённую проверку синтаксиса и тесты.

Попросите агента исследовать один вопрос без изменения файлов. Если он смешал библиотечное правило с найденным кодом, скрыл неизвестную версию или не назвал источник, инструкция слишком общая и требует уточнения.

Проверочный запрос: «Для ОбъединитьТаблицыПоКлючу найди допустимые операции с ТаблицаЗначений в моей версии платформы; исходники проекта и саму функцию не выдумывай». Вход — неизвестная версия платформы и известный контракт объединения; ожидаемый выход — вопрос о версии и список того, что нельзя подтвердить без исходников.

Если агент сразу предлагает патч для несуществующего общего модуля, в AGENTS.md нужно усилить условие остановки: до изменения получить исходник, целевую версию и разрешённую команду проверки. Тест этого правила — наблюдаемое поведение агента, а не длина файла инструкций.

Процедура ПроверитьКлючевуюКолонку(Таблица, ИмяКлюча) Экспорт
    Если Таблица.Колонки.Найти(ИмяКлюча) = Неопределено Тогда
        ВызватьИсключение "Ключевая колонка не найдена";
    КонецЕсли;
КонецПроцедуры