Онбординг нового разработчика с AI: из недель в дни

Традиционный онбординг: прочти вики (устаревшую), пройди README (неполное), найди ментора (занятого), через две недели, может, начнёшь быть продуктивным.

С Claude Code и Cursor кардинально быстрее. Новичок спрашивает прямо у кода — «Как работает авторизация?» — и получает контекстный ответ за секунды. Из актуального кода, не из вики 2023.

Что AI может при онбординге

• Объяснить архитектуру из кода
• Найти, где что происходит («где обрабатываются платежи?»)
• Описать поток данных
• Показать примеры решения типичных проблем
• Объяснить функцию или модуль
• Сгенерировать обзорную карту

# Prompts for onboarding a new person:

# Day 1 — understanding the project
"Read CLAUDE.md and README. Then explain:
1. What this project does
2. The tech stack
3. How to run it locally
4. Main modules and what each does"

# Day 2 — understanding architecture
"Draw the data flow for [main feature].
From HTTP request to database and back.
Mention all middleware and service layers."

# Day 3 — first task
"Look at this bug report: [description].
Find relevant code, explain the cause,
and suggest a fix. Write a test."

Claude Code в терминале отвечает об актуальном коде — не устаревшей документации. Cursor Chat — в редакторе. Оба читают проект и отвечают в контексте.

Что AI не может

Объяснить ПОЧЕМУ выбран подход. Кто за что отвечает. Неписаные конвенции. Политика откатов. Для этого нужен ментор.

Ментор занимается интересным, новичок более самостоятелен. Оба довольнее.

Как подготовить проект

1. Добавьте CLAUDE.md

Постоянный контекст для AI и документация для новых людей. Стек, команды, конвенции, решения. AI читает при каждом запуске — новичок получает согласованную информацию.

2. Структурируйте README

Секции: Quick Start, Architecture, Key Files, Contacts. AI читает — новичок получает персонализированное руководство.

# README.md — onboarding-ready structure

## Quick Start
npm install && npm run dev  # localhost:3000

## Architecture
- src/services/ — business logic
- src/api/ — REST endpoints
- src/models/ — Prisma schema and types

## Key Files (start here)
- src/services/auth.ts — authentication and JWT
- src/services/billing.ts — payments and subscriptions
- src/api/middleware.ts — request pipeline

## Owners
- Auth: @jan
- Billing: @petra
- Infrastructure: @martin

3. Чеклист онбординга

Список задач на первую неделю. AI помогает с каждым пунктом.

• День 1: Запустить локально, пройти README и CLAUDE.md с AI
• День 2: Понять архитектуру — спросить AI о потоке данных
• День 3: Просмотреть последние 3-5 PR — конвенции команды
• День 4: Исправить простой баг с AI — полный цикл
• День 5: Код-ревью PR коллеги с AI — что команда ожидает

Реальные результаты

Сокращение времени онбординга на 40-60%. Продуктивность за 5-7 дней вместо 2-3 недель. Ментор тратит 2-3 часа вместо 2-3 дней.

Лучший онбординг — где новичок отвечает на 80% вопросов сам. AI делает это возможным — ментор фокусируется на тех 20%, которые AI не может.

Инвестиции в CLAUDE.md и README окупаются с каждым новым членом. Бонус: улучшает работу и для существующих.