opencode-config/docs/decisions/091-pr-204-remove-docs-phase.md
Sergey 9dd462b764
refactor(pipeline): remove DOCS phase from pipeline-status (#208)
* test(pipeline): remove adr and project-map test files

* refactor(pipeline): remove DOCS phase from pipeline-status

* test(pipeline): update tests for 6-phase pipeline

* docs(handoff): add handoff and ADR for remove-docs-phase

* docs(handoff): set PR number

* fix(pipeline): parse PR body via json.loads in check_implement

---------

Co-authored-by: opencode-agent <agent@opencode.local>
2026-08-01 03:48:41 +03:00

2.3 KiB
Raw Permalink Blame History

ADR-091: Remove DOCS phase from pipeline-status

Статус

Accepted (2026-08-01)

Контекст

Пайплайн PR содержал 7 фаз: ISSUE → IMPLEMENT → DOCS → CI → REVIEW → MERGE → MEMORY. DOCS phase проверяла handoff-файл (4 секции), mandatory ADR по PR#, project-map README.md и PR-комментарий от docs-reviewer subagent'а.

DOCS phase дублировала работу: PR body уже содержит структуру (4 heading'а enforc'ит create-pr.ts с issue #203), а ADR/handoff/project-map проверялись отдельным subagent'ом. IMPLEMENT phase требовала handoff-файл в diff — хрупкий gate, не связанный с реальным контрактом PR body.

Решение

Убрать DOCS phase целиком. Пайплайн сокращён до 6 фаз: ISSUE → IMPLEMENT → CI → REVIEW → MERGE → MEMORY.

check_implement переписан: вместо handoff-файла в diff проверяет PR body на 4 heading'а (## Что сделано, ## Почему, ## Watch out, ## Pending) через gh pr view N --json body. Контракт уже гарантирован create-pr.ts.

Удалены: check_docs, _check_docs_reviewer_comment, check_adr, check_project_map, dead-константы HANDOFF_DIR, ADR_DIR, PROJECT_MAP_DIR, REQUIRED_SECTIONS, DOCS_REVIEW_RE. MEMORY-константы и REVIEW_VERDICT_RE оставлены.

Существующие docs/handoff/, docs/decisions/ файлы не удаляются — исторический архив.

Альтернативы

— Оставить DOCS phase, но ослабить проверки (только handoff, без ADR/pm). Отклонено: дублирование PR body остаётся, gate всё ещё хрупкий. — Перенести ADR-check в REVIEW phase. Отклонено: mixing concerns, REVIEW должен проверять verdict reviewer'а, не файлы. — Удалить handoff/ADR-генерацию целиком. Отклонено (вне scope): scaffold-handoff.sh ещё используется для документирования решений — отдельный issue.