Präambel (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":"gstack","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":"gstack","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
Sichere Operationen im Plan-Modus
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 eine Skill im Plan-Modus aufruft, hat die Skill Vorrang vor dem generischen Plan-Modus-Verhalten. 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 Arbeitsablauf, der in den Plan-Modus wechselt, kein Verstoß dagegen. AskUserQuestion (jede Variante, mcp__*__AskUserQuestion oder natio; siehe "AskUserQuestion-Format → Tool-Auflösung") erfüllt die Anforderung des Plan-Modus, die Runde zu beenden. Wenn keine Variante aufrufbar ist, ist die Skill BLOCKIERT. Stoppe und melde BLOCKED. AskUserQuestion nicht verfügbar gemäß der AskUserQuestion-Format-Regel. Halte an einem STOP-Punkt sofort an. Setze den Arbeitsablauf 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, nachdem der Skill-Arbeitsablauf abgeschlossen ist, oder wenn der Benutzer dir sagt, die Skill abzubrechen oder den Plan-Modus zu verlassen.
Wenn PROACTIVE auf "false" gesetzt ist, Skills nicht automatisch aufrufen oder proaktiv vorschlagen. Wenn eine Skill nützlich erscheint, frage: "Ich denke, /skillname könnte hier helfen. Möchtest du sie ausführen?"
Wenn SKILL_PREFIX auf "true" gesetzt ist, Namen im Format /gstack-* vorschlagen/aufrufen. Die Disk-Pfade 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-Ablauf" (automatisches Upgrade, wenn konfiguriert, sonst AskUserQuestion mit 4 Optionen, schreibe Snooze-Status, wenn abgelehnt).
Wenn die Ausgabe JUST_UPGRADED <von> <nach> anzeigt: Gib "Ausführen von gstack v{nach} (gerade aktualisiert!)" aus. Wenn SPAWNED_SESSION wahr ist, überspringe die Feature-Erkennung.
Feature-Erkennung, maximal eine Aufforderung pro Sitzung:
- Fehlende
~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion für Continuous-Checkpoint-Auto-Commits. Wenn akzeptiert, führe~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuousaus. Erstelle immer den Marker. - Fehlende
~/.claude/skills/gstack/.feature-prompted-model-overlay: Informiere: "Modell-Overlays sind aktiv. MODEL_OVERLAY zeigt den Patch an." Erstelle immer den Marker.
Nach den Upgrade-Aufforderungen, setze den Arbeitsablauf fort.
Wenn WRITING_STYLE_PENDING yes ist: Frage einmal nach dem Schreibstil:
v1-Prompts sind einfacher: Fachjargon-Erklärungen beim ersten Mal, ergebnisorientierte Fragen, kürzere Prosa. Standard beibehalten oder knappen Stil wiederherstellen?
Optionen:
- A) Den neuen Standard beibehalten (empfohlen, gutes Schreiben hilft allen)
- B) V0-Prosa wiederherstellen,
explain_level: tersesetzen
Wenn A: explain_level nicht setzen (standardmäßig auf default).
Wenn B: ~/.claude/skills/gstack/bin/gstack-config set explain_level terse ausführen.
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: das vollständige Ding erledigen, wenn die KI die Grenzkosten nahe Null macht. Mehr lesen: 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 touch immer 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 oder 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 Nutzungsdaten, ohne eindeutige ID.
Optionen:
- A) Ja, anonym ist in Ordnung
- B) Nein, danke, komplett aus
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:
Lass gstack proaktiv Skills vorschlagen, wie /qa für "funktioniert das?" oder /investigate für Bugs?
Optionen:
- A) Anlassen (empfohlen)
- B) Ausschalten. Ich tippe /commands selbst
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:
Überprüfe, ob im Projektverzeichnis eine CLAUDE.md-Datei existiert. Wenn nicht, erstelle sie.
Verwende AskUserQuestion:
gstack funktioniert am besten, wenn die CLAUDE.md Ihres 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: Füge diesen Abschnitt am Ende von CLAUDE.md an:
## Skill Routing
Wenn die Anfrage des Benutzers zu einer verfügbaren Skill passt, rufe sie über das Skill-Tool auf. Im Zweifelsfall die Skill aufrufen.
Wichtige Routing-Regeln:
- Produktideen/Brainstorming → /office-hours aufrufen
- Strategie/Umfang → /plan-ceo-review aufrufen
- Architektur → /plan-eng-review aufrufen
- Designsystem/Planüberprüfung → /design-consultation oder /plan-design-review aufrufen
- Vollständige Überprüfungspipeline → /autoplan aufrufen
- Bugs/Fehler → /investigate aufrufen
- QA/Testen des Site-Verhaltens → /qa oder /qa-only aufrufen
- Code-Review/Diff-Prüfung → /review aufrufen
- Visuelle Optimierung → /design-review aufrufen
- Auslieferung/Bereitstellung/PR → /ship oder /land-and-deploy aufrufen
- Fortschritt speichern → /context-save aufrufen
- Kontext wiederherstellen → /context-restore aufrufen
Dann committe die Änderung: git add CLAUDE.md && git commit -m "chore: Skill-Routing-Regeln für gstack zu CLAUDE.md hinzugefügt"
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: gstack von gebündelt zu Team-Modus migriert"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 aktuell 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 in einer Sitzung, die von einem AI-Orchestrator (z. B. OpenClaw) gestartet wurde. In gespawnten Sitzungen:
- Verwende NICHT AskUserQuestion für interaktive Aufforderungen. Wähle automatisch die empfohlene Option.
- Führe KEINE Upgrade-Prüfungen, Telemetrie-Aufforderungen, Routing-Injektionen oder Lake-Intro durch.
- Konzentriere dich darauf, die Aufgabe abzuschließen und die Ergebnisse über Prosa-Ausgabe zu melden.
- Beende mit einem Abschlussbericht: was ausgeliefert wurde, Entscheidungen, alles Unklare.
Artefakte-Synchronisation (Skill-Start)
_GSTACK_HOME="${GSTACK_HOME:-$HOME/.gstack}"
# Bevorzuge die v1.27.0.0-Artefaktdatei; falle auf die Hirndatei für Benutzer zurück,
# die mid-stream upgraden, bevor das Migrationsskript läuft.
if [ -f "$HOME/.gstack-artifacts-remote.txt" ]; then
_BRAIN_REMOTE_FILE="$HOME/.gstack-artifacts-remote.txt"
else
_BRAIN_REMOTE_FILE="$HOME/.gstack-brain-remote.txt"
fi
_BRAIN_SYNC_BIN="~/.claude/skills/gstack/bin/gstack-brain-sync"
_BRAIN_CONFIG_BIN="~/.claude/skills/gstack/bin/gstack-config"
# /sync-gbrain context-load: Lehre den Agenten, gbrain zu verwenden, wenn es verfügbar ist.
# Per-Worktree-Pin: Nach dem Redesign verwendet das Projekt einen kubectl-ähnlichen `.gbrain-source` im
# Git-Toplevel, um Abfragen zu begrenzen. Suche den Pin im Worktree (nicht in einer globalen
# Zustandsdatei), damit das Öffnen von Worktree B ohne Pin nicht "indiziert" beansprucht,
# nur weil Worktree A synchronisiert wurde. Leerer String, wenn gbrain nicht konfiguriert ist
# (null Kontextkosten für Nicht-gbrain-Benutzer).
_GBRAIN_CONFIG="$HOME/.gbrain/config.json"
if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_VERSION_OK=$(gbrain --version 2>/dev/null | grep -c '^gbrain ' || echo 0)
if [ "$_GBRAIN_VERSION_OK" -gt 0 ] 2>/dev/null; then
_GBRAIN_PIN_PATH=""
_REPO_TOP=$(git rev-parse --show-toplevel 2>/dev/null || echo "")
if [ -n "$_REPO_TOP" ] && [ -f "$_REPO_TOP/.gbrain-source" ]; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
echo "GBrain konfiguriert. Bevorzuge `gbrain search`/`gbrain query` gegenüber Grep für"
echo "semantische Fragen; verwende `gbrain code-def`/`code-refs`/`code-callers` für"
echo "symbolbewusste Codesuche. Siehe \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Führe /sync-gbrain aus, um zu aktualisieren."
else
echo "GBrain konfiguriert, aber dieser Worktree ist noch nicht gepinnt. Führe `/sync-gbrain --full` aus,"
echo "bevor du dich auf `gbrain search` für Code-Fragen in diesem Worktree verlässt."
echo "Fällt auf Grep zurück, bis gepinnt."
fi
fi
fi
_BRAIN_SYNC_MODE=$("$_BRAIN_CONFIG_BIN" get artifacts_syn
…
[gekürzt für Übersetzung]