Создание репозитория внедрения

Процедура выполняется в начале Подготовки, до запуска платформы. РП внедрения организует создание, ИИ-инженер готовит структуру и проверяет её, DevOps предоставляет необходимые права. Это репозиторий проекта внедрения; он может быть отдельным либо разделом существующего Git, например рядом с литературой в /ai-methodology.

1. Выбрать место и зафиксировать исходную версию

Если Git материалов ещё не определён, ближайшее действие — обеспечить Git для документов и литературы по порядку получения решения. До этого адрес, каталог и ветка остаются неизвестными; примеры структуры ниже не превращаются в значения проекта. Размещение платформы само по себе не выбирает Git.

Указать сервер, репозиторий, базовую ветку, корень материалов и владельцев. Для отдельного репозитория создать пустой проект средствами Git-сервера; для существующего — отдельный каталог без перезаписи файлов. Использовать принятый в команде порядок веток и MR.

Зафиксировать версию исходной методологии и ссылку на неизменяемый commit/tag. Пока она распространяется файлами, сохранить датированный исходный пакет в доступном команде хранилище, записать его контрольную сумму и адрес. Ссылка на изменяемую папку без версии не позволяет воспроизвести правила.

2. Создать стартовый комплект

Использовать список стартовых форм. Он является перечнем копирования; примеры, журналы PoC/Пилота и весь каталог шаблонов автоматически не копируются.

Предлагаемая структура в выбранном корне:

README.md                     # навигация, источник методологии, порядок ведения
project/                      # заполненные паспорт, команда, план и другие формы
rules/                        # только проектные редакции изменённых описаний
journals/                     # появляется при начале PoC
agents/                       # агент внедрения или ссылка на его размещение

Если литература и агенты уже организованы иначе, сохранить их расположение и указать ссылки в README. Не создавать вторую действующую копию.

Скопировать шаблон README в корень, остальные стартовые формы — в project/ с исходными именами. Для материалов Подготовки выбрать применимые формы из указателя и добавить ссылки на рабочие документы в README; сам указатель не копируется как форма. Паспорт, команда, план и процессы ведутся в одном экземпляре. В форме онбординга сейчас заполняются только условия и источники, результаты — на первой неделе PoC.

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

3. Настроить ссылки и доступы

После копирования исправить ссылки, поскольку каталог изменился:

• На заполненные документы — относительные ссылки внутри проектного репозитория.
• На гайды и примеры — ссылки на зафиксированную версию дистрибутива.
• На формы будущих этапов — ссылки на исходные шаблоны до создания рабочих документов; затем заменить их проектными адресами.
• На адаптированные правила — ссылки в rules/; для неизменённых правил сохраняется ссылка на исходную версию.

При файловой поставке использовать доступный всей команде архив или опубликованный просмотр пакета. Не оставлять ссылки на личный диск создателя репозитория.

Проверить чтение участниками, запись ответственными, создание MR, правила принятия изменений. На Подготовке зафиксировать требуемые права агента; при передаче ведения агенту проверить их под его аккаунтом. В документах хранятся адреса систем и результаты проверок доступа, но не пароли и токены.

4. Заполнить и проверить

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

Результат создания: доступный репозиторий, README с версией исходника и адресами документов, стартовый комплект и начальный commit/MR. Проверить ссылки и отсутствие случайно скопированных примерных фактов. Само наличие комплекта не означает готовности к PoC: её подтверждает заполненный чек-лист.

После Подготовки применяется передача ведения агенту внедрения.