hang-in

tunaFlow Architect가 Developer subagent 또는 다른 Claude 세션에 일감을 넘길 때 쓰는 핸드오프 문서를 작성한다. 한 plan을 1~3개의 정확한 PR로 쪼개고, DO/DO NOT/Verification/CI 정책/보고 포맷을 명시해 다른 세션이 가정 없이 그대로 따라갈 수 있게 만든다. tunaFlow에서 일하면서 "developer 핸드오프", "Plan 의 Task 를 누군가에게 넘기자", "Developer subagent 에게 dispatch 할 프롬프트", "이 작업을 다른 세션에서 진행할 수 있게 정리", "PR 분리 전략 + 회귀 가드 명시" 같은 의도가 보이면 반드시 이 스킬을 사용한다. 외부 사용자 issue 대응 시에도 plan 작성 후 곧바로 핸드오프로 이어지므로 함께 트리거한다.

tunaFlow Architect가 작업 영역을 plan 문서로 형식화한다. 외부 사용자 issue 분석, 회귀 진단, 새 feature 설계, 리팩토링 묶음 — 모두 docs/plans/<slug>Plan_YYYY-MM-DD.md로 떨어진다. tunaFlow 작업 중 "plan 작성하자", "이슈 분석해서 plan으로 정리", "회귀 root cause 분해해서 task로 쪼개자", "구현 전 invariant + non-goals 명시", "이 작업을 어떻게 진행할지 문서화", "여러 PR로 분리될 작업의 그림 그리기" 같은 의도가 보이면 반드시 이 스킬을 사용한다. Plan 이 있어야 그 다음 단계인 developer 핸드오프로 이어지므로, plan 미존재 상태에서 갑자기 코드 수정으로 가지 말고 먼저 이 스킬을 거친다.

tunaFlow의 새 버전을 publish하는 11단계 사이클을 실행한다. CHANGELOG 갱신 → 3곳 version bump → tag → build watch → release notes → publish → external issue 회복 안내 댓글 → issue close 까지 한 흐름. tunaFlow 작업 중 "릴리즈 하자", "v0.X.Y-beta 발행", "다음 patch release", "이번 fix들 묶어서 publish", "issue 회복 안내", "release tag 만들기" 같은 의도가 보이면 반드시 이 스킬을 사용한다. 단계 순서가 어긋나거나 누락되면 자산이 stale 한 release 가 되거나 사용자가 fix 적용 사실을 모르므로 정확히 따른다.

gemento 의 새 실험 디렉토리 (`experiments/expNN_<slug>/`) 와 `run.py` 보일러플레이트를 *직전 Exp 의 run.py 패턴 그대로* 복제 후 condition / hook 만 변경하여 만든다. Sonnet (Developer) 가 plan 의 task-03 (`exp## run.py`) 진행 시 사용. 사용자가 "Exp## scaffold", "run.py 작성", "experiment 디렉토리 생성", "Stage 2A/2B/2C 패턴 복사" 등을 언급할 때 트리거. **임의 단순화 금지** — Stage 2A healthcheck/abort + Stage 2B FailureLabel + Stage 2C cycle-by-cycle tattoo_history fix + 결과 JSON meta v1.0 보일러플레이트를 보존한다.

gemento 프로젝트의 새 plan 문서 (parent + N subtask) 와 Sonnet 진행 프롬프트를 일관된 frontmatter / 명명 규칙 / 의존성 다이어그램과 함께 작성하고 docs/plans/index.md 의 Active 섹션에 등록한다. Architect 가 새 실험 / 인프라 / 리팩토링 plan 을 만들 때 사용. "plan 작성", "Stage N 시작", "Exp## plan", "subtask 분할" 등을 사용자가 언급할 때 적극 트리거. plan 의 frontmatter (type=plan/plan-task, parent_plan, parallel_group, depends_on, slug) 와 명명 규칙 (camelCase 또는 kebab-case 일관) 과 index.md 등록 누락을 자동으로 강제한다.

gemento 실험 마감 후 가설 verdict (H##) 를 researchNotebook.md (한국어) + researchNotebook.en.md (영문 Closed-append-only) + docs/plans/index.md 에 일관되게 기록한다. 실험 분석이 끝나서 H## 의 verdict 를 노트북에 반영해야 할 때, "verdict 기록", "노트북 갱신", "Exp## 마감", "H## 채택/조건부/미결/기각" 등을 사용자가 언급할 때 사용한다. 영문 파일의 append-only 정책을 자동으로 강제한다 — 기존 entry/표/문장 절대 수정 금지. 한국어 파일은 표 갱신 + 새 섹션 append + 축 매트릭스 갱신을 함께 처리한다.

Delegate suitable coding subtasks to a local/cloud LLM (Ollama / Ollama Cloud / LM Studio) via tunaLlama, like an architect delegating to a subagent. The local LLM has a smaller context window than Claude, so before delegating non-trivial work fetch relevant project context (state.md + past calls) and prepend it. Maintain oversight by reviewing the returned output.

Prepare and ship a Tunapi release. Use when asked to cut a release, bump release versions, update changelog/spec/readme, tag v<major.minor.patch>, or trigger the GitHub release workflow.