Блок 1

Изучение кодовой базы

Дайте Claude проанализировать проект, сгенерировать CLAUDE.md и исследовать архитектуру через диалог.

~28 мин (8 мин презентация + 20 мин практика)
/init CLAUDE.md Read Tool Grep Tool Glob Tool

От «что это?» до «я знаю эту кодовую базу»

Вы пришли в новую команду. В репозитории 50 файлов, документации нет, а в Slack – сообщение «посмотри код и разберись». Знакомо?

Именно здесь Claude Code превращается из «интересного инструмента» в «как я вообще раньше без этого работал?». Вместо того чтобы часами кликать по файлам, читать импорты и мысленно выстраивать архитектуру, вы ведёте разговор. Задаёте вопросы. Claude читает код и даёт ответы, основанные на том, что реально есть в проекте – а не на том, что кто-то не забыл задокументировать полгода назад.

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

  1. CLAUDE.md – что это, зачем нужен и как /init генерирует его автоматически
  2. Как Claude читает код – инструменты Read, Grep и Glob, работающие за кулисами
  3. Исследование через диалог – просим Claude объяснить архитектуру, поток данных и проектные решения
  4. Погружение в ai-coderrank – разбираемся в каждом слое проекта через диалог

Зачем нужен CLAUDE.md

В каждом проекте есть «племенные знания» – конвенции, подводные камни, причины из серии «мы делаем так, потому что…», которые живут в головах людей. CLAUDE.md фиксирует эти знания в формате, который Claude Code автоматически читает в начале каждой сессии.

Думайте об этом так:

  • README.md – для людей, которые приходят в команду
  • CLAUDE.md – для Claude, который приходит в команду

Когда вы запускаете /init, Claude анализирует всю кодовую базу и генерирует CLAUDE.md, фиксирующий структуру проекта, технологический стек, конвенции и важные паттерны. Вы можете (и должны) редактировать его со временем по мере углубления в проект – но автоматически сгенерированная версия уже на удивление хороша как стартовая точка.

Как Claude читает код

Claude Code имеет не просто доступ к вашим файлам – у него есть специализированные инструменты для разных видов исследования:

Инструмент Что делает Аналогия
Read Открывает и читает конкретный файл cat filename
Grep Ищет паттерны по файлам rg "pattern"
Glob Находит файлы по шаблону имени find . -name "*.ts"

Когда вы спрашиваете Claude «как работает переключение тем?», он не гадает. Он использует Grep, чтобы найти код, связанный с темами, Read – чтобы изучить найденные файлы, и Glob – чтобы проверить, нет ли связанных конфигов. Вы можете наблюдать эти вызовы инструментов в реальном времени прямо в сессии.

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

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

Презентация

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

Практика

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

Квиз

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

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

  • Сгенерировать файл CLAUDE.md с помощью /init и понять его назначение
  • Исследовать архитектуру ai-coderrank через диалоговые запросы
  • Понять, как Claude использует инструменты Read, Grep и Glob под капотом
  • Пройтись по API-роутам, структуре компонентов и переключению тем через диалог
  • Разобраться в разнице между исследованием через диалог и прямыми командами