CLAUDE.md: 6 vrstev pro Claude Code bez ztrát

Systémová konfigurace CLAUDE.md: 6 vrstev pro spolehlivý kontext v Claude Code

Claude Code zahajuje každou relaci od nuly: bez znalostí o projektu, serverech či minulých řešeních. To vede k opakovaným vysvětlením a rizikům – od smazání produkčních dat až po push tajných klíčů do repozitáře. Systémový soubor CLAUDE.md s 582 řádky tento problém řeší pomocí 6 vrstev: od pravidel po automatizované háky. Každá vrstva vznikla na základě reálných incidentů.

Incidenty, které zrodily architekturu

Tři případy určily přístup:

• SNI-proxy přes localhost. Agent nahradil 127.0.0.1 reálnou IP, čímž pokazil upload. Důvod: chybělo pochopení, proč je hodnota právě taková.
• Blokování fail2banem. Vícenásobné SSH připojení během minuty bylo považováno za brute-force útok, což přerušilo trénink modelu.
• Ztráta datasetu. Příkaz „filtrovat“ vedl ke smazání souborů místo jejich přesunu.

Z toho plyne: pravidla vyžadují analýzu současných hodnot před změnami, jednotný SSH tunel a explicitní potvrzení mazání.

Struktura 6 vrstev

Vrstva 1: Pravidla (9 souborů)

Nahrávají se kontextově: pravidla pro SSH neruší úkoly s textem, ladění probíhá bez stylových omezení.

Vrstva 2: Paměť (78 souborů)

Graf znalostí s 178 křížovými odkazy [[filename]]. Základní prvky jsou vždy v kontextu, tematické se načítají na požádání. Uchovává infrastrukturu, řešení a chyby.

Vrstva 3: Předávané shrnutí (Handoffs)

Shrnutí relací: cíl, hotovo, selhání, další krok. Příklad:

## Cíl relace
Color checker: prohledání CNN + diffusion.

## Hotovo
- CNN baseline: medián 1,99 stupně (11M parametrů)
- Prohledání: crop128(3,17), bs16(2,04)
- Diffusion: epoch 5/50, ztráta 0,827

## Nefungovalo
- EfficientNet-B0: nesoulad hashů
- lr=3e-4: NaN bez clippingu

## Další krok
Inference pro diffusion + vizuální tabulky.

27 předávaných shrnutí za 4 dny eliminuje opakování slepých uliček. Funguje mezi předplatnými.

Vrstva 4: Kroniky

Chronologie rozhodnutí: 3–7 řádků na milník. Doplněk k předávaným shrnutím s historií cesty.

Vrstva 5: Háky (Hooks)

Automatizované Python skripty na události (SessionStart, Stop, PreToolUse). Nezávislé na paměti modelu.

Příklad háku pro předávané shrnutí:

# remind_handoff.py (Stop hook)
age = session_age_minutes()
if age < 15 or fresh_handoff_exists():
    return
print(json.dumps({
    "decision": "block",
    "reason": f"Relace {int(age)} min, předávané shrnutí nezapsáno."
}))

Vrstva 6: Dovednosti (16 sad)

Spouštěcí popisy: „použij při zamrzlém GPU“ místo obecných instrukcí.

Háky vs. pravidla: záruka provedení

Pravidla v promptu se v dlouhých relacích zapomínají. Háky běží mechanicky. Hák ověřuje odkazy v CLAUDE.md při startu a připomíná předávané shrnutí při konci.

Ochrana proti supply chain: konfigurace jedním řádkem

V .npmrc:

min-release-age=7

Blokuje balíčky mladší 7 dnů. Zachránilo před útokem na axios 1.14.1 (Sapphire Sleet, 31. března 2026, 3hodinové okno). Analog pro Python v uv.toml:

exclude-newer = "7 days"

Principy z 37 studií

Přepracované do pravidel:

• Proof Loop. Zakaz samoověřování: vyžadovat externí důkazy (testy z čerstvé relace).
• Strukturované uvažování. Formát: fakta → trasování → závěry → ověřené hypotézy. Přesnost patchy: 78 % → 93 %.
• Deterministická orchestrace. Deterministické úkoly (testy, linter) přes shell skripty.
• Červené čáry. Absolutní zákazy: „nesmazávat bez potvrzení“, vázané na incidenty.

Další: generator-evaluator, multi-agent decomposition, agent security.

Metriky a samoaktualizace

• 78 paměťových souborů, 178 odkazů.
• 27 předávaných shrnutí za 4 dny.
• 96,9 % úspěšnost KV-cache (83 relací).

Konfigurace se samoověřuje: Hák SessionStart kontroluje odkazy po změnách.

Klíčové body:

• Předávaná shrnutí a paměť zabraňují ztrátě kontextu mezi relacemi.
• Háky zaručují provedení kritických akcí.
• Obrana proti supply chain: min-release-age=7 v .npmrc / uv.toml.
• Strukturované uvažování zvyšuje přesnost ladění na 93 %.
• Červené čáry minimalizují rizika změn v produkci.

Minimální sada: Deterministická orchestrace + Strukturované uvažování + Obrana supply chain + Předávaná shrnutí.

Repozitář: github.com/AnastasiyaW/claude-code-config (MIT).

— Editorial Team