CommunitySchreiben & Editierengithub.com

ultraindex

Indiziere ein gesamtes Repository (Code + Docs) in eine navigierbare, KI-analysierte Enzyklopädie – mit Karte, Modul-Einträgen und einem Link-Graphen – damit eine KI auch in riesigen Codebasen arbeitet, ohne ihren Kontext zu füllen. Ein Skill mit automatischer Routenauswahl, fundierter, zitationsgeprüfter Analyse und optionaler lokaler (Ollama) semantischer Suche.

Was ist ultraindex?

Ultraindex ist ein KI-Agenten-Skill (für Claude Code, Cursor, Codex etc.), der das Problem des begrenzten Kontextfensters bei großen Codebasen löst, indem er eine durchsuchbare, KI-analysierte Enzyklopädie des gesamten Repos erstellt. Der Skill teilt die Arbeit auf: Eine deterministische Engine (Node.js-Skript, kein npm install nötig) scannt das Projekt, baut einen Link-Graphen aus Importen und Symbolen und generiert die Enzyklopädie-Struktur. Der Entwickler oder ein Sub-Agent reichert dann Module mit fundierten, zitierten Analysen an. Der Skill unterstützt mehrere Plattformen (z. B. Claude Code, Cursor, Codex) und bietet eine autopilot-ähnliche Routenauswahl: Je nach Situation (kein Index vorhanden, Index veraltet, Frage des Benutzers, Sicherheitsüberprüfung, semantische Suche) wird das passende Skript und der passende Workflow ausgeführt. Die Analyse ist zitationsbasiert – Behauptungen müssen durch echte Code-Zeilen belegt sein, und ein Check-Befehl stellt sicher, dass alle Zitate auflösbar sind. Für höchste Sicherheit gibt es einen Verify-Workflow, der jede Behauptung gegen die tatsächliche Quelle prüft. Optional kann eine lokale semantische Suche (Ollama/Embeddings) hinzugefügt werden. Wesentlich ist, dass nie die gesamte Enzyklopädie auf einmal geladen wird – nur einzelne Einträge oder Dossiers –, um das Kontextfenster zu schonen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add maxgfr/ultraindex

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

ultraindex – Erstelle und navigiere eine KI-analysierte Enzyklopädie eines gesamten Repos

Bei einem riesigen Repo ist der Kontext gefüllt, bevor man findet, was zählt. ultraindex behebt das mit einer Aufgabenteilung: Die deterministische, zero-dependency Engine (node scripts/ultraindex.mjs <command> – kein npm install, keine API-Schlüssel, --help für die vollständige Oberfläche) erledigt die mechanische Arbeit – das Projekt scannen, den Link-Graphen bauen, die Enzyklopädie anlegen; du erledigst das Verstehen – fundierte, zitierte Analyse – und navigierst später das Ergebnis, statt das Repo zu lesen.

Die Kernregeln:

  1. Die Engine besitzt die Code-Ansicht und den Graphen (ui:gen-Bereiche) – bei jedem Build neu generiert; niemals von Hand bearbeiten.
  2. Du besitzt die Fachansicht (ui:human-Bereiche). build erhält deine Prosa über Neubuilds und Umbenennungen hinweg.
  3. Analysiere auf Basis von Belegen, nicht aus dem Gedächtnis. Schreibe Analyse nur aus dem echten Quellcode, den dossier dir zeigt, zitiere ihn [datei:zeile], und check schlägt fehl bei jedem Zitat, das nicht aufgelöst werden kann – also rate nicht.
  4. Lade das Minimum. Lies einen Eintrag (oder ein dossier) auf einmal – das ist das beabsichtigte Muster und genau das, was ein per-Modul-Anreicherungs-Subagent tut. Lade niemals graph.json oder das gesamte encyclopedia/-Verzeichnis in den Kontext – das widerspricht dem Zweck.

Die meisten Befehle akzeptieren --json – bevorzuge ihn immer dann, wenn du auf das Ergebnis verzweigst, anstatt es als Text zu lesen.

Routenauswahl nach Situation

Ermittle, in welcher Situation du dich befindest, in dieser Reihenfolge, und lies die passende Referenz für den detaillierten Workflow:

  1. Noch kein Index – kein .ultraindex/ oder docs/ultraindex/ im Repo-Root (suche nach graph.json darin). Erstelle ihn, dann reichere die Top-Module an: lies references/generate.md.

  2. Index existiert – zuerst Frische prüfen. node scripts/ultraindex.mjs check --out <index-verz> --json. Wenn er veraltet oder defekt ist, führe build erneut aus (deine Prosa bleibt erhalten), dann fahre fort. Wenn nur für die Aufgabe irrelevante Dateien geändert wurden, kannst du fortfahren und es vermerken.

  3. Der Benutzer hat eine Aufgabe oder Frage („wo ist X“, „wie funktioniert Z“, „welche Dateien muss ich ändern“) – navigiere durch den Index, öffne nur die Dateien, auf die er verweist, begründe Antworten mit verifizierten Zitaten: lies references/navigate.md.

  4. Die Antwort muss hohe Sicherheit bieten (Audit, Sicherheit, eine korrektheitskritische Behauptung), oder der Benutzer bittet dich, eine Antwort zu überprüfen/beurteilen – nachdem check --answer bestanden hat (Zitate sind auflösbar), eskalieren zur semantischen Verify-Stufe, damit jedes zitierte Excerpt nachweist, dass es die Behauptung stützt, nicht nur existiert: lies references/verify.md.

  5. Der Benutzer hat gebeten, zu indizieren/analysieren/dokumentieren, oder status --json zeigt nicht angereicherte Hubs an und du hast Budget – führe die statusgesteuerte Anreicherungsschleife aus (dossier → zitierte Analyse schreiben → prüfen). Bei einem großen Repo parallelisieren: ein Subagent pro Modul aus der Warteschlange, falls dein Host Subagents unterstützt – lies references/generate.md.

  6. find findet immer noch nichts, oder der Benutzer wünscht semantische/bessere Suche – richte die optionale Embedding-Ebene ein (docker compose, embed, hybride find): lies references/semantic.md.

Ein typischer erster Besuch verkettet 1 → 5 → 3; ein Wiederholungsbesuch ist normalerweise 2 → 3; eine Antwort mit hoher Sicherheit fügt → 4 hinzu.

Befehlsübersicht

  • build --repo <verz> [--out .ultraindex] [--include/--exclude <glob>] [--max-bytes <n>] [--max-files <n>] [--no-cache] [--no-mermaid] – Scanne und (neu) schreibe den Index. Idempotent; erhält angereicherte Prosa. Inkrementell (verwendet Extraktion unveränderter Dateien wieder); warnt, wenn --max-files abschneidet. --out docs/ultraindex für einen committed, PR-prüfbaren Index.
  • map [--module <slug>] [--json] – Zeige INDEX.md (oder einen Eintrag, oder die Modultabelle).
  • find "<abfrage>" [--k <n>] – Bewerte Module, zeige die exakten zu öffnenden Dateien an. Standardmäßig lexikalisch (mit IDF-Termgewichtung); hybrid (+ semantisch), wenn vectors.json existiert.
  • neighbors <datei|modul> [--depth <n>] – Was verlinkt zu / von ihm.
  • symbols "<name>" [--json] – Wo ein Symbol definiert ist (Datei:Zeile, Art, zugehöriges Modul) und welche Dateien darauf verweisen. Unscharfsuche nach Identifikator-Tokens.
  • impact <datei|modul> [--depth <n>] [--json] – Die reverse Abhängigkeitshülle: alles, was das Ziel importiert oder verwendet. „Was passiert, wenn ich das ändere.“
  • status – Die Arbeitswarteschlange der Anreicherung, in der exakten Reihenfolge zum Anreichern.
  • dossier <slug> – Ein Informationspaket eines Moduls (echter Quellcode + Nachbarn; ein reines Dokumentations-/Konfigurationsmodul, z. B. root, zeigt keinen Code – reichere es an, indem du stattdessen seine README/Konfiguration zitierst).
  • ask "<frage>" – Stelle fundierte Belege zusammen, um zu antworten.
  • check [--answer <datei>] [--semantic] – Veralterung + Integrität + Fundierung (Zitate müssen auflösbar sein). Exit-Code ungleich Null ⇒ veraltet, defekt oder unbegründet. --semantic bezieht auch die Verify-Stufe ein (schlägt fehl für eine Behauptung, deren zitiertes Excerpt sie widerlegt, oder die vollständig beurteilt ist, ohne Stützung); es reduziert das Urteil aus den rohen verdicts[] und liest jedes beurteilte Excerpt erneut aus dem Live-Repo – eine manipulierte Zusammenfassung oder abweichende Quelle schlägt fehl, nie bestanden.
  • verify --answer <datei> [--apply <verdicts.json>] [--max-verify <n>] – Die Hochsicherheits-Stufe über check --answer hinaus: Erstelle eine Behauptung↔Zitat-Arbeitsliste zur adversarischen Stützungsprüfung, dann --apply reduziert deine Urteile zu einem Bestehen/Nichtbestehen-Gatter. Siehe references/verify.md.
  • embed [--force] – Baue/aktualisiere vectors.json für die semantische find (benötigt einen Anbieter – siehe references/semantic.md).

Umfangshinweise

  • Keine Schlüssel, kein Netzwerk, deterministisch (die optionale semantische Schicht ist die eine Ausnahme, und sie fällt auf lexikalische Suche zurück, wenn ihr Anbieter fehlt). Zwei Builds eines unveränderten Repos sind byte-identisch, außer manifest.json's builtAt-Provenienz-Zeitstempel; vectors.json ist ebenfalls ausgenommen (seine Floats hängen vom Anbieter ab).
  • AST-genaue Symbole via committed Tree-Sitter-Grammatiken für JS/TS/TSX, Python, Go, Rust, Java, C, C++, C#, Ruby, PHP – echte Verschachtelung, präzise Arten, strukturelle Exports. Andere Sprachen fallen auf Regex-Extraktoren zurück (dennoch durchsuchbar). Die Grammatik-WASMs werden im Bundle mitgeliefert, daher gibt es auch kein npm install zur Nutzungszeit des Skills (die Installation ist schwerer – ~17 MiB WASM).
  • Import-Kanten für JS/TS (tsconfig paths, package exports-Maps), Python, Go (Multi-Modul + replace), Rust (mod/use), Java (Packages), C/C++ (#include "..."), Ruby (require_relative/require), PHP (Composer PSR-4 + relatives require), C# (using → namespace). Plus konservative Code→Code-use-Kanten, wenn eine Datei ein eindeutiges exportiertes Symbol einer anderen Datei referenziert, ohne sie zu importieren. Übrige Sprachen erhalten keine Import-Kanten. Yarn PnP's virtuelles Dateisystem ist nicht im Scope (Workspace-Namen werden dennoch aufgelöst).
  • Hängende Kanten bedeuten normalerweise, dass das Repo selbst defekte Imports oder veraltete Dokumentationslinks hat – das ist ein zu meldender Befund, nicht zu überdecken.

Verwandte Skills