Блок 3

Планування з ADR та діаграмами

Використовуйте режим Plan для обмірковування перед дією, створюйте Architecture Decision Records та генеруйте Mermaid-діаграми інфраструктури — все до написання єдиного рядка коду.

~35 хв (10 хв презентація + 25 хв практика)
Plan Mode (/plan, Shift+Tab) Ultraplan (/ultraplan) Edit/Write Tools Structured Output Mermaid Diagrams

Сім разів відміряй, один раз відріж

Ось патерн, що вбиває проєкти: хтось відкриває файл, починає хакати, і через три години змінив 47 файлів і не пам’ятає, з чого почав. AI робить це гірше — він настільки швидко вносить зміни, що ви можете закопати себе в яму з надлюдською швидкістю.

Режим Plan — це антидот. Це спосіб Claude Code сказати: “Дайте мені спочатку подумати, показати вам, що я б зробив, і отримати ваше схвалення, перш ніж я торкнуся будь-чого.”

Цей блок — про дисципліну. Не нудну — ту, що робить вас швидшим. Ми сплануємо зміну темної теми, яку реалізуємо в Блоці 4, і залишимо документацію, за яку майбутній ви будете вдячні теперішньому вам.

Що ми розглянемо

  1. Режим Plan та ultraplan — коли достатньо локального плану, а коли краще відправити більший план у Claude Code on the web
  2. Architecture Decision Records — легковагі документи, що фіксують рішення та їх обґрунтування
  3. Mermaid-діаграми — текстові діаграми, що живуть у репозиторії та рендеряться на GitHub
  4. План темної теми — картування кожного файлу, який ми зачепимо, кожної змінної, яку змінимо, до написання єдиного рядка коду

Що ви створите

До кінця цього блоку у вашому репозиторії з’являться чотири нових файли:

Файл Призначення
docs/adr/001-dark-theme.md Запис рішення про зміну теми
docs/diagrams/infrastructure.md Mermaid-діаграма топології DO + k3s
docs/diagrams/traffic-flow.md Mermaid-діаграма маршрутизації запитів
docs/diagrams/deployment-pipeline.md Mermaid-діаграма CI/CD-пайплайну

Це не домашні завдання. Це артефакти, які досвідчені інженери створюють перед внесенням змін на рівні інфраструктури — і Claude може згенерувати їх за хвилини.

Чому це важливо для DevOps

Якщо ви коли-небудь успадковували проєкт і питали “чому це налаштовано саме так?” — щоб знайти нуль документації — ви знаєте цей біль. ADR вирішують це. Вони не є дизайн-документами (ті довгі, і їх ніхто не читає). ADR короткі, з чіткою позицією і відповідають на одне запитання: чому ми прийняли це рішення?

А Mermaid-діаграми? Вони версіоновані, diff-friendly, і GitHub рендерить їх нативно. Більше жодних посилань на Lucidchart, що протухають, коли хтось звільняється з компанії.

Ще один інструмент планування варто тримати в голові ще до глибокого розбору в Блоці 13: /ultraplan. Локальний /plan ідеальний, коли вам достатньо терміналу. Ultraplan потрібен для більших змін, коли Claude готує план віддалено в Claude Code on the web, ви коментуєте окремі секції прямо в браузері, а потім або запускаєте виконання у вебі, або повертаєте затверджений план назад у термінал.

Оберіть формат

Виберіть формат, який відповідає тому, як ви використовуєте блок:

Презентація

Нотатки доповідача, структура слайдів та тези для голосового супроводу цього блоку.

Практика

Готові до копіювання команди та промпти для практичної частини з демонстрацією екрана.

Квіз

Перевірте свої знання з цього блоку — 6-8 запитань.

Що ви опануєте

  • Зрозуміти, чому планування важливе навіть при роботі з AI
  • Використати режим Plan для окреслення багатофайлової зміни теми перед редагуванням коду
  • Зрозуміти, коли достатньо локального планування, а коли краще відправити велику задачу в ultraplan на Claude Code on the web
  • Створити Architecture Decision Record (ADR), що фіксує *чому* за рішенням
  • Згенерувати Mermaid-діаграми для топології інфраструктури, потоку трафіку та пайплайну деплою
  • Переглянути та ітерувати план перед переходом до реалізації