Блок 3

Планирование с ADR и диаграммами

Используйте Plan mode, чтобы думать перед действием, создавайте Architecture Decision Records и генерируйте Mermaid-диаграммы инфраструктуры -- всё до написания единой строчки кода.

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

Семь раз отмерь, один раз отрежь

Вот паттерн, который губит проекты: кто-то открывает файл, начинает хачить, и через три часа изменено 47 файлов, а зачем всё начиналось – уже непонятно. ИИ делает это ещё хуже – он так быстро вносит изменения, что можно закопаться в яму на сверхчеловеческой скорости.

Plan mode – это противоядие. Это способ Claude Code сказать: «Дай я сначала подумаю, покажу тебе план и получу одобрение, прежде чем что-то трогать.»

Этот блок про дисциплину. Не скучную – а ту, что делает вас быстрее. Мы спланируем тёмную тему, которую реализуем в Блоке 4, и оставим после себя документацию, за которую будущий-вы скажет спасибо настоящему-вам.

Что мы разберём

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

Что мы создадим

К концу блока в вашем репозитории появятся четыре новых файла:

Файл Назначение
docs/adr/001-dark-theme.md Decision record для изменения темы
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-диаграммы? Они хранятся в системе контроля версий, видны в диффах, и GitHub рендерит их нативно. Больше никаких ссылок на Lucidchart, которые протухают, когда кто-то увольняется.

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

Выберите формат

Выберите формат, который подходит для вашей работы с блоком:

Презентация

Заметки докладчика, структура слайдов и тезисы для голосовой части блока.

Практика

Готовые команды для терминала и промпты для части с демонстрацией экрана.

Квиз

Проверьте свои знания по этому блоку — 6-8 вопросов.

Что вы освоите

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