이 스킬을 호출해야 하는 경우
현재 오픈 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"
# 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과 같이 계획 모드(mode) 상태에 따라 동작을 분기하는 스킬을 위한 계획 모드 힌트입니다.
# 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.
계획 모드 중 스킬 호출
사용자가 계획 모드에서 스킬을 호출하면, 스킬이 일반적인 계획 모드 동작보다 우선합니다. 스킬 파일을 참조(reference)가 아닌 실행 가능한 지침으로 취급하십시오. 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를 읽고 "인라인 업그레이드 흐름"을 따르십시오 (구성된 경우 자동 업그레이드, 그렇지 않으면 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 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"라고 말하고 열기 제안:
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! (recommended)
- 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 (recommended)
- 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이면 건너뜁니다.
최초 실행 안내 (일회성)
ACTIVATED가 no (이 머신에서의 첫 번째 스킬 실행)이고 서문에서 비어 있지 않은 FIRST_TASK: 값을 출력했으며 nongit가 아닌 경우: 토큰에서 매핑된 하나의 짧은 프로젝트별 줄을 알림으로 표시한 다음, 사용자가 실제로 요청한 작업을 계속 진행하십시오. 작업을 중단하지 마십시오. 토큰 매핑: greenfield → "Fresh repo — shape it first with /spec or /office-hours." code_node/code_python/code_rust/code_go/code_ruby/code_ios → "There's code here — /qa to see it work, or /investigate if something's off." branch_ahead → "Unshipped work on this branch — /review then /ship." dirty_default → "Uncommitted changes — /review before committing." clean_default → "Pick one: /spec, /investigate, or /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 (headless, git이 아닌 경우 또는 실행 가능한 항목이 없는 경우)인 경우: 아무것도 표시하지 말고 touch ~/.gstack/.activated 2>/dev/null || true만 실행하십시오.
그렇지 않고 ACTIVATED가 yes이고 FIRST_LOOP_SHOWN가 no이면: 알림으로 한 번 말한 후 계속하십시오:
Tip: gstack pays off when you complete one loop — plan → review → ship. A common first loop:
/office-hoursor/specto shape it,/plan-eng-reviewto lock it, then/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 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
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
…