From dcab91b51cfbce6d81082146b4b31365d1bbbc97 Mon Sep 17 00:00:00 2001 From: adamouabakar Date: Tue, 16 Jun 2026 09:18:24 -0700 Subject: [PATCH 1/3] Add official support for grok Build (xAI) --- .grok/skills/gstack-autoplan/SKILL.md | 1813 ++++++++++ .grok/skills/gstack-benchmark-models/SKILL.md | 626 ++++ .grok/skills/gstack-benchmark/SKILL.md | 749 ++++ .grok/skills/gstack-browse/SKILL.md | 988 ++++++ .grok/skills/gstack-canary/SKILL.md | 1017 ++++++ .grok/skills/gstack-careful/SKILL.md | 54 + .grok/skills/gstack-claude/SKILL.md | 1119 ++++++ .grok/skills/gstack-context-restore/SKILL.md | 875 +++++ .grok/skills/gstack-context-save/SKILL.md | 993 ++++++ .grok/skills/gstack-cso/SKILL.md | 1518 ++++++++ .../gstack-design-consultation/SKILL.md | 1598 +++++++++ .grok/skills/gstack-design-html/SKILL.md | 1473 ++++++++ .grok/skills/gstack-design-review/SKILL.md | 1974 +++++++++++ .grok/skills/gstack-design-shotgun/SKILL.md | 1318 +++++++ .grok/skills/gstack-devex-review/SKILL.md | 1267 +++++++ .grok/skills/gstack-diagram/SKILL.md | 891 +++++ .../skills/gstack-document-generate/SKILL.md | 1216 +++++++ .grok/skills/gstack-document-release/SKILL.md | 1390 ++++++++ .grok/skills/gstack-freeze/SKILL.md | 72 + .grok/skills/gstack-guard/SKILL.md | 67 + .grok/skills/gstack-health/SKILL.md | 1039 ++++++ .grok/skills/gstack-investigate/SKILL.md | 1037 ++++++ .grok/skills/gstack-ios-clean/SKILL.md | 839 +++++ .../skills/gstack-ios-design-review/SKILL.md | 841 +++++ .grok/skills/gstack-ios-fix/SKILL.md | 835 +++++ .grok/skills/gstack-ios-qa/SKILL.md | 955 +++++ .grok/skills/gstack-ios-sync/SKILL.md | 829 +++++ .grok/skills/gstack-land-and-deploy/SKILL.md | 1883 ++++++++++ .grok/skills/gstack-landing-report/SKILL.md | 905 +++++ .grok/skills/gstack-learn/SKILL.md | 916 +++++ .grok/skills/gstack-make-pdf/SKILL.md | 753 ++++ .grok/skills/gstack-office-hours/SKILL.md | 2194 ++++++++++++ .../gstack-open-gstack-browser/SKILL.md | 983 +++++ .grok/skills/gstack-pair-agent/SKILL.md | 1038 ++++++ .grok/skills/gstack-plan-ceo-review/SKILL.md | 2357 ++++++++++++ .../skills/gstack-plan-design-review/SKILL.md | 2086 +++++++++++ .../skills/gstack-plan-devex-review/SKILL.md | 2296 ++++++++++++ .grok/skills/gstack-plan-eng-review/SKILL.md | 1935 ++++++++++ .grok/skills/gstack-plan-tune/SKILL.md | 1377 +++++++ .grok/skills/gstack-qa-only/SKILL.md | 1220 +++++++ .grok/skills/gstack-qa/SKILL.md | 1662 +++++++++ .grok/skills/gstack-retro/SKILL.md | 1789 ++++++++++ .grok/skills/gstack-review/SKILL.md | 1813 ++++++++++ .grok/skills/gstack-scrape/SKILL.md | 917 +++++ .../gstack-setup-browser-cookies/SKILL.md | 600 ++++ .grok/skills/gstack-setup-deploy/SKILL.md | 944 +++++ .grok/skills/gstack-setup-gbrain/SKILL.md | 1800 ++++++++++ .grok/skills/gstack-ship/SKILL.md | 3157 +++++++++++++++++ .grok/skills/gstack-skillify/SKILL.md | 1198 +++++++ .grok/skills/gstack-spec/SKILL.md | 2303 ++++++++++++ .grok/skills/gstack-sync-gbrain/SKILL.md | 1197 +++++++ .grok/skills/gstack-unfreeze/SKILL.md | 41 + .grok/skills/gstack-upgrade/SKILL.md | 273 ++ .grok/skills/gstack/SKILL.md | 987 ++++++ hosts/grok-build.ts | 51 + hosts/index.ts | 5 +- 56 files changed, 66071 insertions(+), 2 deletions(-) create mode 100644 .grok/skills/gstack-autoplan/SKILL.md create mode 100644 .grok/skills/gstack-benchmark-models/SKILL.md create mode 100644 .grok/skills/gstack-benchmark/SKILL.md create mode 100644 .grok/skills/gstack-browse/SKILL.md create mode 100644 .grok/skills/gstack-canary/SKILL.md create mode 100644 .grok/skills/gstack-careful/SKILL.md create mode 100644 .grok/skills/gstack-claude/SKILL.md create mode 100644 .grok/skills/gstack-context-restore/SKILL.md create mode 100644 .grok/skills/gstack-context-save/SKILL.md create mode 100644 .grok/skills/gstack-cso/SKILL.md create mode 100644 .grok/skills/gstack-design-consultation/SKILL.md create mode 100644 .grok/skills/gstack-design-html/SKILL.md create mode 100644 .grok/skills/gstack-design-review/SKILL.md create mode 100644 .grok/skills/gstack-design-shotgun/SKILL.md create mode 100644 .grok/skills/gstack-devex-review/SKILL.md create mode 100644 .grok/skills/gstack-diagram/SKILL.md create mode 100644 .grok/skills/gstack-document-generate/SKILL.md create mode 100644 .grok/skills/gstack-document-release/SKILL.md create mode 100644 .grok/skills/gstack-freeze/SKILL.md create mode 100644 .grok/skills/gstack-guard/SKILL.md create mode 100644 .grok/skills/gstack-health/SKILL.md create mode 100644 .grok/skills/gstack-investigate/SKILL.md create mode 100644 .grok/skills/gstack-ios-clean/SKILL.md create mode 100644 .grok/skills/gstack-ios-design-review/SKILL.md create mode 100644 .grok/skills/gstack-ios-fix/SKILL.md create mode 100644 .grok/skills/gstack-ios-qa/SKILL.md create mode 100644 .grok/skills/gstack-ios-sync/SKILL.md create mode 100644 .grok/skills/gstack-land-and-deploy/SKILL.md create mode 100644 .grok/skills/gstack-landing-report/SKILL.md create mode 100644 .grok/skills/gstack-learn/SKILL.md create mode 100644 .grok/skills/gstack-make-pdf/SKILL.md create mode 100644 .grok/skills/gstack-office-hours/SKILL.md create mode 100644 .grok/skills/gstack-open-gstack-browser/SKILL.md create mode 100644 .grok/skills/gstack-pair-agent/SKILL.md create mode 100644 .grok/skills/gstack-plan-ceo-review/SKILL.md create mode 100644 .grok/skills/gstack-plan-design-review/SKILL.md create mode 100644 .grok/skills/gstack-plan-devex-review/SKILL.md create mode 100644 .grok/skills/gstack-plan-eng-review/SKILL.md create mode 100644 .grok/skills/gstack-plan-tune/SKILL.md create mode 100644 .grok/skills/gstack-qa-only/SKILL.md create mode 100644 .grok/skills/gstack-qa/SKILL.md create mode 100644 .grok/skills/gstack-retro/SKILL.md create mode 100644 .grok/skills/gstack-review/SKILL.md create mode 100644 .grok/skills/gstack-scrape/SKILL.md create mode 100644 .grok/skills/gstack-setup-browser-cookies/SKILL.md create mode 100644 .grok/skills/gstack-setup-deploy/SKILL.md create mode 100644 .grok/skills/gstack-setup-gbrain/SKILL.md create mode 100644 .grok/skills/gstack-ship/SKILL.md create mode 100644 .grok/skills/gstack-skillify/SKILL.md create mode 100644 .grok/skills/gstack-spec/SKILL.md create mode 100644 .grok/skills/gstack-sync-gbrain/SKILL.md create mode 100644 .grok/skills/gstack-unfreeze/SKILL.md create mode 100644 .grok/skills/gstack-upgrade/SKILL.md create mode 100644 .grok/skills/gstack/SKILL.md create mode 100644 hosts/grok-build.ts diff --git a/.grok/skills/gstack-autoplan/SKILL.md b/.grok/skills/gstack-autoplan/SKILL.md new file mode 100644 index 0000000000..a7c7233a46 --- /dev/null +++ b/.grok/skills/gstack-autoplan/SKILL.md @@ -0,0 +1,1813 @@ +--- +name: autoplan +description: | + Auto-review pipeline — reads the full CEO, design, eng, and DX review skills from disk + and runs them sequentially with auto-decisions using 6 decision principles. Surfaces + taste decisions (close approaches, borderline scope, codex disagreements) at a final + approval gate. One command, fully reviewed plan out. + Use when asked to "auto review", "autoplan", "run all reviews", "review this plan + automatically", or "make the decisions for me". + Proactively suggest when the user has a plan file and wants to run the full review + gauntlet without answering [object Object]5-3[object Object] intermediate questions. (gstack) + Voice triggers (speech-to-text aliases): "auto plan", "automatic review". +triggers: + - run all reviews + - automatic review pipeline + - auto plan review +--- + + + +## Preamble (run first) + +```bash +_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) +GSTACK_ROOT="$HOME/.grok/skills/gstack" +[ -n "$_ROOT" ] && [ -d "$_ROOT/.grok/skills/gstack" ] && GSTACK_ROOT="$_ROOT/.grok/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 || .grok/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 -[object Object]2[object Object] -type f 2>/dev/null | wc -l | tr -d ' ') +find ~/.gstack/sessions -mmin +[object Object]2[object Object] -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" +# Conductor host: AskUserQuestion is unreliable here (native disabled, MCP +# variant flaky), so skills render decisions as prose instead of calling the +# tool. Gated on !headless so an eval/CI run INSIDE Conductor (GSTACK_HEADLESS) +# still BLOCKs rather than rendering prose to nobody. +if [ "$_SESSION_KIND" != "headless" ] && { [ -n "${CONDUCTOR_WORKSPACE_PATH:-}" ] || [ -n "${CONDUCTOR_PORT:-}" ]; }; then + echo "CONDUCTOR_SESSION: true" +fi +_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":"autoplan","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-Z[object Object]-9._-'); echo "${_repo:-unknown}")'"}' >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true +fi +for _PF in $(find ~/.gstack/analytics -maxdepth [object Object] -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 entries loaded" + if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then + $GSTACK_BIN/gstack-learnings-search --limit 3 2>/dev/null || true + fi +else + echo "LEARNINGS: [object Object]" +fi +$GSTACK_BIN/gstack-timeline-log '{"skill":"autoplan","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 ".grok/skills/gstack" ] && [ ! -L ".grok/skills/gstack" ]; then + if [ -f ".grok/skills/gstack/VERSION" ] || [ -d ".grok/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" +# Plan-mode hint for skills like /spec that branch behavior on plan-mode state. +# Claude Code exposes plan mode via system reminders; we detect best-effort +# from CLAUDE_PLAN_FILE (set by the harness when plan mode is active) and +# fall back to "inactive". Codex hosts and Claude execution mode both end up +# inactive, which is the safe default (defaults to file+execute pipeline). +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 +``` + +## Plan Mode Safe Operations + +In plan mode, allowed because they inform the plan: `$B`, `$D`, `codex exec`/`codex review`, writes to `~/.gstack/`, writes to the plan file, and `open` for generated artifacts. + +## Skill Invocation During Plan Mode + +If the user invokes a skill in plan mode, the skill takes precedence over generic plan mode behavior. **Treat the skill file as executable instructions, not reference.** Follow it step by step starting from Step [object Object]; the first AskUserQuestion is the workflow entering plan mode, not a violation of it. AskUserQuestion (any variant — `mcp__*__AskUserQuestion` or native; see "AskUserQuestion Format → Tool resolution") satisfies plan mode's end-of-turn requirement. If AskUserQuestion is unavailable or a call fails, follow the AskUserQuestion Format failure fallback: `headless` → BLOCKED; `interactive` → the prose fallback (also satisfies end-of-turn). At a STOP point, stop immediately. Do not continue the workflow or call ExitPlanMode there. Commands marked "PLAN MODE EXCEPTION — ALWAYS RUN" execute. Call ExitPlanMode only after the skill workflow completes, or if the user tells you to cancel the skill or leave plan mode. + +If `PROACTIVE` is `"false"`, do not auto-invoke or proactively suggest skills. If a skill seems useful, ask: "I think /skillname might help here — want me to run it?" + +If `SKILL_PREFIX` is `"true"`, suggest/invoke `/gstack-*` names. Disk paths stay `$GSTACK_ROOT/[skill-name]/SKILL.md`. + +If output shows `UPGRADE_AVAILABLE `: read `$GSTACK_ROOT/gstack-upgrade/SKILL.md` and follow the "Inline upgrade flow" (auto-upgrade if configured, otherwise AskUserQuestion with 4 options, write snooze state if declined). + +If output shows `JUST_UPGRADED `: print "Running gstack v{to} (just updated!)". If `SPAWNED_SESSION` is true, skip feature discovery. + +Feature discovery, max one prompt per session: +- Missing `$GSTACK_ROOT/.feature-prompted-continuous-checkpoint`: AskUserQuestion for Continuous checkpoint auto-commits. If accepted, run `$GSTACK_BIN/gstack-config set checkpoint_mode continuous`. Always touch marker. +- Missing `$GSTACK_ROOT/.feature-prompted-model-overlay`: inform "Model overlays are active. MODEL_OVERLAY shows the patch." Always touch marker. + +After upgrade prompts, continue workflow. + +If `WRITING_STYLE_PENDING` is `yes`: ask once about writing style: + +> v[object Object] prompts are simpler: first-use jargon glosses, outcome-framed questions, shorter prose. Keep default or restore terse? + +Options: +- A) Keep the new default (recommended — good writing helps everyone) +- B) Restore V[object Object] prose — set `explain_level: terse` + +If A: leave `explain_level` unset (defaults to `default`). +If B: run `$GSTACK_BIN/gstack-config set explain_level terse`. + +Always run (regardless of choice): +```bash +rm -f ~/.gstack/.writing-style-prompt-pending +touch ~/.gstack/.writing-style-prompted +``` + +Skip if `WRITING_STYLE_PENDING` is `no`. + +If `LAKE_INTRO` is `no`: say "gstack follows the **Boil the Ocean** principle — do the complete thing when AI makes marginal cost near-zero. Read more: https://garryslist.org/posts/boil-the-ocean" Offer to open: + +```bash +open https://garryslist.org/posts/boil-the-ocean +touch ~/.gstack/.completeness-intro-seen +``` + +Only run `open` if yes. Always run `touch`. + +If `TEL_PROMPTED` is `no` AND `LAKE_INTRO` is `yes`: ask telemetry once via AskUserQuestion: + +> Help gstack get better. Share usage data only: skill, duration, crashes, stable device ID. No code or file paths. Your repo name is recorded locally only and stripped before any upload. + +Options: +- A) Help gstack get better! (recommended) +- B) No thanks + +If A: run `$GSTACK_BIN/gstack-config set telemetry community` + +If B: ask follow-up: + +> Anonymous mode sends only aggregate usage, no unique ID. + +Options: +- A) Sure, anonymous is fine +- B) No thanks, fully off + +If B→A: run `$GSTACK_BIN/gstack-config set telemetry anonymous` +If B→B: run `$GSTACK_BIN/gstack-config set telemetry off` + +Always run: +```bash +touch ~/.gstack/.telemetry-prompted +``` + +Skip if `TEL_PROMPTED` is `yes`. + +If `PROACTIVE_PROMPTED` is `no` AND `TEL_PROMPTED` is `yes`: ask once: + +> Let gstack proactively suggest skills, like /qa for "does this work?" or /investigate for bugs? + +Options: +- A) Keep it on (recommended) +- B) Turn it off — I'll type /commands myself + +If A: run `$GSTACK_BIN/gstack-config set proactive true` +If B: run `$GSTACK_BIN/gstack-config set proactive false` + +Always run: +```bash +touch ~/.gstack/.proactive-prompted +``` + +Skip if `PROACTIVE_PROMPTED` is `yes`. + +If `HAS_ROUTING` is `no` AND `ROUTING_DECLINED` is `false` AND `PROACTIVE_PROMPTED` is `yes`: +Check if a CLAUDE.md file exists in the project root. If it does not exist, create it. + +Use AskUserQuestion: + +> gstack works best when your project's CLAUDE.md includes skill routing rules. + +Options: +- A) Add routing rules to CLAUDE.md (recommended) +- B) No thanks, I'll invoke skills manually + +If A: Append this section to the end of CLAUDE.md: + +```markdown + +## Skill routing + +When the user's request matches an available skill, invoke it via the Skill tool. When in doubt, invoke the skill. + +Key routing rules: +- Product ideas/brainstorming → invoke /office-hours +- Strategy/scope → invoke /plan-ceo-review +- Architecture → invoke /plan-eng-review +- Design system/plan review → invoke /design-consultation or /plan-design-review +- Full review pipeline → invoke /autoplan +- Bugs/errors → invoke /investigate +- QA/testing site behavior → invoke /qa or /qa-only +- Code review/diff check → invoke /review +- Visual polish → invoke /design-review +- Ship/deploy/PR → invoke /ship or /land-and-deploy +- Save progress → invoke /context-save +- Resume context → invoke /context-restore +- Author a backlog-ready spec/issue → invoke /spec +``` + +Then commit the change: `git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"` + +If B: run `$GSTACK_BIN/gstack-config set routing_declined true` and say they can re-enable with `gstack-config set routing_declined false`. + +This only happens once per project. Skip if `HAS_ROUTING` is `yes` or `ROUTING_DECLINED` is `true`. + +If `VENDORED_GSTACK` is `yes`, warn once via AskUserQuestion unless `~/.gstack/.vendoring-warned-$SLUG` exists: + +> This project has gstack vendored in `.grok/skills/gstack/`. Vendoring is deprecated. +> Migrate to team mode? + +Options: +- A) Yes, migrate to team mode now +- B) No, I'll handle it myself + +If A: +[object Object]. Run `git rm -r .grok/skills/gstack/` +2. Run `echo '.grok/skills/gstack/' >> .gitignore` +3. Run `$GSTACK_BIN/gstack-team-init required` (or `optional`) +4. Run `git add .claude/ .gitignore CLAUDE.md && git commit -m "chore: migrate gstack from vendored to team mode"` +5. Tell the user: "Done. Each developer now runs: `cd ~/.grok/skills/gstack && ./setup --team`" + +If B: say "OK, you're on your own to keep the vendored copy up to date." + +Always run (regardless of choice): +```bash +eval "$($GSTACK_BIN/gstack-slug 2>/dev/null)" 2>/dev/null || true +touch ~/.gstack/.vendoring-warned-${SLUG:-unknown} +``` + +If marker exists, skip. + +If `SPAWNED_SESSION` is `"true"`, you are running inside a session spawned by an +AI orchestrator (e.g., OpenClaw). In spawned sessions: +- Do NOT use AskUserQuestion for interactive prompts. Auto-choose the recommended option. +- Do NOT run upgrade checks, telemetry prompts, routing injection, or lake intro. +- Focus on completing the task and reporting results via prose output. +- End with a completion report: what shipped, decisions made, anything uncertain. + +## AskUserQuestion Format + +### Tool resolution (read first) + +"AskUserQuestion" can resolve to two tools at runtime: the **host MCP variant** (e.g. `mcp__conductor__AskUserQuestion` — appears in your tool list when the host registers it) or the **native** Claude Code tool. + +**Conductor rule (read before the MCP rule):** if `CONDUCTOR_SESSION: true` was echoed by the preamble, do NOT call AskUserQuestion at all — neither native nor any `mcp__*__AskUserQuestion` variant. Render EVERY decision brief as the **prose form** below and STOP. This is proactive, not a reaction to a failure: Conductor disables native AUQ and its MCP variant is flaky (it returns `[Tool result missing due to internal error]`), so prose is the reliable path. **Auto-decide preferences still apply first:** if a `[plan-tune auto-decide] →