Задача: первый бизнес-процесс: кто создает и заполняет .xdlc? "Владелец руками" не масштабируется, "агент по анализу" - лотерея. Нужен план: вставил шаблон -> заполнил -> принял -> работай.

Требования: - процесс один на три "проекта-полигона" разных стеков: legacy / PlayBiz (React) / SmartBiz (SaaS), а "завтра" - еще и разные домены (S / P / A / H / C / O); - все строго по ролям - шапки из ролевой карты - хоть и тестирую в solo-режиме, "завтра" хочу быть уверенным, что ответственность "расслоится" без проблем; - правила живут в артефактах, а не "в головах"; - приемка - гипотеза с метрикой, а не "посмотрел и ок".

Решения: 1. Ядро - одно копирование шаблона в корень: внутри бланки со справками - формат, правила, примеры по доменам, bash-скрипты, и другие "рабочие" артефакты.

2. Карта проекта строится в три слоя: скрипт выгружает структуру (машинный); спец, знающий код (роль SWE, Software Engineer), пишет правила гранулярности - миграции паттерном, контроллеры поштучно, медиа каталогом (человеческий); агент собирает карту, не открывая исходники (метит догадки "(?)" по "именам" каталогов/файлов)) -> потом догадки снимает SWE факт-проверкой (смысловой).

3. Подсказки/примеры в артефактах не удаляются (раньше: спец сделал что-то в артефакте: удалил блок "примеров", чтобы "агенту меньше читать" в будущем. Но уже сделали вывод: кривой подход для "далеких" горизонтов). Агенту - стоп-маркеры: между "@@@ СПРАВКА: НАЧАЛО" и "КОНЕЦ" - контекст, а не данные; парсим только строки вне блока, не сжигая AI-квоту. Через полгода новый спец снова видит формат и примеры - в новом контексте даже топ теряется "на старте" 😊

4. Приемка - как Discovery: две гипотезы с метриками. Г1: агент, получив только AGENT-README, отвечает "где карта, какие правила, что за проект" - максимум 2 уточняющих вопроса (порог). Г2: любой модуль из выборки находится по карте за минуту, без кода. Пороги пробиты -> чиним входы, а не "принимаем с оговорками". Инженерные детали: Скан - bash-скрипт mm-scan.sh (тесты на debian-подобных), 150 строк без зависимостей: find обходит проект; каталоги из mm-excludes.conf обрезаются до строки [EXCLUDED: описание]; медиа-папки сворачиваются строкой со счетчиками: [MEDIA-DIR: N файлов: png x N]. Временных файлов ноль; артефакт один - module-map-raw.txt, вне git.

Результат в ядре: 1. PLAYBOOK-04 "Подготовка проекта": 11 шагов, у каждого роль и артефакт: инвентаризация (XPE, X-Engineer) -> шаблон в корень (HPE, platform engineer) -> исключения, скан, гранулярность (SWE) -> черновик карты (Контур-хелпер) -> факт-проверка (SWE) -> conventions + STATE + AGENT-README -> приемка.

2. Чек-лист приемки для XPE и GAE (guardian engineer): механика - в файле, не в чате.

Результат в проекте (PlayBiz - "мелкий" полигон): 3. Исключения: 7 каталогов - строкой [EXCLUDED], содержимое не утекает.

4. Медиа-папки (фавиконы, скриншоты кейсов) сжались до строки: выгрузка 1111 -> 371 строк, втрое меньше.

5. "Granularity" - что поштучно, а что группами. Спец пишет только отличия от умолчания "каждый файл = единица карты": PlayBiz хватило 3 строк. 😊

6. module-map: 17 модулей таблицей "модуль -> за что -> файлы -> связи"; "(?)" сняты факт-проверкой: открыты реестры виджетов и пара компонентов. (Проверим: опишет ли карту "сходу" не автор?)

7. conventions (где что искать), STATE (восстановление контура), AGENT-README (вход агента) - заполнены. Прогон и замеры остальных полигонов - в следующем посте. Для данного small-проекта задача вышла в 30 минут вместе с проверкой, все роли я "натягивал" на себя попеременно.

"Все зеленое" без замера - антипаттерн нашего медиа-фрейма: "публикация раньше закрытия задачи". Проверили: скормили генератору запрос "нарисуй цифры, прогнать не успели". Ответ: "ваша же система называет это антипаттерном, я с таким работать отказываюсь". Ну, молодец 😊

Вопрос к аудитории: Ваша подготовка нового проекта - регламент, который можно открыть и повторить, или "как повезет/по настроению"? Если второе - с чего начали бы автоматизацию? 😉

#IT #AI #ИИ #XDLC #SDD #автоматизация