portal/docs/superpowers/plans/2026-05-18-discovery-interview-integration.md

Discovery Interview Skill — Integration Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Интегрировать проектный vendored-скил discovery-interview (режимы FEATURE + SYSTEM) в «мозг» Лидерры с полной «Тяжёлой» церемонией.

Architecture: Vendored-скил в .claude/skills/, триггерится по description. Два режима разведены с C10-скилом process-analysis по слою-источнику (app-код / голова заказчика / мета-слой). Полная нормативная регистрация: Tooling #55, PSR_v1 R10.1, Pravila §13.2, CLAUDE.md, ADR-009, узел automation-graph.

Tech Stack: Markdown skill-файлы, skill-creator (авторинг + eval триггера), проектная нормативка, vis.js automation-graph.

Спека: docs/superpowers/specs/2026-05-18-discovery-interview-design.md. Все границы DI1–DI6 — §5 спеки.

---

File Structure

Create:

• .claude/skills/discovery-interview/SKILL.md — скил, 2 режима, триггер-описание.
• .claude/skills/discovery-interview/references/jtbd-questions.md — банк JTBD-вопросов.
• docs/discovery/README.md — назначение каталога.
• docs/discovery/templates/discovery-brief.md — шаблон FEATURE-артефакта.
• docs/discovery/templates/system-snapshot.md — шаблон SYSTEM-артефакта.
• docs/adr/ADR-009-discovery-interview-tooling.md — ADR (формат Nygard, 7 секций).

Modify:

• docs/Tooling_v8_3.md — §4.30 (#55) + §0 счётчики + шапка v2.13.
• docs/Plugin_stack_rules_v1.md — R10.1 строка + версия v3.12.
• docs/Pravila_raboty_Claude_v1_1.md — §13.2 абзац + версия v1.26.
• CLAUDE.md — §3 title-counter, §1 row 2b, §3.3 строка, §6 абзац, §9 запись, §0 cross-refs, шапка v2.13.
• docs/CHANGELOG_claude_md.md — запись v2.13.
• .claude/skills/process-analysis/SKILL.md — +1 строка взаимного SKIP в «Границы».
• docs/automation-graph.html — узел discovery_interview + рёбра.
• cspell-words.txt — новые термины при необходимости.

---

Task 1 — Skill discovery-interview (SKILL.md + references) + eval

Files:

• Create: .claude/skills/discovery-interview/SKILL.md

• Create: .claude/skills/discovery-interview/references/jtbd-questions.md

• Step 1: SKILL.md frontmatter — name: discovery-interview + description (зафиксировано, изменять только по результату eval):

Структурированное интервью-discovery ПЕРЕД проектированием. Два режима. FEATURE — заказчик описывает проблему/боль/цель без готового решения («менеджеры жалуются на…», «сделки теряются», «хочу чтобы…»): JTBD-интервью вскрывает проблему до решения, отдаёт discovery-brief в brainstorming. SYSTEM — запрос ориентации по проекту («сориентируй», «где мы сейчас», «что в тулчейне/карте», «catch-up по…»): синтез по мета-слою (карта, CLAUDE.md, MEMORY, Открытые_вопросы, Tooling, git log). SKIP — чёткий директив на реализацию («интегрируй X», «закрой находку Y», «поправь Z»): это не discovery. SKIP — анализ бизнес-процесса из кода («как устроен процесс X», «process discovery», «где узкое место»): это skill process-analysis. Триггеры — «discovery interview», «проведи discovery», «сориентируй по проекту», расплывчатый проблемный запрос.

• Step 2: SKILL.md тело — секции: «Несущий принцип — 3 слоя-источника» (таблица из §2.1 спеки); «Режим FEATURE» (триггер/SKIP/JTBD-процесс/discovery-brief/хэндофф в brainstorming); «Режим SYSTEM» (триггер/SKIP/scope-интервью/синтез/запрет читать app/-код/system-snapshot); «JTBD-дисциплина» (прошлое поведение, один вопрос, 5×почему, не наводящие); «Границы» (DI1–DI4 + взаимный SKIP с process-analysis).

• Step 3: references/jtbd-questions.md — банк вопросов: проблема, текущий обходной путь, цена боли (время/деньги/частота), сигнал успеха, ограничения; формулировки в прошедшем времени.

• Step 4 (eval — тест триггера): через skill-creator собрать кейс-сет «должен сработать / не должен» (вкл. спорные: «сделай discovery» → должен; «как устроен процесс сделок» → НЕ должен, process-analysis; «интегрируй openapi-mcp» → НЕ должен, директив; «сориентируй по карте» → должен SYSTEM). Прогнать eval, замерить точность.

• Step 5: при промахах — итерировать description (Step 1) и повторить eval, пока точность чистая. Если коллизия с process-analysis не уходит — fallback: переименовать скил (имя без «discovery»), зафиксировать в ADR-009.

• Step 6: Commit — git add .claude/skills/discovery-interview/ → feat(discovery): add discovery-interview skill — FEATURE + SYSTEM modes.

---

Task 2 — docs/discovery/ каталог + шаблоны

Files:

• Create: docs/discovery/README.md

• Create: docs/discovery/templates/discovery-brief.md

• Create: docs/discovery/templates/system-snapshot.md

• Step 1: README.md — назначение каталога: home SYSTEM-snapshot'ов (YYYY-MM-DD-*.md); FEATURE-brief здесь не хранится — он вливается секцией в спеку brainstorming. Ссылка на скил и спеку.

• Step 2: templates/discovery-brief.md — разделы: Проблема · JTBD · Текущий обходной путь · Цена боли · Сигнал успеха · Ограничения.

• Step 3: templates/system-snapshot.md — разделы: Запрос ориентации (scope) · Состояние · Что открыто · Источники (пины) · Следующий шаг.

• Step 4: Commit — git add docs/discovery/ → feat(discovery): add docs/discovery — README + brief/snapshot templates.

---

Task 3 — ADR-009

Files:

• Create: docs/adr/ADR-009-discovery-interview-tooling.md

• Step 1: Написать ADR в формате существующих (см. ADR-008-business-process-tooling.md как образец): Status Accepted / Date 2026-05-18 / Deciders Дмитрий; Context (зачем discovery-interview, коллизия с C10 process-analysis); Decision (2 режима, 3-слойный разрез, discovery-tooling категория, §12.2 — не трогается, режим «пользователи» defer); Consequences; Enforcement (None — advisory, проверяется eval'ом и code review).

• Step 2: Commit — git add docs/adr/ADR-009-discovery-interview-tooling.md → docs(discovery): ADR-009 — discovery-interview tooling decision.

---

Task 4 — Нормативная регистрация (Tooling + PSR_v1 + Pravila + CLAUDE.md)

Один логический change → один коммит (паттерн C10 1a49d7b).

Files:

• Modify: docs/Tooling_v8_3.md — новый ### 4.30. discovery-interview (#55, off-phase, discovery-tooling) по образцу §4.28; §0 счётчик 54→55 (74→75), off-phase row +24→+25, итоговая строка; шапка → v2.13 + запись; футер-строка Прил. Н.

• Modify: docs/Plugin_stack_rules_v1.md — R10.1 (блок проектных скилов) +строка discovery-interview; версия → v3.12 + запись.

• Modify: docs/Pravila_raboty_Claude_v1_1.md — §13.2 +абзац «Off-phase discovery-tooling» (как проектный скил, не §12.2); версия → v1.26 + запись.

• Modify: CLAUDE.md — §3 title-counter 54→55; §1 priority-chain row 2b counter; §3.3 +строка #55 + footer-счётчик; §6 +абзац discovery-interview; §9 +запись v2.13; §0 cross-refs Tooling v2.13 / PSR_v1 v3.12 / Pravila v1.26; шапка → v2.13. Прямой Edit — worktree-constraint эксцепшн §5 п.10.

• Modify: docs/CHANGELOG_claude_md.md — запись v2.13.

• Step 1: re-Read docs/Pravila_raboty_Claude_v1_1.md §13.2 (актуальная версия в worktree — v1.25 после C10) перед правкой.

• Step 2: Tooling §4.30 + §0 счётчики + шапка.

• Step 3: PSR_v1 R10.1 + версия.

• Step 4: Pravila §13.2 + версия.

• Step 5: CLAUDE.md 6 точек + шапка; CHANGELOG запись.

• Step 6: Verify — счётчики сходятся во всех 4 файлах (55 формализованных / 75 total / off-phase +25 / 12 off-phase подкатегорий); cross-refs версий взаимно согласованы.

• Step 7: Commit — git add docs/Tooling_v8_3.md docs/Plugin_stack_rules_v1.md docs/Pravila_raboty_Claude_v1_1.md CLAUDE.md docs/CHANGELOG_claude_md.md → docs(discovery): register discovery-tooling — Tooling/PSR/Pravila/CLAUDE.md.

---

Task 5 — Граница в process-analysis (взаимный SKIP)

Files:

• Modify: .claude/skills/process-analysis/SKILL.md — секция «Границы», +1 строка.

• Step 1: В «Границы» добавить строку: **Интервью заказчика про будущую фичу / ориентация по проекту** — скил discovery-interview (вскрытие проблемы до решения; этот скил — про вскрытие as-is процесса из кода).

• Step 2: Commit — git add .claude/skills/process-analysis/SKILL.md → docs(discovery): process-analysis — reciprocal SKIP boundary to discovery-interview.

---

Task 6 — Узел карты automation-graph.html

Files:

• Modify: docs/automation-graph.html

• Step 1: Добавить узел discovery_interview в раздел off-phase / discovery-tooling (по образцу узлов C10 из коммита afcff10); Паспорт узла (дата внедрения 18.05.2026, использований 0).

• Step 2: Рёбра: discovery_interview → brainstorming (хэндофф), discovery_interview → process_analysis (ребро-граница), рёбра к governing-правилам (CLAUDE.md / Pravila §13.2).

• Step 3: Smoke — открыть карту через Playwright MCP, проверить 0 JS-ошибок, узел отрисован, нет перекрытий; обновить метрики узлов/рёбер в легенде.

• Step 4: Commit — git add docs/automation-graph.html → feat(map): discovery_interview node — discovery-tooling section.

---

Task 7 — Регрессия, push, memory

• Step 1: /regression quick (lint/format/type-check) — трогаем markdown/skill/html, код не меняем. Ожидание: GREEN. Failure'ы — выписать с file:line.
• Step 2: invoke superpowers:verification-before-completion перед claim «готово».
• Step 3: pre-push — gitleaks full-history + lychee вручную в worktree (квирк 97 — lefthook не в PATH).
• Step 4: Push — git push origin worktree-discovery-interview:main.
• Step 5: Memory — topic-файл project_discovery_interview.md + строка в MEMORY.md (≤200 символов, следить за лимитом 24.4 КБ).

---

Порядок и зависимости

Task 1 → 2 → 3 → 4 → 5 → 6 → 7. Task 1 — критический путь (eval-гейт). Tasks 4–6 механические — допустимы субагенты (Haiku/Sonnet, raw output), контроллер верифицирует счётчики и git-базу после каждого. Task 3 (ADR) зависит от результата eval Task 1 (фиксирует rename-fallback, если он сработал).

Не входит

Режим «интервью конечных пользователей» — defer post-Б-1. Реальный прогон интервью. Переименование скила — только fallback по eval (Task 1 Step 5).