Kontextové soubory — CLAUDE.md, AGENTS.md, .cursorrules
Kontextové soubory
CLAUDE.md, AGENTS.md, .cursorrules — trvalá paměť pro AI
Problém amnézie sessions
Každá AI kódovací session začíná s čistým štítem. Váš AI agent si nepamatuje včerejší rozhodnutí, vaše kódovací standardy ani vaše technologické preference. Bez trvalého kontextu ztrácíte čas opětovným vysvětlováním stejných omezení v každé session.
Kontextové soubory tento problém řeší. Jsou to soubory s instrukcemi na úrovni projektu, které AI agenti čtou automaticky na začátku každé session, čímž zajišťují konzistentní chování napříč všemi interakcemi.
CLAUDE.md — Kontextový soubor Claude Code
Umístěte CLAUDE.md do kořenového adresáře projektu. Claude ho čte na začátku každé session.
# CLAUDE.md ## Přehled projektu E-commerce platforma postavená na Next.js 15, PostgreSQL a Stripe pro platby. ## Kódovací standardy - Použij TypeScript strict mode - Všechny API odpovědi ve standardním envelope formátu - Zpracování chyb přes vlastní třídu AppError ## Architektonická rozhodnutí - Server Components jako výchozí, Client Components pouze když je vyžadována interaktivita - Veškerý přístup k databázi přes repository pattern
Další formáty kontextových souborů
AGENTS.md
Používá Codex a podobní agenti. Stejný koncept jako CLAUDE.md, ale s formátováním instrukcí specifickým pro agenty. Může definovat více rolí agentů.
.cursorrules
Používá Cursor IDE. JSON nebo plain text formát. Načítá se automaticky pro každou Cursor AI interakci v projektu.
.github/copilot-instructions.md
Kontextový soubor GitHub Copilota. Markdown formát, čtený Copilotem ve VS Code a na GitHub.com.
CONVENTIONS.md
Nástroj-agnostický soubor konvencí. Funguje s jakýmkoli AI nástrojem přijímajícím kontext. Vhodný pro týmy používající více AI asistentů.
Co zahrnout do kontextových souborů
Přehled projektu
Tech stack, architektonický vzor, klíčové závislosti. Dejte AI celkový obraz, aby každý návrh zapadal do celku.
Kódovací standardy
Konvence pojmenování, struktura souborů, řazení importů, vzory zpracování chyb. Buďte konkrétní — 'použij camelCase', ne 'dodržuj best practices'.
Architektonická rozhodnutí
Proč jste zvolili konkrétní vzory. 'Repository pattern pro přístup k databázi' zabrání AI generovat raw SQL dotazy.
Požadavky na testování
Testovací framework, očekávání pokrytí, co testovat a co ne. Zabrání AI přeskakovat testy nebo používat špatný framework.
Pravidla NEDĚLEJ
Explicitní zákazy. 'Nikdy nepoužívej typ any v TypeScriptu' nebo 'Nepřidávej nové závislosti bez diskuse'. Toto jsou nejsilnější položky.
Konvence souborů
Kam co umístit. 'Komponenty v src/components/, API routes v src/app/api/'. Zabrání AI vytvářet soubory na špatných místech.
Best practices pro kontextové soubory
Klíčový poznatek
Kontextové soubory jsou mostem mezi sessions. Bez nich každá AI interakce začíná od nuly. S nimi se váš AI agent stává konzistentním členem týmu, který si pamatuje vaše standardy, vzory a preference.
Momentálně nejsou žádné komentáře.