1c-rules — набор правил и инструментов разработки на 1С для ИИ-агентов

Если ты ИИ-агент и тебе нужно установить или обновить правила в проекте, перейди к AGENT-INSTALL.md и следуй инструкциям оттуда. Текущий файл — обзор для разработчика.

1c-rules — это переносимый набор правил, ролей субагентов, on-demand инструкций и интеграций для разработки в 1С:Предприятие 8 (BSL) с помощью ИИ-агентов. Содержимое раскладывается в проект единым установщиком и адаптируется под формат каждого инструмента.

Правила и команды собираются под конкретный инструмент адаптерами из adapters/*.yaml. Поддерживаются:

• Cursor (.cursor/rules/, .cursor/agents/, .cursor/commands/, .cursor/skills/)
• Claude Code (.claude/rules-1c/, .claude/agents/, .claude/commands/)
• OpenAI Codex (.codex/rules/, .codex/agents/, .codex/skills/, .codex/config.toml; slash-команды ставятся в пользовательский ~/.codex/prompts/)
• OpenCode (.opencode/command/)
• Kilo Code (.kilo/rules-1c/ for on-demand rules referenced by AGENTS.md, .kilo/commands/, .kilo/agents/, .kilo/skills/)
• Kimi Code CLI (.kimi-code/rules-1c/, .kimi-code/agents/, .kimi-code/skills/, .kimi-code/mcp.json; slash-команды доступны через Skills/Plugins Kimi)
• Qwen Code (.qwen/rules-1c/, .qwen/agents/, .qwen/commands/, .qwen/skills/; MCP в .qwen/settings.json под mcpServers с httpUrl; entry stub QWEN.md → AGENTS.md)
• Command Code (.commandcode/rules-1c/, .commandcode/agents/, .commandcode/commands/, .commandcode/skills/; MCP в корневом .mcp.json, общий с Claude Code)
• Cline (.cline/rules-1c/, .cline/agents/, .cline/skills/; MCP только глобальный — установщик проектный MCP не пишет; не кладёт on-demand правила в .clinerules/, чтобы не раздувать контекст)
• Pi (.pi/rules-1c/, .pi/prompts/ для команд, .pi/skills/; без субагентов и без MCP — у Pi нет встроенного MCP)
• Прочее (other, универсальный fallback) (.ai-agent/rules/, .ai-agent/agents/, .ai-agent/commands/, .ai-agent/skills/, .ai-agent/mcp.json) — для любого ИИ-клиента, которого нет в списке выше (Aider, Continue, Cody и т.п.). Ничего не автодетектится — выбирается вручную при установке. На диск пишутся максимально портабельные правила: AGENTS.md в корне (де-факто стандарт для современных агентов), а on-demand-правила и описания субагентов — по нейтральным путям под .ai-agent/ с минимальной frontmatter (description + alwaysApply).

Один и тот же исходный набор правил из content/ раскладывается во все активные инструменты одновременно, поэтому AGENTS.md, on-demand правила и описания субагентов остаются согласованными независимо от того, в каком клиенте вы работаете.

Установка спроектирована как протокол, который выполняет сам ИИ-агент. Откройте проект в любимом ИИ-агенте (Cursor / Claude Code / Codex / OpenCode / Kilo Code / Kimi / Qwen / Command Code / Cline / Pi) и отправьте сообщение:

Установи правила из https://github.com/comol/ai_rules_1c по AGENT-INSTALL.md.

Всё. Остальное — клонирование репозитория, определение активных инструментов, миграция существующих AGENTS.md / CLAUDE.md, запросы перед разрушительными действиями — описано в AGENT-INSTALL.md, который агент прочитает сам.

Если агент не справляется (ограниченная среда, нет FS-доступа, нужен детерминированный CI-запуск) — тот же протокол реализован как PowerShell-скрипт install.ps1:

git clone https://github.com/comol/ai_rules_1c.git $env:TEMP\1c-rules
& $env:TEMP\1c-rules\install.ps1 init -Source $env:TEMP\1c-rules

Имя локальной папки произвольное: в примерах используется 1c-rules, но установленный или рабочий каталог может называться иначе.

Параметр -Source также принимает URL напрямую — в этом случае установщик сам делает shallow-clone в кэш под $env:TEMP (ключ кэша — хэш URL) и переиспользует его при повторных запусках; требует git в PATH:

.\install.ps1 init -Source https://github.com/comol/ai_rules_1c

Команды: init / update / add <tool> / remove [<tool>] / doctor / eject.

Если MCP-серверы уже установлены дистрибутивом MCP по его INSTALL.md в мультипроектном режиме (каталог GLOBAL_ROOT, projects.registry.json, динамические порты по проектам), установщик правил это автоматически обнаруживает (переменная окружения BASESAI_MCP_GLOBAL_ROOT либо MCP_GLOBAL_ROOT в .dev.env + файл install.manifest.json) и не трогает mcp.json — ни проектный, ни глобальный. Вместо этого он записывает в USER-RULES.md секцию mcp:install_forme с фактическими серверами, url и портами из артефактов установки. Правильный порядок: сначала MCP по INSTALL.md, затем правила — повторные init / update правил рабочую MCP-схему не ломают. Принудительное поведение — флаг -McpMode auto|managed|external (по умолчанию auto). Подробности — в AGENT-INSTALL.md → External MCP installation.

• Корневой свод правил — AGENTS.md: исходный always-on контекст для ИИ-агента: персона, процедура разработки, принципы, перечень MCP-инструментов и их использование, стандарты кода, дисциплина вызовов инструментов. В этом репозитории он хранится в корне для удобного просмотра и поддерживается как читаемый документ без обязательных плейсхолдеров путей.
• Пользовательские правила — USER-RULES.md: пустой по умолчанию файл для команды/проекта. Установщик его не перезаписывает.
• Память проекта — memory.md: строгий долговременный слой для глобальных критичных правил проекта. Маршрутизация между memory.md и векторной памятью remember / recall описана в AGENTS.md → Project memory; это не общий блокнот.
• Самоулучшаемые правила — LLM-RULES.md: слой правил поведения агента, накопленных из наблюдаемого «трения» (корректировки пользователя, избыточные шаги, конфликтующие правила). Пишется только командой /evolve с поштучным одобрением пользователя; агент в обычных задачах лишь фиксирует сигналы (remember с префиксом rule-friction:) и рекомендует запустить /evolve. Приоритет при конфликте: выше AGENTS.md и on-demand правил, ниже USER-RULES.md и memory.md. Установщик не перезаписывает.
• Адаптация под модель — AGENT_MODEL в .dev.env + профили content/rules/model-opus5.md / model-sonnet5.md / model-fable5.md / model-gpt56.md (роутер — model-adaptation.md). Базовый свод модель-нейтрален; профиль — тонкая надстройка под задокументированное поведение конкретной модели (Claude Opus 5 / Sonnet 5 / Fable 5 / GPT-5.6): длина ответов и отчётов, объём нарратива, глубина планирования, охота к делегированию, лишние самопроверки, рекомендации по effort / verbosity. Общие принципы промптинга, справедливые для всех моделей, живут в базовых правилах и профилем не переопределяются; хард-гейты (метаданные через 1c-metadata-manage, операции с ИБ, MCP-first, цепочка валидаторов и её бюджет, templatesearch / recall, CONFUSION, обязательный отчёт) профиль ослабить не может. Включается командой /rulesmodel <модель> (название — в любом написании, нормализует сама; auto — определить текущую модель, off — выключить); при первой установке модель предлагается выбрать. Источники специфики: гайды Anthropic и OpenAI по промптингу конкретных моделей.
• Параметры проекта — .dev.env: единый источник правды для всех правил, on-demand-инструкций, слэш-команд и субагентов. Содержит параметры генерации кода (PREFIX, COMPANY, DEVELOPER, PLATFORM_VERSION, шаблоны комментариев, NEW_OBJECTS_IN), параметры подключения к ИБ для команд и тестов (PLATFORM_PATH, INFOBASE_KIND/INFOBASE_PATH, IB_USER/IB_PASSWORD, EXTENSION_NAME, EXPORT_PATH, LOG_PATH, INFOBASE_PUBLISH_URL для веб-тестов, UI_TESTING — режим веб-тестирования UI: manual (по умолчанию — только по явному запросу) / auto / off; PLATFORM_ARGS / IBCMD_ARGS — дополнительные аргументы запуска платформы для инструментов скилла 1c-metadata-manage; SUPPORT_GUARD — реакция гейта поддержки на правку объекта типовой «на замке»: deny (по умолчанию) / warn / off) и модели субагентов по ярусам (SUBAGENT_MODEL_CODING — код/метаданные/архитектура, SUBAGENT_MODEL_ANALYSIS — план/аналитика/ревью/тест/доки, SUBAGENT_MODEL_LIGHT — исследование/поиск/быстрые фиксы; пусто — модель AI-клиента по умолчанию; при первой установке предлагается профиль по бенчу onec-llm-bench.lovable.app; сами файлы субагентов имён моделей не содержат), а также режим оркестрации (ORCHESTRATION — standard (по умолчанию) / economy; переключается командой /economymode) и параметры процесса разработки (QUICKFIX_MAX_LINES — лимит строк пути quick-fix, пусто = 40; DEBUG_FAST_PATH — режим быстрого пути отладки: standard (по умолчанию) / extended / off; VERIFICATION_DEPTH — глубина статических проверок кода: standard (по умолчанию) / full / lite, переключается командой /litemode, которая при уровне lite также ставит UI_TESTING=off; CAVEMAN — автоактивация краткого стиля общения caveman: on (по умолчанию, на всех задачах) / auto (только на разработке) / off, переключается командой /caveman; AGENT_MODEL — модель головного агента для адаптации правил под её поведение: opus5 / sonnet5 / fable5 / gpt56, пусто = профиль не применяется, переключается командой /rulesmodel, которая принимает название модели в любом написании). Установщик создаёт .dev.env автоматически на init, заполняет автодетектом PLATFORM_VERSION (из Configuration.xml), PLATFORM_PATH (поиск в C:\Program Files\1cv8\) и PREFIX (из NamePrefix расширения), запрашивает остальное в интерактивном режиме. В -NonInteractive оставляет пустые поля с явным WARNING. Шаблон — .dev.env.example.
• Установщик — install.ps1: PowerShell-инсталлятор (команды init / update / add / remove / doctor / eject).
• Спецификация установщика — AGENT-INSTALL.md: что пишется/обновляется на диске, как происходит миграция и что принадлежит установщику.

.
├── AGENTS.md                # шаблон основного свода правил (always-on контекст после установки)
├── AGENT-INSTALL.md         # инструкция установки для ИИ-агентов
├── USER-RULES.md            # пользовательские правила (не трогается установщиком)
├── memory.md                # память проекта
├── LLM-RULES.md             # самоулучшаемые правила агента (пишет только /evolve, с одобрения пользователя)
├── install.ps1              # PowerShell-установщик
├── .dev.env.example         # шаблон параметров проекта
├── adapters/                # адаптеры под инструменты (cursor, claude-code, codex, opencode, kilocode, kimi, qwen, command-code, cline, pi, other)
├── content/
│   ├── rules/               # on-demand правила, подключаемые по задаче
│   ├── agents/              # описания 13 специализированных субагентов
│   ├── commands/            # слэш-команды (doctor, deploy-and-test, economymode, litemode, caveman, rulesmodel, evolve, getconfigfiles, loadfrom1cbase, update1cbase, checkmcp, installmcp, updatemcp, updaterules, check-uuid, install-agent-browser, install-windows-mcp)
│   ├── skills/              # SKILL-пакеты (1c-metadata-manage, mermaid-diagrams и др.)
│   ├── openspec-bundle/     # снапшот вывода `openspec init` для каждого инструмента
│   └── mcp-servers.json     # каталог MCP-серверов экосистемы 1С
├── openspec/                # OpenSpec-воркспейс (specs/, changes/, project.md)
└── tools/                   # вспомогательные скрипты (refresh-openspec-bundle.ps1)

Независимо от канала установки (агент или install.ps1) на диске будет:

• AGENTS.md, USER-RULES.md, memory.md, LLM-RULES.md — в корне проекта. Это требование инструментов: Cursor, Claude Code, Codex, OpenCode, Kilo, Kimi, Qwen, Command Code, Cline и Pi читают AGENTS.md именно из корня; перенос в .cursor//.claude/ отключит загрузку. Для Qwen дополнительно пишется stub QWEN.md → AGENTS.md.
• директории активных инструментов (.cursor/, .claude/, .codex/, .opencode/, .kilo/, .kimi-code/, .qwen/, .commandcode/, .cline/, .pi/, .ai-agent/) — для каждого детектированного. On-demand правила лежат в каталоге rules / rules-1c адаптера, не дублируются в отдельный «общий» каталог. Особенности MCP: Kilo — .kilo/kilo.json (mcp); Qwen — merge mcpServers в .qwen/settings.json (httpUrl); Command Code / Claude Code — общий .mcp.json; Cline и Pi — проектный MCP не пишется.
• openspec/ — OpenSpec-воркспейс (если ещё не было).
• .ai-rules.json — манифест с перечнем размещённых файлов, активных инструментов, выбранным каноническим каталогом on-demand правил и версией.

AGENTS.md ссылается на on-demand правила по пути одного канонического каталога (приоритет cursor → claude-code → kilocode → kimi → qwen → command-code → cline → opencode → codex → pi → other; other становится каноном только когда выбран без «реального» инструмента). При установке только под один инструмент в проекте появится ровно одна тулзовая директория плюс AGENTS.md/USER-RULES.md/memory.md/LLM-RULES.md в корне — без дополнительных общих папок.

Если активен ровно один инструмент, агент-установщик не задаёт уточняющих вопросов. PowerShell-fallback дополнительно поддерживает флаги -Tools cursor,claude-code, -NonInteractive, -AssumeYes. Полный протокол и описание манифеста — в AGENT-INSTALL.md.

Подгружаются ИИ-агентом по задаче, когда сценарий совпадает с описанием правила. Полный и авторитетный список входных точек находится в AGENTS.md → Additional rules; список ниже — обзор по группам.

• coding-standards.md — краткий индекс стандартов кода и ссылок на детальные правила.
• dev-standards-core.md — совместимый router детальных стандартов разработки.
• dev-standards-env.md — параметры .dev.env, операции с ИБ, UI-тесты, модели субагентов, оркестрация и параметры процесса.
• dev-standards-code-style.md — стиль BSL, метрики качества, запрещённые конструкции, документация API, типографика, комментарии и внутреннее ревью.
• dev-standards-change-markers.md — маркеры изменения типового кода, нейминг метаданных и выбор типа объекта.
• dev-standards-architecture.md — архитектурные паттерны, расширения, стандарты платформы, code smells.
• module-structure.md — канонические шаблоны регионов для общих модулей, модулей объектов и менеджеров, модулей форм; директивы препроцессора; обязательные регионы.
• forms.md — единая точка входа для задач по управляемым формам; выбирает нужные companion-правила для Form.xml, Form.Module.bsl, событий, async, reserved names и XML-валидации.
• form-patterns.md — паттерны раскладки управляемых форм: архетипы (документ / обработка / список / элемент справочника / мастер), нейминг (ГруппаШапка, Отбор[Поле] + Использование), принципы layout и advanced ERP-паттерны.
• forms-add.md — генерация и доработка форм, включая правила представления (программная модификация типовых форм, размещение элементов, проверка заполнения, команды формы).
• form-module.md — работа с модулем формы: подключение обработчиков событий в Form.xml, зарезервированные имена свойств (запрет на локальные переменные ПараметрыВыбора, СвязиПараметровВыбора, СписокВыбора, ПараметрыОтбора, ОтборСтрок), данные формы.
• async-methods.md — практическое руководство по Асинх / Ждать / Обещание (платформа 8.3.18+) с типичными паттернами и ловушками (тихая потеря исключений без Ждать, Асинх в обработчиках событий формы, HTTP-async).
• extension-patterns.md — паттерны расширений (CFE): типы перехватчиков, правила ПродолжитьВызов, маркеры #Вставка / #Удаление, ограничения заимствованных объектов, антипаттерны.
• dcs-design.md — правила проектирования отчётов на СКД: выбор типа наборов данных, вычисляемые поля vs ресурсы, параметры и пользовательские настройки, варианты, программный override компоновки, взаимодействие с RLS, чек-лист производительности.
• dcs-advanced-composition.md — продвинутая программная компоновка СКД: двухпроходная предобработка (фильтрация детальных записей ДО свёртки — скрытие строк/колонок кросс-таба с нулевым итогом, рантайм-подмена набора данных в скомпилированном макете) и прямое выполнение запроса компоновки вместо движка СКД для тяжёлых по памяти отчётов. Подгружать, только когда штатного override из dcs-design.md §5 не хватает.
• bsp-access-rights.md — программная работа с профилями групп доступа БСП: Роли.Роль — ссылка на ИдентификаторыОбъектовМетаданных, а не строка (иначе роли молча теряются при записи); роли расширений живут в отдельном справочнике; шаблон создания/обновления профиля, назначение профиля пользователю, API проверки прав, ролей и RLS, антипаттерны (ОбменДанными.Загрузка, правка поставляемого профиля).
• registers-design.md — проектирование регистров (сведений, накопления, бухгалтерии, расчёта): измерения и ресурсы, периодичность, индексирование, подчинение регистратору, остатки vs обороты, проведение и перепроведение.
• query-design.md — единая точка входа для работы с запросами; выбирает companions (dev-standards-architecture.md §3, skill query-writing / query-optimization, anti-patterns).
• metadata-xml-workarounds.md — типовые ошибки при ручной генерации метаданных XML (отсутствие LineNumber в табличных частях, опечатка PagesGroupExtInfo, обязательный Page.enabled, уникальность UUID).
• tooling-playbooks.md — пошаговые MCP-плейбуки под типовые задачи (написание кода, ревью, архитектура, исправление ошибок, оптимизация, рефакторинг — включая методику безопасного рефакторинга и обязательный impact-анализ, метаданные XML, формы, интеграции, документация, сравнение версий платформы).
• mcp-first-search.md — дисциплина MCP-first поиска по исходникам 1С: цепочка приоритетов (граф → code-metadata → повтор с grep=true → нативные инструменты) и обязательная заметка «что было испробовано» перед fallback на Grep / Glob / поиск файлов по маске / чтение модулей целиком. Приоритет ограниченный, а не запрет: без подключённых MCP-серверов, после промаха настроенного запроса или при устаревшем индексе нативные поиск и чтение применяются сразу (одна строка обоснования).
• ui-testing-tools.md — предпочтительный стек для UI-тестов: agent-browser (экономия токенов на a11y-snapshot) → встроенный browser MCP → Windows-MCP только как last resort для desktop; перед веб-тестами обязательный preflight с запросом /install-agent-browser, если его нет; запрет самодельного screenshotter/OCR.
• web-client-driving.md — поведение веб-клиента 1С под любым драйвером (слой над ui-testing-tools.md): что искать в a11y-снимке (модальные окна, подтверждения, ошибки, незаполненные обязательные, информационная строка отчёта), одинарный клик выделяет — открывает двойной, раскрытие узлов дерева, скоупинг действий к нужной таблице на форме с несколькими, заполнение полей (ввод по умолчанию, вставка как fallback, Shift+F4, составные типы, чекбокс отбора СКД), навигация по пути метаданных Shift+F11, чтение табличного документа и расшифровка, закрытие форм с проверкой, дисциплина против циклов (максимум 2 попытки, смена метода вместо повтора).
• model-adaptation.md — адаптация свода под модель, которая его исполняет: как AGENT_MODEL из .dev.env выбирает профиль, какие написания названий моделей распознаются, что профилю можно менять (длина ответов и отчётов, объём нарратива, глубина планирования, охота к делегированию, самопридуманные перепроверки) и что нельзя (хард-гейты, цепочка валидаторов и её бюджет, MCP-first, templatesearch / recall, CONFUSION, обязательный отчёт), плюс модель-нейтральная база промптинга, действующая всегда.
• model-opus5.md / model-sonnet5.md / model-fable5.md / model-gpt56.md — профили поведения под Claude Opus 5, Claude Sonnet 5, Claude Fable 5 (Mythos 5) и GPT-5.6: рекомендации по усилию (effort) и verbosity, стиль отчётов и нарратива, границы автономии, работа с субагентами и памятью. Подгружается ровно один — по значению AGENT_MODEL (переключение: /rulesmodel <модель>).
• subagents.md / subagent-pipeline.md — каталог субагентов и формализованный pipeline для делегированных full-cycle задач (без делегирования full-cycle выполняется головным агентом напрямую — «стандартный путь»).
• orchestrator-economy.md — режим экономии оркестратора: включается командой /economymode (пишет ORCHESTRATION=economy в .dev.env, действует на весь проект, включая новые чаты; выключение — /economymode off); головной агент делегирует исполнение дешёвым субагентам, оставляя себе решения, спеки и верификацию. Выбор моделей не меняется — модели берутся из SUBAGENT_MODEL_* по ярусу субагента; если они не заданы, команда при включении предложит выбрать (профили по бенчу или свои слаги; сменить позже — /economymode models).
• getconfigfiles.md — выгрузка объектов метаданных из информационной базы в репозиторий.
• integrations-add.md — правила для интеграций (HTTP-сервисы, REST, очереди).
• sdd-integrations.md — правила работы с OpenSpec.
• logging-strategy.md — позитивная стратегия логирования: когда писать в ЖурналРегистрации, уровни, нейминг событий, структура Данные, запрет на секреты / PII, ротация.
• locks-and-transactions.md — управляемые блокировки, границы транзакций, фиксированный порядок блокировок, предотвращение взаимных блокировок, режимы блокировок, диагностика через техжурнал.
• anti-patterns.md — каталог 1С анти-паттернов и рубрика код-ревью.
• systematic-debugging.md — методика отладки: 4 фазы и быстрый путь для очевидных первопричин (DEBUG_FAST_PATH).
• verification-checklist.md — совместимый router правил верификации.
• verification-policy.md — уровни глубины, quick-fix, promotion triggers и quick-fix gate.
• verification-gates.md — синтаксис, логика, стиль, impact-анализ и XML-валидация.
• verification-delivery.md — reproduction, соответствие плану, опциональные review/UI-тесты и итоговый отчёт.
• platform-solutions.md — типичные ловушки платформы и проверенные шаблоны решений (включая фоновые задания из внешней обработки через БСП).

Тринадцать ролей под конкретные задачи: 1c-explorer, 1c-analytic, 1c-planner, 1c-architect, 1c-arch-reviewer, 1c-developer, 1c-metadata-manager, 1c-refactoring, 1c-performance-optimizer, 1c-error-fixer, 1c-tester, 1c-code-reviewer, 1c-doc-writer. Когда какой использовать — описано в content/rules/subagents.md (точка входа из AGENTS.md → Skills and Subagents).

Скиллы — это самодостаточные подключаемые модули с собственной документацией и (опционально) скриптами/инструментами. Активный инструмент подхватывает их из своего skills/-каталога. В поставке:

Главный скилл для работы с метаданными конфигурации: создание, редактирование, валидация, удаление объектов, форм, отчётов, макетов, ролей, расширений, баз. Скилл — диспетчер: по ключевым словам задачи он направляет агента в нужный домен и при сложных мутирующих сценариях делегирует работу субагенту 1c-metadata-manager. Все XML-операции выполняются через скрипты в tools/, которые корректно обрабатывают BOM, кодировки, UUID, порядок ChildObjects и кросс-ссылки — то, что легко сломать ручной правкой.

Покрываемые домены:

• Объекты метаданных (meta-manage.md) — справочники, документы, регистры (сведений, накопления, бухгалтерии, расчёта), перечисления, константы, общие модули, реквизиты, табличные части.
• Целостность UUID (uuid-check.md) — поиск объектов с одинаковым идентификатором в XML-выгрузке (атрибуты uuid, элементы xr:TypeId / xr:ValueId), с опциональной перегенерацией. Запускать после массовой генерации метаданных, ручной правки XML и слияния веток; слэш-команда /check-uuid.
• Управляемые формы (form-manage.md) — создание, редактирование, анализ, валидация Form.xml, элементов, команд, событий.
• Схемы компоновки данных, СКД (skd-manage.md) — отчёты, наборы данных, запросы СКД.
• Табличные документы, MXL (mxl-manage.md) — макеты, печатные формы, декомпиляция MXL.
• Роли и права (role-manage.md) — права, RLS, разграничение доступа.
• Внешние обработки и отчёты (epf-manage.md) — каркас, сборка, дамп EPF/ERF.
• Конфигурации и расширения (cf-manage.md, cfe-manage.md) — создание, диффы, патчи, регистрация в БСП (bsp-manage.md).
• Состояние поддержки (support-manage.md) — типовые «на замке», снятие с поддержки, включение возможности изменения. Мутирующие скрипты скилла сами отказываются править заблокированный объект поставщика и ведут сюда либо в расширение.
• Пакеты XDTO (xdto-manage.md) — анализ пакета и типов, сборка из XSD, выгрузка схемы, точечная правка, валидация. Для обменов, интеграций и веб-сервисов.
• Базы данных (db-manage.md) — реестр, создание, запуск, загрузка/выгрузка ИБ, DT-бэкапы.
• Подсистемы и командный интерфейс (subsystem-manage.md, interface-manage.md).
• Макеты и шаблоны, справка (template-manage.md, help-manage.md), паттерны БСП (ssl-patterns.md).
• Запросы — написание новых (query-writing.md) и оптимизация (query-optimization.md).
• Веб-публикация (web-manage.md) — публикация/снятие, статус, smoke-тесты для Apache/IIS.
• Распаковка бинарников без платформы 1С — домен в таблице диспетчера указывает на standalone-скилл v8unpack-cf (skill-local docs/v8unpack-cf.md — тонкий pointer); извлечение и сборка CF/CFE/EPF через Python-утилиту v8unpack.

• mcp-1c-tools — диспетчер MCP-серверов экосистемы 1С: каталог серверов, маршрутизация задач, fallback-цепочка (graph → code-metadata → grep=true retry → Grep), параметрические подсказки. Подгружается до выбора любого 1С MCP-инструмента; per-server описания — в docs/<server>.md.
• caveman — стиль общения: краткие рабочие ответы на русском, без лишнего объяснения. По умолчанию (.dev.env CAVEMAN=on) включён на всех задачах. CAVEMAN=auto ограничивает его разработкой (реализация, отладка, деплой) и выключает на ревью / анализе / аудите / документации; CAVEMAN=off отключает автоактивацию полностью. Явные команды /caveman работают в любом режиме.
• img-grid-analysis — наложение пронумерованной сетки на изображение для определения пропорций колонок. Используется при генерации MXL-макетов из скриншотов или сканов печатных форм; даёт коэффициенты ширины колонок для JSON-DSL компилятора.
• mermaid-diagrams — практическое руководство по диаграммам Mermaid, совместимым с большинством рендереров (плюс ASCII-сайдкары для просмотра в чистом Markdown).
• powershell-windows — правила скриптинга в Windows PowerShell (разделители команд, кавычки путей, замены curl/timeout/&&, Docker, HTTP, JSON). Подгружается, когда правила выполняют shell-команды на Windows.
• md-to-docx — конвертация Markdown в Word-документ (.docx) c сохранением заголовков, таблиц, списков, кода, ссылок и инлайн-изображений. Требует Node.js и пакет docx.
• prompt-enhancer — превращение короткой неструктурированной заметки или ТЗ в подробную императивную постановку с пронумерованными шагами анализа, явными граничными случаями и фиксированным форматом вывода. Сохраняет термины и не добавляет новых требований.
• transcribe — транскрибация аудио и видео через Gemini 2.5 Flash API: дословная расшифровка с таймкодами, опциональное саммари, режим --analyze-ui для разбора экранного интерфейса со скриншотами. Требует Python, ffmpeg и GEMINI_API_KEY.
• handoff — сжимает текущий разговор в самодостаточный handoff-документ для следующей сессии (новый чат, другая машина, другой ИИ-клиент). Не дублирует durable-артефакты (openspec/, memory.md, коммиты, заметки в 1c-templates-mcp), а ссылается на них. Дефолтный путь — handoffs/handoff-<timestamp>.md в корне проекта. Адаптировано из mattpocock/skills.
• v8unpack-cf — распаковка и сборка бинарных файлов 1С (CF / CFE / EPF) в человекочитаемые исходники (JSON + BSL) через Python-утилиту v8unpack без платформы 1С. Используется, когда на руках только бинарник, а инфобазы / Конфигуратора / ibcmd нет; для выгрузки из работающей инфобазы через платформу — правило getconfigfiles. Требует Python и пакет v8unpack.

Правила рассчитаны на работу совместно с пакетом MCP-серверов от vibecoding1c.ru/mcp_server (Docker-контейнеры, поднимаются локально по HTTP). Все серверы опциональны: правила содержат graceful fallback, если конкретный MCP не поднят. Каталог адресов и идентификаторов — в content/mcp-servers.json. Единый источник правды по MCP-маршрутизации, fallback-порядку и таблицам инструментов — скилл mcp-1c-tools (content/skills/mcp-1c-tools/SKILL.md, разделы docs/<server>.md); плейбуки под типовые задачи — в content/rules/tooling-playbooks.md.

Основной инструмент для глубокого анализа конфигурации. Метаданные индексируются как граф связей, что даёт многоуровневый impact-анализ и понимание архитектуры в терминах бизнес-сущностей.

• get_object_dossier — полное «досье» объекта одним вызовом: реквизиты, табличные части, измерения/ресурсы, формы, подписки, роли, зависимости (USED_IN, движения регистров), модули с сигнатурами процедур, бизнес-описание.
• trace_impact — рекурсивный impact-анализ глубиной 1–10 по USED_IN / DO_MOVEMENTS_IN / CALLS. «Если изменю X — что ещё затронет?» Используется перед рефакторингом.
• trace_call_chain — рекурсивный обход графа вызовов BSL (callees / callers, глубина 1–10), с дизамбигуацией одноимённых процедур по объекту-владельцу.
• search_code — поиск по коду конфигурации: fulltext (Lucene), semantic (по смыслу), hybrid. Уровни детализации L0–L3 (от полного кода процедуры до минимальных карточек) для управления токенами.
• search_metadata — JSON-шаблоны Cypher-запросов (детерминированные) или NL → Cypher: списки атрибутов, объектов категории, форм, значений перечислений, измерений и т.д.
• search_metadata_by_description — Lucene-fulltext + опционально вектор по Синоним / Комментарий / Описание / Справка.
• business_search / answer_metadata_question — семантический поиск по бизнес-описаниям и Q&A на естественном языке.
• find_objects_using_object / find_usages_of_object / find_register_movement_docs / resolve_qualified_name / find_by_guid / compare_base_and_extension — точечные обходы графа.

Базовый «индекс» конфигурации (используется как fallback к графовому MCP).

• Метаданные: metadatasearch (FTS/семантика, режим names_only для компактных списков), get_metadata_details (полная структура объекта по имени).
• Код: codesearch (гибридный поиск), search_function (структурный FTS-индекс по процедурам/функциям с экзакт+fuzzy), get_module_structure (содержимое модуля), get_method_call_hierarchy (плоский call-граф), graph_dependencies (плоские зависимости forward/reverse), bsl_scope_members (доступные методы/свойства/события для BSL-контекста).
• Формы: search_forms (поиск форм по элементам, реквизитам, командам), inspect_form_layout (полное дерево формы — иерархия элементов, привязки, обработчики).
• XSD и валидация: get_xsd_schema (XSD под Справочник, Документ, РегистрСведений и пр., в т.ч. подобъекты Форма / СКД / Макет) и verify_xml (валидация XML-строки против XSD).
• Справка: helpsearch (поиск по HTML-справке).
• Администрирование: reindex, stats.

syntaxcheck — проверка кода через BSL Language Server. Бюджет — 1 вызов на цикл по умолчанию; до 3 только тогда, когда предыдущий запуск нашёл содержательный дефект. После лимита исправляются содержательные ошибки, остаточный стилевой шум не запускает новый цикл.

• templatesearch — гибридный поиск (вектор + fulltext) по библиотеке из 2000+ шаблонов и архитектурных паттернов 1С. Вызывается до написания кода.
• remember — сохранение проектного факта/корректировки/нетривиального решения в векторную память (одна самодостаточная заметка на запись, на английском, с сохранением оригинальных имён объектов/модулей 1С).
• recall — векторный поиск по сохранённым заметкам. Используется в начале нетривиальной задачи с ключевыми терминами (имя объекта, подсистема, текст ошибки).

Маршрутизация между этой памятью и memory.md описана в разделе AGENTS.md → Project memory (всегда подгружается вместе с правилами).

ssl_search — поиск стандартных функций БСП (любой версии) по точному имени и по семантике. Перед написанием новой служебной процедуры агент проверяет, нет ли готовой в БСП, чтобы «не изобретать велосипед».

Поиск по официальной справке конкретной версии платформы — критично, потому что сигнатуры и поведение меняются между версиями.

• docinfo — точечный поиск по известному имени объекта/метода (ТаблицаЗначений, Массив.Найти, Запрос).
• docsearch — гибридный (вектор + BM25) поиск по описанию, когда точное имя неизвестно.

Кроме проверки сигнатур, сервер закрывает проверку платформенных механизмов: перед самописной реализацией специализированной возможности (криптография, СЛАУ и численные методы, анализ данных, система взаимодействия и боты, шина/очереди сообщений, полнотекстовый поиск, регулярные выражения и т.п.) агент обязан спросить справку — есть ли готовый механизм в платформе (docsearch по описанию → docinfo по найденным именам, плюс ssl_search для БСП). Память модели не считается доказательством отсутствия механизма (канон — AGENTS.md → MCP Tool Calling → A.7).

Доступ к коммерческому сервису 1С:Напарник в роли субагента + поиск по ИТС.

• Анализ кода: check_1c_code (синтаксис, логика, производительность), review_1c_code (стиль, стандарты ИТС, нейминг, структура), rewrite_1c_code / modify_1c_code (переписывание/целевые правки), ask_1c_ai (свободный диалог с сохранением контекста).
• Документация и база знаний: search_1c_documentation (документация под конкретную версию платформы), onec_help (актуальная справка), its_help → fetch_its (поиск по ИТС-стандартам с обязательным дочитыванием полной статьи), diff_1c_documentation_versions (диффы между версиями платформы), config_help (документация по конкретным конфигурациям — ERP, БП, ЗУП, УТ).

Бюджет check_1c_code / review_1c_code такой же: 1 вызов каждого валидатора на цикл по умолчанию, до 3 только после содержательного дефекта. Output AI-инструментов всегда перепроверяется через syntaxcheck + check_1c_code + review_1c_code перед сдачей кода.

Установщик безусловно разворачивает OpenSpec-воркспейс (openspec/) с режимом «не перезаписывать существующее». Слэш-команды /opsx:propose, /opsx:apply, /opsx:archive, /opsx:explore разворачиваются автоматически для каждого активного инструмента из набора cursor, claude-code, codex, opencode, kilocode (бандлы — в content/openspec-bundle/<tool>/). Особенность Codex: его бандл содержит только SKILL-пакеты OpenSpec (.codex/skills/openspec-*), без слэш-команд — workflow вызывается через скиллы напрямую. Для kimi, qwen, command-code, cline, pi и other тулз-специфичного OpenSpec-бандла нет — работайте напрямую с openspec/specs/ и openspec/changes/ (или через установленные OpenSpec skills, где они есть). Подробности — в openspec/README.md.

• vibecoding1c.ru — портал по вайбкодингу для 1С: курсы, бенчмарк моделей, статьи, продукты для разработки 1С с ИИ.
• vibecoding1c.ru/mcp_server — пакет MCP-серверов для 1С, под который заточены правила и плейбуки этого репозитория.
• Telegram-канал «IT Does Matter» — обсуждение вайбкодинга для 1С, MCP, ИИ-агентов, практик и обновлений.

Никакой лицензии, берите и используйте как хотите