fix(agents): enforce bug-discovery protocol across all subagent layers (#128 )

* 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>

2026-07-29 18:29:41 +03:00

1.5 KiB

Raw Permalink Blame History

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):

AGENTS.md — секция помечена MANDATORY, добавлен нумерованный протокол и список применимых subagents.
run-pipeline templates A-E — каждый template содержит явный reminder загружать skill.
Agent definition bodies (reviewer, docs-reviewer, memory-syncer) — секция "## Bug Discovery" в конце body.
bug-discovery SKILL.md description — расширена триггерными фразами для лучшего semantic matching.

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

— Одиночное усиление в AGENTS.md (отвергнуто: уже не работал). — Permission-level enforcement через bash deny-rules (отвергнуто: bug-discovery — поведенческий паттерн, не bash-команда).

1.5 KiB Raw Permalink Blame History Unescape Escape