docs(discovery): ADR-009 — discovery-interview tooling decision

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 06:24:51 +03:00
parent 592ec41c53
commit d136fe6810
1 changed files with 59 additions and 0 deletions
@@ -0,0 +1,59 @@
+# ADR-009: Discovery-interview tooling
+
+- **Status:** Accepted
+- **Date:** 2026-05-18
+- **Deciders:** Дмитрий
+
+## Context
+
+Запрос вида «менеджеры жалуются на X» или «хочу, чтобы Y» — симптом, не задача.
+`brainstorming` уходит в проектирование решения, не удерживая разговор в проблемном
+поле; для расплывчатых проблемных запросов нет слоя, который вскрывает проблему до
+решения (JTBD / customer discovery). Аналогично у заказчика нет способа получить
+синтезированную ориентацию по состоянию проекта — CLAUDE.md и MEMORY грузятся
+пассивно, `audit-portal` даёт качественный вердикт, не ориентацию.
+
+Параллельно 17.05.2026 раздел C10 карты ввёл скил `process-analysis`, чей режим 1 —
+«process discovery» (реконструкция as-is бизнес-процесса из кода). Это создаёт риск
+дубля (§5 п.6 CLAUDE.md) и коллизии триггеров по слову «discovery».
+
+## Decision
+
+Вводится проектный vendored-скил `discovery-interview` (`.claude/skills/`), два
+режима:
+
+- **FEATURE** — интервью заказчика перед фичей: JTBD вскрывает проблему, отдаёт
+  discovery-brief в `brainstorming`.
+- **SYSTEM** — интервью-ориентация по состоянию проекта: синтез по мета-слою (карта,
+  CLAUDE.md, MEMORY, Открытые_вопросы, Tooling, git log).
+
+Режим «интервью конечных пользователей» — **defer** post-Б-1 (нет живых
+пользователей; дублировал бы `design:user-research`).
+
+Дубль с `process-analysis` исключён **разрезом по слою-источнику**: `process-analysis`
+работает с app-кодом (`routes/`, `app/Jobs`, `audit_*`); discovery-interview — с
+головой заказчика (FEATURE) и мета-слоем управления (SYSTEM). Триггер-коллизия по
+слову «discovery» снята лексическим разведением описаний + взаимными SKIP-блоками;
+проверено триггер-eval'ом 20/20 (`.claude/skills/discovery-interview/evals/`) —
+переименование скила (fallback) не понадобилось.
+
+discovery-interview — *проектный* скил (как `audit-portal`, `regression`), не
+Superpowers-скил → регистрируется в Pravila §13.2; §12.2 (карта Superpowers-скилов)
+не трогается. Категория — новая 12-я off-phase подкатегория `discovery-tooling`,
+вне UI-пула PSR_v1; реестр Tooling — #55.
+
+## Consequences
+
+- Положительно: расплывчатый проблемный запрос получает дисциплину discovery до
+  проектирования; заказчик получает синтез-ориентацию on-demand; дубля с C10
+  `process-analysis` нет (разрез по слою), коллизия триггеров снята (eval 20/20).
+- Риск: скил self-authored — принадлежит проекту, без upstream-зависимости (это
+  смягчение, не риск).
+- Defer: режим «интервью конечных пользователей» — до появления живых пользователей
+  (блокер Б-1).
+
+## Enforcement
+
+None — discovery-interview advisory; корректность срабатывания проверяется
+триггер-eval'ом (`evals/evals.json`) и code review. Границы с `process-analysis`,
+`brainstorming` и `audit-portal` зафиксированы в SKILL.md секции «Границы».