이 기술을 호출해야 하는 경우
현재 열려 있는 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 (GSTACK_HEADLESS) 내의 eval/CI 실행은
# 아무도 없는 곳에 산문을 렌더링하지 않고 여전히 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로 끝나며, 이는 안전한 기본값입니다 (기본적으로 file+execute 파이프라인).
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"이면, 스킬을 자동으로 호출하거나 사전에 제안하지 마십시오. 스킬이 유용해 보이면, "해당 상황에 /skillname이 도움이 될 것 같습니다 — 실행하시겠습니까?" 라고 물어보십시오.
SKILL_PREFIX가 "true"이면, /gstack-* 이름을 제안/호출하십시오. 디스크 경로는 ~/.claude/skills/gstack/[skill-name]/SKILL.md로 유지됩니다.
출력에 UPGRADE_AVAILABLE <old> <new>가 표시되면: ~/.claude/skills/gstack/gstack-upgrade/SKILL.md를 읽고 "인라인 업그레이드 흐름"을 따르십시오 (구성된 경우 자동 업그레이드, 그렇지 않으면 4가지 옵션이 있는 AskUserQuestion, 거절하면 snooze 상태를 기록).
출력에 JUST_UPGRADED <from> <to>가 표시되면: "gstack v{to} 실행 중 (방금 업데이트됨!)"을 출력하십시오. SPAWNED_SESSION이 true이면, 기능 발견을 건너뛰십시오.
기능 발견, 세션당 최대 하나의 프롬프트:
~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint가 없음: Continuous checkpoint 자동 커밋에 대해 AskUserQuestion하십시오. 수락되면~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous를 실행하십시오. 항상 마커를 터치하십시오.~/.claude/skills/gstack/.feature-prompted-model-overlay가 없음: "모델 오버레이가 활성화되었습니다. MODEL_OVERLAY가 패치를 보여줍니다."라고 알리십시오. 항상 마커를 터치하십시오.
업그레이드 프롬프트 후, 워크플로를 계속하십시오.
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
yes인 경우에만 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 (headless, 비-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
사용자의 요청이 사용 가능한 스킬과 일치하면, Skill 도구를 통해 호출하십시오. 확실하지 않으면 스킬을 호출하십시오.
주요 라우팅 규칙:
- 제품 아이디어/브레인스토밍 → /office-hours 호출
- 전략/범위 → /plan-ceo-review 호출
- 아키텍처 → /plan-eng-review 호출
- 디자인 시스템/계획 검토 → /design-consultation 또는 /plan-design-review 호출
- 전체 검토 파이프라인 → /autoplan 호출
- 버그/오류 → /investigate 호출
- QA/"이거 작동하나요?" → /qa 호출
- 계획 및 범위 지정 → /spec 호출
- 코드 검토 → /review 호출
- 출시/병합 → /ship 호출
- 문제 조사 → /investigate 호출
- PR 설명 생성 → /desc 호출
- 커밋 설명 생성 → /commit 호출
- 테스트 생성 → /test 호출
- 문서 생성 → /doc 호출
- 리팩터링/정리 → /spring-cleaning 호출
- 성능 문제 → /perf 호출
- 보안 검토 → /security-review 호출
- 종속성 업데이트 → /dep-review 호출
- 온보딩/아키텍처 질문 → /office-hours 호출
- 아키텍처 검토 → /plan-eng-review 호출
- 디자인 검토 → /design-consultation 호출
B의 경우: ~/.claude/skills/gstack/bin/gstack-config set routing_declined true를 실행하고 touch ~/.gstack/.activated 2>/dev/null || true를 실행하십시오.
HAS_ROUTING이 yes이거나 ROUTING_DECLINED가 true이면 이 섹션을 건너뛰십시오.