---
pr: 120
title: refactor(agents): extract bug-discovery skill, AGENTS.md to English, EN descriptions
---

## Что сделано

- **Новый скилл `bug-discovery`** (`.opencode/skills/bug-discovery/SKILL.md`) —
  6-шаговый протокол, извлечённый из AGENTS.md (проверка дубликатов →
  `create-issue` tool → EN title / RU body → продолжить задачу → отчёт
  оркестратору).
- **AGENTS.md переведён на английский** (все 8 секций). Bug Discovery Protocol
  сокращён с 8 строк до 1 строки + ссылка на скилл `bug-discovery`. Tools
  упрощён — убрана мягкая enforcement-фраза ("НЕ fallback на raw bash, НЕ обход
  через `gh api`"), оставлен только deny-list указатель.
- **10 skill descriptions переведены на английский** (только frontmatter, тела
  НЕ трогались): run-pipeline, code-standards, memory, python-development,
  run-tests, get-project-map, release (убран дубль триггеров), tunnel, spec,
  issue.
- **`add-skill` тело обновлено** — инструкция про description: теперь явно
  требует EN. Формат `Use when ... Also when user says "..."` (RU фразы в
  триггерах OK, т.к. юзер говорит по-русски). Шаблон frontmatter обновлён.
- **`docs/project-map/README.md`** — добавлен `bug-discovery/SKILL.md` в
  дерево `.opencode/skills/`.
- **Handoff + ADR-053** созданы.

Проверки: `pytest tests/test_permissions.py` 13 passed; `ruff check` OK;
`ruff format --check` OK (40 files); `check-permissions.py` OK; кириллицы в
AGENTS.md нет (verified via python regex).

## Почему

AGENTS.md перегружен процедурными деталями (8-строчный Bug Discovery Protocol).
RU descriptions мешают semantic matching (descriptions используются для
skill selection). Мягкая enforcement ("НЕ fallback на raw bash, НЕ обход
через `gh api`") не работает — реальный enforcement это deny-list в
`permission.bash` файла `opencode.json`. Извлечение протокола в скилл держит
AGENTS.md компактным (52 → 45 строк), а EN descriptions улучшают matching.

## Pending

—

## Watch out

- Глобальный `~/.config/opencode/AGENTS.md` НЕ трогался — он монтируется через
  docker volume (Dockerfile/docker-compose), изменения project-local AGENTS.md
  подхватятся после rebuild/restart контейнера.
- `add-skill` теперь инструктирует EN descriptions для новых скиллов —
  существующие скиллы с RU description НЕ мигрированы принудительно (только 10
  в этом PR). `branch`, `repo-init`, `repo-readme`, `configure-opencode`,
  `add-skill` уже имели EN descriptions — не тронуты.
- Тела скиллов (кроме `add-skill`) НЕ изменялись — остаются на русском с
  английскими техническими терминами (как было).
- `bug-discovery` появится в `available_skills` только после рестарта opencode
  (скиллы загружаются при старте).