Onboarding nového vývojáře s AI: z týdnů na dny

Onboarding nového vývojáře tradičně vypadá takhle: přečti si wiki (zastaralou), projdi README (neúplné), najdi mentora (zaneprázdněného), a za dva týdny snad začneš být produktivní. Často i déle.

S AI nástroji jako Claude Code a Cursor se tohle dramaticky zrychluje. Nováček se může zeptat přímo kódu — 'Jak funguje autorizace v tomhle projektu?' — a dostat kontextově relevantní odpověď za sekundy. Ne z wiki z roku 2023, ale z aktuálního kódu.

Co AI při onboardingu umí

• Vysvětlit architekturu projektu z aktuálního kódu
• Najít, kde se co děje ('kde se zpracovávají platby?')
• Popsat flow dat od requestu po response
• Ukázat příklady, jak tým řeší typické problémy
• Vysvětlit, co dělá konkrétní funkce nebo modul
• Vygenerovat přehledovou mapu projektu

# Prompty pro onboarding noveho cloveka:

# Den 1 — pochopení projektu
"Precti CLAUDE.md a README. Pak mi vysvetli:
1. Co tenhle projekt dela
2. Jaky je tech stack
3. Jak ho spustit lokalne
4. Hlavni moduly a co kazdy dela"

# Den 2 — pochopení architektury
"Nakresli mi data flow pro [hlavni feature].
Od HTTP requestu po databazi a zpet.
Zmin vsechny middleware a service vrstvy."

# Den 3 — prvni task
"Podivej se na tento bug report: [popis].
Najdi relevantni kod, vysvetli pricinu,
a navrhni fix. Napis test."

Claude Code přímo v terminálu odpovídá na otázky o aktuálním kódu — ne o zastaralé dokumentaci. Cursor Chat dělá totéž v editoru. Oba čtou váš projekt a odpovídají v kontextu.

Co AI při onboardingu neumí

Vysvětlit, PROČ se tým rozhodl pro určitý přístup. Kdo je odpovědný za kterou část. Jaké jsou nepsané konvence ('tohle nikdy neděláme v pátek'). Jakou politiku má tým k rollbackům. Na tohle pořád potřebujete mentora.

Výsledek: mentor teď řeší jen to zajímavé, ne navigaci po souborech. Nováček je méně závislý a víc samostatný. Oba jsou spokojenější.

Jak připravit projekt na AI onboarding

1. Přidejte CLAUDE.md do projektu

CLAUDE.md v rootu projektu je persistentní kontext pro AI agenty — ale taky skvělá dokumentace pro nové lidi. Stack, build příkazy, konvence, důležitá rozhodnutí. AI ho čte při každém spuštění, takže nováček dostane konzistentní informace.

2. Strukturujte README pro strojové čtení

Přidejte sekce: Quick Start (jak spustit), Architecture (hlavní moduly), Key Files (kam se podívat jako první), Contacts (kdo vlastní co). AI přečte README a nováček dostane personalizovaný průvodce projektem.

# README.md — struktura pro onboarding

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

## Architecture
- src/services/ — business logika
- src/api/ — REST endpointy
- src/models/ — Prisma schema a typy

## Key Files (zacnete tady)
- src/services/auth.ts — autentizace a JWT
- src/services/billing.ts — platby a subscriptions
- src/api/middleware.ts — request pipeline

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

3. Vytvořte onboarding checklist

Jednoduchý seznam úkolů pro první týden. AI pomáhá s každým bodem — nováček používá AI k pochopení kódu místo čekání na mentora.

• Den 1: Nastartovat projekt lokálně, projít README a CLAUDE.md s AI
• Den 2: Pochopit hlavní architekturu — zeptat se AI na data flow
• Den 3: Projít 3–5 posledních PR — pochopit týmové konvence
• Den 4: Opravit jednoduchý bug s pomocí AI — celý cyklus od pochopení po merge
• Den 5: Code review kolegy s pomocí AI — naučit se co tým očekává

Reálné výsledky

Týmy, se kterými pracuji, reportují 40–60% zkrácení onboarding času po zavedení AI-supported onboardingu. Nový člověk je produktivní za 5–7 dní místo 2–3 týdnů. Mentor tráví s nováčkem 2–3 hodiny místo 2–3 dnů.

Nejlepší onboarding je ten, kde si nováček může odpovědět na 80 % otázek sám. AI tohle umožňuje — a mentor se může soustředit na těch 20 %, které AI neumí.

Investice do přípravy projektu na AI onboarding (CLAUDE.md, strukturovaný README) se vrátí při každém novém členu týmu. A bonus: zlepšuje to práci i pro stávající členy týmu.