Каталог материалов и документов проекта
Каталог организован по PPT: люди, процессы, технологии. В каждой области указаны основной гайд, место записи результата, пример, уровень и момент применения. Последовательность работ задаёт процесс внедрения, краткую картину — сводка методологии.
Уровни: предприятие — программа и общие условия; команда — работа с конкретным продуктом; оба — материал применим на двух уровнях с явной областью ответственности. Общие факты сохраняются в документах программы, локальные — в документах команды; копировать их в оба места не нужно. Правила ведения нескольких команд.
У материала одно основное место описания. Связи с другими областями оформляются ссылками: процесс определяет критерии приёмки, технологии обеспечивают выполнение проверок, люди осваивают работу. Группировка PPT не заменяет последовательность этапов и не создаёт три комплекта одинаковых форм.
Люди
Ответственность, участие, обучение и освоение нового способа работы. На предприятии — владельцы программы и офис внедрения ИИ при масштабировании; в команде — назначенные участники и их практика. Гайд команды связывает роли с работами; участие и прогресс помогают разбирать подтверждённые результаты участников.
| Работа или результат | Уровень и момент применения | Основное описание | Шаблон / место записи | Пример |
|---|---|---|---|---|
| Команда | Оба · при назначении ответственных; уточнять при изменениях | Роли, ответственность программы | Назначения | Пример |
| Организовать офис внедрения ИИ | Предприятие · до широкого масштабирования; далее постоянно | Гайд офиса | Состав и полномочия в паспорте программы, календарь, план и журнал программы по порядку | — |
| Разбор участия | Оба · при необходимости разбора участия | При необходимости отдельного разбора; гайд | Форма | Пример |
| Передача инженерных обязанностей — первое событие передачи | Оба · при фактической передаче обязанностей по команде или общему сопровождению | Гайд | Журнал | Пример |
Обучение и вовлечение — оба уровня. Подготовка команды к работе с агентом. На уровне программы поддержку, обучение и обмен опытом организует офис внедрения ИИ; для первых пилотов эти функции могут выполнять назначенные участники программы. В команде инструкции связываются с процессом задачи и Git-процессом, практика фиксируется в журнале PoC. Отдельная дублирующая форма не создаётся.
Процессы
Исследование и программа предприятия · Внедрение в команду · Метрики результата, процесса и баланса
Последовательность внедрения, требования к работе и результатам, управление и непрерывное улучшение. Сквозной процесс связывает программу предприятия с циклом команды. Охват применения, ревью и тестирование, стратегия тестирования и правила действий определяют применимые условия и основания решений.
Исследование и программа предприятия
До подготовки программы проводится проверка применимости. Её результат — короткая запись в существующей задаче, чате или заметке с условиями проб, доказательствами и решением; формы программы для исследования не требуются.
Масштабирование внедрения применяется с подготовки программы: выбор пилотных команд, перенос опыта, проверка применимости, волны, закрепление и оценка результата. Область и цели ведутся в паспорте программы, волны и общие зависимости — в её плане, решения и наблюдения — в принятом журнале. Подробное распределение записей — в гайде. Иллюстрация переноса есть в разделе проверки переносимости.
Планирование, работа и контроль
Проверка улучшений по PDSA применяется на недельном разборе и по результатам ошибок; запись — в действующем журнале PoC или Пилота. Чек-лист готовности команды помогает выбрать работы развития; он не заменяет гейты конкретной работы.
Для уровня «оба» используются те же формы с обозначением области и ссылками на первичные факты. Типы и порядок применения описаны в гайде форм.
| Работа или результат | Уровень и момент применения | Основное описание | Шаблон / место записи | Пример |
|---|---|---|---|---|
| Индекс репозитория | Оба · при создании места ведения документов | Создание | README | Пример |
| Паспорт | Оба · при подготовке организованного внедрения в соответствующей области | Гайд; применение для программы | Форма | Пример |
| План внедрения | Оба · при планировании и пересмотре работ | Описание; применение для программы | Форма | Пример |
| Материалы Подготовки | Команда · Подготовка | Гайды по работам | Отдельные шаблоны; указатель не копируется как форма для заполнения | Указатель примеров |
| Статусная модель задач | Команда · Подготовка; пересмотр по результатам | Гайд | Форма | Пример |
| Работа с агентами и HITL | Команда · Подготовка; актуализация на PoC и Пилоте | Гайд | Маршрут, ссылки на процессы задач/Git | Пример |
| Git/MR и ревью | Команда · Подготовка; пересмотр по результатам | Гайд, ревью | Форма | Пример |
| Выбранные показатели | Оба · до начала измерений | Гайд РП, расчёты; оценка программы | Форма | Пример |
| Мониторинг и согласование оценок | Оба · PoC и Пилот; сводки программы по её области | Гайд РП | Согласованные сводки и решения в журнале Пилота | Показатели проекта |
| Готовность к PoC | Команда · перед стартом PoC | Переход | Чек-лист | Пример |
| Формирование целей и результатов | Оба · до начала внедрения и при изменении целей | Типовые цели и процедура, расчёты | Цели; краткий итог в паспорте, значения и границы в перечне показателей | Предложение на утверждение |
| Обследование клиента | Оба · при подготовке программы и команды | Гайд | Цели; паспорт и команда | Пример |
| Свойства проекта | Команда · Подготовка | Гайд | Контекст | Пример |
| Выбор задач | Команда · Подготовка и последующие этапы | Гайд | Область, первые задачи | Пример |
| Журнал PoC — начало недели 1 | Команда · начало PoC | Процесс, онбординг | Форма | Пример |
| Готовность к Пилоту — подготовка перехода по результатам PoC | Команда · подготовка к Пилоту | Переход | Чек-лист | Пример |
| Журнал Пилота — начало Пилота | Команда · начало Пилота | Гайд РП, расчёты | Форма | Пример |
| Проектные уточнения | Оба · при изменении правила в обозначенной области | При изменении исходного правила; процедура | Записи | Пример |
| Профиль потока | Команда · по необходимости | Если нужно отдельное представление выбранного потока; описание | Форма | Пример |
| Изменение режима проверки | Команда · при предложении изменить контроль | При предложении изменить ревью; регламент | Форма | Пример |
| Решение о переходе | Оба · при контрольном решении | Если нужен отдельный протокол вместо записи в журнале/чек-листе; описание; применение для программы | Форма | Пример |
| План достижения метрик | Команда · при завершении Пилота по второму основанию | При завершении Пилота по второму основанию; описание | Форма | Пример |
Требования и приёмка — команда; общие правила — предприятие. Гайд требований определяет работу с продуктовыми обязательствами, регламент ревью и стратегия тестирования — порядок и достаточность проверок. Критерии и правила фиксируются в существующих требованиях, процессе задачи и приёмке. Техническое обеспечение проверок находится в области технологий.
Ведение документов — оба уровня. Создание репозитория, адаптация правил, ведение агентом и порядок вывода действий используют те же первичные документы. Агент не создаёт параллельный учёт задач, решений и метрик. При отсутствии агента записи ведут назначенные участники по руководству.
Технологии
Платформа выполнения агентов описывает необходимые возможности, подключение проекта и проверку готовности. Конкретная реализация выбирается после определения этих условий.
Платформа, инференс, знания и навыки агентов, интеграции и средства выполнения работы и проверок. Предприятие обеспечивает общие сервисы и ресурсы; команда подключает продукт и проверяет конкретный рабочий путь. Процесс приёмки определяет, какие доказательства нужны, а техническая работа должна обеспечить их получение.
Платформа и агенты
| Работа или результат | Уровень и момент применения | Основное описание | Где сохраняется результат |
|---|---|---|---|
| Подготовить платформу и инференс | Оба · до зависимой работы; при наличии готового сервиса — проверить применимость и доступность | Развёртывание платформы, моделей, выбор схемы | Схема размещения, реестр моделей, условия онбординга; ссылки на версии и выполненные проверки |
| Адаптировать знания и навыки агентов | Команда · PoC; общие улучшения — предприятие после проверки применимости | Онбординг агентов, перенос проверенного комплекта | Версии литературы и навыков в Git, журнал онбординга, журнал PoC; пример записи — запись онбординга |
При адаптации навыков и регламентов для GLM 5.3 учитываются особенности работы с этой моделью: освоение типовых задач, конкретные проверки и порядок работы с нетиповыми задачами. Материал применяется в команде при онбординге и расширении типов задач, на предприятии — при подготовке общих навыков и регламентов.
Установка и настройка выполняются по документации выбранных версий. Наличие формы с адресом не заменяет проверку работоспособности. При общих сервисах команда ссылается на их описание и отдельно подтверждает своё подключение.
Настройка и проверка автоматического сбора показателей — работа ИИ-инженера на PoC и при изменении источников: результатом служат версия навыка, проверенная сводка и ежедневный сбор по расписанию или просьбой агенту; подтверждение — FLOW-06 журнала PoC, выбранные показатели — в перечне.
Инструменты, среды и продуктовые материалы
| Работа или результат | Уровень и момент применения | Основное описание | Шаблон / место записи | Пример |
|---|---|---|---|---|
| Размещение и варианты PoC | Оба · общие сервисы и схема конкретного продукта | Развилки и зависимости | Схема по периодам; краткая ссылка в паспорте | Облако и временные системы |
| Доступы и модели | Оба · до зависимой работы и при изменении подключений | Гайд | Git, системы, модели, оркестратор | Пример |
| Артефакты продукта и развитие | Команда · Подготовка и дальнейшее развитие | Требования, тесты | Реестр | Пример |
| Тестовая инфраструктура | Команда · Подготовка и развитие; общие сервисы — по ссылкам | Гайд | DEV и деплой, UAT, зависимости, БД и миграции | Пример |
| Журнал онбординга — начало адаптации на неделе 1 PoC | Команда · начало адаптации | Ведение журнала | Шапка и указания агенту | Свободная запись |
Стартовый комплект: Подготовка
Это указатель копирования для отдельной команды, сохраняющий связь с процедурой создания репозитория. Подробные описания, уровень применения и примеры находятся в областях PPT выше.
При создании проекта шаблон README переносится в корень, применимые рабочие формы — в project/:
- Паспорт, команда, план внедрения.
- Материалы Подготовки — выбрать отдельные формы по работам; сам указатель не копируется как форма для заполнения.
- Реестр артефактов и развития, процесс задач, работа с агентами, Git/MR.
- План мониторинга, готовность к PoC.
Существующий документ клиента подключается ссылкой, если покрывает необходимые сведения. Состояние «не применимо» содержит основание. Формы, связывающие уже заполненные документы, отдельно создавать не требуется. В форме онбординга на Подготовке заполняются условия и источники; подтверждения результатов добавляются на PoC и не становятся условием его начала.
Для программы предприятия применимость этих форм и места записи определяются порядком документов программы; командный комплект не копируется автоматически на уровень предприятия.
Направления Подготовки
Все три области развиваются совместно. Способы выполнения Подготовки определяют, откуда получить факты и с кем принять решения. Полный перечень форм и соответствие пунктам готовности — в указателе шаблонов.
- Люди: назначения участников, их время, участие экспертов и план освоения работы.
- Процессы: цели, контекст, выбор задач, план, правила работы, приёмка и измерения.
- Технологии: размещение, инференс, доступы, интеграции, первая среда и продуктовые материалы.
Документы по ходу внедрения
Момент создания определяется работой, а не областью PPT. Агент внедрения создаёт документы по запросу инженера, затем — по настроенным событиям. Журнал онбординга ведёт агент, с которым инженер выполняет адаптацию, в том числе до запуска агента внедрения. При ручном ведении документы создают назначенные участники. До появления рабочей формы индекс ссылается на исходный шаблон.
| Когда | Документ | Основная область |
|---|---|---|
| Начало адаптации на неделе 1 PoC | Журнал онбординга | Технологии |
| Начало недели 1 PoC | Журнал PoC | Процессы |
| Подготовка к Пилоту | Готовность к Пилоту | Процессы |
| Начало Пилота | Журнал Пилота | Процессы |
| Первое событие передачи обязанностей | Журнал передачи | Люди |
Журнал PoC содержит каталог проверок и недельные записи. Журнал Пилота содержит записи недель и когорт; несколько когорт могут наблюдаться одновременно. Физическое разбиение на файлы выбирает проект, смысл и история сохраняются. На уровне программы журнал решений и наблюдений ведётся с начала программы по её событиям.
Формы по необходимости
Эти формы не копируются автоматически; могут понадобиться уже на Подготовке. Описания и примеры приведены в таблицах соответствующих областей:
- Люди: разбор участия.
- Процессы: проектные уточнения, профиль потока, изменение режима проверки, решение о переходе, план достижения метрик.
Слои методологии
PPT группирует предмет работ; слои различают назначение файлов.
| Слой | Где находится | Как используется |
|---|---|---|
| Первое знакомство | Сводка, презентация, руководство, словарь | Объясняет подход и начало работы |
| Описания и гайды | Процесс, документы 03–09, правила действий, guides/, roles/ |
Определяют правила и объясняют действия; не заполняются как формы |
| Шаблоны | templates/ |
Источники рабочих документов; создаются в нужный момент |
| Примеры | examples/ |
Помогают заполнению; примерные факты не переносятся в проект |
| Проектные документы | Репозитории программы и команд | Заполненные формы, действующие уточнения, журналы и доказательства |
Журнал или чек-лист — вид рабочего документа. Его правила находятся в описании, формат — в шаблоне, заполнение показано в примере. Отдельный гайд для каждой формы не нужен, если существующее описание достаточно. Общие и командные записи связываются по правилам уровней.
Обучение и проверка результатов
Онбординг команды · Масштабирование. Инструкции сохраняются в документах рабочего процесса, практика — в журнале PoC.
Связанные разделы: формулирование замечаний, критичность замечаний, условия повышения автономности и переход к пост-ревью.
Служебные материалы
templates/project-readiness-checklist.md, templates/implementation-gates.md, templates/pilot-cohort-report.md и roles/gina-engineer.md — переходники для старых ссылок, а не дополнительные формы или роли. В комплект проекта они не включаются.
Выбранные материалы перечислены в индексе презентации; варианты и промежуточные сборки хранятся отдельно в _methodology-lab и не входят в Git.