c3efae6a30
* fix(agents): strengthen bug-discovery protocol in AGENTS.md to MANDATORY * fix(skills): add bug-discovery triggers to run-pipeline templates A-E * fix(agents): add bug-discovery section to subagent bodies * fix(skill): strengthen bug-discovery description for semantic matching * docs(handoff): scaffold handoff and ADR for bug-discovery protocol * docs(handoff): set PR number --------- Co-authored-by: opencode-agent <agent@opencode.local>
18 lines
1.5 KiB
Markdown
18 lines
1.5 KiB
Markdown
# ADR-057: Enforce bug-discovery protocol across all subagent layers
|
||
|
||
## Статус
|
||
Accepted (2026-07-29)
|
||
|
||
## Контекст
|
||
Bug-discovery protocol в AGENTS.md состоял из одной строки и не срабатывал у subagents. Subagents (reviewer, docs-reviewer, memory-syncer) не загружали skill `bug-discovery` при обнаружении багов вне scope текущей задачи — баги либо игнорировались, либо фиксировались напрямую (нарушение протокола).
|
||
|
||
## Решение
|
||
Усилить протокол в 4 слоях (defense-in-depth):
|
||
1. AGENTS.md — секция помечена MANDATORY, добавлен нумерованный протокол и список применимых subagents.
|
||
2. run-pipeline templates A-E — каждый template содержит явный reminder загружать skill.
|
||
3. Agent definition bodies (reviewer, docs-reviewer, memory-syncer) — секция "## Bug Discovery" в конце body.
|
||
4. bug-discovery SKILL.md description — расширена триггерными фразами для лучшего semantic matching.
|
||
|
||
## Альтернативы
|
||
— Одиночное усиление в AGENTS.md (отвергнуто: уже не работал).
|
||
— Permission-level enforcement через bash deny-rules (отвергнуто: bug-discovery — поведенческий паттерн, не bash-команда).
|