Вивчення кодової бази — Презентація

Орієнтовна тривалість: ~8 хвилин Тон: “Дозвольте показати вам щось, що змінило мій підхід до онбордингу в нові проєкти.”

Слайд 1: Проблема онбордингу (1.5 хв)

Тези:

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

Для більшості з нас — дні. Іноді тижні. Ви читаєте файли, відстежуєте імпорти, дивитесь 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-маршрути, структуру компонентів, перемикання тем, усе це. Переходьте до терміналу.”