Build Mode
Kurz
Modul 11 · První skutečná aplikace

Když projekt roste

Co dělat, když aplikace přestane být přehledná a agent v ní začne bloudit.

11 minlekce 67/107

Po lekci umíš

  • Poznáš, kdy projekt přerostl svoji strukturu
  • Umíš agentovi pomoct se v projektu vyznat
  • Víš, kdy má smysl přeuspořádat a kdy ne
Obsah lekce (5)

Zpočátku je všechno snadné. Projekt má deset souborů, agent v něm má přehled a každá změna trefí napoprvé.

Po pár týdnech se to zhorší. Ne kvůli agentovi – kvůli tomu, že projekt vyrostl.

Poznávací znamení

  1. Agent hledá dlouho

    Než něco změní, prochází spoustu souborů. Struktura mu nepomáhá.

  2. Změny na špatných místech

    Upraví podobnou komponentu místo té správné. Znamená, že v projektu je víc podobných věcí.

  3. Stejná věc na víc místech

    Formátování data na pěti místech, každé trochu jinak.

  4. Bojíš se sáhnout na určitou část

    Nejjasnější signál. Vždycky to něco rozbije.

Co pomáhá nejvíc

Pomáhá málo

  • Dělit soubory na menší jen kvůli velikosti.
  • Přidávat vrstvy „pro budoucnost“.
  • Přejmenovávat všechno najednou.

Pomáhá hodně

  • Jasná pravidla v CLAUDE.md, kam co patří.
  • Jedno místo pro každou opakující se věc.
  • Předvídatelné názvy souborů a složek.

Úklid, který se vyplatí

Prompt pro Claude Code

Kde se projekt opakuje

Když se aplikace začne zdát nepřehledná.

Projdi tenhle projekt a najdi místa, kde se stejná věc řeší víckrát.

Zajímá mě:
1. Kód, který se opakuje skoro doslova.
2. Stejná logika napsaná pokaždé trochu jinak (formátování dat, textů, cen).
3. Komponenty, které dělají skoro totéž.
4. Soubory, které se už nepoužívají.

U každého nálezu napiš, jak často se to opakuje a jestli má smysl to
sjednotit, nebo je to jen náhodná podobnost.

Nic zatím neměň.

Poslední věta v bodě 4 je záměrná. Ne každá podobnost je duplicita – dvě věci, které vypadají stejně a mění se nezávisle, mají zůstat oddělené.

Mapa projektu

Nejlevnější věc, kterou pro přehlednost uděláš: nech si projekt popsat a popis ulož.

Prompt pro Claude Code

Popiš mi strukturu projektu

Po větším přírůstku nebo po pauze.

Popiš mi strukturu tohohle projektu tak, aby to pochopil někdo,
kdo ho vidí poprvé.

1. Které složky k čemu jsou.
2. Kde leží věci, které se často mění.
3. Kde je logika, kterou by člověk hledal jinde, než ve skutečnosti je.
4. Co je v projektu nekonzistentní.

Výsledek ulož do souboru STRUKTURA.md a přidej na něj odkaz z CLAUDE.md.

Bod 3 je nejužitečnější. Každý projekt má místo, kde něco leží jinde, než by člověk čekal. Napsat to je levnější než to přesouvat.

Kdy přeuspořádat a kdy ne

  1. Přeuspořádej, když tě to brzdí

    Konkrétně: hledáš věci, agent trefuje špatná místa, bojíš se sáhnout na část projektu.

  2. Nepřeuspořádávej, když je to jen esteticky nepříjemné

    Projekt nemusí být hezký. Musí se v něm dát pracovat.

  3. Nikdy neuklízej a nestav zároveň

    Jedna změna, jeden účel. Úklid smíchaný s novou funkcí se nedá zkontrolovat.

Pro zvídavé

Když projekt naroste tak, že se do jednoho sezení nevejde, přestane pomáhat i dobrá struktura. Tehdy se vyplatí pracovat po částech: nechat agenta soustředit se na jednu oblast a dát mu k ní potřebný kontext, místo aby procházel všechno.

Nástroje, které to usnadňují – vlastní postupy, pomocní agenti a paralelní práce – jsou v modulu o agentech.

Cvičení20 minut

Spusť ve svém projektu prompt na opakování a prompt na strukturu.

Z nálezů si vyber jednu věc, která tě nejvíc brzdí, a tu sjednoť. Ostatní nech být.

Commitni zvlášť, s popiskem, že šlo o úklid.

Co si odnést

  • Projekt přerostl strukturu, když agent hledá dlouho a trefuje špatná místa.
  • Nejvíc pomáhá předvídatelnost: jasná pravidla, jedno místo pro jednu věc.
  • Sjednocuj to, co se mění společně, ne to, co vypadá podobně.
  • Úklid dělej samostatně, na větvi, a nikdy zároveň s novou funkcí.

Máš to za sebou?

Označ lekci jako hotovou, ať víš, kde jsi skončil. Nic se tím neuzamkne.

Obsah aktualizován: 21. srpna 2026