/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(모든 변형 — mcp__*__AskUserQuestion 또는 네이티브; "AskUserQuestion 형식 → 도구 확인" 참조)은 플랜 모드의 턴 종료 요구 사항을 충족시킵니다. 호출 가능한 변형이 없으면 스킬이 차단(BLOCKED)됩니다 — 중지하고 BLOCKED — AskUserQuestion unavailable을 보고하세요(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가 없음: 지속적인(Continuous) 체크포인트 자동 커밋에 대해 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 호출
- 코드 검토/diff 확인 → /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을 통해 한 번 경고합니다:
이 프로젝트는 gstack이
.claude/skills/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을 사용하지 마세요. 권장 옵션을 자동으로 선택하세요.
- 업그레이드 확인, 텔레메트리 프롬프트, 라우팅 삽입 또는 lake intro를 실행하지 마세요.
- 작업 완료와 산문 출력을 통한 결과 보고에 집중하세요.
- 완료 보고서로 종료: 출시된 사항, 결정된 사항, 불확실한 사항.
AskUserQuestion 형식
도구 확인 (먼저 읽기)
"AskUserQuestion"은 런타임에 두 가지 도구로 확인될 수 있습니다: 호스트 MCP 변형(예: mcp__conductor__AskUserQuestion — 호스트가 등록하면 도구 목록에 나타남) 또는 네이티브 Claude Code 도구.
규칙: mcp__*__AskUserQuestion 변형이 도구 목록에 있으면 이를 선호하세요. 호스트는 --disallowedTools AskUserQuestion을 통해 네이티브 AUQ를 비활성화할 수 있으며(Conductor가 기본적으로 수행), 네이티브를 호출하면 자동으로 실패합니다. 동일한 질문/옵션 형태; 동일한 결정 브리핑 형식이 적용됩니다.
도구 목록에 AskUserQuestion 변형이 없으면 이 스킬은 BLOCKED입니다. 중지하고 BLOCKED — AskUserQuestion unavailable을 보고한 후 사용자를 기다리세요. 결정을 계획 파일에 대체하여 작성하지 말고, 산문으로 내보내고 중지하지 말며, 자동으로 결정하지 마세요(/plan-tune AUTO_DECIDE 옵트인이 자동 선택을 승인하는 경우만 예외).
형식
모든 AskUserQuestion은 결정 브리핑이며 tool_use로 보내야 합니다(산문이 아님).
D<N> — <한 줄 질문 제목>
Project/branch/task: <_BRANCH를 사용한 1개의 짧은 기준 문장>
ELI10: <16세도 이해할 수 있는 평이한 영어, 2-4문장, 중요성을 설명>
Stakes if we pick wrong: <잘못 선택할 경우 무엇이 깨지고, 사용자가 무엇을 보며, 무엇을 잃는지 한 문장>
Recommendation: <선택> because <한 줄 이유>
Completeness: A=X/10, B=Y/10 (또는: Note: options differ in kind, not coverage — no completeness score)
Pros / cons:
A) <옵션 레이블> (권장)
✅ <장점 — 구체적이고 관찰 가능하며 40자 이상>
❌ <단점 — 솔직하게, 40자 이상>
B) <옵션 레이블>
✅ <장점>
❌ <단점>
Net: <실제로 무엇을 절충하고 있는지 한 줄로 요약>
D-번호 매기기: 스킬 호출의 첫 번째 질문은 D1입니다. 스스로 증가시키세요. 이것은 모델 수준의 지침이지, 런타임 카운터가 아닙니다.
ELI10은 항상 존재하며, 평이한 영어로, 함수 이름이 아닙니다. 추천(Recommendation)은 항상 존재합니다. (권장) 레이블을 유지하세요. AUTO_DECIDE가 이에 의존합니다.
완전성(Completeness): Completeness: N/10 사용
… (원문이 잘려서 중략)