/landing-report — 버전 큐 대시보드
프리앰블 (먼저 실행)
_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
GSTACK_ROOT="$HOME/.cursor/skills/gstack"
[ -n "$_ROOT" ] && [ -d "$_ROOT/.cursor/skills/gstack" ] && GSTACK_ROOT="$_ROOT/.cursor/skills/gstack"
GSTACK_BIN="$GSTACK_ROOT/bin"
GSTACK_BROWSE="$GSTACK_ROOT/browse/dist"
GSTACK_DESIGN="$GSTACK_ROOT/design/dist"
_UPD=$($GSTACK_BIN/gstack-update-check 2>/dev/null || .cursor/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=$($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=$($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 <($GSTACK_BIN/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_SESSION_KIND=$($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로 게이트되어 eval/CI 실행이 Conductor 내부(GSTACK_HEADLESS)에서 실행될 때
# 아무도 보지 않는 산문을 렌더링하는 대신 여전히 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, 대화형).
# 이후 모든 실행에서 핫 경로(hot path)를 피하기 위함입니다.
_FIRST_TASK=""
if [ "$_ACTIVATED" = "no" ] && [ "$_SESSION_KIND" != "headless" ]; then
_FIRST_TASK=$($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=$($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=$($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=$($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 "$GSTACK_BIN/gstack-telemetry-log" ]; then
$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 "$($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
$GSTACK_BIN/gstack-learnings-search --limit 3 2>/dev/null || true
fi
else
echo "LEARNINGS: 0"
fi
$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=$($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 ".cursor/skills/gstack" ] && [ ! -L ".cursor/skills/gstack" ]; then
if [ -f ".cursor/skills/gstack/VERSION" ] || [ -d ".cursor/skills/gstack/.git" ]; then
_VENDORED="yes"
fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$($GSTACK_BIN/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$($GSTACK_BIN/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
# Plan-mode 행동을 분기하는 /spec과 같은 스킬을 위한 Plan-mode 힌트입니다.
# Claude Code는 시스템 알림을 통해 plan mode를 노출합니다. 우리는
# CLAUDE_PLAN_FILE (harness가 plan mode 활성화 시 설정)에서 최선을 다해 감지하고
# "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
Plan Mode 안전 작업
Plan mode에서 계획에 정보를 제공하므로 허용됨: $B, $D, codex exec/codex review, ~/.gstack/ 쓰기, 계획 파일 쓰기, 생성된 아티팩트를 위한 open.
Plan Mode 중 스킬 호출
사용자가 plan mode에서 스킬을 호출하면, 스킬이 일반적인 plan mode 동작보다 우선합니다. 스킬 파일을 참조가 아닌 실행 가능한 명령어로 취급하십시오. 0단계부터 단계별로 따르십시오. 첫 번째 AskUserQuestion은 워크플로가 plan mode에 진입하는 것이지 위반이 아닙니다. AskUserQuestion (모든 변형 — mcp__*__AskUserQuestion 또는 네이티브; "AskUserQuestion 형식 → 도구 해결" 참조)은 plan mode의 턴 종료 요구 사항을 충족합니다. AskUserQuestion을 사용할 수 없거나 호출이 실패하면 AskUserQuestion 형식 실패 폴백을 따르십시오: headless → BLOCKED; interactive → 산문 폴백 (역시 턴 종료 충족). STOP 지점에서 즉시 중지하십시오. 워크플로를 계속하거나 그곳에서 ExitPlanMode를 호출하지 마십시오. "PLAN MODE EXCEPTION — ALWAYS RUN"으로 표시된 명령은 실행됩니다. 스킬 워크플로가 완료된 후에만 ExitPlanMode를 호출하거나, 사용자가 스킬을 취소하거나 plan mode를 종료하라고 지시한 경우에만 호출하십시오.
PROACTIVE가 "false"인 경우, 스킬을 자동으로 호출하거나 사전에 제안하지 마십시오. 스킬이 유용해 보이면 "해당 작업에 /skillname이 도움이 될 수 있습니다. 실행할까요?"라고 물으십시오.
SKILL_PREFIX가 "true"인 경우, /gstack-* 이름을 제안/호출하십시오. 디스크 경로는 $GSTACK_ROOT/[skill-name]/SKILL.md로 유지됩니다.
출력에 UPGRADE_AVAILABLE <old> <new>가 표시되면: $GSTACK_ROOT/gstack-upgrade/SKILL.md를 읽고 "인라인 업그레이드 흐름"을 따르십시오 (구성된 경우 자동 업그레이드, 그렇지 않으면 4가지 옵션으로 AskUserQuestion, 거절 시 snooze 상태 기록).
출력에 JUST_UPGRADED <from> <to>가 표시되면: "gstack v{to} 실행 중 (방금 업데이트됨!)"을 출력하십시오. SPAWNED_SESSION이 true이면 기능 발견을 건너뛰십시오.
기능 발견, 세션당 최대 한 번 프롬프트:
$GSTACK_ROOT/.feature-prompted-continuous-checkpoint가 없음: Continuous 체크포인트 자동 커밋에 대해 AskUserQuestion합니다. 수락되면$GSTACK_BIN/gstack-config set checkpoint_mode continuous를 실행하십시오. 항상 마커를 터치하십시오.$GSTACK_ROOT/.feature-prompted-model-overlay가 없음: "모델 오버레이가 활성화되어 있습니다. MODEL_OVERLAY가 패치를 보여줍니다."라고 알리십시오. 항상 마커를 터치하십시오.
업그레이드 프롬프트 후 워크플로를 계속하십시오.
WRITING_STYLE_PENDING이 yes인 경우: 작성 스타일에 대해 한 번 묻습니다:
v1 프롬프트는 더 간단합니다: 첫 사용 용어 설명, 결과 기반 질문, 더 짧은 문장. 기본값을 유지하거나 간결하게 되돌리시겠습니까?
옵션:
- A) 새 기본값 유지 (권장 — 좋은 글은 모두에게 도움이 됩니다)
- B) V0 문체 복원 —
explain_level: terse설정
A인 경우: explain_level을 설정하지 않은 상태로 둡니다 (기본값은 default).
B인 경우: $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인 경우: $GSTACK_BIN/gstack-config set telemetry community 실행
B인 경우: 후속 질문:
익명 모드는 집계 사용량만 보내며 고유 ID는 없습니다.
옵션:
- A) 네, 익명이 괜찮습니다
- B) 아니요, 완전히 끕니다
B→A인 경우: $GSTACK_BIN/gstack-config set telemetry anonymous 실행
B→B인 경우: $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인 경우: $GSTACK_BIN/gstack-config set proactive true 실행
B인 경우: $GSTACK_BIN/gstack-config set proactive false 실행
항상 실행:
touch ~/.gstack/.proactive-prompted
PROACTIVE_PROMPTED가 yes이면 건너뛰십시오.
첫 실행 안내 (일회성)
ACTIVATED가 no인 경우 (이 머신에서 첫 번째 스킬 실행) AND 프리앰블에서 비어 있지 않은 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을 대체하고 (최선의 노력으로) 실행한 후 활성화를 표시합니다:
$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 또는 /qa-only 호출
- 코드 리뷰/diff 확인 → /review 호출
- 시각적 개선 → /design-review 호출
- 출시/배포/PR → /ship 또는 /land-and-deploy 호출
- 진행 상황 저장 → /context-save 호출
- 컨텍스트 복원 → /context-restore 호출
- 백로그 준비 사양/이슈 작성 → /spec 호출
그런 다음 변경 사항을 커밋하십시오: git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"
B인 경우: $GSTACK_BIN/gstack-config set routing_declined true를 실행하고 touch ~/.gstack/.routing-declined를 실행하십시오.
건너뛰기: HAS_ROUTING이 yes이거나 ROUTING_DECLINED가 true이거나 PROACTIVE_PROMPTED가 no인 경우.
스킬 본문: /landing-report
$GSTACK_BIN/gstack-landing-report를 실행하십시오. 출력을 표시하십시오. 변이하지 마십시오.
종료
$GSTACK_BIN/gstack-timeline-log '{"skill":"landing-report","event":"finished"}' 2>/dev/null &
_TEL_END=$(date +%s)
_TEL_DURATION=$((_TEL_END - _TEL_START))
$GSTACK_BIN/gstack-telemetry-log --event-type skill_run --skill landing-report --outcome success --duration "$_TEL_DURATION" --session-id "$_SESSION_ID" 2>/dev/null || true
/context-save (저장) 중단
사용자가 /context-save를 중단하라고 하면: $GSTACK_BIN/gstack-config set save_mode abort를 실행하고 GSTACK_SAVE_MODE=abort를 설정하십시오. 이 스킬 호출의 나머지 부분에 대해 가능한 모든 /context-save 호출을 건너뛰십시오.