이 스킬을 호출해야 하는 경우
어떤 VERSION 슬롯이 현재 열린 PR에 의해 점유되어 있는지, 어떤 형제 Conductor 워크스페이스에 곧 출시될 WIP 작업이 있는지, 그리고 /ship이 다음에 어떤 슬롯을 선택할지 보여줍니다. 변경은 없습니다. 스냅샷일 뿐입니다. "랜딩 리포트", "큐에 뭐가 있지?", "열린 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 host: AskUserQuestion은 여기서 신뢰할 수 없음(네이티브 비활성화, MCP
# 변형 불안정)이므로 스킬은 도구를 호출하는 대신 결정을 일반 텍스트로 렌더링합니다.
# !headless로 게이트되어 Conductor(GSTACK_HEADLESS) 내부의 평가/CI 실행은
# 텍스트를 아무에게도 렌더링하지 않고 여전히 차단합니다.
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 → 차단됨; interactive → 일반 텍스트 폴백(역시 턴 종료를 충족). STOP 지점에서 즉시 중지하십시오. 워크플로우를 계속하거나 거기서 ExitPlanMode를 호출하지 마십시오. "계획 모드 예외 — 항상 실행"으로 표시된 명령은 실행됩니다. 스킬 워크플로우가 완료된 후에만 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, 거부하면 스누즈 상태 기록).
출력에 JUST_UPGRADED <from> <to>가 표시되면: "gstack v{to} 실행 중 (방금 업데이트됨!)"을 인쇄하십시오. 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_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
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(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
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
…