Дмитрий
60 lines
4.1 KiB
Markdown
60 lines
4.1 KiB
Markdown
# 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 секции «Границы».
|