opencode-config/docs/handoff/pr-163-resolve-prompt-contradictions.md
Sergey 27db3851b6
fix(agents): resolve prompt contradictions and path mismatches (#163)
* fix(agents): allow echo and fix paths in docs-reviewer

* fix(agents): allow echo and load memory skill in memory-syncer

* fix(agents): fix skills path and load code-standards in reviewer

* fix(pipeline): remove checkout master from template E

* fix(scripts): update scaffold path in pipeline-status error

* docs(handoff): add handoff and ADR for prompt contradictions fix

* docs(handoff): set PR number

---------

Co-authored-by: opencode-agent <agent@opencode.local>
2026-07-31 18:47:32 +03:00

2.6 KiB
Raw Blame History


pr: 163 title: fix(agents): resolve prompt contradictions and path mismatches

Что сделано

Устранены 8 противоречий в prompt-инструкциях агентов и скриптах пайплайна:

  • Убран запрет echo из Rule 8 docs-reviewer.md и Rule 7 memory-syncer.md (echo уже в allow-list).
  • Заменён устаревший путь config/scripts/scaffold-handoff.sh.opencode/scripts/scaffold-handoff.sh в docs-reviewer.md (ADR секция) и pipeline-status.py (сообщение об ошибке check_adr).
  • Заменён origin/master...HEADorigin/HEAD...HEAD в docs-reviewer.md (Setup шаг 4) для унификации default-branch.
  • Заменён find skills/find .opencode/skills/ в reviewer.md (Setup шаг 4).
  • Добавлена загрузка skill("code-standards") в Setup reviewer.md после загрузки project skills.
  • Убран git checkout master && git pull из Template E в run-pipeline/SKILL.md (memory-syncer работает на уже смерженном default branch — checkout/pull запрещены его permission set).
  • Добавлена загрузка skill("memory") в Setup memory-syncer.md перед дистилляцией.
  • Добавлен явный guard в Spec cleanup секцию docs-reviewer.md: «НЕ выполнять spec cleanup pre-merge — это post-merge операция».

Зеркало ~/.config/opencode/ синхронизировано с repo-local .opencode/ (agents/, skills/, scripts/).

Почему

Противоречия между permission set'ами и prompt-инструкциями приводили к:

  • Невозможности использовать echo для debug, хотя он разрешён в allow-list.
  • Несоответствию путей скриптов (scaffold-handoff.sh переехал из config/scripts/ в .opencode/scripts/, но prompts и сообщения об ошибках не обновились).
  • Поломке на main-репо из-за хардкода origin/master вместо origin/HEAD.
  • Неспособности reviewer найти project skills (путь skills/ вместо .opencode/skills/).
  • Violation permission set'а memory-syncer'а (Template E требовал git checkout master && git pull, которые отсутствуют в allow-list).
  • Выполнению post-merge операций (spec cleanup) на pre-merge стадии.

Pending

Watch out