codemap

Was macht codemap?

Führen Sie das gebündelte Skript aus. Es liest den Arbeitsbaum bei jedem Aufruf frisch ein und gibt eine kompakte, sortierte Karte aus; es schreibt nie etwas.

${CLAUDE_SKILL_DIR}/scripts/codemap --ext php,blade.php --dir app
${CLAUDE_SKILL_DIR}/scripts/codemap --ext css,scss --symbols
${CLAUDE_SKILL_DIR}/scripts/codemap --ext ts,tsx --dir src --symbols --max 150

Optionen: --ext (durch Komma getrennt, keine Punkte nötig), --dir, --symbols, --max (Ausgabezeilen-Limit, Standard 300), --exclude REGEX (wiederholbar).

Die Ausgabe sieht so aus:

# codemap: 12 Dateien in 3 Verzeichnissen (dir: app, ext: php, via rg)
Http/Controllers/
  UserController.php: class UserController, fn index, fn store

Wann es verwendet werden sollte

• Sie benötigen alle Dateien eines oder mehrerer Typen und wissen nicht, wo sie sich befinden.
• Sie sind dabei, mehrere Dateien zu lesen, nur um herauszufinden, was sie definieren: führen Sie es zuerst mit --symbols aus und lesen Sie nur die Dateien, die relevant sind.
• Ein Unteragent beginnt in einem unbekannten Bereich: Übergeben Sie ihm die Codemap dieses Verzeichnisses, anstatt ihn von Grund auf suchen zu lassen.

Wann es nicht verwendet werden sollte

• Sie kennen den Dateinamen oder ein genaues Muster: Verwenden Sie Glob.
• Sie benötigen Text innerhalb von Dateien: Verwenden Sie Grep.
• Sie benötigen Definitionen oder Referenzen eines Symbols und ein LSP-Plugin ist aktiviert: Verwenden Sie das LSP-Tool.

Fallstricke

• .gitignore wird beachtet, wenn ripgrep oder git verfügbar ist; vendor/, node_modules/, Build-Ausgabe, minifizierte Dateien und Source Maps werden immer übersprungen.
• Symbole stammen aus zeilenbasierten Mustern, nicht aus einem Parser: PHP-Klassen/Funktionen auf oberster Ebene, JS/TS-exports, Python-class/def auf oberster Ebene, Go-type/func, CSS-Custom-Properties (als Zählung) und SCSS/Less-Mixins. Behandeln Sie sie als Inhaltsverzeichnis und lesen Sie dann die Datei.
• Wenn die Ausgabe mit # ... truncated endet, schränken Sie mit --dir, --ext oder --exclude ein, anstatt --max weit zu erhöhen.