Wayfinding Routing

Wayfinding-Routing (Selbstorientierungs- und Notfall-Fallback-Engine)

Der Skill Wayfinding-Routing, auch bekannt als survival-routing, dead-reckoning, pathfinder-routing und celestial-routing, dient LLM-Agenten als verbindlicher Rahmen für Navigation und Notfallwiederherstellung.

Er stattet Agenten mit proaktiven Wayfinding-Heuristiken für die normale Ausführung und mit Notfallprotokollen für Kontextdrift, wiederkehrende Ausführungsfehler, ausfallende APIs oder Sackgassen aus.

Übersicht der Synonyme und Strategien

Die fünf zentralen Notfall- und Orientierungsprotokolle

1. PROTOCOL-ANCHOR-RESET (Nordstern-Fallback / Celestial Routing)

• Auslöser: Kontextdrift, widersprüchliche Nutzeranweisungen oder Orientierungsverlust in langen Sitzungen mit vielen Turns.
• Heuristische Regel: Freie Texterzeugung anhalten. Flüchtige Annahmen verwerfen. Root-Ankerdokumente (CLAUDE.md, AGENTS.md, START.md) erneut lesen. Den Zielzustand vor weiteren Aktionen auf die maßgebliche Root-Anweisung zurücksetzen.

2. PROTOCOL-STOP-EXPLAIN (Rubber-Duck-Reflexionsschleife)

• Auslöser: Ein Terminalbefehl, eine Dateiänderung oder eine API-Anfrage schlägt zweimal mit demselben Fehler fehl.
• Heuristische Regel: Befehlsausführung sperren. Vor dem dritten Versuch muss der Agent eine formale Selbstreflexion ausgeben:
  1. Welcher genaue Fehler trat in Versuch 1 und 2 auf?
  2. Warum scheiterte die vorherige Diagnosehypothese?
  3. Welcher neue alternative Ansatz wird gewählt? Die Ausführung wird erst nach dieser ausdrücklichen Begründung entsperrt.

3. PROTOCOL-GRACEFUL-DEGRADATION (mehrstufige Fallback-Kaskade)

• Auslöser: Primäres Werkzeug, MCP-Server oder externe API ist nicht verfügbar oder liefert Fehler.
• Heuristische Regel: Niemals abrupt scheitern oder blind schleifen. Stufenweise degradieren:
  • Stufe 1 (optimal): vollständige native API oder MCP-Werkzeug
  • Stufe 2 (Ersatzwerkzeug): lokale Python-CLI oder Skript
  • Stufe 3 (Nur-Lese-Zustand): direkte Dateiauswertung (view_file oder Rohtext)
  • Stufe 4 (Übergabe): strukturierten Statusbericht und offene Optionen für den Nutzer darstellen.

4. PROTOCOL-BREADCRUMB-BACKTRACK (Dead Reckoning und Sackgassenerkennung)

• Auslöser: Ein komplexer mehrstufiger Refactoring- oder Workflow-Pfad stößt in Schritt N auf eine unauflösbare Blockade.
• Heuristische Regel: Vor zerstörerischen Änderungen Brotkrumen aufzeichnen. Scheitert ein Pfad:
  1. Nicht eingecheckte Änderungen zurücknehmen und Zustand wiederherstellen.
  2. Zum letzten sauberen Brotkrumen-Checkpoint zurückspringen.
  3. Die fehlgeschlagene Route in TODO.md als blockiert markieren.
  4. Alternativen Pfad B versuchen.

5. PROTOCOL-CIRCUIT-BREAKER (Notaus und sicherer Ausstieg)

• Auslöser: Ausführungslimit erreicht, Endlosschleife erkannt oder kritischer Systemsperrfehler.
• Heuristische Regel: Notabschaltung ausführen:
  1. Alle selbst erworbenen Datei- und Git-Sperren freigeben (python -m workflowhooker check).
  2. Aktuellen Teilzustand in .SYNC/SURVIVAL_STATE.json oder AUTOMATIONS-MEMORY.md speichern.
  3. Vorfall in ANTIGRAVITY-LOG.txt protokollieren.
  4. Mit einer umsetzbaren Zusammenfassung für Nutzer oder Orchestrator sauber beenden.

Integration mit automation-self-care und workflowhooker

wayfinding-routing liefert die zugrunde liegende Navigationslogik für:

• automation-self-care: Prüft Sidecar-Prompts anhand der fünf Protokolle auf Selbstheilungsfähigkeit.
• workflowhooker: Liefert Standardheuristiken für schrittweise Sperrprüfung und Brotkrumenprotokollierung.
• staircase-routing: Nutzt PROTOCOL-ANCHOR-RESET für vertikale Verzeichnisnavigation.