Was macht loadpath – Codebase-Strukturanalyse?
Eine Agentenfertigkeit, die analysiert, wie eine Codebasis ihr Gewicht trägt: Platzierung, Abhängigkeitsrichtung, strukturelle Abweichung und eingefrorene Grenzen.
Übersicht
Diese Fertigkeit untersucht die Abhängigkeitsstruktur einer Codebasis und liefert Metriken zu:
- Platzierung: Wie gut sind Module innerhalb der Verzeichnisstruktur positioniert?
- Abhängigkeitsrichtung: Fließen Abhängigkeiten gemäß der gewünschten Architektur (z. B. von niedrigen zu hohen Ebenen)?
- Strukturelle Abweichung: Wie stark weicht die tatsächliche Struktur von einer idealen (entkoppelten) Struktur ab?
- Eingefrorene Grenzen: Welche Module oder Schnittstellen sollten als unveränderlich betrachtet werden (z. B. nach Außen gerichtete APIs)?
Verwendung
Rufen Sie die Fertigkeit wie folgt auf:
# Analysieren des aktuellen Verzeichnisses
loadpath
# Analysieren eines bestimmten Pfades
loadpath --path ./src
# Ausgabe als JSON für Weiterverarbeitung
loadpath --format json
Plattformen
Diese Fertigkeit kann mit allen gängigen KI-Agenten verwendet werden, die benutzerdefinierte Fertigkeiten unterstützen:
- Claude Code
- Cursor
- Codex
- Andere agentenbasierte Entwicklungswerkzeuge
Konfiguration
Keine spezielle Konfiguration erforderlich. Die Fertigkeit erkennt automatisch:
- Das verwendete Versionskontrollsystem (Git)
- Die Programmiersprache(n) im Repository
- Die Verzeichnisstruktur
Ausgabe
Die Ausgabe erfolgt als strukturierter Bericht:
{
"placementScore": 0.87,
"dependencyDirection": "unten -> oben",
"structuralDrift": 12.3,
"frozenBoundaries": ["src/api/", "src/lib/public/"]
}
Beispiele
# Analysieren der src/-Ordnerstruktur
loadpath --path ./src
Dies zeigt an, wie gut die Module in src/ zueinander passen und ob Abhängigkeiten in die richtige Richtung fließen.
Einschränkungen
- Die Analyse basiert auf statischer Codeanalyse – dynamische Aufrufe (Reflection, Injection) werden nicht erkannt.
- Sehr große Codebasen können längere Analysezeiten erfordern.
- Sprachen mit stark dynamischen Eigenschaften (z. B. Python ohne Typannotationen) liefern weniger präzise Ergebnisse.
Lizenz
Diese Fertigkeit wird unter der MIT-Lizenz bereitgestellt.