# ADR-040: AGENTS.md pipeline sections consolidation + gh pr comment scope wording fix (PR #91)

## Статус

Accepted (2026-07-26)

## Контекст

3 секции в AGENTS.md описывали pipeline с разных сторон: `## Orchestrator Model (главное)` (главный чат = только план, subagent error retry), `## Development Workflow` (run-pipeline + pipeline-status orchestration), `## Pipeline` (pipeline-status / merge-pr / run-pipeline skill). Дублирование между Orchestrator Model и Pipeline секциями по `pipeline-status` и `merge-pr`.

C2 contradiction: AGENTS.md:49-51 описывал `gh pr comment*` scope как "reviewer/docs-reviewer" (per-agent override), но в `opencode.json:204` `gh pr comment*` находится в global allow-list (применимо ко всем агентам). `agent` блок в opencode.json не поддерживает per-agent `permission.bash` override.

## Решение

1. Слить 3 секции в 1 `## Pipeline`: orchestrator концепция (главный чат = только план, через subagents), pipeline-фазы (ISSUE → IMPLEMENT → DOCS → CI → REVIEW → MERGE → MEMORY), subagent error retry policy (1 retry → STOP + report), ссылки на `pipeline-status` / `merge-pr` / `/run-pipeline` — всё в одной секции (~6 строк вместо ~15).
2. Fix C2 wording: neutral description соответствует global allow-list — убрано "reviewer/docs-reviewer", "Промпт уже запрещает" → "Промпт запрещает", убрано "противоречие minimal".

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

- **Оставить 3 секции** — отклонено: дублирование pipeline-описания в Orchestrator Model и Pipeline секциях (оба упоминают `pipeline-status`, `merge-pr`, `run-pipeline`)
- **Scoped per-agent permission override для `gh pr comment*`** — отклонено: `agent` блок в opencode.json не имеет per-agent `permission.bash` field, override невозможен без изменения opencode schema