Préambule (à exécuter en premier)
_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 entries loaded"
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
Opérations sécurisées en mode Plan
En mode plan, les opérations autorisées car elles informent le plan : $B, $D, codex exec/codex review, écritures dans ~/.gstack/, écritures dans le fichier de plan, et open pour les artefacts générés.
Invocation de compétence en mode Plan
Si l'utilisateur invoque une compétence en mode plan, la compétence prime sur le comportement générique du mode plan. Traitez le fichier de compétence comme des instructions exécutables, pas comme une référence. Suivez-le étape par étape en commençant par l'étape 0 ; la première AskUserQuestion est le flux de travail qui entre en mode plan, pas une violation de celui-ci. AskUserQuestion (toute variante, mcp__*__AskUserQuestion ou native ; voir "Format AskUserQuestion → Résolution d'outil") satisfait l'exigence de fin de tour du mode plan. Si aucune variante n'est appelable, la compétence est BLOQUÉE. Arrêtez-vous et signalez BLOCKED. AskUserQuestion unavailable selon la règle du format AskUserQuestion. À un point STOP, arrêtez-vous immédiatement. Ne continuez pas le flux de travail et n'appelez pas ExitPlanMode à cet endroit. Les commandes marquées "PLAN MODE EXCEPTION. ALWAYS RUN" s'exécutent. Appelez ExitPlanMode uniquement après la fin du flux de travail de la compétence, ou si l'utilisateur vous demande d'annuler la compétence ou de quitter le mode plan.
Si PROACTIVE est "false", n'invoquez pas automatiquement et ne suggérez pas de compétences de manière proactive. Si une compétence semble utile, demandez : "Je pense que /skillname pourrait aider ici, voulez-vous que je l'exécute ?"
Si SKILL_PREFIX est "true", suggérez/invoquez les noms /gstack-*. Les chemins disques restent ~/.claude/skills/gstack/[skill-name]/SKILL.md.
Si la sortie affiche UPGRADE_AVAILABLE <old> <new> : lisez ~/.claude/skills/gstack/gstack-upgrade/SKILL.md et suivez le "flux de mise à niveau en ligne" (mise à niveau automatique si configurée, sinon AskUserQuestion avec 4 options, écrivez l'état de report si refusé).
Si la sortie affiche JUST_UPGRADED <from> <to> : imprimez "Exécution de gstack v{to} (juste mis à jour !)". Si SPAWNED_SESSION est vrai, ignorez la découverte de fonctionnalités.
Découverte de fonctionnalités, une seule invite par session :
~/.claude/skills/gstack/.feature-prompted-continuous-checkpointmanquant : AskUserQuestion pour les validations automatiques de points de contrôle continus. Si accepté, exécutez~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Toujours créer le marqueur.~/.claude/skills/gstack/.feature-prompted-model-overlaymanquant : informez "Les superpositions de modèle sont actives. MODEL_OVERLAY montre le patch." Toujours créer le marqueur.
Après les invites de mise à niveau, continuez le flux de travail.
Si WRITING_STYLE_PENDING est yes : demandez une fois à propos du style d'écriture :
Les invites v1 sont plus simples : glossaire de jargon pour la première utilisation, questions axées sur les résultats, prose plus courte. Garder la valeur par défaut ou restaurer le style concis ?
Options :
- A) Garder la nouvelle valeur par défaut (recommandé, une bonne écriture aide tout le monde)
- B) Restaurer la prose V0, définir
explain_level: terse
Si A : laissez explain_level non défini (par défaut à default).
Si B : exécutez ~/.claude/skills/gstack/bin/gstack-config set explain_level terse.
Exécutez toujours (quel que soit le choix) :
rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted
Ignorez si WRITING_STYLE_PENDING est no.
Si LAKE_INTRO est no : dites "gstack suit le principe Boil the Lake, faites la chose complète lorsque l'IA rend le coût marginal proche de zéro. En savoir plus : https://garryslist.org/posts/boil-the-ocean" Proposez d'ouvrir :
open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen
Exécutez open uniquement si oui. Exécutez toujours touch.
Si TEL_PROMPTED est no ET LAKE_INTRO est yes : interrogez la télémétrie une fois via AskUserQuestion :
Aidez gstack à s'améliorer. Partagez uniquement les données d'utilisation : compétence, durée, plantages, ID d'appareil stable. Pas de code, de chemins de fichiers ou de noms de dépôts.
Options :
- A) Aidez gstack à s'améliorer ! (recommandé)
- B) Non merci
Si A : exécutez ~/.claude/skills/gstack/bin/gstack-config set telemetry community
Si B : demandez un suivi :
Le mode anonyme envoie uniquement des données d'utilisation agrégées, sans ID unique.
Options :
- A) D'accord, l'anonymat me convient
- B) Non merci, complètement désactivé
Si B→A : exécutez ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous
Si B→B : exécutez ~/.claude/skills/gstack/bin/gstack-config set telemetry off
Exécutez toujours :
touch ~/.gstack/.telemetry-prompted
Ignorez si TEL_PROMPTED est yes.
Si PROACTIVE_PROMPTED est no ET TEL_PROMPTED est yes : demandez une fois :
Laissez gstack suggérer proactivement des compétences, comme /qa pour "est-ce que ça marche ?" ou /investigate pour les bugs ?
Options :
- A) Garder actif (recommandé)
- B) Désactiver. Je taperai les /commandes moi-même
Si A : exécutez ~/.claude/skills/gstack/bin/gstack-config set proactive true
Si B : exécutez ~/.claude/skills/gstack/bin/gstack-config set proactive false
Exécutez toujours :
touch ~/.gstack/.proactive-prompted
Ignorez si PROACTIVE_PROMPTED est yes.
Si HAS_ROUTING est no ET ROUTING_DECLINED est false ET PROACTIVE_PROMPTED est yes :
Vérifiez si un fichier CLAUDE.md existe dans la racine du projet. S'il n'existe pas, créez-le.
Utilisez AskUserQuestion :
gstack fonctionne mieux lorsque le CLAUDE.md de votre projet inclut des règles de routage de compétences.
Options :
- A) Ajouter des règles de routage à CLAUDE.md (recommandé)
- B) Non merci, j'invoquerai les compétences manuellement
Si A : Ajoutez cette section à la fin de CLAUDE.md :
## Skill routing
Lorsque la demande de l'utilisateur correspond à une compétence disponible, invoquez-la via l'outil Skill. En cas de doute, invoquez la compétence.
Règles de routage clés :
- Idées de produits/brainstorming → invoquer /office-hours
- Stratégie/périmètre → invoquer /plan-ceo-review
- Architecture → invoquer /plan-eng-review
- Système de conception/révision de plan → invoquer /design-consultation ou /plan-design-review
- Pipeline de révision complet → invoquer /autoplan
- Bugs/erreurs → invoquer /investigate
- QA/test de comportement du site → invoquer /qa ou /qa-only
- Révision de code/vérification de diff → invoquer /review
- Polissage visuel → invoquer /design-review
- Livraison/déploiement/PR → invoquer /ship ou /land-and-deploy
- Sauvegarder la progression → invoquer /context-save
- Reprendre le contexte → invoquer /context-restore
Ensuite, validez le changement : git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"
Si B : exécutez ~/.claude/skills/gstack/bin/gstack-config set routing_declined true et dites qu'ils peuvent réactiver avec gstack-config set routing_declined false.
Cela ne se produit qu'une fois par projet. Ignorez si HAS_ROUTING est yes ou ROUTING_DECLINED est true.
Si VENDORED_GSTACK est yes, avertissez une fois via AskUserQuestion sauf si ~/.gstack/.vendoring-warned-$SLUG existe :
Ce projet a gstack intégré dans
.claude/skills/gstack/. L'intégration est dépréciée. Migrer vers le mode équipe ?
Options :
- A) Oui, migrer vers le mode équipe maintenant
- B) Non, je m'en occupe moi-même
Si A :
- Exécutez
git rm -r .claude/skills/gstack/ - Exécutez
echo '.claude/skills/gstack/' >> .gitignore - Exécutez
~/.claude/skills/gstack/bin/gstack-team-init required(ouoptional) - Exécutez
git add .claude/ .gitignore CLAUDE.md && git commit -m "chore: migrate gstack from vendored to team mode" - Dites à l'utilisateur : "Terminé. Chaque développeur exécute maintenant :
cd ~/.claude/skills/gstack && ./setup --team"
Si B : dites "OK, vous êtes seul pour maintenir la copie intégrée à jour."
Exécutez toujours (quel que soit le choix) :
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}
Si le marqueur existe, ignorez.
Si SPAWNED_SESSION est "true", vous fonctionnez dans une session générée par un
orchestrateur AI (par exemple, OpenClaw). Dans les sessions générées :
- N'utilisez PAS AskUserQuestion pour les invites interactives. Choisissez automatiquement l'option recommandée.
- N'exécutez PAS les vérifications de mise à niveau, les invites de télémétrie, l'injection de routage ou l'introduction au lac.
- Concentrez-vous sur l'accomplissement de la tâche et la communication des résultats via une sortie en prose.
- Terminez par un rapport d'achèvement : ce qui a été livré, les décisions prises, tout élément incertain.
Synchronisation des artefacts (début de compétence)
_GSTACK_HOME="${GSTACK_HOME:-$HOME/.gstack}"
# Préférer le fichier d'artefacts v1.27.0.0 ; se rabattre sur le fichier brain pour les utilisateurs
# qui mettent à niveau en cours de route avant que le script de migration ne s'exécute.
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: enseigne à l'agent d'utiliser gbrain lorsqu'il est disponible.
# Per-worktree pin : la refonte post-spike utilise `.gbrain-source` de style kubectl dans le
# niveau supérieur git pour limiter les requêtes. Recherchez l'épingle dans le worktree (pas un fichier
# d'état global) afin d'éviter de déclamer "indexé" simplement parce que le worktree A a été synchronisé.
# Chaîne vide lorsque gbrain n'est pas configuré (coût de contexte nul pour les utilisateurs non-gbrain).
_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 configuré. Préférez `gbrain search`/`gbrain query` à Grep pour les"
echo "questions sémantiques ; utilisez `gbrain code-def`/`code-refs`/`code-callers` pour la"
echo "recherche de code sensible aux symboles. Voir \"## GBrain Search Guidance\" dans CLAUDE.md."
echo "Exécutez /sync-gbrain pour actualiser."
else
echo "GBrain configuré mais ce worktree n'est pas encore épinglé. Exécutez `/sync-gbrain --full`"
echo "avant de vous fier à `gbrain search` pour les questions de code dans ce worktree."
echo "Revient à Grep jusqu'à ce qu'il soit épinglé."
fi
fi
fi
_BRAIN_SYNC_MODE=$("$_BRAIN_CONFIG_BIN" get artifacts_syn
…
[Le reste du contenu a été tronqué pour la traduction]