1C AI DevStart

Стартовый шаблон Claude Code для разработки на 1С:Предприятие 8.

Готовый каталог .claude/ для проекта вашей базы: правила кодирования по стандартам 1С,
скиллы с паттернами разработки на BSL, субагенты-роли и протокол работы с живой базой через MCP.
Скопируйте в проект, пройдите настройку одной командой - и агент начнёт писать код
по стандартам, сверяясь с метаданными реальной конфигурации, а не со своей памятью.

Что умеет шаблон

• 📏 Нормы BSL в одном месте - правила кодирования по стандартам ИТС с единым
  чек-листом проверки; подключаются автоматически при работе с исходниками 1С.
• 🔌 Источники истины вместо памяти - протокол MCP: структура метаданных, проверка
  запросов и данные берутся из живой базы через MCP, тексты стандартов и диагностик -
  с v8std.ru (v8std), а «где это написано в исходниках» - из индекса кода (code-index)
  с графом вызовов и картой влияния. Агент не выдумывает реквизиты, не цитирует стандарты
  по памяти и не перебирает файлы грепом там, где есть индекс.
• 🧩 18 скиллов разработки - паттерны и практики для запросов, управляемых форм,
  жизненного цикла объектов, транзакций и блокировок, БСП, СКД, расширений, интеграций,
  обменов EnterpriseData и OData, работы с базой и индексом исходников через MCP, а также
  пакетных операций с конфигуратором и запуска внешнего агента за вторым мнением.
• 👥 6 субагентов-ролей - архитектор, исследователь кода, разработчик, ревьюер,
  упрощатель и составитель документации: тонкие роли без копий правил, каждый со своим фокусом.
• 🛂 Полномочия под контролем - паспорт проекта CLAUDE.md фиксирует, какие исходники
  агент вправе менять сам, какие - только по явному запросу, а какие лишь читать.
• ⚙️ Пакетные операции - выгрузка и загрузка конфигураций и расширений, сборка
  и разборка внешних обработок скриптами PowerShell через конфигуратор.

Быстрый старт

Понадобятся: Windows, платформа 1С:Предприятие 8.3, установленный
Claude Code и PowerShell. Для работы MCP - расширение
1c_mcp Владимира Харина, установленное в вашу базу,
и публикация базы с его HTTP-сервисом на веб-сервере (локальном или общем).
Без него шаблон тоже работает, но агент лишится большого числа функциональных действий.

1. Получите шаблон. Скопируйте содержимое репозитория, кроме README.md и install.md,
в папку своего проекта 1С.

Шаблон - это просто набор файлов: .claude/, CLAUDE.md и заготовки каталогов.
Если брали шаблон клонированием, не переносите в проект папку .git.

Или поручите это агенту - откройте Claude Code в папке будущего проекта и напишите:
Установи шаблон по инструкции https://raw.githubusercontent.com/mr-ske1r/1c-ai-devstart/master/install.md

2. Запустите настройку. Откройте Claude Code в папке проекта и выполните:

/setup-project

Команда проведёт по этапам, объясняя каждый; где можно, предложит готовый ответ, а вопросы
с вариантами задаст кнопками:

• подключение к базе - найдёт установленную платформу и предложит выбрать базу из списка
  окна запуска 1С, спросит пользователя. Пароль вы вписываете в файл сами: агент его
  не запрашивает и не видит, а сам файл в git не попадает;
• исходники - если src/cf пуст, предложит выгрузить конфигурацию в XML штатными
  средствами конфигуратора. Про расширения спросит, с какими работает ваш проект,
  и выгрузит только их: перебирать десятки расширений поставщика типовой конфигурации
  ни к чему. Выгрузили всё заранее сами - шаг просто пропускается. Конфигурацию, версию,
  режим совместимости и префиксы расширений вычитает из выгрузки, вам останется подтвердить;
• как агент пишет код - маркеры доработок (нужны ли они вообще: паспорт собирается
  и без них, если история правок у вас живёт в git), стиль асинхронности, куда класть новые
  объекты и доработки типовых, префикс конфигурации. Ответы попадают в паспорт CLAUDE.md;
• полномочия - какие исходники агент вправе менять сам, какие только по явному запросу,
  а какие лишь читать. По умолчанию предлагается осторожный набор: доверие к агенту проще
  наращивать, чем откатывать последствия;
• доступ к живой базе через MCP - необязательный этап: если в базу установлено расширение
  MCP и она опубликована на веб-сервере, пропишет подключение; нет - пропустит, вернуться
  можно позже.

Команда идемпотентна: сверяет фактическое состояние и доделывает недостающее. На второй
машине после клонирования вашего проекта просто запустите её ещё раз.

3. Перезапустите сессию - поднимутся MCP-серверы из .mcp.json. Проверьте, что
сервер вашей базы отвечает и видит вашу конфигурацию.

Готово: агент работает по правилам, видит метаданные базы и знает границы своих полномочий.

4. По желанию - подключите индекс исходников. В новой сессии выполните:

/setup-code-index

Команда поставит на машину индексатор code-index
его штатным установщиком, зарегистрирует в нём каталог src вашего проекта и допишет сервер
code-index в .mcp.json и секцию в паспорт. После этого «где это реализовано», «кто вызывает
процедуру» и «что затронет изменение объекта» агент отвечает по индексу за миллисекунды,
а не перебором файлов. Индексатор один на машину: второй и следующие проекты подключаются
той же командой. Каждое действие вне папки проекта - установка, переменная окружения,
автозапуск - выполняется только с вашего подтверждения. Без индекса шаблон работает:
агент читает исходники напрямую, просто медленнее.

Обновление шаблона

Скопируйте из репозитория папку .claude поверх своей. Файлы в корне - CLAUDE.md,
.mcp.json, настройки - не трогайте: они уже подогнаны под ваш проект.

Или поручите это агенту - откройте Claude Code в папке проекта и напишите:
Обнови шаблон по инструкции https://raw.githubusercontent.com/mr-ske1r/1c-ai-devstart/master/install.md

Как работать с задачами

Полный цикл

Для средних и сложных доработок запустите 1c-feature-dev:

/1c-feature-dev Добавить интеграцию с API сервисдеска

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

Лёгкий цикл

Для небольших и понятных задач используйте две команды:

/new-brief @Задача.md

Сначала проверьте и при необходимости поправьте с агентом brief.md, затем вызывайте команду создания плана

/new-plan @.tasks/<задача>/brief.md

После этого передайте план агенту на реализацию:

Реализуй план @.tasks/<задача>/plan.md

Субагенты отдельно

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

Используй субагента 1c-code-reviewer и проверь изменения по задаче @.tasks/<задача>/brief.md

Что внутри

.claude/
  rules/
    1c-rules.md          ← нормы BSL + чек-лист проверки кода (подключается на исходниках 1С)
    mcp.md               ← протокол источников истины: MCP → исходники → память с пометкой
    common-rules.md      ← общие правила поведения агента
  skills/                ← 18 скиллов: паттерны, примеры, ловушки
  agents/                ← 6 субагентов-ролей
  commands/              ← команды: /setup-project, /setup-code-index, /commit, документирование и планирование
CLAUDE.md                ← паспорт проекта (заполняется при настройке)
CLAUDE.local.md.example  ← личные настройки разработчика (не коммитится)
.mcp.json.example        ← подключение MCP-серверов: база проекта, v8std и code-index
.gitignore.example
src/
  cf/                    ← основная конфигурация
  cf_vendor/             ← эталон поставщика для сравнения (только чтение)
  cfe_<имя>/             ← расширения конфигурации
  epf/  erf/             ← внешние обработки и отчёты
tools/                   ← настройки подключения к базе для пакетных скриптов
.tasks/<задача>/         ← работа по задаче: постановка, бриф, план, дизайн, фазы
docs/<задача>/           ← сданная документация: техническая и пользовательская

Скиллы

Скиллы содержат знания, паттерны и рабочие процессы разработки на 1С: как проектировать решение,
писать и проверять BSL-код, работать с запросами, формами, СКД, расширениями и интеграциями.
Один скилл стоит особняком - codex-cli про инструмент вокруг разработки, а не про саму 1С.

Обычно они подхватываются автоматически по описанию задачи. При необходимости скилл можно
запустить явно — как 1c-feature-dev в примере выше.

Субагенты

Как это устроено

Принцип «ЧТО/КАК» - у каждого факта один дом:

• ЧТО (нормы) живёт в .claude/rules/1c-rules.md: одна норма - одна строка, без примеров.
  Правило подключается только при работе с исходниками 1С и не занимает контекст зря.
• КАК (паттерны, примеры, ловушки) живёт в скиллах. Скилл ссылается на норму,
  а не копирует её.
• Субагенты - тонкие роли: не таскают копии правил, а ссылаются на общий чек-лист
  и протокол MCP.
• Паспорт CLAUDE.md - только факты вашего проекта: конфигурация, каталоги, префиксы,
  маркеры, полномочия.
• Инструменты физического изменения XML-исходников не дублируются внутри шаблона: для этого можно подключить специализированные внешние скиллы.

Такое разделение держит контекст агента компактным и исключает противоречия между копиями
одного и того же знания.

Отсюда следствия:

• у каждой нормы указано происхождение - [std#404] (номер страницы стандарта),
  [платформа], [рекомендация], [правило проекта]; наш собственный выбор вынесен
  в секцию «Политика шаблона» и ослабляется под проект. Видно, где стандарт, а где вкус;
• чек-лист один на всех - агенты разработчик, ревьюер и основная сессия сверяются по одному
  тексту, поэтому критерии приёмки не расходятся с критериями написания;
• скилл ссылается на норму, а не пересказывает её - правка нормы не оставляет
  разошедшихся копий в десятке файлов;
• скиллы согласованы между собой - области ответственности разграничены, пересекающиеся
  пары разведены заранее. На пограничной задаче агент берёт нужный скилл, а не всё похожее
  сразу.

Это не россыпь удачных подсказок в одной папке, а собранный каркас: нормы, знания, роли
и проверки подогнаны друг к другу.

MCP-серверы

Баз может быть несколько - рабочая, тестовая, база смежной системы. Каждая подключается
своим сервером в .mcp.json и заносится строкой в паспорт проекта: там указано, где
тестовый контур, а где рабочий, и что на каждой базе разрешено. Агент выбирает базу по этой
таблице и в базу, помеченную «только чтение», не пишет.

Шаблон работает и без MCP - тогда агент опирается на исходники проекта и честно помечает,
что не смог свериться с базой. Индекс тоже необязателен: без него исходники читаются
напрямую. Но полную силу протокол источников истины набирает с подключённой базой.

Рекомендуемое дополнение: cc-1c-skills

Шаблон намеренно не содержит инструментов для прямого изменения XML-исходников 1С. Для таких задач рекомендуется использовать cc-1c-skills Николая Широкова.

Эти скиллы дополняют шаблон инструментами для создания и изменения объектов метаданных,
управляемых форм, СКД и макетов с проверкой результата.

Таким образом, скиллы шаблона отвечают за правила, паттерны и процесс разработки,
а cc-1c-skills дополняют их инструментами для непосредственной работы со структурой XML-исходников 1С.

Истоки и благодарности

Шаблон стоит на плечах открытых проектов сообщества 1С:

• Владимир Харин - 1c_mcp, MCP-сервер
  для 1С:Предприятие, на который рассчитан протокол источников истины шаблона,
  и 1c-batch, скрипты пакетных операций
  с конфигуратором: скилл 1c-batch включён в шаблон с разрешения автора и перенесён
  без изменений.
• Игорь Апресов - v8std.ru, публичное зеркало стандартов
  разработки 1С, и MCP-сервер v8std поверх него, подключённый в этом шаблоне.
  Стандарты сделаны общественным достоянием (CC0) - за что автору огромное уважение.
• Сергей Костяков - code-index-mcp, индексатор
  исходников с MCP-сервером и родной поддержкой выгрузок 1С (MIT; публикация на Инфостарте).
  Сам инструмент в шаблон не входит и ставится его штатным установщиком; шаблон добавляет
  к нему норму приоритета «сначала индекс», скилл mcp-code-index и команду /setup-code-index.
• AndreevED/1c-ai-feature-dev-workflow -
  адаптация воркфлоу feature-dev от Anthropic для платформы 1С. Отсюда взят цикл спецификационной разработки: скилл 1c-feature-dev
  (анализ → архитектура → код → ревью), скилл brainstorm и пятёрка субагентов -
  адаптированы под архитектуру шаблона.

И отдельное спасибо всему сообществу 1С — каждому, кто открыто делится своими проектами,
инструментами и накопленным опытом. Эта культура обмена позволяет изучать, адаптировать
и развивать доступные наработки, создавая на их основе новые полезные решения — с уважением
к авторству и условиям использования.