npm run validate:claude-tooling — Integrita Claude toolingu

Kontroluje, že všechno, na co CLAUDE.md, pravidla v .claude/rules/ a jednotlivé schopnosti odkazují, v repozitáři skutečně existuje: cesty v backticích, markdownové odkazy, npm příkazy a odkazy na jiné skilly. Navíc vyžaduje, aby každý skill řekl, kdy se NEMÁ použít, a aby se jméno schopnosti neopakovalo napříč vrstvami. Zkrácený odkaz („macros/ui.html") se dohledává jako koncovka skutečné cesty, aby brána nenutila psát prózu plnými cestami; zástupné symboly (, clm-NN) a gitové reference se přeskakují.

Kdy ho spustit

Po každé změně CLAUDE.md, .claude/rules/, .claude/skills/, .claude/agents/** nebo .claude/workflows/** — a po přejmenování či zrušení jakéhokoli skriptu, na který se z těch textů odkazuje.

Co shodí běh

• CT1 — pravidlo v .claude/rules/ má parsovatelný frontmatter a neprázdné položky v paths
• CT2 — cesta uvedená v backticích v CLAUDE.md, pravidle nebo schopnosti existuje
• CT3 — markdownový odkaz vede na existující soubor
• CT4 — zmíněný npm run <x> je v package.json
• CT5 — odkaz na skill vede na existující .claude/skills/<jméno>/SKILL.md
• CT6 — skill uvádí, kdy se NEMÁ použít
• CT7 — jméno se neopakuje mezi skillem, agentem a workflow
• CT8 — workflow deklaruje jen existující skilly a agenty, personu ze závazného slovníku a cíl
• CT9 — zapisující skill, který mění sdílený stav nebo se dotýká rozsahu pokrytí, má disable-model-invocation

Co je potřeba vědět

• Kontroluje odkazy, ne pravdivost vět. Jestli je pravidlo obsahově správné, ze stromu odvodit nejde — na to je review, a brána to nesmí předstírat.
• Doplňuje katalog toolingu, nenahrazuje ho: katalog hlídá, že každá schopnost má záznam, tenhle validátor hlídá, že cíle odkazů existují.
• Soubory, které jsou záměrně gitignorované a lokální (.prismatic-local.toml, CLAUDE.local.md, .claude/settings.local.json), jsou vyjmenované jako výjimka. Odvozovat výjimku z .gitignore by znamenalo, že cokoli ignorovaného přestane být hlídané.
• Součást npm run build i pre-commit hooku. V režimu dev neběží — je to rychlá iterační smyčka a brána tam nic nepřidá.
• CT9 nevyžaduje zámek u schopností, které jen čtou. Kontrola rozsahu se má dít často a sama; brána, která by ji zamykala, by byla překážkou správného chování.

Popis vychází z hlavičkového komentáře zdrojového souboru. Volání, zařazení do pipeline i členství v pre-commit hooku se dopočítávají při každém buildu ze samotného repozitáře.