portal/docs/superpowers/specs/2026-05-18-discovery-interview-design.md

Discovery Interview — интеграция skill: дизайн

Дата: 18.05.2026 Статус: Принят (brainstorming-сессия 18.05.2026 — заказчик одобрил «Тяжёлый» вариант + режимы FEATURE & SYSTEM) Раздел карты: новая 12-я off-phase подкатегория discovery-tooling Связано: ADR-009, план docs/superpowers/plans/2026-05-18-discovery-interview-integration.md

1. Контекст и проблема

При запросе новой фичи Claude склонен сразу уходить в решение (brainstorming solution-leaning). Расплывчатые/проблемные запросы заказчика («менеджеры жалуются на X», «сделки теряются») требуют сначала вскрыть проблему — JTBD, текущий обходной путь, цену боли — до проектирования.

Аналогично у заказчика нет быстрого способа получить синтезированную ориентацию по состоянию проекта (карта / тулчейн / открытые вопросы): CLAUDE.md и MEMORY грузятся пассивно, audit-portal даёт тяжёлый качественный вердикт, не ориентацию, карта — статичный граф.

discovery interview — техника продуктового / customer discovery: структурированное интервью, вскрывающее проблему до решения (Blank — customer development, Torres — continuous discovery, JTBD).

2. Решение

Skill discovery-interview — проектный vendored-скил в .claude/skills/, два режима:

• FEATURE — интервью заказчика перед фичей.
• SYSTEM — интервью-ориентация по мета-слою проекта.

Режим «интервью конечных пользователей» — не входит, defer post-Б-1 (нет живых пользователей Лидерры; дублировал бы design:user-research / product-management:synthesize-research).

2.1. Несущий принцип — разрез по трём слоям-источникам

Параллельная сессия 17.05.2026 закрыла раздел C10 карты и создала skill process-analysis (#53), чей режим 1 называется «process discovery». Чтобы discovery-interview не стал дублем (§5 п.6 CLAUDE.md), способности разведены по слою-источнику данных:

Способность	Слой-источник	Метод
process-analysis (C10 #53)	app-код — routes/, app/Jobs, audit_*	реконструкция бизнес-процесса из кода
discovery-interview FEATURE	голова заказчика	интервью человека
discovery-interview SYSTEM	мета-слой — карта, CLAUDE.md, MEMORY, Открытые_вопросы, Tooling, git log	интервью + синтез

Три непересекающихся слоя-источника → метод не дублируется → §5 п.6 соблюдён. Объединяющая нить скила — структурированное интервью человека; process-analysis человека не интервьюирует вообще.

3. Режим FEATURE

• Триггер: запрос проблемной формы — боль / жалоба / цель без готового решения.
• SKIP: чёткий директив («интегрируй X», «закрой находку Y», «поправь Z»).
• Процесс: JTBD-интервью — прошлое поведение вместо гипотетики, один вопрос за раз, 5׫почему» до корня, не наводящие вопросы.
• Артефакт: discovery-brief — проблема / JTBD / текущий обходной путь / цена боли / сигнал успеха / ограничения.
• Хэндофф: brief → brainstorming как проблемная секция спеки; brainstorming забирает её и не перезадаёт уже выясненные вопросы.

4. Режим SYSTEM

• Триггер: запрос ориентации — «сориентируй по проекту», «где мы сейчас», «что в тулчейне / карте», «catch-up по X».
• SKIP: «как устроен процесс …», «process discovery», «где узкое место» — это process-analysis.
• Процесс: короткое интервью — уточнить, что именно ориентировать (scope) → синтез по мета-слою → ответ.
• Запрет: SYSTEM не читает app/-код — это исключительный метод process-analysis. Источники SYSTEM — только мета-слой.
• Артефакт: system-snapshot → docs/discovery/YYYY-MM-DD-*.md.

5. Границы (конфликт-аудит)

• DI1 FEATURE ↔ brainstorming — FEATURE покрывает только проблемное поле, условный триггер + SKIP на директив, чистый хэндофф.
• DI2 SYSTEM ↔ process-analysis — разрез по слою-источнику; SYSTEM запрещено читать app/-код.
• DI3 SYSTEM ↔ audit-portal / карта — SYSTEM = активный синтез-ответ на запрос ориентации, не качественный вердикт (audit-portal) и не статичный дамп (карта / MEMORY).
• DI4 триггер-коллизия слова «discovery» — лексическое разведение триггеров (мои триггеры не используют голое «discovery» / «процесс») + взаимный SKIP в «Границах» discovery-interview и process-analysis.
• DI5 over-firing от «1%-правила» using-superpowers — консервативные триггеры, явные SKIP-примеры, eval триггер-описания через skill-creator.
• DI6 режим «интервью пользователей» — defer post-Б-1.
• §12.2: discovery-interview — проектный скил (как audit-portal, regression), не Superpowers-скил → регистрируется в Pravila §13.2, не в §12.2 (§12.2 — карта Superpowers-скилов). Триггерится штатным механизмом using-superpowers по description.

6. Эффективность

«Максимальная эффективность в использовании» = скил точно срабатывает в нужный момент и молчит в ненужный. Рычаги:

1. Консервативный триггер — FEATURE срабатывает только на проблемных запросах.
2. Явные SKIP-примеры в description — против «1%-правила».
3. Чистый хэндофф в brainstorming — без дубля вопросов.
4. JTBD-дисциплина зашита в теле SKILL.md.
5. Персистентные артефакты — FEATURE-brief в спеке, SYSTEM-snapshot в docs/discovery/.

Контроль — eval триггер-описания через skill-creator: кейс-сет «должен / не должен сработать», включая спорные («сделай discovery», «как у нас дела») → итерировать описание, пока точность чистая. Fallback при остаточной коллизии с process-analysis — переименование скила (имя без слова «discovery»).

7. Интеграционный footprint («Тяжёлый» вариант)

• Skill .claude/skills/discovery-interview/ — SKILL.md + references/.
• docs/discovery/ — home SYSTEM-snapshot'ов + README.md + шаблоны.
• docs/adr/ADR-009-discovery-interview-tooling.md.
• Tooling Прил. Н v2.13 — инструмент #55, §4.30, новая 12-я off-phase подкатегория discovery-tooling; счётчик 54→55 формализованных (74→75 total), off-phase row +24→+25.
• PSR_v1 v3.12 — R10.1.
• Pravila v1.26 — §13.2 (как проектный скил; §12.2 не трогается — см. DI §12.2).
• CLAUDE.md v2.13 — §3 title-counter, §1 row 2b counter, §3.3 строка, §6 абзац, §9 запись, §0 cross-refs. Правка прямым Edit — worktree-constraint эксцепшн §5 п.10 (прецедент A11 v2.10 / ADR-006 v2.11).
• docs/automation-graph.html — узел discovery_interview, рёбра к brainstorming + governing-правилам + ребро-граница к process-analysis.
• .claude/skills/process-analysis/SKILL.md — +1 строка в «Границы» (взаимный SKIP) как разрешение реального overlap.

8. Не входит

• Режим «интервью конечных пользователей» — defer post-Б-1.
• Реальный прогон интервью при интеграции (скил создаётся, не исполняется).
• Переименование скила — только fallback по результату eval (Фаза 2).