Understand Anything

Vytvořeno: 27.8.2026 | Aktualizováno: 27.08.2026 22:24

Understand Anything je plugin pro Claude Code, který z projektu vytváří interaktivní znalostní graf souborů, funkcí, tříd a jejich závislostí. Hodí se hlavně pro rychlou orientaci v neznámém nebo větším repozitáři, návrat ke staršímu projektu a posouzení dopadu změn.

Nástroj kombinuje lokální statickou analýzu s LLM interpretací:

Tree-sitter deterministicky zjišťuje strukturální fakta: importy, exporty, definice funkcí a tříd, volání a dědičnost. Používá se také pro detekci změn při inkrementální aktualizaci.
LLM pracuje nad parsovanou strukturou a zdrojovým kódem. Doplňuje popisy uzlů, tagy, architektonické vrstvy, business domény a průvodce architekturou.

Výsledný graf se ukládá do .ua/knowledge-graph.json. Pokud projekt už používá starší adresář .understand-anything/, nástroj jej zachová jako datový adresář. Dashboard pak graf načte a umožní jej vizuálně procházet, vyhledávat a rozkliknout vztahy mezi uzly.

První běh stojí více, protože vytváří mapu celého zahrnutého projektu: Tree-sitter lokálně a bez spotřeby tokenů zjistí strukturu kódu a vztahy, zatímco LLM nad strukturou a zdrojovým kódem vytváří sémantické popisy, architektonické vrstvy, business domény a prohlídku projektu. Právě LLM část spotřebovává tokeny. Běžné další spuštění je inkrementální, ale stále může obnovovat architektonický pohled a prohlídku.

Doporučený pracovní postup:

Při převzetí projektu nebo na začátku větší práce spusť /understand. Vznikne výchozí mapa, nad kterou lze používat dashboard, vysvětlení i chat.
Při každodenních malých změnách analýzu nespouštěj. Pro drobné úpravy není potřeba po každém commitu obnovovat graf.
Před větší změnou spusť /understand-diff. Pomůže zjistit, které části systému mohou aktuální změny ovlivnit, ještě před commitem.
Po dokončení významné funkční nebo architektonické změny znovu spusť /understand, aby graf odpovídal nové podobě projektu.
Při návratu ke starému projektu otevři nejdřív /understand-dashboard a pro konkrétní otázky použij /understand-chat. Často není nutné hned znovu analyzovat celý projekt.

Analýzu podadresáře, například /understand src/frontend, použij, pokud řešíš samostatnou část monorepozitáře nebo chceš rychleji prozkoumat jen aktuálně upravovanou oblast. Parametr –exclude „tests/*,docs/*“ dává smysl pro adresáře, které pro dané rozhodnutí nepotřebuješ zahrnout. Výjimky lze držet také v .ua/.understandignore; po přidání nových výjimek je potřeba provést /understand –full, aby se graf vytvořil z nově vymezeného rozsahu.

/understand –auto-update automaticky inkrementálně aktualizuje graf po commitu. Vhodný je hlavně pro sdílený graf, který průběžně používá více lidí. Jednotlivec jej obvykle nemá zapínat po každém commitu: malé změny často nevyžadují nový sémantický pohled a automatická aktualizace by spouštěla LLM práci v okamžicích, kdy z ní není praktický přínos.

Dražší /understand –full má smysl, když je potřeba graf sestavit zcela znovu, například po změně vynechávaných cest nebo při ověření aktuálního stavu po větší změně. /understand –review použij pro úplnou LLM kontrolu grafu, když záleží na kvalitě a konzistenci sémantických závěrů; běžný běh provádí jen základní deterministickou validaci referenční integrity.

Nejdřív vytvoř mapu projektu a potom ji obnovuj jen ve významných okamžicích, ne jako povinný krok po každé malé změně.

V otevřené relaci Claude Code se nejprve přidá marketplace a nainstaluje plugin:

/plugin marketplace add Egonex-AI/Understand-Anything
/plugin install understand-anything

/plugin marketplace add Egonex-AI/Understand-Anything přidá repozitář projektu jako zdroj pluginů.
/plugin install understand-anything nainstaluje plugin.

Po instalaci je potřeba Claude Code restartovat, aby nové příkazy načetl.

/understand
/understand-dashboard

/understand analyzuje aktuální projekt a vytvoří nebo inkrementálně aktualizuje znalostní graf.
/understand-dashboard otevře interaktivní dashboard. Uzel lze vyhledat nebo otevřít a zobrazit jeho kód, vztahy a vysvětlení.

/understand-explain src/auth/login.ts
/understand-chat How does the payment flow work?
/understand-diff
/understand-onboard
/understand-domain

/understand-explain src/auth/login.ts provede detailní vysvětlení zadaného souboru nebo funkce.
/understand-chat How does the payment flow work? položí otázku nad již analyzovaným projektem. Text dotazu je možné napsat česky.
/understand-diff ukáže, které části systému ovlivňují aktuální změny před commitem.
/understand-onboard vytvoří onboardingový průvodce pro nové členy týmu.
/understand-domain extrahuje business domény, toky a procesní kroky.

/understand src/frontend
/understand --full
/understand --exclude "tests/*,docs/*"

/understand src/frontend omezuje analýzu na podadresář. Hodí se například pro část monorepozitáře.
/understand –full ignoruje existující graf a provede úplnou analýzu všech zahrnutých souborů.
/understand –exclude „tests/*,docs/*“ vynechá soubory nebo adresáře podle globových vzorů. Vzory lze také spravovat v .ua/.understandignore; nově přidané výjimky vyžadují úplný běh s –full.

/understand --auto-update
/understand --review

/understand –auto-update zapne automatickou inkrementální aktualizaci grafu po commitu. Má smysl hlavně tehdy, když graf udržuje a používá více lidí.
/understand –review spustí úplnou LLM kontrolu grafu. Běžný běh provádí jen základní deterministickou validaci referenční integrity; plná kontrola je dražší.

Strukturální vazby z Tree-sitteru jsou reprodukovatelné, ale sémantické závěry LLM jsou interpretace. Popisy účelu souborů, přiřazení vrstev nebo business toky je proto potřeba u důležitých rozhodnutí ověřit přímo v kódu.

LLM při analýze pracuje s původním zdrojovým kódem. Před použitím nad neveřejným repozitářem je potřeba ověřit, zda zvolený poskytovatel modelu smí tento kód zpracovávat. Projekt pro privacy nebo enterprise scénáře uvádí možnost použít lokálního poskytovatele modelu, například Ollama.