diff --git a/docs/adr/ADR-009-discovery-interview-tooling.md b/docs/adr/ADR-009-discovery-interview-tooling.md new file mode 100644 index 00000000..ee279d02 --- /dev/null +++ b/docs/adr/ADR-009-discovery-interview-tooling.md @@ -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 секции «Границы».