Dostupné

Session lifecycle

Práce, kterou z velké části dělají agenti, končí tam, kde končí kontext. Session-context soubor je jediné místo, ze kterého se dá pokračovat, aniž by se všechno odvozovalo znovu.

Otevření

python scripts/session_start.py <slug>

Uzavření

python scripts/session_close.py <slug> po indexu, reportu a bráně kvality

Soubor

.claude/session-context/RRRR-MM-DD-HHMMSS-<slug>.md

Kontrola

scripts/validate_session_context.py — název, lineage, povinné sekce, žádná tajemství

Autocommit

výhradně explicitní; žádný hook nikdy nic nezacommituje

Návaznost se ověřuje, nedoporučuje

Každý soubor jmenuje předchozí session, na kterou navazuje, nebo výslovně říká, že žádná není. Validátor kontroluje tvar názvu, existenci předchůdce a přítomnost povinných sekcí: mise, rozsah, non-goals, změněné soubory, validace s výsledky, rizika, další kroky.

Řetěz session je tím pádem procházitelný. Otázka „proč je tenhle adresář takhle pojmenovaný“ má dohledatelnou odpověď v session, která to rozhodla.

Pravidlo, kvůli kterému to má smysl

Zapisují se selhání. Session, která pustila bránu a ta spadla, to napíše. Soubor, který hlásí jen úspěchy, je deník, ne záznam — a další agent mu uvěří přesně jednou.

Historické session-context soubory se navíc nepřepisují. Opravit se smí odkaz, který se skutečně přesunul; tvrzení ne. Záznam o tom, co se tehdy vědělo, je součástí jeho hodnoty.

Statický report

Uzavření vygeneruje statický HTML report do static/reports/: přehled session, dokumentační graf a vyhledávací index. Běží bez serveru a bez CDN, na lokálně vendorovaných knihovnách ověřených hashem.

Kde to v repozitáři žije

• docs/development/SESSION_LIFECYCLE.md — postup otevření, průběhu a uzavření session
• .claude/session-context/README.md — pravidla adresáře a tvar souboru
• scripts/session_start.py — založení souboru, navázání na předchůdce, start hooky
• scripts/session_report.py — generátor statického DX reportu

Souvisí

Zpět na sekci Roadmapa