# 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 čtyř 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/standards/rules.md – obecná pravidla práce: komunikace s uživatelem, organizace souborů a obsahu, rozhodování a rozsah, práce se změnami
- @~/.claude/standards/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/standards/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á `~/.claude/standards/rules.md`, *Kam co zapsat*. Zadání, návrh a produktové podklady drží `~/.claude/standards/product.md`, kam vede odkaz ze `structure.md`
- `~/.claude/standards/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ží `~/.claude/standards/rules.md`, *Životní cyklus projektu*
- `~/.claude/standards/evidence.md` – zjišťování z dat: vidlička před měřením, stupně vyloučení, ověření, že ptaná věc v datech je, shoda měření s tvrzením, ověření tvrzení z webu skriptem. **Odkaz, ne import** – načti si ho, než měříš, dotazuješ se do dat, hledáš příčinu chyby nebo zapisuješ tvrzení z webu; spouštěč drží `~/.claude/standards/rules.md`
- `~/.claude/standards/delegation.md` – delegace na agenty: jak je zadat, co mají vracet, model a effort podle úkolu. **Odkaz, ne import** – načti si ho, než pustíš agenta; zákaz mechanické práce v hlavní session drží `~/.claude/standards/rules.md`
- `~/.claude/standards/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/standards/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 `/end` 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 (už `web.md` a `admin.md` patří k největším souborům a `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.

- `~/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í; v doméně je navíc `~/Context/web/metadata.md` – strukturovaná data a náhled pro sdílení (`og:image`), načti si ho, když je zakládáš, měníš nebo kontroluješ, a `~/Context/web/server.md` – co se ověří až na nasazeném webu (konfigurace serveru, SEO infrastruktura, nasazení, GDPR), kdy si ho načíst, říká `web.md`, *B. Na serveru*
- `~/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 `~/Context/web/web.md`
- `~/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 `~/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 `~/Context/web/web.md`
- `~/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/`
- `~/Context/text/text.md` – redakční pravidla 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
- `~/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 `~/Context/web/web.md`, který řeší stránku jako celek, kdežto tenhle soubor to, co je na ní napsané
- `~/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
- `~/Context/design/design.md` – obecná pravidla 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 `~/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ží `~/Context/brand/brand.md`
- `~/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
- `~/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 `~/Context/speaking/`; tahle doména říká, jak se to dělá
- `~/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
- `~/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
- `~/Context/legal/legal.md` – práce s právními a úředními zdroji (co je primární zdroj a co jen reprodukce, čím se doslovné znění předpisu nedohledá a čím ano, jak se hledá v novelizovaném předpisu, co se k tvrzení povinně zapisuje) – načti si ho vždy, když se o právní úpravu opírá rozhodnutí: lhůta, náležitost dokladu, povinnost vůči spotřebiteli, místo plnění, retenční doba. **Není to právní poradna** a odborný výklad nenese; ten patří do projektu, kterého se týká
- `~/Context/astronomy/astronomy.md` – astronomie (astrofotografie, astrometrie, vizuální pozorování, technické vybavení) – načti si ji vždy, když řešíš astronomické pozorování, snímání nebo měření či vybíráš a seřizuješ vybavení. Je to know-how oboru; Honzova astronomická činnost jako fakt o něm leží v korpusu (`brand/`, `speaking/`, `organizations/`)
- `~/Context/coding/coding.md` – pravidla psaní kódu (naming, git, bezpečnost, TypeScript, SQL, shell, frontend) – načti si ho vždy, když píšeš či upravuješ kód; v doméně je navíc `~/Context/coding/modeling.md` – návrh modelu (postup návrhu, modelování stavu, rozhraní a guardy, návrh API, automatika a vnější systémy, konfigurace), načti si ho, když navrhuješ nebo měníš datový model, stavy, přechody nebo API, a `~/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`
- `~/Context/coding/quality.md` – ověřování a kontroly kvality (kontrakt příkazů, průběžná kontrola, vrstvy kontroly a umístění testů, prahy kontrol, závislosti, stupňování autonomie, bezpečnostní audit) – **platí pro každý projekt, i bez kódu**: leží v `coding/`, ale kontrakt příkazů a vrstvy kontroly má i dokumentační projekt. Načti si ho, když zakládáš nebo přenastavuješ projekt, pouštíš revizi či nasazení, nebo rozhoduješ, jestli je práce hotová

Pozor na zařazení `brand/`: sám o sobě je to **korpus** (fakt o tom, kdo Honza je), ne metodika – v `~/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. **Profil organizace si projekt načítá sám** ve svém `CLAUDE.md` – klient ze své složky pod `~/Projekty`, kde mu profil leží, a v `organizations/` po něm zbývá jen odkaz. Rozcestník je v `~/Context/CLAUDE.md`.

- **Znalostní báze psaní:** `~/Context/compose/`, archiv textů `~/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.
- **Co kde na disku leží:** `~/Projekty/<Client>/` – všechno pro jednoho klienta nebo spolupráci, u které je co držet (kritérium `~/.claude/skills/project/client.md`, *Rozpoznání*); `~/Dev/` – vlastní produkty, nástroje a osobní projekty; `~/Context` – znalost, `~/Depot` – podklady; `~/Documents` a `~/Downloads` jsou mimo Claude. Důvody a zamítnuté varianty drží `~/.claude/docs/decisions.md`, *Struktura disku: klienti ve vlastní složce, vlastní věci v `~/Dev`*.
- **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 `~/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 `~/Context/`.