/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"
_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":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "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"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true
플랜 모드 안전 작업
플랜 모드에서는 계획을 수립하는 데 도움이 되므로 다음 작업이 허용됩니다: $B, $D, codex exec/codex review, ~/.gstack/에 쓰기, 계획 파일에 쓰기, 생성된 아티팩트에 대한 open.
플랜 모드 중 스킬 호출
사용자가 플랜 모드에서 스킬을 호출하면 스킬이 일반적인 플랜 모드 동작보다 우선합니다. 스킬 파일을 참조가 아닌 실행 가능한 지침으로 취급하세요. 0단계부터 단계별로 따르세요. 첫 번째 AskUserQuestion은 워크플로우가 플랜 모드로 진입하는 것이지, 이를 위반하는 것이 아닙니다. AskUserQuestion은 플랜 모드의 턴 종료 요구 사항을 충족합니다. 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, 거절 시 스누즈 상태 기록).
출력에 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 Lake 원칙을 따릅니다 — 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이면 건너뛰세요.
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 또는 /qa-only 호출
- 코드 리뷰/차이점 확인 → /review 호출
- 시각적 다듬기 → /design-review 호출
- 출시/배포/PR → /ship 또는 /land-and-deploy 호출
- 진행 상황 저장 → /context-save 호출
- 컨텍스트 복원 → /context-restore 호출
그런 다음 변경 사항을 커밋하세요: git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"
B 선택 시: ~/.claude/skills/gstack/bin/gstack-config set routing_declined true를 실행하고 gstack-config set routing_declined false로 다시 활성화할 수 있다고 알리세요.
이 작업은 프로젝트당 한 번만 발생합니다. HAS_ROUTING이 yes이거나 ROUTING_DECLINED가 true이면 건너뛰세요.
VENDORED_GSTACK이 yes인 경우, ~/.gstack/.vendoring-warned-$SLUG가 존재하지 않으면 AskUserQuestion을 통해 한 번 경고하세요.
이 프로젝트는
.claude/skills/gstack/에 gstack이 벤더링되어 있습니다. 벤더링은 더 이상 사용되지 않습니다. 팀 모드로 마이그레이션하시겠습니까?
옵션:
- A) 예, 지금 팀 모드로 마이그레이션합니다
- B) 아니요, 직접 처리하겠습니다
A 선택 시:
git rm -r .claude/skills/gstack/실행echo '.claude/skills/gstack/' >> .gitignore실행~/.claude/skills/gstack/bin/gstack-team-init required(또는optional) 실행git add .claude/ .gitignore CLAUDE.md && git commit -m "chore: migrate gstack from vendored to team mode"실행- 사용자에게 "완료되었습니다. 각 개발자는 다음을 실행하세요:
cd ~/.claude/skills/gstack && ./setup --team"라고 알리세요.
B 선택 시: "알겠습니다. 벤더링된 복사본을 최신 상태로 유지하는 것은 사용자의 책임입니다."라고 말하세요.
항상 실행 (선택과 관계없이):
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}
마커가 있으면 건너뛰세요.
SPAWNED_SESSION이 "true"이면 AI 오케스트레이터(예: OpenClaw)에 의해 생성된 세션 내에서 실행 중입니다. 생성된 세션에서는:
- 대화형 프롬프트에 AskUserQuestion을 사용하지 마세요. 권장 옵션을 자동으로 선택하세요.
- 업그레이드 확인, 텔레메트리 프롬프트, 라우팅 삽입 또는 호수 소개를 실행하지 마세요.
- 작업 완료에 집중하고 산문 출력을 통해 결과를 보고하세요.
- 완료 보고서로 종료하세요: 무엇이 출시되었는지, 결정된 사항, 불확실한 점.
AskUserQuestion 형식
모든 AskUserQuestion은 결정 브리핑이며 tool_use로 전송되어야 하며 산문이 아니어야 합니다.
D<N> — <한 줄 질문 제목>
프로젝트/브랜치/작업: <_BRANCH를 사용한 1개의 짧은 설명 문장>
ELI10: <16세도 이해할 수 있는 평이한 영어, 2-4문장, 중요성 명시>
잘못 선택할 경우의 위험: <무엇이 잘못되는지, 사용자가 보게 될 것, 손실되는 것에 대한 한 문장>
권장 사항: <선택> 왜냐하면 <한 줄 이유>
완전성: A=X/10, B=Y/10 (또는: 참고: 옵션은 종류가 다르며 범위가 아닙니다 — 완전성 점수 없음)
장점 / 단점:
A) <옵션 레이블> (권장)
✅ <장점 — 구체적이고 관찰 가능하며, ≥40자>
❌ <단점 — 솔직하게, ≥40자>
B) <옵션 레이블>
✅ <장점>
❌ <단점>
요약: <실제로 무엇을 절충하고 있는지에 대한 한 줄 종합>
D-번호 매기기: 스킬 호출의 첫 번째 질문은 D1입니다. 직접 번호를 증가시키세요. 이는 모델 수준의 명령이며 런타임 카운터가 아닙니다.
ELI10은 항상 존재하며, 함수 이름이 아닌 평이한 영어로 작성하세요. 권장 사항은 항상 존재합니다. (recommended) 레이블을 유지하세요. AUTO_DECIDE는 이에 의존합니다.
완전성: 옵션이 적용 범위에서 다를 때만 Completeness: N/10을 사용하세요. 10 = 완전함, 7 = 해피 패스, 3 = 지름길. 옵션이 종류가 다른 경우 Note: options differ in kind, not coverage — no completeness score.라고 작성하세요.
장점/단점: ✅와 ❌를 사용하세요. 실제 선택이 있는 경우 옵션당 최소 2개의 장점과 1개의 단점, 항목당 최소 40자. 단방향/파괴적 확인을 위한 하드 스톱 이스케이프: ✅ No cons — this is a hard-stop choice.
중립 자세: Recommendation: <default> — this is a taste call, no strong preference either way; (recommended)는 AUTO_DECIDE를 위해 기본 옵션에 유지됩니다.
노력 양쪽 척도: 옵션에 노력이 포함된 경우 인간 팀과 CC+gstack 시간을 모두 레이블로 지정하세요(예: (human: ~2 days / CC: ~15 min)). 결정 시 AI 압축을 표시합니다.
요약 라인은 트레이드오프를 마무리합니다. 스킬별 지침은 더 엄격한 규칙을 추가할 수 있습니다.
내보내기 전 자체 점검
AskUserQuestion을 호출하기 전에 확인하세요:
- D 헤더가 있음
- ELI10 단락이 있음 (중요성 문장도 포함)
- 구체적인 이유가 있는 권장 사항 줄이 있음
- 완전성 점수 있음 (범위) 또는 종류 참고 있음 (종류)
- 모든 옵션에 ≥2개의 ✅와 ≥1개의 ❌가 있으며, 각각 ≥40자임 (또는 하드 스톱 이스케이프)