서문 (먼저 실행)
_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":"gstack","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":"gstack","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. 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>가 표시되면: "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가 활성화되었습니다. 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) 끄기. 직접 /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이면 건너뛰세요.
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을 통해 한 번 경고:
이 프로젝트에는
.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을 사용하지 마세요. 권장 옵션을 자동으로 선택하세요. - 업그레이드 확인, 텔레메트리 프롬프트, 라우팅 삽입, lake 소개를 실행하지 마세요.
- 작업 완료에 집중하고 산문 출력을 통해 결과를 보고하세요.
- 완료 보고서로 종료: 배송된 항목, 결정 사항, 불확실한 사항.
아티팩트 동기화 (스킬 시작)
_GSTACK_HOME="${GSTACK_HOME:-$HOME/.gstack}"
# Prefer the v1.27.0.0 artifacts file; fall back to brain file for users
# upgrading mid-stream before the migration script runs.
if [ -f "$HOME/.gstack-artifacts-remote.txt" ]; then
_BRAIN_REMOTE_FILE="$HOME/.gstack-artifacts-remote.txt"
else
_BRAIN_REMOTE_FILE="$HOME/.gstack-brain-remote.txt"
fi
_BRAIN_SYNC_BIN="~/.claude/skills/gstack/bin/gstack-brain-sync"
_BRAIN_CONFIG_BIN="~/.claude/skills/gstack/bin/gstack-config"
# /sync-gbrain context-load: teach the agent to use gbrain when it's available.
# Per-worktree pin: post-spike redesign uses kubectl-style `.gbrain-source` in the
# git toplevel to scope queries. Look for the pin in the worktree (not a global
# state file) so that opening worktree B without a pin doesn't claim "indexed"
# just because worktree A was synced. Empty string when gbrain is not
# configured (zero context cost for non-gbrain users).
_GBRAIN_CONFIG="$HOME/.gbrain/config.json"
if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_VERSION_OK=$(gbrain --version 2>/dev/null | grep -c '^gbrain ' || echo 0)
if [ "$_GBRAIN_VERSION_OK" -gt 0 ] 2>/dev/null; then
_GBRAIN_PIN_PATH=""
_REPO_TOP=$(git rev-parse --show-toplevel 2>/dev/null || echo "")
if [ -n "$_REPO_TOP" ] && [ -f "$_REPO_TOP/.gbrain-source" ]; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
echo "Falls back to Grep until pinned."
fi
fi
fi
_BRAIN_SYNC_MODE=$("$_BRAIN_CONFIG_BIN" get artifacts_syn
…
[translation truncated]