/landing-report — Tableau de bord de la file d'attente des versions
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":"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 entrées chargées"
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
Opérations sécurisées en mode plan
En mode plan, autorisées car elles informent le plan : $B, $D, codex exec/codex review, écritures dans ~/.gstack/, écritures dans le fichier du plan et open pour les artefacts générés.
Invocation de la 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 workflow entrant en mode plan, pas une violation de celui-ci. AskUserQuestion (n'importe quelle 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 conformément à la règle du format AskUserQuestion. À un point STOP, arrêtez-vous immédiatement. Ne continuez pas le workflow 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 workflow de la compétence, ou si l'utilisateur vous demande d'annuler la compétence ou de quitter le mode plan.
Demande de fonctionnalité
Si PROACTIVE est "false", n'invoquez pas automatiquement et ne suggérez pas proactivement de compétences. Si une compétence semble utile, demandez : "Je pense que /nom-de-la-competence pourrait aider ici — voulez-vous que je l'exécute ?"
Si SKILL_PREFIX est "true", suggérez/invoquez les noms /gstack-*. Les chemins sur disque restent ~/.claude/skills/gstack/[nom-competence]/SKILL.md.
Mises à jour
Si la sortie affiche UPGRADE_AVAILABLE <ancien> <nouveau> : 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 <de> <vers> : imprimez "Exécution de gstack v{vers} (tout juste mis à jour !)". Si SPAWNED_SESSION est vrai, ignorez la découverte de fonctionnalités.
Découverte de fonctionnalités, au maximum une invite par session
- Fichier
~/.claude/skills/gstack/.feature-prompted-continuous-checkpointmanquant : AskUserQuestion pour les validations automatiques continues de point de contrôle. Si accepté, exécutez~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Toujours toucher le marqueur. - Fichier
~/.claude/skills/gstack/.feature-prompted-model-overlaymanquant : informez "Les superpositions de modèle sont actives. MODEL_OVERLAY montre le correctif." Toujours toucher le marqueur.
Après les invites de mise à niveau, continuez le workflow.
Style d'écriture
Si WRITING_STYLE_PENDING est yes : demandez une fois à propos du style d'écriture :
Les invites v1 sont plus simples : glossaire de jargon en première utilisation, questions structurées par résultat, prose plus courte. Garder par défaut ou restaurer le style concis ?
Options :
- A) Garder le nouveau 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.
Toujours exécuter (quel que soit le choix) :
rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted
Ignorer si WRITING_STYLE_PENDING est no.
Principe Boil the Lake
Si LAKE_INTRO est no : dites "gstack suit le principe Boil the Lake — faites la chose complète quand 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. Toujours exécuter touch.
Télémétrie
Si TEL_PROMPTED est no ET LAKE_INTRO est yes : demandez 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, chemins de fichiers ou noms de dépôt.
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 l'utilisation agrégée, sans ID unique.
Options :
- A) Oui, l'anonyme me va
- 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
Toujours exécuter :
touch ~/.gstack/.telemetry-prompted
Ignorer si TEL_PROMPTED est yes.
Proactivité
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 activé (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
Toujours exécuter :
touch ~/.gstack/.proactive-prompted
Ignorer si PROACTIVE_PROMPTED est yes.
Routage des compétences
Si HAS_ROUTING est no ET ROUTING_DECLINED est false ET PROACTIVE_PROMPTED est yes :
Vérifiez si un fichier CLAUDE.md existe à 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 des 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 produit/brainstorming → invoquer /office-hours
- Stratégie/portée → 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 du 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 n'arrive qu'une fois par projet. Ignorer si HAS_ROUTING est yes ou ROUTING_DECLINED est true.
Compétence intégrée au projet (vendored)
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 directe est obsolète. Migrer vers le mode équipe ?
Options :
- A) Oui, migrer vers le mode équipe maintenant
- B) Non, je m'en occuperai 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."
Toujours exécuter (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, ignorer.
Sessions engendrées (spawned)
Si SPAWNED_SESSION est "true", vous êtes exécuté dans une session engendrée par un orchestrateur IA (par exemple, OpenClaw). Dans les sessions engendrées :
- N'utilisez PAS AskUserQuestion pour les invites interactives. Choisissez automatiquement l'option recommandée.
- N'exécutez PAS de vérifications de mise à niveau, d'invites de télémétrie, d'injection de routage ou d'introduction au lac.
- Concentrez-vous sur l'exécution de la tâche et le rapport des résultats via une sortie en prose.
- Terminez par un rapport d'achèvement : ce qui a été livré, décisions prises, tout ce qui est incertain.
Format AskUserQuestion
Résolution d'outil (à lire en premier)
« AskUserQuestion » peut se résoudre en deux outils au moment de l'exécution : la variante MCP de l'hôte (par exemple mcp__conductor__AskUserQuestion — apparaît dans votre liste d'outils lorsque l'hôte l'enregistre) ou l'outil natif de Claude Code.
Règle : si une variante mcp__*__AskUserQuestion est dans votre liste d'outils, préférez-la. Les hôtes peuvent désactiver l'AUQ native via --disallowedTools AskUserQuestion (Conductor le fait, par défaut) et router via leur variante MCP ; appeler la native échoue silencieusement. Même forme de questions/options ; le même format de résumé de décision s'applique.
Si aucune variante AskUserQuestion n'apparaît dans votre liste d'outils, cette compétence est BLOQUÉE. Arrêtez-vous, signalez BLOCKED — AskUserQuestion unavailable, et attendez l'utilisateur. N'écrivez pas de décisions dans le fichier du plan comme substitut, ne les émettez pas comme prose et arrêtez-vous, et ne décidez pas automatiquement silencieusement (seules les options d'adoption /plan-tune AUTO_DECIDE autorisent la sélection automatique).
Format
Chaque AskUserQuestion est un résumé de décision et doit être envoyé en tant que tool_use, pas en prose.
D<N> — <titre de la question en une ligne>
Projet/branche/tâche : <1 phrase de contexte courte utilisant _BRANCH>
ELI10 : <anglais simple qu'un adolescent de 16 ans pourrait suivre, 2-4 phrases, nommez les enjeux>
Enjeux si nous choisissons mal : <une phrase sur ce qui casse, ce que l'utilisateur voit, ce qui est perdu>
Recommandation : <choix> parce que <raison en une ligne>
Complétude : A=X/10, B=Y/10 (ou : Remarque : les options diffèrent en nature, pas en couverture — pas de score de complétude)
Avantages / inconvénients :
A) <libellé de l'option> (recommandée)
✅ <avantage — concret, observable, ≥40 caractères>
❌ <inconvénient — honnête, ≥40 caractères>
B) <libellé de l'option>
✅ <avantage>
❌ <inconvénient>
Net : <synthèse en une ligne de ce que vous échangez réellement>
Numérotation D : la première question dans une invocation de compétence est D1 ; incrémentez vous-même. C'est une instruction au niveau du modèle, pas un compteur d'exécution.
ELI10 est toujours présent, en anglais simple, pas des noms de fonctions. La recommandation est TOUJOURS présente. Gardez le libellé (recommandée) ; AUTO_DECIDE en dépend.
Complétude : utilisez Completeness: N/10
… [tronqué pour la traduction]