Anatomie Claude Code projektu

Shraddha Bharuka popsala strukturu repozitáře, která umožňuje, aby Claude Code fungoval jako zkušený inženýr přímo v projektu — ne jako chatbot. Základem je 5 komponent, které dávají Claudovi nepřetržitý přístup ke čtyřem typům informací: proč systém existuje, kde se věci nacházejí, jaká jsou pravidla a jak se práce dělá.

CLAUDE.md je řídící soubor celého projektu — ne knowledge dump, ale stručný přehled tří věcí:

• Proč — účel systému
• Co — mapa repozitáře
• Jak — pravidla a příkazy

Pokud je soubor příliš dlouhý, model začne přehlížet důležitý kontext. Doporučení: udržovat ho stručný.

Místo opakovaného přepisování instrukcí se běžné workflows převedou do skills uložených v '.claude/skills/':

• checklist pro code review
• playbook pro refaktoring
• postup pro release
• průvodce debuggingem

Výsledek: konzistentní chování napříč sezeními i v rámci týmu.

Modely zapomínají, hooks ne. Hooks zajišťují deterministické chování:

• spuštění formátovače po každé editaci
• spuštění testů při změnách klíčových částí
• blokování nebezpečných adresářů (auth/, billing/, migrations/)

Dokumentace nepatří do promptů. Claude potřebuje pouze vědět, kde pravda žije:

• přehled architektury
• ADR (záznamy o architektonických rozhodnutích)
• provozní runbooky

Tím se zachová čistý kontext a model si sám načte správný zdroj, když ho potřebuje.

Malé CLAUDE.md soubory umístěné přímo u „ostrých hran„ kódu:

• src/auth/CLAUDE.md
• src/persistence/CLAUDE.md
• infra/CLAUDE.md

Claude vidí upozornění a pravidla přesně tehdy, když v daném místě pracuje.

Prompting is temporary. Structure is permanent. When your repo is organized this way, Claude stops behaving like a chatbot… and starts acting like a project-native engineer.

• Shraddha Bharuka – The Anatomy of a Claude Code Project (X/Twitter)