Napiš pravidla projektu (CLAUDE.md, AGENTS.md), kterými se agent řídí pokaždé
Claude Code čte CLAUDE.md, Codex AGENTS.md, Gemini CLI GEMINI.md. Soubor s pravidly projektu je nejlevnější způsob, jak agentovi jednou provždy říct, co má a nemá dělat. Tento prompt ho napíše s vámi.
Přesné znění promptu
Napíšeme soubor s pravidly projektu, který bude AI agent číst na začátku každé relace. Nejdřív si prohlédni projekt (strukturu složek, package soubory, existující dokumentaci) a pak mi navrhni obsah souboru [CLAUDE.md / AGENTS.md / GEMINI.md].
Soubor má mít tyto části, každou stručnou (agent ho čte při každém startu, každý řádek stojí tokeny):
1. CO JE TENTO PROJEKT: dvě věty. Účel, pro koho, v jakém stavu.
2. JAK SPUSTIT A OTESTOVAT: přesné příkazy pro instalaci, spuštění, testy, build. Nic navíc.
3. STRUKTURA: kde co leží, jen složky, které agent potřebuje znát.
4. PRAVIDLA, KTERÁ SE NESMÍ PORUŠIT: [např. „nikdy neměň schéma databáze bez migrace", „žádné tajné klíče v kódu", „nezasahuj do složky legacy/"]
5. STYL A KONVENCE: jazyk komentářů a commitů, formátování, pojmenování. Jen to, co se liší od výchozích zvyklostí.
6. PRACOVNÍ POSTUP: [např. „nejdřív plán, pak kód", „po každé změně spusť testy", „malé commity s popisem"]
7. CO NEDĚLAT BEZ ZEPTÁNÍ: [např. instalace nových závislostí, mazání souborů, změny v konfiguraci nasazení]
Pravidla formuluj jako příkazy, ne jako popis. Vynech všechno, co si agent dokáže zjistit sám z kódu. Na konci mi řekni, co jsi z projektu nevyčetl a co ti mám doplnit.
Proč tento prompt funguje
Bez souboru s pravidly agent každou relaci začíná od nuly a znovu hádá, jak projekt spustit a co je v něm zakázané. Soubor to řeší jednou. Nejčastější chyba je napsat ho příliš dlouhý: agent ho čte pokaždé, takže patří dovnitř jen to, co z kódu nevyčte. Proto prompt trvá na stručnosti a na formě příkazů. Sekce 4 a 7 jsou ty, které vás ochrání před drahými přehmaty. Soubor je dobré po pár týdnech revidovat: co agent porušuje opakovaně, patří výš a jasněji.