# Staircase Routing

> Eigenständige Navigations- und Routing-Strategie, die Verzeichnishierarchien nach oben und unten nach Wegweiser-Dokumenten wie CLAUDE.md, AGENTS.md, README.md und RULES.md sowie nach nutzerkonfigurierbaren Stichwörtern durchsucht. Die Konfiguration erfolgt über staircase-config.json oder config.json. Auch als Up-and-Down Routing oder Walking Bass Routing bekannt.

- Skill: `ellmos-ai/staircase-routing` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add ellmos-ai/staircase-routing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ellmos-ai/staircase-routing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ellmos-ai (https://skillmd.com/u/ellmos-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ellmos-ai/staircase-routing

---


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

# Staircase-Routing (Up-and-Down / Walking Bass Routing)

Der Skill **Staircase-Routing**, auch *Up-and-Down Routing* oder *Walking Bass
Routing* genannt, kapselt die Strategie zur Prüfung von
Verzeichnisdokumenten für KI-Agenten.

Wenn ein Agent ein Verzeichnis betritt oder an einer Datei arbeitet, nutzt er
diese Strategie, um maßgeblichen Kontext, Regeln und Wegweiser-Dokumente zu
finden, bevor er Code ändert oder eine Aktion ausführt.

---

## 1. Standards für Wegweiser-Dokumente

Staircase-Routing sucht standardmäßig nach diesen Wegweiser-Dokumenten:

- **Globale und projektbezogene Steuerung:** `CLAUDE.md`, `AGENTS.md`,
  `START.md`, `RULES.md`
- **Projektübersicht und Aufgaben:** `README.md`, `TODO.md`, `NOTIZ.md`,
  `BEWEISNOTIZ.md`
- **Benutzerdefinierte Stichwörter:** Konfiguriert über
  `staircase-config.json` oder `config.json`.

---

## 2. Traversal-Algorithmus

```text
                           [ Root- / Workspace-Ebene ]
                           ┌────────────────────────┐
                           │   CLAUDE.md / RULES.md │ ◄── (Schritt 2: Root-Wegweiser lesen)
                           └───────────▲────────────┘
                                       │ (Treppe aufwärts)
                           ┌───────────┴────────────┐
                           │ Unterordner / Ziel     │ ◄── (Schritt 1: Im CWD beginnen)
                           └───────────┬────────────┘
                                       │ (Treppe abwärts)
                           ┌───────────▼────────────┐
                           │ Kind- / Modulordner    │ ◄── (Schritt 3: Untergeordnete Wegweiser finden)
                           │   module-rules.md      │
                           └────────────────────────┘
```

### Schritt 1: Aktuelles Arbeitsverzeichnis (CWD) prüfen

- Prüfe das Verzeichnis der Zieldatei oder das aktive Arbeitsverzeichnis.
- Sind Wegweiser-Dokumente vorhanden, lies sie sofort.

### Schritt 2: Nach oben traversieren

- Wird im CWD **kein** Wegweiser-Dokument gefunden, gehe in das
  Elternverzeichnis (`..`).
- Wiederhole dies schrittweise nach oben, bis ein Root-Wegweiser-Dokument
  (`CLAUDE.md` oder `AGENTS.md`) oder die Workspace-Grenze erreicht ist.
- Lies alle gefundenen Root-Wegweiser, um globale Vorgaben und Projektregeln
  festzustellen.

### Schritt 3: Nach unten prüfen

- Gehe vom festgestellten Root-Verzeichnis nach unten in die für die Aufgabe
  relevanten Unterverzeichnisse.
- Finde spezialisierte Wegweiser auf Modulebene, Domänenregeln oder
  Komponentenkonfigurationen und lies sie.

---

## 3. Nutzerkonfigurierbare Stichwörter (`staircase-config.json`)

Agenten können eine lokale oder globale `staircase-config.json` lesen, um die
gesuchten Wegweiser anzupassen:

```json
{
  "signpost_filenames": [
    "CLAUDE.md",
    "AGENTS.md",
    "START.md",
    "RULES.md",
    "README.md",
    "TODO.md"
  ],
  "custom_buzzwords": [
    "SECURITY",
    "POLICY",
    "GOVERNANCE",
    "PIPELINE"
  ],
  "max_upward_depth": 10,
  "exclude_directories": [
    "node_modules",
    ".git",
    "__pycache__",
    "dist",
    "build",
    "archive"
  ]
}
```

---

## 4. Integration mit `letter-hooker` und geplanten Aufgaben

`staircase-routing` ist als zentraler Preflight-Bootloader in den Skill
**`letter-hooker`** und die geplante Aufgabe
**`antigravity-kontext-and-workflow-loader-and-divider`** eingebettet. Dadurch
finden und befolgen Agenten Wegweiser-Dokumente, bevor sie Änderungen beginnen.