Понимание вашей кодовой базы — Презентация

Целевая продолжительность: ~8 минут Тон: “Позвольте показать вам то, что изменило мой подход к онбордингу в новые проекты.”

Слайд 1: Проблема онбординга (1,5 мин)

Тезисы для выступления:

“Сколько времени уходит, чтобы по-настоящему разобраться в новой кодовой базе? Не просто ‘я нашёл main-файл’ — а реально понять архитектуру, паттерны, причины проектных решений?

У большинства из нас — дни. Иногда недели. Вы читаете файлы, проходите по импортам, смотрите git blame, задаёте вопросы коллегам, читаете устаревшую документацию…

А что, если вместо этого можно было бы провести 20-минутный разговор?”

Ключевой тезис: Claude Code превращает исследование кодовой базы из одиночной охоты за сокровищами в управляемую экскурсию.

Слайд 2: Как Claude на самом деле читает код (2,5 мин)

Тезисы для выступления:

• Claude Code — не магия. Он использует конкретные инструменты для взаимодействия с файловой системой
• Три основных инструмента исследования:
  • Read — открывает файл и читает его содержимое (как cat, но умнее — может читать определённые диапазоны строк)
  • Grep — ищет паттерны по всей кодовой базе (работает на ripgrep, поэтому быстро)
  • Glob — находит файлы по шаблонам (как find, но удобнее)
• Когда вы задаёте вопрос, Claude решает, какие инструменты использовать и в каком порядке
• Он связывает их в цепочки: “Найди все TypeScript-файлы” (Glob) -> “Ищи ‘theme’ в этих файлах” (Grep) -> “Прочитай наиболее релевантный файл” (Read)

Аналогия: “Это как наблюдать за тем, как опытный разработчик ориентируется в новой кодовой базе. Он не читает каждый файл сверху донизу. Он ищет паттерны, идёт по следу и строит ментальную модель. Claude делает ровно то же самое — только за секунды.”

“Следите за вызовами инструментов в терминале. Вы увидите строки вроде ‘Reading src/app/layout.tsx’ или ‘Searching for pattern: theme’. Это не украшение — это Claude активно исследует ваш код, чтобы ответить на ваш вопрос.”

Слайд 3: CLAUDE.md — Память проекта (2,5 мин)

Тезисы для выступления:

• CLAUDE.md — это специальный файл, который Claude Code автоматически читает в начале каждой сессии
• Думайте о нём как о README, но для вашего AI-напарника
• Он содержит: обзор проекта, стек технологий, структуру файлов, соглашения, основные команды, подводные камни
• Команда /init автоматически генерирует его, анализируя вашу кодовую базу

“Вот какая ментальная модель мне нужна от вас. README.md — это документ для онбординга нового человека в команде. CLAUDE.md — это документ для онбординга Claude. И так же, как хороший README, хороший CLAUDE.md становится лучше со временем, когда вы его дополняете.”

Что входит в CLAUDE.md:

• Описание и назначение проекта
• Стек технологий и ключевые зависимости
• Обзор структуры директорий
• Команды для сборки/тестирования/деплоя
• Соглашения по стилю кода и паттерны
• Известные особенности и подводные камни

Важный нюанс: /init даёт отличную стартовую точку, но настоящая сила — в ручном редактировании со временем. Когда вы обнаруживаете, что “в этом проекте мы всегда используем именованные экспорты” или “API-роуты следуют вот такому шаблону” — добавьте это в CLAUDE.md. Каждая будущая сессия выиграет от этого.

Слайд 4: Разговорное исследование vs. прямые команды (1 мин)

Тезисы для выступления:

Два режима работы с Claude Code:

1. Разговорный: Задавайте открытые вопросы
   • “Объясни архитектуру этого проекта”
   • “Как данные попадают из API в графики?”
   • “Какую стратегию тестирования использует этот проект?”
2. Прямой: Давайте конкретные команды
   • “Прочитай файл src/app/api/models/route.ts и объясни, что он делает”
   • “Найди все файлы, которые импортируют компонент ModelCard”
   • “Найди TODO-комментарии в кодовой базе”

“Оба подхода допустимы. Разговорный хорош для исследования — когда вы не знаете, чего вы не знаете. Прямой хорош, когда у вас конкретный вопрос. Со временем у вас выработается интуиция, какой подход использовать.”

Слайд 5: Переход к практике (0,5 мин)

Тезисы для выступления:

“Хватит теории. Давайте запустим /init на ai-coderrank и посмотрим, что Claude узнает о нашем проекте. Затем проведём настоящий разговор об архитектуре — API-роуты, структура компонентов, переключение тем, всё это. Переходите в терминал.”