---
description: Обязательный порядок выполнения агентного пайплайна (все кодовые репозитории)
alwaysApply: true
---

# Пайплайн агентной разработки

## Область действия

Полный пайплайн ниже применяется к **любым** изменениям **кода/конфигов/тестов** в репозиториях **`dnd_player`**, **`project-converter`**, **`DndGamePlayerLicenseServer`**. **Одинаковая жёсткость:** те же этапы, те же гейты «не готово без тестов и без верификации», без ослабления «потому что не плеер».

Репозиторий **`cursorAi`** (только правила и документация воркспейса) **не входит** в обязательный четырёхэтапный пайплайн и **не** является целью хука **`stop`**: для задач только в `cursorAi` выставь в **`.cursor/pipeline-state.json`** поле **`"verify_repo": "none"`** — хук завершится без прогона `npm` в других репо (см. **`project.mdc`**).

## Обязательный триггер запуска пайплайна

Любое сообщение пользователя, которое приводит к правке кода в перечисленных репозиториях, обязано проходить полный пайплайн (если пользователь явно не сузил scope до «только совет / только текст»).

## Обязательная последовательность

1. Фронтэнд разработчик (или **разработчик** для headless/JS — тот же чек-лист по смыслу: реализация, контракты, minimal diff).
2. Разработчик автотестов (UI или unit/integration по стеку репозитория).
3. Ревьювер кода.
4. Верификация «как у пользователя» или **эквивалент** (см. ниже).

## Этап 4 по типу репозитория

- **`dnd_player`**: браузер или окно **Electron** (renderer), затем verify-скрипты репозитория.
- **`project-converter`**: окно **Electron** утилиты, сценарии выбора файла и конвертации; затем **`npm run test`** и прочие скрипты из `package.json` этого репо. **Вариант A:** при изменении поведения скрипт `test` и тесты — **в том же PR** (см. **`project.mdc`**).
- **`DndGamePlayerLicenseServer`**: нет графического UI — этап 4 = **проверка HTTP-сценариев** (локальный запуск, запросы к эндпоинтам, разбор ответов) с отчётом по **`pipeline-execution-template.mdc`**; не считать достаточным только чтение кода.

## Правила перехода между этапами

- Нельзя запускать следующий этап, пока предыдущий не завершен.
- Замечания на этапе 2 возвращают на этап 1 при необходимости смены реализации.
- Замечания ревьювера — на этап 1 или 2 по зоне ответственности.
- Замечания этапа 4 — на этап 1, затем снова 2 → 3 → 4.
- Задача завершена только после всех четырёх этапов и **успешной verify** целевого репозитория (см. **`project.mdc`**, поле **`verify_repo`** в **`pipeline-state.json`**). Хук **`stop`** (`.cursor/hooks/final-verify.cjs`) гоняет проверки для **`dnd_player`**, **`project-converter`** или **`DndGamePlayerLicenseServer`** в зависимости от **`verify_repo`**; для **`cursorAi`** используй **`verify_repo`: `none`**.

## Отчётность

На каждом этапе используй формат из **`pipeline-execution-template.mdc`**.

## Детали по стекам

Чек-листы этапов: **`agent-1-*` … `agent-3-ui-tester.mdc`**, под-агенты: **`.cursor/agents/`**, skill: **`feature-pipeline`**.