이 스킬을 호출해야 하는 경우
현재 열려 있는 PR이 점유하고 있는 VERSION 슬롯, WIP(작업 진행 중) 상태로 곧 출시될 가능성이 있는 형제 Conductor 워크스페이스, 그리고 다음 /ship이 선택할 슬롯을 보여줍니다. 돌연변이는 없습니다. 단지 스냅샷일 뿐입니다. 사용자가 "landing report", "queue에 뭐가 있나요?", "열린 PR 보여줘", 또는 "다음에 어떤 버전을 claim해야 하나요?"라고 요청할 때 사용하세요.
/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(계획 모드가 활성화된 경우 harness에 의해 설정됨)에서 최선을 다해 감지하고
# "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"이면 스킬을 자동으로 호출하거나 사전에 제안하지 마십시오. 스킬이 유용해 보이면 "도움이 될 것 같습니다 — 실행해 볼까요?"라고 물어보십시오.
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은 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) 끄기 — 직접 /commands를 입력하겠습니다
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은 plan → review → ship 한 루프를 완료할 때 효과를 봅니다. 일반적인 첫 루프는
/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 호출
...(번역을 위해 잘림)