TigerKit
TigerKit(tk, plugin namespace /tk:*)은 sealed GAP → Launch → Reflect 흐름과 steering replacement /tk:next, continuation handoff, generalized meta-feedback으로 AI-induced source loss를 줄입니다. GitHub PR/commit은 선택 capability이며, plain workspace에서도 workflow 작성·실행·회고가 가능해야 합니다.
공개 실행 표면은 Claude Code plugin command입니다. 별도 repo-local skill 파일 없이 commands/*.md와 .claude-plugin/plugin.json이 /tk:* contract를 소유합니다.
v8 MVP scope는 Claude Code command 기능 안정화입니다. Hermes Agent, Codex CLI, npx skills 기반 command-skill adapter는 사전조사 대상이지만 현재 release artifact로 제공하지 않습니다. 특히 Hermes에서 /gap, /launch, /reflect 같은 native slash command를 제공하려면 .hermes/plugins/<name>/plugin.yaml과 ctx.register_command() 기반 plugin adapter가 별도로 필요하며, 이 PR 범위에는 포함하지 않습니다.
해당 workflow를 명시한 natural language request는 대응하는 /tk:* command contract로 처리합니다.
Installation
Claude Code에서 TigerKit marketplace를 등록한 뒤 tk plugin을 설치합니다.
claude plugin marketplace add MTGVim/tiger-kit
claude plugin install tk@tiger-kit --scope user
설치 여부와 사용 가능한 명령을 확인합니다.
claude plugin list --available --json
claude plugin details tk
프로젝트 단위로만 설치하려면 설치 명령의 scope를 project로 바꿉니다.
claude plugin install tk@tiger-kit --scope project
설치 후 Claude Code를 다시 시작하고 /tk:gap, /tk:launch, /tk:reflect, /tk:next, /tk:handoff, /tk:meta-feedback 명령을 사용합니다. v8 MVP에서 source intake와 spec normalization은 /tk:gap이 담당하므로 /tk:spec은 공개 command surface에서 제거되었습니다.
Command Surface
| Command | 역할 | 저장 성격 |
|---|
/tk:gap | 즉석 지시, 브레인스토밍, 회의 메모, URL, ticket, 기존 branch-local Spec Patch를 source material로 intake하고, source를 ground하고 ambiguity를 attack한 뒤 launch 가능한 sealed workflow를 만들거나 GAP_BLOCKED로 중단합니다. | branch-local |
/tk:gap --review | v7 Contract-based Gap Review compatibility mode로 조치 필요 항목과 확인 필요 항목를 report.md와 run.json에 남깁니다. | branch-local |
/tk:launch | sealed workflow만 tk-runner subagent로 실행하고 검증, 중단 receipt, runtime harness, reflect trace를 남깁니다. | branch-local execution |
/tk:reflect | gap+launch trace와 branch-local working memory에서 repo에 영구 보존할 insight만 rubric으로 선별하고 durable target에 반영한 뒤 기본적으로 meta-feedback을 함께 제출합니다. | durable insight |
/tk:next | 현재 TigerKit 상태와 workspace/repo context를 읽고 다음 안전 실행 항목 하나를 실제로 이어서 시도하며 receipt를 남깁니다. | branch/workspace-local continuation execution |
/tk:handoff | 다음 세션이나 다음 작업자가 이어받을 continuation 문서와 pending follow-up queue를 작성합니다. | continuation |
/tk:meta-feedback | 세션 내역에서 TigerKit command/skill 개선안을 일반화해 추출합니다. | generalized feedback |
Core Model
gap = source intake + source grounding + ambiguity attack + sealed launch workflow 생성
launch = sealed workflow 실행 + verification + abort/reflect receipt
reflect = gap+launch trace와 branch-local working memory에서 repo에 영구 보존할 insight만 추출/반영
next = continuation state를 읽고 다음 안전 작업을 실제로 이어서 시도
handoff = 다음 세션/작업자용 continuation context
meta-feedback = 세션 내 TigerKit 개선 피드백 일반화
gap과 canonical handoff 산출물은 .claude/tigerkit/branches/<branch-key>/ 아래의 branch-local generated working memory입니다. 기존 branch-local Spec Patch가 있으면 /tk:gap의 source material로 읽을 수 있지만, v8 MVP는 /tk:spec command를 노출하지 않습니다. /tk:handoff는 경로 미지정 resume을 위해 .claude/tigerkit/global-index.json에 최신 handoff pointer도 기록합니다. repo-wide durable knowledge가 아닙니다.
/tk:gap 기본 실행은 git/GitHub가 없는 workspace에서도 GAP_READY 또는 GAP_BLOCKED로 끝날 수 있습니다. GAP_READY에는 task별 assumed_preconditions, 봉인 전 readonly_preflight 결과, sealed tigerkit-launch-workflow가 포함되어야 하고, GAP_BLOCKED에는 unresolved decision/conflict/missing source/preflight failure 때문에 workflow block을 포함하지 않습니다. v7 review behavior는 /tk:gap --review에서 유지합니다.
GitHub remote, git branch, commit 가능 여부는 launch preflight capability로 기록하며 prerequisite가 아닙니다. commit/PR이 불가능해도 workflow가 commit/PR을 요구하지 않으면 /tk:launch는 Commit: skipped_not_git_repo 같은 명시 skip reason으로 성공할 수 있습니다. Git worktree context는 Superpowers-style SessionStart read-only hook이 세션 시작 시 한 번 점검하고, base/source worktree에만 있는 root-level Markdown과 .claude/ 후보를 additionalContext로 proposal-only 제안합니다. /tk:gap은 이 context를 source grounding에 포함하고, /tk:launch와 /tk:next는 command마다 같은 후보를 다시 묻지 않습니다. 사용자가 거절한 동일 candidate signature는 .claude/tigerkit/local/session-start/worktree-context-declines.json로 suppress합니다.
/tk:next는 primary execution pipeline을 대체하지 않는 steering replacement continuation command입니다. 현재 TigerKit artifact와 workspace 상태를 읽어 handoff/trace의 다음 안전 작업을 실제로 이어서 시도하고, commit/push/PR/merge/release/deploy/GitHub issue write 같은 외부 side effect는 사용자 승인 또는 artifact상의 명시 approval 없이는 수행하지 않습니다.
reflect는 durable insight를 Frequency, Cost, Risk, Stability, Coverage rubric으로 평가하고 apply=true일 때 CLAUDE.md 또는 .claude/rules/**/*.md에 직접 반영합니다. 반영할 durable insight가 없으면 파일을 수정하지 않는 것도 정상 성공입니다. reflect 처리 직후 /tk:meta-feedback을 proposal-only로 제출하며, --no-meta-feedback 또는 --meta-feedback=false로 생략할 수 있습니다.
Operational Docs
