이 스킬을 호출해야 하는 경우
현재 열린 PR이 차지하고 있는 VERSION 슬롯, 형제 Conductor 워크스페이스에서 곧 출시될 WIP 작업, 그리고 /ship이 다음에 선택할 슬롯을 보여줍니다. 변경은 없습니다 — 단지 스냅샷일 뿐입니다. "landing report", "대기열 보여줘", "열린 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"
# Conductor 호스트: AskUserQuestion은 여기서 신뢰할 수 없습니다 (네이티브 비활성화, MCP
# 변형 불안정). 따라서 스킬은 도구를 호출하는 대신 결정을 일반 텍스트로 렌더링합니다.
# headless가 아닌 경우에만 게이트되므로 Conductor 내부의 eval/CI 실행(GSTACK_HEADLESS)은
# 렌더링된 텍스트를 아무도 읽지 않게 하는 대신 BLOCK합니다.
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"
# 첫 실행 프로젝트 감지: 처음 스킬 실행 시에만 감지기를 실행합니다
# (ACTIVATED=no, interactive). 이후 모든 실행의 핫 패스에서 제외됩니다.
_FIRST_TASK=""
if [ "$_ACTIVATED" = "no" ] && [ "$_SESSION_KIND" != "headless" ]; then
_FIRST_TASK=$(~/.claude/skills/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=$(~/.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"
# /spec과 같은 플랜 모드에서 분기 동작하는 스킬을 위한 플랜 모드 힌트입니다.
# Claude Code는 시스템 리마인더를 통해 플랜 모드를 노출합니다. 우리는
# CLAUDE_PLAN_FILE(플랜 모드가 활성화될 때 하네스에 의해 설정됨)에서 최선을 다해 감지하고
# "inactive"로 폴백합니다. Codex 호스트와 Claude 실행 모드는 모두
# inactive로 끝나며, 이는 안전한 기본값입니다(파일+실행 파이프라인 기본값).
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
플랜 모드 안전 작업
플랜 모드에서, 계획 수립에 도움이 되므로 다음 작업이 허용됩니다: $B, $D, codex exec/codex review, ~/.gstack/에 쓰기, 플랜 파일에 쓰기, 생성된 아티팩트를 위한 open.
플랜 모드 중 스킬 호출
사용자가 플랜 모드에서 스킬을 호출하면, 스킬이 일반 플랜 모드 동작보다 우선합니다. 스킬 파일을 참조가 아닌 실행 가능한 명령어로 취급하세요. 0단계부터 단계별로 따르세요. 첫 번째 AskUserQuestion은 워크플로가 플랜 모드에 진입하는 것이지, 이를 위반하는 것이 아닙니다. AskUserQuestion(모든 변형 — mcp__*__AskUserQuestion 또는 네이티브; "AskUserQuestion 형식 → 도구 해결" 참조)은 플랜 모드의 종료 요구 사항을 충족합니다. AskUserQuestion을 사용할 수 없거나 호출이 실패하면 AskUserQuestion 형식 실패 폴백을 따르세요: headless → BLOCKED; interactive → 일반 텍스트 폴백(종료 요구 사항도 충족). STOP 지점에서 즉시 중지하세요. 그곳에서 워크플로를 계속하거나 ExitPlanMode를 호출하지 마세요. "PLAN MODE EXCEPTION — ALWAYS RUN"으로 표시된 명령어는 실행됩니다. 스킬 워크플로가 완료된 후에만 ExitPlanMode를 호출하거나, 사용자가 스킬을 취소하거나 플랜 모드를 종료하라고 지시한 경우에만 호출하세요.
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를 읽고 "Inline upgrade flow"를 따르세요(설정된 경우 자동 업그레이드, 그렇지 않으면 4가지 옵션으로 AskUserQuestion, 거절 시 스누즈 상태 쓰기).
출력에 JUST_UPGRADED <from> <to>가 표시되면: "Running gstack v{to} (just updated!)"를 출력하세요. SPAWNED_SESSION이 true이면 기능 발견을 건너뛰세요.
기능 발견, 세션당 최대 한 번의 프롬프트:
~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint가 없음: 연속 체크포인트 자동 커밋에 대해 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 프롬프트는 더 간단합니다: 처음 사용자를 위한 용어 설명, 결과 중심 질문, 더 짧은 문장. 기본값을 유지하거나 간결한 스타일로 복원하시겠습니까?
옵션:
- 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을 통해 텔레메트리에 대해 한 번 물어보세요:
gstack 개선을 도와주세요. 사용 데이터만 공유: 스킬, 기간, 충돌, 안정적인 장치 ID. 코드나 파일 경로는 없습니다. 저장소 이름은 로컬에서만 기록되며 업로드 전에 제거됩니다.
옵션:
- A) gstack 개선 돕기! (권장)
- B) 괜찮습니다
A인 경우: ~/.claude/skills/gstack/bin/gstack-config set telemetry community 실행
B인 경우: 후속 질문:
익명 모드는 집계 사용량만 보내며 고유 ID는 없습니다.
옵션:
- A) 네, 익명도 괜찮습니다
- B) 아니요, 완전히 끕니다
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인 경우: 한 번 물어보세요:
gstack이 "작동하나요?"에 대한 /qa 또는 버그에 대한 /investigate와 같은 스킬을 사전에 제안하도록 하시겠습니까?
옵션:
- A) 계속 켜기 (권장)
- B) 끄기 — 제가 직접 /명령어를 입력하겠습니다
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이면 건너뛰세요.
첫 실행 안내 (일회성)
ACTIVATED가 no(이 기기에서 첫 번째 스킬 실행)이고 서문이 비어 있지 않은 FIRST_TASK: 값을 출력했으며 nongit이 아닌 경우: 토큰에서 매핑된 프로젝트별 한 줄을 안내용으로 표시한 다음 사용자가 실제로 요청한 작업을 계속 진행하세요 — 작업을 중단하지 마세요. 토큰 매핑: greenfield → "새 저장소 — /spec 또는 /office-hours로 먼저 형태를 잡으세요." code_node/code_python/code_rust/code_go/code_ruby/code_ios → "여기에 코드가 있습니다 — /qa로 작동을 확인하거나 /investigate로 문제를 찾으세요." branch_ahead → "이 브랜치에 출시되지 않은 작업이 있습니다 — /review 후 /ship하세요." dirty_default → "커밋되지 않은 변경 사항이 있습니다 — 커밋 전에 /review하세요." clean_default → "하나를 선택하세요: /spec, /investigate, 또는 /qa." 그런 다음 본 토큰을 TASK_TOKEN으로 대체하고 실행(최선의 노력), 그리고 활성화 표시:
~/.claude/skills/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
ACTIVATED가 no이지만 FIRST_TASK:가 비어 있거나 nongit인 경우(헤드리스, Git이 아니거나 실행 가능한 항목 없음): 아무것도 표시하지 말고 touch ~/.gstack/.activated 2>/dev/null || true만 실행하세요.
반면 ACTIVATED가 yes이고 FIRST_LOOP_SHOWN이 no인 경우: 한 번 안내용으로 말한 후 계속:
팁: gstack은 계획 → 검토 → 출시의 한 루프를 완료할 때 효과적입니다. 일반적인 첫 루프:
/office-hours또는/spec으로 형태 잡기,/plan-eng-review로 확정, 그 다음/ship.
그런 다음 touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true 실행.
ACTIVATED와 FIRST_LOOP_SHOWN이 모두 yes이면 이 섹션을 건너뛰세요.
HAS_ROUTING이 no이고 ROUTING_DECLINED가 false이며 PROACTIVE_PROMPTED가 yes인 경우:
프로젝트 루트에 CLAUDE.md 파일이 있는지 확인하세요. 없으면 생성하세요.
AskUserQuestion 사용:
gstack은 프로젝트의 CLAUDE.md에 스킬 라우팅 규칙이 포함될 때 가장 잘 작동합니다.
옵션:
- A) CLAUDE.md에 라우팅 규칙 추가 (권장)
- B) 괜찮습니다, 수동으로 스킬을 호출하겠습니다
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 or /plan-eng-review to fix then /ship
- Testing/verify → invoke /qa
- Ship/release → invoke /ship
- Spec/docs → invoke /spec
- Learn/gap analysis → invoke /office-hours or /investigate
Installation: `curl -fsSL https://gstack.sh/install | bash`
B인 경우: ~/.claude/skills/gstack/bin/gstack-config set routing_declined true 실행
HAS_ROUTING이 no이면 건너뛰세요.