/landing-report – Versions-Warteschlangen-Dashboard
Präambel (immer zuerst ausführen)
_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true
mkdir -p ~/.gstack/sessions
touch ~/.gstack/sessions/"$PPID"
_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
echo "BRANCH: $_BRANCH"
_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
echo "PROACTIVE: $_PROACTIVE"
echo "PROACTIVE_PROMPTED: $_PROACTIVE_PROMPTED"
echo "SKILL_PREFIX: $_SKILL_PREFIX"
source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
echo "TELEMETRY: ${_TEL:-off}"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
_EXPLAIN_LEVEL=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "default")
if [ "$_EXPLAIN_LEVEL" != "default" ] && [ "$_EXPLAIN_LEVEL" != "terse" ]; then _EXPLAIN_LEVEL="default"; fi
echo "EXPLAIN_LEVEL: $_EXPLAIN_LEVEL"
_QUESTION_TUNING=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
echo "QUESTION_TUNING: $_QUESTION_TUNING"
mkdir -p ~/.gstack/analytics
if [ "$_TEL" != "off" ]; then
echo '{"skill":"landing-report","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "unknown")'"}' >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
fi
for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
if [ -f "$_PF" ]; then
if [ "$_TEL" != "off" ] && [ -x "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
fi
rm -f "$_PF" 2>/dev/null || true
fi
break
done
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
_LEARN_FILE="${GSTACK_HOME:-$HOME/.gstack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
_LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
echo "LEARNINGS: $_LEARN_COUNT Einträge geladen"
if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
fi
else
echo "LEARNINGS: 0"
fi
~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"landing-report","event":"started","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
_HAS_ROUTING="no"
if [ -f CLAUDE.md ] && grep -q "## Skill routing" CLAUDE.md 2>/dev/null; then
_HAS_ROUTING="yes"
fi
_ROUTING_DECLINED=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
echo "HAS_ROUTING: $_HAS_ROUTING"
echo "ROUTING_DECLINED: $_ROUTING_DECLINED"
_VENDORED="no"
if [ -d ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
_VENDORED="yes"
fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true
Plan-Modus – Sichere Operationen
Im Plan-Modus erlaubt, da sie den Plan informieren: $B, $D, codex exec/codex review, Schreibzugriffe auf ~/.gstack/, Schreibzugriffe auf die Plan-Datei und open für generierte Artefakte.
Skill-Aufruf während des Plan-Modus
Wenn der Benutzer ein Skill im Plan-Modus aufruft, hat das Skill Vorrang vor dem generischen Verhalten des Plan-Modus. Behandle die Skill-Datei als ausführbare Anweisungen, nicht als Referenz. Folge ihr Schritt für Schritt ab Schritt 0; die erste AskUserQuestion ist der Workflow, der in den Plan-Modus eintritt, kein Verstoß dagegen. AskUserQuestion erfüllt die Anforderung des Plan-Modus am Ende des Zugs. Halte an einem STOP-Punkt sofort an. Setze den Workflow nicht fort und rufe ExitPlanMode dort nicht auf. Befehle, die mit „PLAN MODE EXCEPTION — ALWAYS RUN" gekennzeichnet sind, werden ausgeführt. Rufe ExitPlanMode erst auf, wenn der Skill-Workflow abgeschlossen ist, oder wenn der Benutzer dir sagt, dass du das Skill abbrechen oder den Plan-Modus verlassen sollst.
Wenn PROACTIVE auf "false" gesetzt ist, Skills nicht automatisch aufrufen oder proaktiv vorschlagen. Wenn ein Skill nützlich erscheint, frage: „Ich glaube, /skillname könnte hier helfen – soll ich es ausführen?"
Wenn SKILL_PREFIX auf "true" gesetzt ist, schlage /gstack-*-Namen vor/rufe sie auf. Die Pfade auf der Festplatte bleiben ~/.claude/skills/gstack/[skill-name]/SKILL.md.
Wenn die Ausgabe UPGRADE_AVAILABLE <alt> <neu> anzeigt: Lies ~/.claude/skills/gstack/gstack-upgrade/SKILL.md und folge dem „Inline-Upgrade-Workflow" (automatisches Upgrade, wenn konfiguriert, sonst AskUserQuestion mit 4 Optionen, schreibe Snooze-Zustand, wenn abgelehnt).
Wenn die Ausgabe JUST_UPGRADED <von> <nach> anzeigt: Gib „gstack v{to} wird ausgeführt (gerade aktualisiert!)" aus. Wenn SPAWNED_SESSION true ist, überspringe die Feature-Erkennung.
Feature-Erkennung, maximal eine Eingabeaufforderung pro Sitzung:
- Fehlende
~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion für Continuous-Checkpoint-Auto-Commits. Wenn angenommen, führe~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuousaus. Berühre immer den Marker. - Fehlende
~/.claude/skills/gstack/.feature-prompted-model-overlay: Informiere „Modell-Overlays sind aktiv. MODEL_OVERLAY zeigt den Patch an." Berühre immer den Marker.
Nach Upgrade-Eingabeaufforderungen den Workflow fortsetzen.
Wenn WRITING_STYLE_PENDING yes ist: Frage einmal nach dem Schreibstil:
v1-Eingabeaufforderungen sind einfacher: Fachjargon-Glossare für erstmalige Verwendung, ergebnisorientierte Fragen, kürzere Prosa. Standard beibehalten oder knapp wiederherstellen?
Optionen:
- A) Den neuen Standard beibehalten (empfohlen – gutes Schreiben hilft allen)
- B) V0-Prosa wiederherstellen – setze
explain_level: terse
Wenn A: explain_level nicht setzen (standardmäßig auf default).
Wenn B: Führe ~/.claude/skills/gstack/bin/gstack-config set explain_level terse aus.
Immer ausführen (unabhängig von der Wahl):
rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted
Überspringen, wenn WRITING_STYLE_PENDING no ist.
Wenn LAKE_INTRO no ist: Sage „gstack folgt dem Boil the Lake-Prinzip – mache die vollständige Sache, wenn KI die Grenzkosten nahe Null macht. Erfahre mehr: https://garryslist.org/posts/boil-the-ocean". Biete an, zu öffnen:
open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen
Führe open nur aus, wenn ja. Führe immer touch aus.
Wenn TEL_PROMPTED no UND LAKE_INTRO yes ist: Frage einmal nach Telemetrie via AskUserQuestion:
Hilf gstack, besser zu werden. Teile nur Nutzungsdaten: Skill, Dauer, Abstürze, stabile Geräte-ID. Kein Code, keine Dateipfade, keine Repo-Namen.
Optionen:
- A) Hilf gstack, besser zu werden! (empfohlen)
- B) Nein danke
Wenn A: Führe ~/.claude/skills/gstack/bin/gstack-config set telemetry community aus.
Wenn B: Frage nach:
Der anonyme Modus sendet nur aggregierte Daten, keine eindeutige ID.
Optionen:
- A) Klar, anonym ist in Ordnung
- B) Nein danke, vollständig deaktiviert
Wenn B→A: Führe ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous aus.
Wenn B→B: Führe ~/.claude/skills/gstack/bin/gstack-config set telemetry off aus.
Immer ausführen:
touch ~/.gstack/.telemetry-prompted
Überspringen, wenn TEL_PROMPTED yes ist.
Wenn PROACTIVE_PROMPTED no UND TEL_PROMPTED yes ist: Frage einmal:
Soll gstack proaktiv Skills vorschlagen, wie /qa für „funktioniert das?" oder /investigate für Fehler?
Optionen:
- A) Aktiviert lassen (empfohlen)
- B) Deaktivieren – ich gebe /commands selbst ein
Wenn A: Führe ~/.claude/skills/gstack/bin/gstack-config set proactive true aus.
Wenn B: Führe ~/.claude/skills/gstack/bin/gstack-config set proactive false aus.
Immer ausführen:
touch ~/.gstack/.proactive-prompted
Überspringen, wenn PROACTIVE_PROMPTED yes ist.
Wenn HAS_ROUTING no UND ROUTING_DECLINED false UND PROACTIVE_PROMPTED yes ist:
Prüfe, ob eine CLAUDE.md-Datei im Projektstammverzeichnis existiert. Wenn sie nicht existiert, erstelle sie.
Verwende AskUserQuestion:
gstack funktioniert am besten, wenn die CLAUDE.md deines Projekts Skill-Routing-Regeln enthält.
Optionen:
- A) Routing-Regeln zu CLAUDE.md hinzufügen (empfohlen)
- B) Nein danke, ich rufe Skills manuell auf
Wenn A: Hänge diesen Abschnitt an das Ende von CLAUDE.md an:
## Skill routing
Wenn die Anfrage des Benutzers zu einem verfügbaren Skill passt, rufe ihn über das Skill-Tool auf. Im Zweifelsfall den Skill aufrufen.
Wichtige Routing-Regeln:
- Produktideen/Brainstorming → /office-hours aufrufen
- Strategie/Umfang → /plan-ceo-review aufrufen
- Architektur → /plan-eng-review aufrufen
- Designsystem/Planprüfung → /design-consultation oder /plan-design-review aufrufen
- Vollständige Prüfpipeline → /autoplan aufrufen
- Fehler/Probleme → /investigate aufrufen
- QA/Test des Website-Verhaltens → /qa oder /qa-only aufrufen
- Code-Review/Diff-Prüfung → /review aufrufen
- Visuelle Nachbesserung → /design-review aufrufen
- Ship/Deploy/PR → /ship oder /land-and-deploy aufrufen
- Fortschritt speichern → /context-save aufrufen
- Kontext wiederherstellen → /context-restore aufrufen
Dann die Änderung committen: git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"
Wenn B: Führe ~/.claude/skills/gstack/bin/gstack-config set routing_declined true aus und sage, dass sie es mit gstack-config set routing_declined false wieder aktivieren können.
Dies geschieht nur einmal pro Projekt. Überspringen, wenn HAS_ROUTING yes oder ROUTING_DECLINED true ist.
Wenn VENDORED_GSTACK yes ist, warne einmal via AskUserQuestion, es sei denn, ~/.gstack/.vendoring-warned-$SLUG existiert:
Dieses Projekt hat gstack in
.claude/skills/gstack/gebündelt. Das Bündeln ist veraltet. Zum Team-Modus migrieren?
Optionen:
- A) Ja, jetzt zum Team-Modus migrieren
- B) Nein, ich kümmere mich selbst darum
Wenn A:
- Führe
git rm -r .claude/skills/gstack/aus - Führe
echo '.claude/skills/gstack/' >> .gitignoreaus - Führe
~/.claude/skills/gstack/bin/gstack-team-init required(oderoptional) aus - Führe
git add .claude/ .gitignore CLAUDE.md && git commit -m "chore: migrate gstack from vendored to team mode"aus - Sage dem Benutzer: "Erledigt. Jeder Entwickler führt jetzt aus:
cd ~/.claude/skills/gstack && ./setup --team"
Wenn B: Sage „OK, du bist selbst dafür verantwortlich, die gebündelte Kopie auf dem neuesten Stand zu halten."
Immer ausführen (unabhängig von der Wahl):
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}
Wenn der Marker existiert, überspringen.
Wenn SPAWNED_SESSION "true" ist, läufst du innerhalb einer Sitzung, die von einem AI-Orchestrator (z. B. OpenClaw) gestartet wurde. In gestarteten Sitzungen:
- Verwende KEIN AskUserQuestion für interaktive Eingabeaufforderungen. Wähle automatisch die empfohlene Option.
- Führe KEINE Upgrade-Prüfungen, Telemetrie-Eingabeaufforderungen, Routing-Injektion oder Lake-Einführung durch.
- Konzentriere dich darauf, die Aufgabe zu erledigen und die Ergebnisse über Prosa-Ausgabe zu melden.
- Beende mit einem Abschlussbericht: was ausgeliefert wurde, Entscheidungen, alles Unsichere.
AskUserQuestion-Format
Jede AskUserQuestion ist eine Entscheidungszusammenfassung und muss als tool_use gesendet werden, nicht als Prosa.
D<N> — <einzeiliger Fragentitel>
Projekt/Branch/Aufgabe: <1 kurzer begründender Satz unter Verwendung von _BRANCH>
ELI10: <einfaches Englisch, das ein 16-Jähriger verstehen würde, 2-4 Sätze, benenne die Risiken>
Risiken bei falscher Wahl: <ein Satz, was kaputt geht, was der Benutzer sieht, was verloren geht>
Empfehlung: <Wahl> weil <einzeiliger Grund>
Vollständigkeit: A=X/10, B=Y/10 (oder: Hinweis: Optionen unterscheiden sich in der Art, nicht im Umfang – keine Vollständigkeitsbewertung)
Vorteile / Nachteile:
A) <Optionsbezeichnung> (empfohlen)
✅ <Vorteil – konkret, beobachtbar, ≥40 Zeichen>
❌ <Nachteil – ehrlich, ≥40 Zeichen>
B) <Optionsbezeichnung>
✅ <Vorteil>
❌ <Nachteil>
Netto: <einzeilige Synthese, was du eigentlich abwägst>
D-Nummerierung: Erste Frage in einem Skill-Aufruf ist D1; erhöhe selbstständig. Dies ist eine modellweite Anweisung, kein Laufzeitzähler.
ELI10 ist immer vorhanden, in einfachem Englisch, keine Funktionsnamen. Empfehlung ist IMMER vorhanden. Behalte das Label (empfohlen); AUTO_DECIDE hängt davon ab.
Vollständigkeit: Verwende Vollständigkeit: N/10 nur, wenn sich die Optionen im Umfang unterscheiden. 10 = vollständig, 7 = Happy Path, 3 = Abkürzung. Wenn sich die Optionen in der Art unterscheiden, schreibe: Hinweis: Optionen unterscheiden sich in der Art, nicht im Umfang – keine Vollständigkeitsbewertung.
Vorteile / Nachteile: Verwende ✅ und ❌. Mindestens 2 Vorteile und 1 Nachteil pro Option, wenn die Wahl echt ist; mindestens 40 Zeichen pro Aufzählungspunkt. Harte Ausnahme für einseitige/zerstörerische Bestätigungen: ✅ Keine Nachteile – dies ist eine harte Entscheidung.
Neutrale Haltung: Empfehlung: <Standard> – dies ist eine Geschmacksfrage, keine starke Präferenz in die eine oder andere Richtung; (empfohlen) BLEIBT auf der Standardoption für AUTO_DECIDE.
Aufwand beidseitig skalieren: Wenn eine Option Aufwand beinhaltet, kennzeichne sowohl die Zeit des Menschen als auch die Zeit von CC+gstack, z. B. (Mensch: ~2 Tage / CC: ~15 Min). Macht die KI-Kompression zum Entscheidungszeitpunkt sichtbar.
Die Netto-Zeile schließt den Kompromiss ab. Skillspezifische Anweisungen können strengere Regeln hinzufügen.
Selbstprüfung vor dem Senden
Bevor du AskUserQuestion aufrufst, überprüfe:
- D-Header vorhanden
- ELI10-Absatz vorhanden (auch Risikozeile)
- Empfehlungszeile mit konkretem Grund vorhanden
- Vollständigkeit bewertet (Umfang) ODER Hinweis zur Art (Art)
- Jede Option hat ≥2 ✅ und ≥1 ❌, jeweils ≥40 Zeichen (oder Härte-Ausnahme)
- […]