Ivan Fontosh
46 lines
4.5 KiB
Plaintext
46 lines
4.5 KiB
Plaintext
---
|
|
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`**.
|