Перейти к содержимому
Размах

Walkthrough методология — closure Phase 0 → Phase 1

Контекст

После Phase 0 research (60+ docs, ~5.5 MB) — было сделано 13 reviews (12 codex per-section + Claude Opus 4.7 consolidated с 1M ctx). Они нашли 39 findings (15 critical + 12 high + 12 medium).

Николай явно попросил систематический walkthrough с pros/cons для каждого critical/high, не silent fix.

Что сделано

Walkthrough в 3 этапа (~1.5 часа разговора):

  1. Этап 1: 15 critical в 6 логических группах (Timeline / Tech versions / Sponsor / Data integrity / UX / Process)
  2. Этап 2: 12 high в 5 группах (Naming / Estimates / Data scope / LLM-security / Phase decomposition)
  3. Этап 3: 12 medium (5 явно решены, 4 уже applied в rewrite, 3 silent cleanups)

Результат: 33+ явных решений + 4 implicit (applied при rewrite) + 4 silent cleanups = ~41 decisions.

После — apply в 6 phases (~4-6 часов работы):

  1. DECISIONS.md update в netnik-state
  2. ARCHITECTURE.md sync versions/timeline/tokens/cleanup
  3. ROADMAP.md sync
  4. 9 plan/active/*.md rewrite с per-task micro-checklists (70 checklists total)
  5. CHOICE_CHECKLIST post-hoc для top-10 выборов
  6. ASCII wireframes E2-block-1

Как сделано / в каком виде

Walkthrough conversation pattern

Каждый вопрос Николаю — через AskUserQuestion с 3-4 options:

  • 1-я опция — (Recommended) с явным указанием rationale
  • Остальные — alternatives с trade-offs
  • Каждый вопрос отдельно — Николай видит chunked progress

Группировка findings в логические группы (не по severity priority):

  • Связанные decisions решаются вместе (например, версии стека — Python/Next.js/PG одним вопросом×3)
  • Группа = ≤4 вопросов (limit AskUserQuestion)

Apply discipline

  • НЕ применяем silent automatic fixes без walkthrough decision
  • Все decisions → DECISIONS.md update (durable Git memory)
  • ARCHITECTURE/ROADMAP/plan-files refactor с walkthrough_decisions frontmatter (для traceability)
  • Per-task micro-checklists в plan files (Николай явное требование, не optional)

Что улучшено / что отвергнуто и почему

Улучшено:

  • Single walkthrough conversation (~1.5 часа) → 41 decisions vs typical “несколько итераций” подход
  • AskUserQuestion с recommended option speeds up при mass-decision walkthroughs
  • Frontmatter walkthrough_decisions: [...] в каждом plan-file → fixer-agent видит откуда decisions

Отвергнуто:

  • “Apply сразу без walkthrough, я доверяю рекомендациям” (Николай выбрал structured walkthrough — лучший выбор для critical decisions)
  • “По одному вопросу за раз без grouping” — слишком много clicks
  • “Сразу к Этапу 2/3 без Apply Этапа 1” — Николай выбрал full walkthrough first, apply одним массивом

Lesson learned (главный вывод)

В контексте крупного review (10+ findings, 5+ файлов impacted) — делай structured walkthrough с groups по 3-4 вопроса каждый, recommended-first options, и apply одним массивом после full walkthrough closure. НЕ применяй decisions silently.

Per-task micro-checklists в plan-files должны быть с самого начала — добавлять их post-hoc на 9 файлов = ~3 часа работы. Easier: создавать сразу при первой записи plan.

В каких будущих ситуациях пригодится

  1. Phase 1.5 launch review — когда будет следующий review (после Phase 1 complete), используем тот же walkthrough pattern
  2. Phase 2 Ozon scope review — перед стартом extended Ozon foundation walkthrough необходим
  3. External finance audit Phase 1.5 — структурированный walkthrough с auditor по findings
  4. Любой migration walkthrough — структура “Группа A: Critical / B: High / C: Medium” работает

Связанные lessons / decisions

  • netnik-state/projects/razmakh/DECISIONS.md — walkthrough closure section
  • netnik-state/decisions/razmakh-stack-choices-checklist-2026-05-17.md — 10 CHOICE_CHECKLIST
  • research/_reviews/REVIEWS_PHASE_E.md — base навигационный документ для walkthrough
  • prompts/parallel-research.md — related pattern (multi-agent triangulation)

Verification

  • 39/39 findings из REVIEWS_PHASE_E явно addressed (decisions documented)
  • Per-task checklists count: 70 в 9 plan files (verified через grep)
  • Versions sync: Python 3.13 / Next.js 16.2.x / PostgreSQL 18 — везде в ARCHITECTURE/ROADMAP/plan/00
  • Foundation duration sync: 8/11/14 нед — везде
  • Claude Opus 4.7 re-verify (1M ctx, independent session) — in progress по состоянию записи lesson

Дополнительные ссылки

  • Walkthrough conversation transcript: текущая сессия Claude Code (можно auto-archive в ~/.claude/projects/.../jsonl)
  • REVIEWS_PHASE_E.md: research/_reviews/REVIEWS_PHASE_E.md
  • 13 reviews source: research/_reviews/{ARCHITECTURE,ROADMAP,00-foundation,01-settings,02-sku,03-orders,04-supplies,05-finance,06-reviews,07-today,1.5-partners,2.0-ozon}-review.md + CLAUDE-CONSOLIDATED-REVIEW.md

Дублируется в: netnik-state/lessons/razmakh-walkthrough-methodology-2026-05-17.md (P16 двойное хранение).