Připravte projekt pro AI

AI agent je jen tak dobrý, jak dobře si o projektu může přečíst. Pár textových souborů — a složka, kterou popíšete jedním dechem — promění každé další sezení z „nejdřív musím zjistit, co to vlastně je“ na „už to znám, jdeme stavět“. Žádné programování není potřeba.

↳ Myšlenka za tím prakticky v Academy: AI-native řemeslo — sedm osvědčených zásad.

Hlavní myšlenka v jedné větě

Nepíšete pro počítač. Necháváte vzkaz tomu, kdo projekt otevře příště — a tím je dnes často AI agent. Projekt, který se umí sám představit, je projekt, kterým agent prochází rychle a málokdy v něm něco rozbije. Jako dobře udržovaná dílna: nářadí tam, kde ho čekáte, a na zdi lísteček s tím, co je rozdělané.

Soubory, které odvedou práci

Všechno jsou to soubory .md — Markdown, jen text s lehkým formátováním (# Nadpis, - odrážka). Otevřete a upravíte je v libovolném textovém editoru. Největší díl práce zvládnou čtyři z nich:

Soubor	Co to je
`README.md`	Vstupní dveře. Co projekt je, pro koho je a jak ho spustit. První, co si člověk i agent přečte.
`CLAUDE.md`	Mozek projektu — stálý brief pro agenta. Co má vždycky vědět, než se čehokoli dotkne.
`changelog.md`	Krátký průběžný záznam o tom, co se kdy změnilo. Paměť projektu.
`wishlist.md`	Co byste chtěli dál, řečeno obyčejně. Nápady, které agent vezme, když řeknete „udělej další věc“.

README.md — vstupní dveře

Ať je krátké. Kdokoli (nebo kterýkoli agent), kdo sem přijde bez kontextu, by měl projektu rozumět do minuty. Osvědčená podoba:

# Název projektu

Jedna věta o tom, co to je a pro koho.

## Co je tady
- web/   — veřejný web
- scripts/ — malé pomocné nástroje

## Jak to spustit
brew install ...
npm run dev

## Kde to žije
Pushuje se na GitHub; Cloudflare při každém pushi web znovu sestaví.

Proč na tom záleží: README odpovídá na otázky, které by jinak agent musel jen hádat — a hádání je přesně to místo, kde se věci tiše pokazí.

CLAUDE.md — mozek projektu

Tohle je stálý brief, který si agent přečte jako první, každé sezení. Není to návod — jsou to domácí pravidla. Věci, které platí teď a jejichž opětovné objevování by bylo drahé: kde co je, čeho se nikdy nedotýkat, jak máte rádi prováděné změny.

# CLAUDE.md — co vědět, než se dotkneš tohoto projektu

## Co to je
Statický prezentační web + pár automatizačních skriptů.

## Základní pravidla
- Zdroj pravdy je git. Push na GitHub to nasadí — takže pushuj uvážlivě.
- Nikdy nedávej do gitu hesla, API klíče ani osobní data. Používej zástupné hodnoty.
- Raději uprav existující soubor, než abys zakládal nový.

## Struktura
- web/ je web. scripts/ jsou nástroje. Nemíchej je.

## Když si nejsi jistý
Než uděláš něco nevratného (mazání, přejmenování, force-push), zeptej se.

Proč na tom záleží: agent mezi sezeními ztrácí paměť. CLAUDE.md je způsob, jak si váš projekt zapamatuje — rozdíl mezi agentem, který respektuje vaše nastavení, a tím, který se ho učí po zlém.

changelog.md + wishlist.md — paměť a směr

Dva drobné soubory, které vydají za mnohem víc, než vypadají. Changelog je minulost: datovaný řádek pro každou smysluplnou změnu, nejnovější nahoře. Wishlist je budoucnost: volný seznam toho, co byste chtěli, bez okolků.

# changelog.md
## 2026-06-27
- Přidán kontaktní formulář na úvodní stránku.
- Opraven nefunkční odkaz v patičce.

## 2026-06-20
- Spuštěna první verze.

# wishlist.md
- Sekce s blogem.
- Přepínač tmavého režimu.
- Přihlášení k newsletteru.

Proč na tom záleží: spolu vám umožní říct „co jsme minulý týden změnili?“ nebo „udělej další věc z wishlistu“ a agent přesně ví, co tím myslíte. Používejte data v UTC (2026-06-27), aby se záznam četl stejně, ať je kdokoli kdekoli.

Složka, kterou popíšete jedním dechem

Nepotřebujete chytrou strukturu — potřebujete zřejmou. Seskupujte podle toho, co věci jsou:

muj-projekt/
  README.md        # vstupní dveře
  CLAUDE.md        # mozek
  changelog.md     # co se změnilo
  wishlist.md      # co bude dál
  web/             # web
  scripts/         # malé pomocné nástroje
  n8n/             # automatizační workflow (pokud jsou)

Složka	Obsahuje
`web/`	Web — stránky, styly, obrázky.
`scripts/`	Malé samostatné nástroje — zálohovací skript, úklid dat.
`n8n/`	Automatizační workflow, držené stranou od webu.

Praktické pravidlo: pokud dokážete ukázat na složku a třemi slovy říct, co v ní je, dokáže to i agent.

Proč je díky tomu každé sezení rychlejší a bezpečnější

Rychlejší — agent si přečte README a CLAUDE.md a rovnou pracuje, místo aby prvních deset minut znovu poznával projekt.
Bezpečnější — základní pravidla („nikdy nedávej do gitu hesla“, „před mazáním se zeptej“) jsou jednou zapsaná a ctěná pokaždé, ne ponechaná náhodě.
Vaše — jsou to obyčejné soubory ve vašem git repu. Žádný dodavatel, žádné uzamčení. Cestují s projektem a přežijí jakýkoli jednotlivý nástroj. To je cesta tvůrce: mějte svou dílnu vlastní.

Uveďte to do praxe — Academy: AI-native řemeslo → · Zdroj pravdy pro to všechno: Git & GitHub