mcp__*__AskUserQuestion

## Decisions to confirm

PROACTIVE

"false"

SKILL_PREFIX

"true"

/gstack-*

~/.claude/skills/gstack/[skill-name]/SKILL.md

UPGRADE_AVAILABLE <old> <new>

~/.claude/skills/gstack/gstack-upgrade/SKILL.md

JUST_UPGRADED <from> <to>

SPAWNED_SESSION

• Missing

  ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint

  : AskUserQuestion for Continuous checkpoint auto-commits. If accepted, run

  ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous

  . Always touch marker.
• Missing

  ~/.claude/skills/gstack/.feature-prompted-model-overlay

  : inform "Model overlays are active. MODEL_OVERLAY shows the patch." Always touch marker.

WRITING_STYLE_PENDING

yes

v1 prompts are simpler: first-use jargon glosses, outcome-framed questions, shorter prose. Keep default or restore terse?

• A) Keep the new default (recommended — good writing helps everyone)
• B) Restore V0 prose — set

  explain_level: terse

explain_level

default

~/.claude/skills/gstack/bin/gstack-config set explain_level terse

rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted

WRITING_STYLE_PENDING

no

LAKE_INTRO

no

open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen

open

touch

TEL_PROMPTED

no

LAKE_INTRO

yes

Help gstack get better. Share usage data only: skill, duration, crashes, stable device ID. No code, file paths, or repo names.

• A) Help gstack get better! (recommended)
• B) No thanks

~/.claude/skills/gstack/bin/gstack-config set telemetry community

Anonymous mode sends only aggregate usage, no unique ID.

• A) Sure, anonymous is fine
• B) No thanks, fully off

~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous

~/.claude/skills/gstack/bin/gstack-config set telemetry off

touch ~/.gstack/.telemetry-prompted

TEL_PROMPTED

yes

PROACTIVE_PROMPTED

no

TEL_PROMPTED

yes

Let gstack proactively suggest skills, like /qa for "does this work?" or /investigate for bugs?

• A) Keep it on (recommended)
• B) Turn it off — I'll type /commands myself

~/.claude/skills/gstack/bin/gstack-config set proactive true

~/.claude/skills/gstack/bin/gstack-config set proactive false

touch ~/.gstack/.proactive-prompted

PROACTIVE_PROMPTED

yes

HAS_ROUTING

no

ROUTING_DECLINED

false

PROACTIVE_PROMPTED

yes

gstack works best when your project's CLAUDE.md includes skill routing rules.

• A) Add routing rules to CLAUDE.md (recommended)
• B) No thanks, I'll invoke skills manually

undefined

• 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

Then commit the change: `git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"`

If B: run `~/.claude/skills/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 `.claude/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:
1. Run `git rm -r .claude/skills/gstack/`
2. Run `echo '.claude/skills/gstack/' >> .gitignore`
3. Run `~/.claude/skills/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 ~/.claude/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 "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}

SPAWNED_SESSION

"true"

• 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.

• D<N> header present
• ELI10 paragraph present (stakes line too)
• Recommendation line present with concrete reason
• Completeness scored (coverage) OR kind-note present (kind)
• Every option has ≥2 ✅ and ≥1 ❌, each ≥40 chars (or hard-stop escape)
• (recommended) label on one option (even for neutral-posture)
• Dual-scale effort labels on effort-bearing options (human / CC)
• Net line closes the decision
• You are calling the tool, not writing prose

Remote-MCP mode: local artifacts sync is a no-op (brain admin's server

pulls from GitHub/GitLab). Show the user this is by design, not broken.

Privacy stop-gate: if output shows `ARTIFACTS_SYNC: off`, `artifacts_sync_mode_prompted` is `false`, and gbrain is on PATH or `gbrain doctor --fast --json` works, ask once:

> gstack can publish your artifacts (CEO plans, designs, reports) to a private GitHub repo that GBrain indexes across machines. How much should sync?

Options:
- A) Everything allowlisted (recommended)
- B) Only artifacts
- C) Decline, keep everything local

After answer:

```bash

• Lead with the point. Say what it does, why it matters, and what changes for the builder.
• Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers.
• Tie technical choices to user outcomes: what the real user sees, loses, waits for, or can now do.
• Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path.
• Sound like a builder talking to a builder, not a consultant presenting to a client.
• Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay.
• No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant.
• The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides.

• Gloss curated jargon on first use per skill invocation, even if the user pasted the term.
• Frame questions in outcome terms: what pain is avoided, what capability unlocks, what user experience changes.
• Use short sentences, concrete nouns, active voice.
• Close decisions with user impact: what the user sees, waits for, loses, or gains.
• User-turn override wins: if the current message asks for terse / no explanations / just the answer, skip this section.
• Terse mode (EXPLAIN_LEVEL: terse): no glosses, no outcome-framing layer, shorter responses.

• idempotent
• idempotency
• race condition
• deadlock
• cyclomatic complexity
• N+1
• N+1 query
• backpressure
• memoization
• eventual consistency
• CAP theorem
• CORS
• CSRF
• XSS
• SQL injection
• prompt injection
• DDoS
• rate limit
• throttle
• circuit breaker
• load balancer
• reverse proxy
• SSR
• CSR
• hydration
• tree-shaking
• bundle splitting
• code splitting
• hot reload
• tombstone
• soft delete
• cascade delete
• foreign key
• composite index
• covering index
• OLTP
• OLAP
• sharding
• replication lag
• quorum
• two-phase commit
• saga
• outbox pattern
• inbox pattern
• optimistic locking
• pessimistic locking
• thundering herd
• cache stampede
• bloom filter
• consistent hashing
• virtual DOM
• reconciliation
• closure
• hoisting
• tail call
• GIL
• zero-copy
• mmap
• cold start
• warm start
• green-blue deploy
• canary deploy
• feature flag
• kill switch
• dead letter queue
• fan-out
• fan-in
• debounce
• throttle (UI)
• hydration mismatch
• memory leak
• GC pause
• heap fragmentation
• stack overflow
• null pointer
• dangling pointer
• buffer overflow

REPO_MODE

• solo

  — You own everything. Investigate and offer to fix proactively.

• collaborative

  /

  unknown

  — Flag via AskUserQuestion, don't fix (may be someone else's).

~/.claude/skills/gstack/ETHOS.md

• Layer 1 (tried and true) — don't reinvent. Layer 2 (new and popular) — scrutinize. Layer 3 (first principles) — prize above all.

jq -n --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" --arg skill "SKILL_NAME" --arg branch "$(git branch --show-current 2>/dev/null)" --arg insight "ONE_LINE_SUMMARY" '{ts:$ts,skill:$skill,branch:$branch,insight:$insight}' >> ~/.gstack/analytics/eureka.jsonl 2>/dev/null || true

• DONE — completed with evidence.
• DONE_WITH_CONCERNS — completed, but list concerns.
• BLOCKED — cannot proceed; state blocker and what was tried.
• NEEDS_CONTEXT — missing info; state exactly what is needed.

STATUS

REASON

ATTEMPTED

RECOMMENDATION

git remote get-url origin 2>/dev/null

• If the URL contains "github.com" → platform is GitHub
• If the URL contains "gitlab" → platform is GitLab
• Otherwise, check CLI availability:

  • gh auth status 2>/dev/null

    succeeds → platform is GitHub (covers GitHub Enterprise)

  • glab auth status 2>/dev/null

    succeeds → platform is GitLab (covers self-hosted)
  • Neither → unknown (use git-native commands only)

1. gh pr view --json baseRefName -q .baseRefName

   — if succeeds, use it

2. gh repo view --json defaultBranchRef -q .defaultBranchRef.name

   — if succeeds, use it

1. glab mr view -F json 2>/dev/null

   and extract the

   target_branch

   field — if succeeds, use it

2. glab repo view -F json 2>/dev/null

   and extract the

   default_branch

   field — if succeeds, use it

1. git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's|refs/remotes/origin/||'

2. If that fails:

   git rev-parse --verify origin/main 2>/dev/null

   → use

   main

3. If that fails:

   git rev-parse --verify origin/master 2>/dev/null

   → use

   master

main

git diff

git log

git fetch

git merge

<default>

_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
B=""
[ -n "$_ROOT" ] && [ -x "$_ROOT/.claude/skills/gstack/browse/dist/browse" ] && B="$_ROOT/.claude/skills/gstack/browse/dist/browse"
[ -z "$B" ] && B="$HOME/.claude/skills/gstack/browse/dist/browse"
if [ -x "$B" ]; then
  echo "READY: $B"
else
  echo "NEEDS_SETUP"
fi

NEEDS_SETUP

1. Tell the user: "gstack browse needs a one-time build (~10 seconds). OK to proceed?" Then STOP and wait.
2. Run:

   cd <SKILL_DIR> && ./setup

3. If

   bun

   is not installed:
   bash

   if ! command -v bun >/dev/null 2>&1; then
     BUN_VERSION="1.3.10"
     BUN_INSTALL_SHA="bab8acfb046aac8c72407bdcce903957665d655d7acaa3e11c7c4616beae68dd"
     tmpfile=$(mktemp)
     curl -fsSL "https://bun.sh/install" -o "$tmpfile"
     actual_sha=$(shasum -a 256 "$tmpfile" | awk '{print $1}')
     if [ "$actual_sha" != "$BUN_INSTALL_SHA" ]; then
       echo "ERROR: bun install script checksum mismatch" >&2
       echo "  expected: $BUN_INSTALL_SHA" >&2
       echo "  got:      $actual_sha" >&2
       rm "$tmpfile"; exit 1
     fi
     BUN_VERSION="$BUN_VERSION" bash "$tmpfile"
     rm "$tmpfile"
   fi

1. Zero friction at T0. First five minutes decide everything. One click to start. Hello world without reading docs. No credit card. No demo call.
2. Incremental steps. Never force developers to understand the whole system before getting value from one part. Gentle ramp, not cliff.
3. Learn by doing. Playgrounds, sandboxes, copy-paste code that works in context. Reference docs are necessary but never sufficient.
4. Decide for me, let me override. Opinionated defaults are features. Escape hatches are requirements. Strong opinions, loosely held.
5. Fight uncertainty. Developers need: what to do next, whether it worked, how to fix it when it didn't. Every error = problem + cause + fix.
6. Show code in context. Hello world is a lie. Show real auth, real error handling, real deployment. Solve 100% of the problem.
7. Speed is a feature. Iteration speed is everything. Response times, build times, lines of code to accomplish a task, concepts to learn.
8. Create magical moments. What would feel like magic? Stripe's instant API response. Vercel's push-to-deploy. Find yours and make it the first thing developers experience.

1. Chef-for-chefs — Your users build products for a living. The bar is higher because they notice everything.
2. First five minutes obsession — New dev arrives. Clock starts. Can they hello-world without docs, sales, or credit card?
3. Error message empathy — Every error is pain. Does it identify the problem, explain the cause, show the fix, link to docs?
4. Escape hatch awareness — Every default needs an override. No escape hatch = no trust = no adoption at scale.
5. Journey wholeness — DX is discover → evaluate → install → hello world → integrate → debug → upgrade → scale → migrate. Every gap = a lost dev.
6. Context switching cost — Every time a dev leaves your tool (docs, dashboard, error lookup), you lose them for 10-20 minutes.
7. Upgrade fear — Will this break my production app? Clear changelogs, migration guides, codemods, deprecation warnings. Upgrades should be boring.
8. SDK completeness — If devs write their own HTTP wrapper, you failed. If the SDK works in 4 of 5 languages, the fifth community hates you.
9. Pit of Success — "We want customers to simply fall into winning practices" (Rico Mariani). Make the right thing easy, the wrong thing hard.
10. Progressive disclosure — Simple case is production-ready, not a toy. Complex case uses the same API. SwiftUI: `Button("Save") { save() }` → full customization, same API.

1. Read CLAUDE.md for project URL, docs URL, CLI install command
2. Read README.md for getting started instructions
3. Read package.json or equivalent for install commands

• CLI: Run

  --help

  via bash. Evaluate output quality, flag design, discoverability.
• API playground: Navigate via browse if one exists. Screenshot.
• Naming: Check consistency across the API surface.

• Browse: Navigate to 404 pages, submit invalid forms, try unauthenticated access
• CLI: Run with missing args, invalid flags, bad input

• Check search functionality (try 3 common queries)
• Verify code examples are copy-paste-complete
• Check language switcher behavior
• Check information architecture (can you find what you need in <2 min?)

• CHANGELOG quality (clear? user-facing? migration notes?)
• Migration guides (exist? step-by-step?)
• Deprecation warnings in code (grep for deprecated/obsolete)

• README setup instructions (steps? prerequisites? platform coverage?)
• CI/CD configuration (exists? documented?)
• TypeScript types (if applicable)
• Test utilities / fixtures

• Community links (GitHub Discussions, Discord, Stack Overflow)
• GitHub issues (response time, templates, labels)
• Contributing guide

• Bug report templates
• NPS or feedback widgets
• Analytics on docs

~/.claude/skills/gstack/bin/gstack-review-read

review

plan-eng-review

adversarial-review

codex-review

plan-design-review

design-review-lite

codex-plan-review

plan-eng-review

via:"autoplan"

review

via:"ship"

via

autoplan-voices

design-outside-voices

+====================================================================+
|                    REVIEW READINESS DASHBOARD                       |
+====================================================================+
| Review          | Runs | Last Run            | Status    | Required |
|-----------------|------|---------------------|-----------|----------|
| Eng Review      |  1   | 2026-03-16 15:00    | CLEAR     | YES      |
| CEO Review      |  0   | —                   | —         | no       |
| Design Review   |  0   | —                   | —         | no       |
| Adversarial     |  0   | —                   | —         | no       |
| Outside Voice   |  0   | —                   | —         | no       |
+--------------------------------------------------------------------+
| VERDICT: CLEARED — Eng Review passed                                |
+====================================================================+

• Eng Review (required by default): The only review that gates shipping. Covers architecture, code quality, tests, performance. Can be disabled globally with `gstack-config set skip_eng_review true` (the "don't bother me" setting).
• CEO Review (optional): Use your judgment. Recommend it for big product/business changes, new user-facing features, or scope decisions. Skip for bug fixes, refactors, infra, and cleanup.
• Design Review (optional): Use your judgment. Recommend it for UI/UX changes. Skip for backend-only, infra, or prompt-only changes.
• Adversarial Review (automatic): Always-on for every review. Every diff gets both Claude adversarial subagent and Codex adversarial challenge. Large diffs (200+ lines) additionally get Codex structured review with P1 gate. No configuration needed.
• Outside Voice (optional): Independent plan review from a different AI model. Offered after all review sections complete in /plan-ceo-review and /plan-eng-review. Falls back to Claude subagent if Codex is unavailable. Never gates shipping.

• CLEARED: Eng Review has >= 1 entry within 7 days from either `review` or `plan-eng-review` with status "clean" (or `skip_eng_review` is `true`)
• NOT CLEARED: Eng Review missing, stale (>7 days), or has open issues
• CEO, Design, and Codex reviews are shown for context but never block shipping
• If `skip_eng_review` config is `true`, Eng Review shows "SKIPPED (global)" and verdict is CLEARED

• Parse the `---HEAD---` section from the bash output to get the current HEAD commit hash
• For each review entry that has a `commit` field: compare it against the current HEAD. If different, count elapsed commits: `git rev-list --count STORED_COMMIT..HEAD`. Display: "Note: {skill} review from {date} may be stale — {N} commits since review"
• For entries without a `commit` field (legacy entries): display "Note: {skill} review from {date} has no commit tracking — consider re-running for accurate staleness detection"
• If all reviews match the current HEAD, do not display any staleness notes

1. Check if there is an active plan file in this conversation (the host provides plan file paths in system messages — look for plan file references in the conversation context).
2. If not found, skip this section silently — not every review runs in plan mode.

• plan-ceo-review: `status`, `unresolved`, `critical_gaps`, `mode`, `scope_proposed`, `scope_accepted`, `scope_deferred`, `commit` → Findings: "{scope_proposed} proposals, {scope_accepted} accepted, {scope_deferred} deferred" → If scope fields are 0 or missing (HOLD/REDUCTION mode): "mode: {mode}, {critical_gaps} critical gaps"
• plan-eng-review: `status`, `unresolved`, `critical_gaps`, `issues_found`, `mode`, `commit` → Findings: "{issues_found} issues, {critical_gaps} critical gaps"
• plan-design-review: `status`, `initial_score`, `overall_score`, `unresolved`, `decisions_made`, `commit` → Findings: "score: {initial_score}/10 → {overall_score}/10, {decisions_made} decisions"
• plan-devex-review: `status`, `initial_score`, `overall_score`, `product_type`, `tthw_current`, `tthw_target`, `mode`, `persona`, `competitive_tier`, `unresolved`, `commit` → Findings: "score: {initial_score}/10 → {overall_score}/10, TTHW: {tthw_current} → {tthw_target}"
• devex-review: `status`, `overall_score`, `product_type`, `tthw_measured`, `dimensions_tested`, `dimensions_inferred`, `boomerang`, `commit` → Findings: "score: {overall_score}/10, TTHW: {tthw_measured}, {dimensions_tested} tested/{dimensions_inferred} inferred"
• codex-review: `status`, `gate`, `findings`, `findings_fixed` → Findings: "{findings} findings, {findings_fixed}/{findings} fixed"

• CODEX: (only if codex-review ran) — one-line summary of codex fixes
• CROSS-MODEL: (only if both Claude and Codex reviews exist) — overlap analysis
• UNRESOLVED: total unresolved decisions across all reviews
• VERDICT: list reviews that are CLEAR (e.g., "CEO + ENG CLEARED — ready to implement"). If Eng Review is not CLEAR and not skipped globally, append "eng review required".

1. Read the plan file (Read tool) to see its full current content. Search the read output for a `## GSTACK REVIEW REPORT` heading anywhere in the file.
2. If found, use the Edit tool to DELETE the entire existing section. Match from `## GSTACK REVIEW REPORT` through either the next `## ` heading or end of file, whichever comes first. Replace with the empty string. This applies regardless of where the section currently lives — mid-file deletion is intentional, not a special case. If the Edit fails (e.g., concurrent edit changed the content), re-read the plan file and retry once.
3. After the delete (or skipped, if no section existed), append the new `## GSTACK REVIEW REPORT` section at the END of the file. Use the Edit tool to match the file's current last paragraph and add the section after it, or use Write to re-emit the whole file with the section at the end.
4. Verify with the Read tool that `## GSTACK REVIEW REPORT` is the last `## ` heading in the file before continuing. If it isn't, repeat steps 2-3 once.