brain/docs/adr/ADR-009-discovery-interview-tooling.md

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 секции «Границы».