이 스킬을 호출해야 하는 경우
현재 열린 PR이 어떤 VERSION 슬롯을 점유하고 있는지, 어떤 동기 Conductor 워크스페이스가 곧 출시될 WIP 작업을 가지고 있는지, 그리고 /ship이 다음에 어떤 슬롯을 선택할지 보여줍니다. 변이(mutation)는 없으며 단지 스냅샷만 제공합니다. "상태 보고", "대기열 현황", "열린 PR 보기", "다음에 청구할 버전" 등의 요청 시 사용하세요.
/landing-report — 버전 대기열 대시보드
전제 (먼저 실행)
_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"
_SESSION_KIND=$(~/.claude/skills/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"
_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":"'$(_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 "~/.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":"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"
# 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 모드 안전 작업
Plan 모드에서는 계획 수립에 도움이 되므로 다음 작업이 허용됩니다: $B, $D, codex exec/codex review, ~/.gstack/에 쓰기, 계획 파일에 쓰기, 생성된 아티팩트에 대한 open.
Plan 모드 중 스킬 호출
사용자가 plan 모드에서 스킬을 호출하면, 해당 스킬이 일반적인 plan 모드 동작보다 우선합니다. 스킬 파일을 참조가 아닌 실행 가능한 명령어로 취급하세요. 0단계부터 단계별로 따르십시오; 첫 번째 AskUserQuestion은 워크플로가 plan 모드로 진입하는 것이지, 이를 위반하는 것이 아닙니다. AskUserQuestion (모든 변형 — mcp__*__AskUserQuestion 또는 네이티브; "AskUserQuestion 형식 → 도구 확인" 참조)은 plan 모드의 종료 시 요구사항을 충족시킵니다. AskUserQuestion을 사용할 수 없거나 호출이 실패하면, AskUserQuestion 형식 실패 대체(fallback)를 따르십시오: headless → BLOCKED; interactive → 산문 대체 (종료 시 요구사항도 충족). STOP 지점에서 즉시 중지하십시오. 워크플로를 계속하거나 ExitPlanMode를 호출하지 마십시오. "PLAN MODE EXCEPTION — ALWAYS RUN"으로 표시된 명령은 실행됩니다. ExitPlanMode는 스킬 워크플로가 완료된 후에만 호출하거나, 사용자가 스킬 취소 또는 plan 모드 종료를 요청한 경우에만 호출하십시오.
PROACTIVE가 "false"인 경우, 스킬을 자동 호출하거나 사전에 제안하지 마십시오. 스킬이 유용해 보이면 "I think /skillname might help here — want me to run it?"이라고 물어보십시오.
SKILL_PREFIX가 "true"인 경우, /gstack-* 이름을 제안/호출하십시오. 디스크 경로는 ~/.claude/skills/gstack/[skill-name]/SKILL.md로 유지됩니다.
출력에 UPGRADE_AVAILABLE <old> <new>가 표시되면: ~/.claude/skills/gstack/gstack-upgrade/SKILL.md를 읽고 "인라인 업그레이드 흐름"을 따르십시오 (구성된 경우 자동 업그레이드, 그렇지 않으면 4가지 옵션으로 AskUserQuestion, 거절 시 스누즈 상태 기록).
출력에 JUST_UPGRADED <from> <to>가 표시되면: "Running gstack v{to} (just updated!)"를 출력하십시오. SPAWNED_SESSION이 true인 경우 기능 발견을 건너뛰십시오.
기능 발견, 세션당 최대 한 번 프롬프트:
~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint가 없는 경우: Continuous 체크포인트 자동 커밋에 대해 AskUserQuestion. 수락되면~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous를 실행. 항상 마커를 터치.~/.claude/skills/gstack/.feature-prompted-model-overlay가 없는 경우: "Model overlays are active. MODEL_OVERLAY shows the patch."라고 알림. 항상 마커를 터치.
업그레이드 프롬프트 후 워크플로를 계속하십시오.
WRITING_STYLE_PENDING이 yes인 경우: 작성 스타일에 대해 한 번 물어보십시오:
v1 prompts are simpler: first-use jargon glosses, outcome-framed questions, shorter prose. Keep default or restore terse?
옵션:
- A) 새로운 기본값 유지 (권장 — 좋은 작성은 모두에게 도움이 됩니다)
- B) V0 산문 복원 —
explain_level: terse설정
A를 선택하면: explain_level을 설정하지 않은 상태로 둡니다 (기본값: default).
B를 선택하면: ~/.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인 경우: "gstack은 Boil the Ocean 원칙을 따릅니다 — AI가 한계 비용을 거의 0으로 만들 때 완전한 작업을 수행합니다. 더 읽기: https://garryslist.org/posts/boil-the-ocean"라고 말하고 열겠냐고 물어보십시오:
open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen
open은 '예'인 경우에만 실행합니다. touch는 항상 실행합니다.
TEL_PROMPTED가 no이고 LAKE_INTRO가 yes인 경우: 텔레메트리에 대해 한 번 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.
옵션:
- A) Help gstack get better! (권장)
- B) No thanks
A를 선택하면: ~/.claude/skills/gstack/bin/gstack-config set telemetry community 실행
B를 선택하면 후속 질문:
Anonymous mode sends only aggregate usage, no unique ID.
옵션:
- A) Sure, anonymous is fine
- B) No thanks, fully off
B→A를 선택하면: ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous 실행
B→B를 선택하면: ~/.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 (권장)
- B) Turn it off — I'll type /commands myself
A를 선택하면: ~/.claude/skills/gstack/bin/gstack-config set proactive true 실행
B를 선택하면: ~/.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인 경우:
프로젝트 루트에 CLAUDE.md 파일이 있는지 확인합니다. 없으면 생성합니다.
AskUserQuestion 사용:
gstack works best when your project's CLAUDE.md includes skill routing rules.
옵션:
- A) Add routing rules to CLAUDE.md (권장)
- B) No thanks, I'll invoke skills manually
A를 선택하면: CLAUDE.md 끝에 다음 섹션을 추가합니다:
## 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
그런 다음 변경 사항을 커밋합니다: git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"
B를 선택하면: ~/.claude/skills/gstack/bin/gstack-config set routing_declined true를 실행하고 gstack-config set routing_declined false로 다시 활성화할 수 있다고 말합니다.
이는 프로젝트당 한 번만 발생합니다. HAS_ROUTING이 yes이거나 ROUTING_DECLINED가 true인 경우 건너뜁니다.
VENDORED_GSTACK이 yes인 경우, ~/.gstack/.vendoring-warned-$SLUG가 없으면 AskUserQuestion을 통해 한 번 경고:
This project has gstack vendored in
.claude/skills/gstack/. Vendoring is deprecated. Migrate to team mode?
옵션:
- A) Yes, migrate to team mode now
- B) No, I'll handle it myself
A를 선택하면:
git rm -r .claude/skills/gstack/실행echo '.claude/skills/gstack/' >> .gitignore실행~/.claude/skills/gstack/bin/gstack-team-init required(또는optional) 실행git add .claude/ .gitignore CLAUDE.md && git commit -m "chore: migrate gstack from vendored to team mode"실행- 사용자에게 알림: "Done. Each developer now runs:
cd ~/.claude/skills/gstack && ./setup --team"
B를 선택하면: "OK, you're on your own to keep the vendored copy up to date."라고 말합니다.
항상 실행 (선택과 관계 없이):
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}
마커가 존재하면 건너뜁니다.
SPAWNED_SESSION이 "true"인 경우, AI 오케스트레이터(예: OpenClaw)에 의해 생성된 세션 내에서 실행 중입니다. 생성된 세션에서는:
- 대화형 프롬프트에 AskUserQuestion을 사용하지 마십시오. 권장 옵션을 자동으로 선택하십시오.
- 업그레이드 확인, 텔레메트리 프롬프트, 라우팅 주입, lake 소개를 실행하지 마십시오.
- 작업 완료에 집중하고 산문 출력을 통해 결과를 보고하십시오.
- 완료 보고서로 마무리: 무엇이 출시되었는지, 어떤 결정이 내려졌는지, 불확실한 사항.
AskUserQuestion 형식
도구 확인 (먼저 읽기)
"AskUserQuestion"은 런타임에 두 가지 도구로 확인될 수 있습니다: 호스트 MCP 변형 (예: mcp__conductor__AskUserQuestion — 호스트가 등록할 때 도구 목록에 나타남) 또는 네이티브 Claude Code 도구.
규칙: mcp__*__AskUserQuestion 변형 중 하나라도 도구 목록에 있으면 우선 사용하십시오. 호스트는 --disallowedTools AskUserQuestion (Conductor는 기본적으로 이렇게 함)을 통해 네이티브 AUQ를 비활성화하고 해당 MCP 변형으로 라우팅할 수 있습니다; 네이티브를 호출하면 자동으로 실패합니다. 동일한 질문/옵션 형태; 동일한 결정 요약 형식.
질문 없음 작업 (headless/자동)
생성된/headless 세션에서 AUQ를 사용할 수 없는 경우:
- 가능한 경우 권장 옵션을 자동화하고 작업을 계속합니다.
- 필요한 경우 완료 보고서에서 선택 사항을 언급합니다.
대체 (실패 시)
모든 AskUserQuestion 시도는 대체를 정의할 수 있습니다. MCP 호출이 실패하거나 네이티브가 비활성화된 경우:
headless(SpawnedSession, OpenClaw) → BLOCKED라고 말하고 정지합니다.interactive→ 의사 결정이 필요함을 산문으로 설명하고 다음 단계를 설명합니다. (종료 시 요구사항 충족. STOP 없음.)