/landing-report — Tableau de bord de la file d'attente des versions
Préambule (à exécuter en premier)
_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
GSTACK_ROOT="$HOME/.cursor/skills/gstack"
[ -n "$_ROOT" ] && [ -d "$_ROOT/.cursor/skills/gstack" ] && GSTACK_ROOT="$_ROOT/.cursor/skills/gstack"
GSTACK_BIN="$GSTACK_ROOT/bin"
GSTACK_BROWSE="$GSTACK_ROOT/browse/dist"
GSTACK_DESIGN="$GSTACK_ROOT/design/dist"
_UPD=$($GSTACK_BIN/gstack-update-check 2>/dev/null || .cursor/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=$($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=$($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 <($GSTACK_BIN/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_SESSION_KIND=$($GSTACK_BIN/gstack-session-kind 2>/dev/null || echo "interactive")
case "$_SESSION_KIND" in spawned|headless|interactive) ;; *) _SESSION_KIND="interactive" ;; esac
echo "SESSION_KIND: $_SESSION_KIND"
# Hôte Conductor : AskUserQuestion n'est pas fiable ici (natif désactivé, variante
# MCP capricieuse), donc les skills rendent les décisions en prose au lieu d'appeler
# l'outil. Verrouillé sur !headless pour qu'une exécution d'évaluation/CI À L'INTÉRIEUR
# de Conductor (GSTACK_HEADLESS) reste BLOQUÉE plutôt que de rendre la prose à personne.
if [ "$_SESSION_KIND" != "headless" ] && { [ -n "${CONDUCTOR_WORKSPACE_PATH:-}" ] || [ -n "${CONDUCTOR_PORT:-}" ]; }; then
echo "CONDUCTOR_SESSION: true"
fi
_ACTIVATED=$([ -f ~/.gstack/.activated ] && echo "yes" || echo "no")
_FIRST_LOOP_SHOWN=$([ -f ~/.gstack/.first-loop-tip-shown ] && echo "yes" || echo "no")
echo "ACTIVATED: $_ACTIVATED"
echo "FIRST_LOOP_SHOWN: $_FIRST_LOOP_SHOWN"
# Détection de projet au premier lancement : exécuter le détecteur UNIQUEMENT lors du
# tout premier lancement du skill (ACTIVATED=no, interactif) afin qu'il reste hors du
# chemin chaud pour chaque exécution ultérieure.
_FIRST_TASK=""
if [ "$_ACTIVATED" = "no" ] && [ "$_SESSION_KIND" != "headless" ]; then
_FIRST_TASK=$($GSTACK_BIN/gstack-first-task-detect 2>/dev/null || true)
fi
echo "FIRST_TASK: $_FIRST_TASK"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$($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=$($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=$($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":"'$(_repo=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null | tr -cd 'a-zA-Z0-9._-'); echo "${_repo:-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 "$GSTACK_BIN/gstack-telemetry-log" ]; then
$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 "$($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
$GSTACK_BIN/gstack-learnings-search --limit 3 2>/dev/null || true
fi
else
echo "LEARNINGS: 0"
fi
$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=$($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 ".cursor/skills/gstack" ] && [ ! -L ".cursor/skills/gstack" ]; then
if [ -f ".cursor/skills/gstack/VERSION" ] || [ -d ".cursor/skills/gstack/.git" ]; then
_VENDORED="yes"
fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$($GSTACK_BIN/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$($GSTACK_BIN/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
# Indice de mode plan pour les skills comme /spec qui modifient leur comportement en
# fonction de l'état du mode plan. Claude Code expose le mode plan via des rappels
# système ; nous détectons au mieux à partir de CLAUDE_PLAN_FILE (défini par le harnais
# lorsque le mode plan est actif) et retombons sur "inactif". Les hôtes Codex et le
# mode d'exécution de Claude aboutissent tous deux à inactif, ce qui est la valeur par
# défaut sûre (par défaut, pipeline fichier+exécution).
if [ -n "${CLAUDE_PLAN_FILE:-}${GSTACK_PLAN_MODE_FORCE:-}" ]; then
export GSTACK_PLAN_MODE="active"
elif [ "${GSTACK_PLAN_MODE:-}" = "active" ]; then
export GSTACK_PLAN_MODE="active"
else
export GSTACK_PLAN_MODE="inactive"
fi
echo "GSTACK_PLAN_MODE: $GSTACK_PLAN_MODE"
[ -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 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 prévaut 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 à partir de l'Étape 0 ; le premier 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 de l'outil") satisfait à l'exigence de fin de tour du mode plan. Si AskUserQuestion est indisponible ou qu'un appel échoue, suivez le repli en cas d'échec du format AskUserQuestion : headless → BLOQUÉ ; interactive → le repli en prose (satisfait également la fin de tour). À un point d'arrêt STOP, arrêtez immédiatement. Ne poursuivez pas le flux de travail et n'appelez pas ExitPlanMode à cet endroit. Les commandes marquées "EXCEPTION MODE PLAN — TOUJOURS EXÉCUTER" s'exécutent. Appelez ExitPlanMode uniquement une fois le flux de travail de la compétence terminé, 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 manière proactive des compétences. Si une compétence semble utile, demandez : "Je pense que /nomcompétence 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 $GSTACK_ROOT/[skill-name]/SKILL.md.
Si la sortie affiche UPGRADE_AVAILABLE <ancien> <nouveau> : lisez $GSTACK_ROOT/gstack-upgrade/SKILL.md et suivez le "Flux de mise à niveau intégré" (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> : affichez "Exécution de gstack v{vers} (vient d'être mis à jour !)". Si SPAWNED_SESSION est vrai, ignorez la découverte de fonctionnalités.
Découverte de fonctionnalités, au maximum une invitation par session :
$GSTACK_ROOT/.feature-prompted-continuous-checkpointmanquant : AskUserQuestion pour les validations automatiques de points de contrôle continus. Si accepté, exécutez$GSTACK_BIN/gstack-config set checkpoint_mode continuous. Toujours toucher le marqueur.$GSTACK_ROOT/.feature-prompted-model-overlaymanquant : informez "Les superpositions de modèle sont actives. MODEL_OVERLAY montre le correctif." Toujours toucher le marqueur.
Après les invitations 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 première utilisation, questions cadrées par 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 $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.
Si LAKE_INTRO est no : dites "gstack suit le principe Boil the Ocean — faire 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.
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 ni de chemins de fichiers. Le nom de votre dépôt est enregistré localement uniquement et supprimé avant tout téléchargement.
Options :
- A) Aidez gstack à s'améliorer ! (recommandé)
- B) Non merci
Si A : exécutez $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 convient
- B) Non merci, complètement désactivé
Si B→A : exécutez $GSTACK_BIN/gstack-config set telemetry anonymous
Si B→B : exécutez $GSTACK_BIN/gstack-config set telemetry off
Toujours exécuter :
touch ~/.gstack/.telemetry-prompted
Ignorer 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 bogues ?
Options :
- A) Garder activé (recommandé)
- B) Désactiver — je taperai les /commandes moi-même
Si A : exécutez $GSTACK_BIN/gstack-config set proactive true
Si B : exécutez $GSTACK_BIN/gstack-config set proactive false
Toujours exécuter :
touch ~/.gstack/.proactive-prompted
Ignorer si PROACTIVE_PROMPTED est yes.
Guide de première utilisation (unique)
Si ACTIVATED est no (première exécution de compétence sur cette machine) ET le préambule a affiché une valeur FIRST_TASK: non vide qui n'est PAS nongit : affichez UNE ligne courte et spécifique au projet, mappée à partir du jeton, à titre d'information, puis CONTINUEZ avec ce que l'utilisateur a réellement demandé — n'interrompez PAS sa tâche. Mappez le jeton : greenfield → "Nouveau dépôt — façonnez-le d'abord avec /spec ou /office-hours." code_node/code_python/code_rust/code_go/code_ruby/code_ios → "Il y a du code ici — /qa pour le voir fonctionner, ou /investigate si quelque chose cloche." branch_ahead → "Travail non livré sur cette branche — /review puis /ship." dirty_default → "Modifications non validées — /review avant de valider." clean_default → "Choisissez une option : /spec, /investigate ou /qa." Remplacez ensuite le jeton que vous avez vu par TASK_TOKEN et exécutez (au mieux), et marquez comme activé :
$GSTACK_BIN/gstack-telemetry-log --event-type first_task_scaffold_shown --skill "TASK_TOKEN" --outcome shown 2>/dev/null || true
touch ~/.gstack/.activated 2>/dev/null || true
Si ACTIVATED est no mais que FIRST_TASK: est vide ou nongit (headless, non-git, ou rien d'exploitable) : n'affichez rien, exécutez simplement touch ~/.gstack/.activated 2>/dev/null || true.
Sinon, si ACTIVATED est yes ET FIRST_LOOP_SHOWN est no : dites une fois à titre d'information (puis continuez) :
Astuce : gstack porte ses fruits lorsque vous terminez une boucle — planifier → revoir → livrer. Une première boucle courante :
/office-hoursou/specpour la façonner,/plan-eng-reviewpour la verrouiller, puis/ship.
Exécutez ensuite touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true.
Ignorer cette section si ACTIVATED et FIRST_LOOP_SHOWN sont tous deux yes.
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 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 :
## Routage des compétences
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
- Bogues/erreurs → invoquer /investigate
- QA/test de comportement du site → invoquer /qa ou /qa-only
- Révision de code/vérification des diffs → invoquer /review
- Polissage visuel → invoquer /design-review
- Livrer/déployer/PR → invoquer /ship ou /land-and-deploy
- Sauvegarder la progression → invoquer /context-save
- Reprendre le contexte → invoquer /context-restore
- Rédiger un spec/issue prêt pour le backlog → invoquer /spec
Validez ensuite le changement : git add CLAUDE.md && git commit -m "chore: ajout des règles de routage des compétences gstack à CLAUDE.md"
Si B : exécutez `$GSTACK_BIN/gstack-
… [tronqué pour la traduction]