<img src="banner.png" width="100%" alt="wayfinding-routing banner">

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

Synonyme Strategie	Metapher und Kernprinzip	Anwendungsfall
wayfinding-routing (primär)	Wayfinding / räumliche Orientierung: Navigation ohne externes GPS durch Wegweiser und Umgebungshinweise.	Primärer Navigationsregelkreis für Sidecars, workflowhooker und automation-self-care.
survival-routing	Notfall-Fallback und Selbsterhalt: Circuit-Breaking und kontrollierte Degradation, wenn Werkzeuge ausfallen oder Schleifen entstehen.	Notfallwiederherstellung bei Timeouts, wiederholten Fehlern oder Berechtigungsgrenzen.
dead-reckoning	Nautische Koppelnavigation: Exakten Zustand aus schrittweisen Brotkrumen ohne externe Statusquelle rekonstruieren.	Ausführungsschritte in Scratch-Dateien oder TODO.md verfolgen, um präzise zurückzugehen.
pathfinder-routing	Pfadfinder und Vorauskommando: Wege für Multi-Agenten-Teams vorab prüfen und vorbereiten.	Preflight-Prüfung von Verzeichnisbäumen, Sperren und Aufgabenabhängigkeiten.
celestial-routing	Astronavigation: An unveränderlichen Nordstern-Ankerdokumenten ausrichten, wenn lokaler Kontext verrauscht ist.	Rückfall auf CLAUDE.md, AGENTS.md und START.md, wenn Prompt-Anweisungen widersprüchlich sind.
Strategie likelihood-routing (eigener Skill, falls installiert)	Wahrscheinlichkeits-Gradient als Wärmer/Kälter-Sensor: Steuerdateien über die bedingte Folgewahrscheinlichkeit (Likelihood Scoring) eines Zielbegriffs bewerten und dem Gradienten ($\Delta S$) folgen.	Fallback ohne Memory-Dienst, wenn ein projektspezifischer Fachbegriff in keiner Session-Historie auftaucht.

---

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.
• Strategie likelihood-routing (eigener Skill, falls installiert): Liefert den Wahrscheinlichkeits-Gradienten als Wärmer/Kälter-Sensor für PROTOCOL-ANCHOR-RESET, wenn Steuerdateien mehrdeutig auf mehrere plausible Äste verweisen — komplementär zu staircase-routing, das nach Stichwort-Treffer statt nach Gradient sucht.

Changelog

1.1.0 (2026-09-27)

• Strategie likelihood-routing in Übersichtstabelle und Integrationsabschnitt erwähnt (ohne Link -- der Skill ist private-only und noch nicht Teil dieses öffentlichen Repos; die Sichtbarkeitsfrage liegt beim Nutzer).