claude

# Globální konfigurace Claude Code

## Závazná pravidla

Následující soubory obsahují **závazná pravidla** – platí stejně jako pravidla psaná přímo v tomhle souboru.

**Načítají se dvojím způsobem.** Co je uvedené `@`, se rozbalí do každé session automaticky a platí bez výjimky. Zbytek je **odkaz**: nenačte se sám a u každého je napsáno, kdo a kdy ho má načíst – u dvou z nich ty, u `WORKTREE.md` rozcestník v kořeni kontejneru. Je to táž vědomá volba jako u doménových znalostí níž: odkaz se dodržuje hůř než import, ale těch pár desítek kilobajtů by jinak stálo kontext v každé session, i tam, kde se jich nic netýká.

- @~/.claude/RULES.md – obecná pravidla práce: komunikace s uživatelem, organizace souborů a obsahu, rozhodování a rozsah, práce se změnami
- @~/.claude/PTYDEPE.md – tabulka termínů, na kterých jsme se výslovně dohodli: co se místo čeho používá a v jakém rozsahu. Úvahy, zamítnuté varianty a historii náhrad drží `~/.claude/skills/ptydepe/terms.md`, který se schválně neimportuje – za běhu stačí tabulka
- `~/.claude/STRUCTURE.md` – standardní struktura projektu, co patří do kterého souboru a povinnost průběžně je aktualizovat. **Odkaz, ne import** – je to katalog k nahlédnutí, ne pravidlo pro každou odpověď; načti si ho, než do některého z těch souborů zapíšeš. Kam který zápis míří, říká `RULES.md`, *Kam co zapsat*
- `~/.claude/skills/LIFECYCLE.md` – rozhraní kroků životního cyklu: co který dělá, co po něm platí, proč stojí v tom pořadí. **Odkaz, ne import** – načti si ho, jakmile v některém kroku stojíš; rámeček s pořadím drží `RULES.md`, *Životní cyklus projektu*
- `~/.claude/WORKTREE.md` – worktree layout projektu: kontejner s `.bare`, jeden pracovní adresář na větev, zakládání větve a layoutové odchylky jejího dokončení (postup samotný drží `/merge`). **Odkaz, ne import** – platí jen v projektu s tímhle uspořádáním, kde si ho natáhne rozcestník v kořeni kontejneru; zapíná a ruší ho `/worktree`
- `~/.claude/BYPASS.md` a `~/.claude/skills/SESSION.md` – **ani odkaz, ani import, a je to rozhodnutí.** První je registr toho, čím se dají obejít kontroly v repozitáři s konfigurací; druhý mechanika čtení nahrané session. Ani jedno není pravidlo pro práci: registr se čte, když se o nějaké kontrole rozhoduje, a `SESSION.md` si načte `/cleanup` nebo `/skill` ve chvíli, kdy transcript opravdu otevírá. Jmenovat je tady by z nich udělalo povinnou četbu pro každou session, aniž by to čemukoliv pomohlo.

Když identifikuješ obecné pravidlo platné napříč projekty, u kterého nevadí, že bude veřejně vidět na GitHubu, navrhni jeho extrakci do `~/.claude/`.

## Doménové znalosti

Aplikují se podmíněně – jen když pracuju v dané doméně. Nejsou to pravidla pro každý úkol, ale soubory znalostí pro konkrétní typy práce.

**Proč odkaz a ne `@import`:** projektový `CLAUDE.md` doménu importuje natvrdo, protože tam platí vždy. Tady je to naopak – naráz platí jedna doména, ne všechny, a `@import` celého seznamu by stál kontext v každé session (samotné `web.md` a `admin.md` mají skoro 500 řádků, `analytics/` je celá knowledge base). Odkaz se dodržuje hůř než import, ale je to vědomá volba: cenu za nespolehlivost platím jen tady, ne v projektech.

- `~/Dev/context/web/web.md` – checklist pro každé webové rozhraní (použitelnost, přístupnost, typografie, formuláře, výkon, GDPR, …) – načti si ho vždy, když pracuješ na webovém rozhraní
- `~/Dev/context/web/admin.md` – checklist pro administrační a backoffice rozhraní (struktura, seznamy a tabulky, akce a potvrzování, editace, oprávnění, auditní stopa) – načti si ho vždy, když děláš administraci nebo interní nástroj; platí navíc k `~/Dev/context/web/web.md`
- `~/Dev/context/analytics/` – knowledge base pro implementační webovou analytiku (principy, revize měření a katalog nálezů, měřicí architektura, datová vrstva, GTM konvence, consent, features, systémy, consent lišty, platformy, šablony pro vývojáře) – načti si `~/Dev/context/analytics/analytics.md` vždy, když reviduješ, nasazuješ nebo konfiguruješ webové měření, a z něj se prokliknij dál; platí navíc k `~/Dev/context/web/web.md`
- `~/Dev/context/advertising/advertising.md` – knowledge base pro výkonnostní reklamu (principy vedení kampaní, bidding a konverzní akce, získávání poptávky bez okamžitého nákupu, katalog nálezů, posouzení cizího účtu, spolupráce s týmem, jednotlivé reklamní systémy) – načti si ji vždy, když vedeš, optimalizuješ nebo posuzuješ placené kampaně; drží **řízení kampaní**, kdežto jak se konverze naměří a pošle do systému, drží `analytics/`
- `~/Dev/context/text/text.md` – redakční standard pro psaní textů (stavba textu, obsah, zakázané obraty, stylistika, gramatika, text odkazu, sjednocené psaní slov) – načti si ho vždy, když píšeš nebo edituješ souvislý text v češtině: článek, newsletter, dokumentaci, obsah webu
- `~/Dev/context/text/copy.md` – texty v rozhraní (tón, popisky akcí, čísla a údaje, chybové hlášky a odmítnutí, texty u částek a dokladů) – načti si ho vždy, když píšeš cokoliv, co uvidí uživatel v rozhraní: popisek tlačítka, stav, hlášku, potvrzovací dialog. Platí navíc k `~/Dev/context/web/web.md`, který řeší stránku jako celek, kdežto tenhle soubor to, co je na ní napsané
- `~/Dev/context/text/typography.md` – česká typografie (interpunkce a znaky, mezery, čísla, jednotky, datum a čas, výčty, ustálené zápisy jmen) – načti si ji vždy, když sázíš český text – tedy spolu s `text.md`, ale i tam, kde souvislý text nevzniká: slajd, popisek grafu, mikrocopy, dokumentaci
- `~/Dev/context/design/design.md` – obecné standardy vizuální tvorby (kontrast a čitelnost, barva a barvoslepost, hierarchie a prázdné místo) – načti si ho vždy, když navrhuješ cokoliv vizuálního; v doméně je navíc `~/Dev/context/design/slides.md` – prezentace a slajdy (kolik informace na slajd, nadpis jako tvrzení, tempo, čitelnost v sále, animace, provoz), načti si ho vždy, když děláš nebo reviduješ promítanou prezentaci: školení, přednášku, pitch, prezentaci výsledků. Je to znalost, ne Honzův vizuál – ten drží `~/Dev/context/brand/brand.md`
- `~/Dev/context/brand/brand.md` – osobní brand a pozicování Jana Tichého (zastřešení, čím se odlišuje, cílové skupiny, vztah k samostatné značce kurzu AI) – načti si ho vždy, když píšeš cokoliv, co Honzu prezentuje navenek: web, prodejní stránku, inzerát, medailonek, bio, nabídku. Je to zdroj pravdy; projekty z něj vychází a drží jen svůj překlad do kanálu
- `~/Dev/context/training/training.md` – jak se staví a vede školení: formáty, didaktický postoj, stavba obsahu, práce se skupinou, udržování obsahu – načti si ho vždy, když připravuješ nebo upravuješ školení, kurz nebo workshop. Co kdy proběhlo, drží evidence ve `~/Dev/context/speaking/`; tahle doména říká, jak se to dělá
- `~/Dev/context/business/business.md` – obchodní stránka práce: dnes fakturace (sazby, daňový režim, dohody s klienty, deník výjimek k obdobím, stopy práce pro dohledání nenatrackovaného času) – načti si ji vždy, když vystavuješ faktury, řešíš, za co a kolik se účtuje, nebo dohledáváš čas, který se zapomněl natrackovat; řídí ji skill `/invoicing`, který sám žádná čísla neobsahuje
- `~/Dev/context/depot/depot.md` – kam se ukládají příchozí podklady a co se s nimi pak dělá. Stojí na dvou nezávislých osách: **co dokument je** (jak se pozná, kam jde, co se s ním spustí) a **odkud přišel** (co zbude ve zdroji, jak se drží čára toho, co už se zpracovalo). K tomu cíle a pořadí rozhodování mezi nimi a obsah vyňatý ze směrování – načti si ji vždy, když zařazuješ stažený nebo přijatý soubor; řídí ji skill `/depot`, který sám žádné pravidlo nenese
- `~/Dev/context/coding/coding.md` – standardy návrhu a psaní kódu (návrh a modelování stavu, rozhraní a guardy, návrh API, automatika a vnější systémy, naming, git, bezpečnost, TypeScript, SQL, frontend) – načti si ho vždy, když navrhuješ datový model nebo píšeš či upravuješ kód; v doméně je navíc `~/Dev/context/coding/quality.md` – ověřování a kontroly kvality (kontrakt příkazů, průběžná kontrola, prahy kontrol, závislosti, stupňování autonomie, bezpečnostní audit), načti si ho, když zakládáš nebo přenastavuješ projekt, pouštíš revizi či nasazení, nebo rozhoduješ, jestli je práce hotová, a `~/Dev/context/coding/architecture.md` – architektura aplikace (vrstvy a směr závislostí, jediná cesta k datům, hranice transakce kolem cizího systému, souběh, běhy na pozadí) a **kontrolní seznam minima hotové aplikace**, načti si ho, když zakládáš projekt, navrhuješ jeho stavbu nebo reviduješ architekturu; říká si i sám, kdy platí – rozlišuje *aplikaci* od *nástroje*. Při běžném psaní kódu stačí `coding.md`

Pozor na zařazení `brand/`: sám o sobě je to **korpus** (fakt o tom, kdo Honza je), ne standard – v `~/Dev/context/CLAUDE.md` je vedený tak. V seznamu výš je proto, že se na rozdíl od zbytku korpusu načítá **podmíněně jako doménová znalost**, protože platí pro každý text mířící ven.

Zbytek korpusu se nenačítá paušálně: `archive/` (všechny Honzovy texty), `compose/` (jeho hlas, spouští se skillem `/compose`), `speaking/` (školení, přednášky, konzultační i školicí klienti, ohlasy) a `organizations/` (profily organizací, se kterými Honza pracuje – kdo tam sedí, kdo co schvaluje, na čem jedou). Sáhni po nich, když potřebuješ doklad nebo data, ne pravidlo. **U `organizations/` platí, že projekt pro konkrétní organizaci si její profil načítá sám** ve svém `CLAUDE.md`. Rozcestník je v `~/Dev/context/CLAUDE.md`.

- **Znalostní báze psaní:** `~/Dev/context/compose/`, archiv textů `~/Dev/context/archive/`. Čte je skill `/compose` – tenhle řádek je jediné místo, kde ty cesty stojí, takže se po přesunu opravují tady, ne ve skillu.
- **Sklad podkladů:** `~/Depot/` – nahrávky, prezentace, cizí dokumenty a vlastní poznámky, ze kterých se staví znalost. Leží v něm to, co nemá vlastní domov u klienta ani v projektu, a **nemaže se odtud ani nepřejmenovává**, protože na jednotlivé adresáře odkazují evidence `sources.md` v `~/Dev/context/`. Pravidla drží `~/Depot/CLAUDE.md` a načtou se samy, protože nad materiálem se pracuje přímo tam – typicky `/learn` nebo `/transcript`.

Když identifikuješ znovupoužitelnou doménovou znalost, která se může hodit ve více projektech, ale měla by zůstat soukromá, protože je citlivá nebo patří do osobního know-how, navrhni její extrakci do `~/Dev/context/`.