deep-slice

name	deep-slice
description	Use when the user wants slice-level management inside a deep-work Phase 3 (Implement) session — status dashboard, manual activation, spike mode entry, reset, or per-slice model override. Triggers on `/deep-slice`, "slice status", "spike mode", "slice reset", "슬라이스 상태", "스파이크 모드". Primary escape hatch for TDD-blocked scenarios (phase-guard surfaces `/deep-slice spike|reset` in block messages). Subcommands: `activate SLICE-NNN`, `spike SLICE-NNN`, `reset SLICE-NNN`, `model SLICE-NNN [model]`.
user-invocable	true

Invocation

이 스킬은 두 가지 경로로 호출됩니다 — 어느 쪽이든 본 SKILL 본문의 절차를 그대로 실행합니다:

1. Claude Code 슬래시 — 사용자가 /deep-slice [args...] 입력 (skill 의 user-invocable: true 가 슬래시 진입을 허용).
2. 타 에이전트 / Codex / Copilot CLI / Gemini CLI / SDK — Skill({ skill: "deep-work:deep-slice", args: "..." }) 형태로 명시 invoke (cross-platform 표준 경로).

두 경로 모두 args 는 동일한 토큰 문자열로 전달되며, 본문 ($ARGUMENTS 자리) 의 파서가 동일하게 처리합니다.

Inputs (skill args)

인자	의미
(없음)	Slice status dashboard
activate SLICE-NNN	특정 slice 수동 활성화
spike SLICE-NNN	Spike mode 진입 (TDD 강제 해제)
reset SLICE-NNN	PENDING 으로 리셋 (spike 코드는 git stash 보관)
model SLICE-NNN [model]	`haiku

빈 args / 매칭되지 않는 토큰 → 본문의 default 분기로 진입.

Prerequisites

이 entry skill 은 deep-work-orchestrator (Phase dispatch) 및 deep-work-workflow (reference skill — Phase 규약/Exit Gate/M3 envelope) 와 함께 동작합니다. 활성 deep-work 세션이 있을 때는 세션 state file (.claude/deep-work.<SESSION_ID>.md) 의 변수 (work_dir, current_phase, active_slice 등) 를 읽어 동작하며, 세션 외부에서도 standalone 실행이 가능한 경우 본문의 분기를 따릅니다.

Cross-platform self-containment: Claude Code 에서는 sibling skill 이 description 매칭으로 자동 로드됩니다. Codex / Copilot CLI / Gemini CLI / Agent SDK 에서 Skill() 로 호출 시 sibling auto-load 보장이 약할 수 있으므로, 본문은 self-contained 으로 보존되어 있습니다 — state file 해석, $ARGUMENTS 파싱, AskUserQuestion 분기, 출력 포맷이 인라인.

Escape hatch utility (v6.2.4) — TDD 블록 시 phase-guard가 안내하는 수동 slice 개입 경로 (spike, reset, model). /deep-implement auto-flow가 정상 동작할 때는 대부분 자동 관리됩니다. 참조처: hooks/scripts/phase-guard-core.js L110-L123 (TDD 블록 메시지에서 /deep-slice spike/reset 안내).

Slice Management (v4.0)

Manage slices within a Deep Work implementation session.

Language

Detect the user's language from their messages or the Claude Code language setting. Output ALL user-facing messages in the detected language.

Usage

• /deep-slice — Show slice status dashboard
• /deep-slice activate SLICE-NNN — Manually activate a specific slice
• /deep-slice spike SLICE-NNN — Enter spike mode for a specific slice
• /deep-slice reset SLICE-NNN — Reset a slice to PENDING
• /deep-slice model SLICE-NNN [model] — Override model for a specific slice (v4.1)

Slice Status Dashboard

Resolve the current session's state file:

1. If DEEP_WORK_SESSION_ID env var is set → .claude/deep-work.${DEEP_WORK_SESSION_ID}.md
2. If .claude/deep-work-current-session pointer file exists → read session ID → .claude/deep-work.${SESSION_ID}.md
3. Legacy fallback → .claude/deep-work.local.md

Set $STATE_FILE to the resolved path.

Read $STATE_FILE and $WORK_DIR/plan.md to display:

Slice Status Dashboard

SLICE-001 [GREEN] ██████ tests:5/5 spec:3/3 contract:4/4 receipt:✅
SLICE-002 [RED]   ███░░░ tests:2/5 spec:1/3 contract:1/3 receipt:⏳
SLICE-003 [PEND]  ░░░░░░ tests:0/3 spec:0/2 contract:0/2 receipt:—
SLICE-004 [SPIKE] ▓▓▓▓░░ tests:—   spec:—   contract:—   receipt:⚠️

진행률: 1/4 완료 | Active: SLICE-002
TDD 모드: strict | 디버깅: 0회

For each slice, read the receipt JSON from $WORK_DIR/receipts/SLICE-NNN.json to get:

• TDD state (PENDING/RED/RED_VERIFIED/GREEN_ELIGIBLE/GREEN/REFACTOR/SPIKE)
• Sensor state (SENSOR_RUN/SENSOR_FIX/SENSOR_CLEAN — displayed if sensor infrastructure active)
• Test pass count (from verification output)
• Spec checklist completion
• Contract compliance (passed/total items from contract_compliance field)
• Receipt status (✅ complete, ⏳ in_progress, ⚠️ spike, — pending)

TDD state icon mapping:

[PEND]    — not started
[RED]     — failing test written
[RED_V]   — red verified
[G_ELG]   — green eligible
[GREEN]   — tests passing
[REFACT]  — refactoring
[SPIKE]   — spike mode
[S_CLEAN] — sensors passed
[S_RUN]   — sensors running
[S_FIX]   — fixing sensor errors

Activate Command

/deep-slice activate SLICE-NNN:

1. Verify the target slice exists in plan.md
2. Verify it's not already completed (- [x])
3. Update state file:
   • active_slice: SLICE-NNN
   • tdd_state: PENDING (reset for new slice)
4. Display:

   SLICE-NNN 활성화: [Goal]
      파일: [file1, file2]
      이전 활성 slice: [previous or none]
   
   Contract ([acceptance_threshold]):
     ✅ [contract item 1]
     ✅ [contract item 2]
     ⬜ [contract item 3 — not yet verified]
   

Spike Command

/deep-slice spike SLICE-NNN:

1. Set the slice's TDD state to SPIKE
2. Update state: tdd_state: SPIKE
3. Display:

   SLICE-NNN spike 모드 진입
      TDD 강제가 해제되었습니다. 자유롭게 코딩하세요.
      ⚠️ spike 코드는 merge 대상이 아닙니다.
      종료 시 /deep-slice reset SLICE-NNN 으로 TDD로 복귀하세요.
   

Model Override Command (v4.1)

/deep-slice model SLICE-NNN [model]:

1. Validate model name: must be one of haiku, sonnet, opus, main, auto
2. If invalid, display: ⚠️ 유효하지 않은 모델: [model]. 사용 가능: haiku, sonnet, opus, main, auto
3. Store override in state file: model_overrides.SLICE-NNN: [model]
4. Display:

   SLICE-NNN 모델 override: [model]
      다음 실행 시 이 모델이 사용됩니다.
      해제: /deep-slice model SLICE-NNN auto
   

Reset Command

/deep-slice reset SLICE-NNN:

1. If slice was in SPIKE mode:
   • Stash current changes: git stash push -m "spike: SLICE-NNN"
   • Reset slice status to unchecked in plan.md
2. Update state:
   • tdd_state: PENDING
   • active_slice: SLICE-NNN
3. Reset receipt to initial state
4. Display:

   SLICE-NNN 리셋
      TDD 상태: PENDING (처음부터 시작)
      spike 코드: git stash에 보관됨