| name | handoff |
| description | Export an approved Build Gate brief to the downstream coding ecosystem you actually use — Spec-Kit (specs/NNN-slug/{spec,plan,tasks}.md), Kiro (.kiro/specs/<slug>/{requirements,design,tasks}.md), GStack (/office-hours brief), or Claude Code (AGENTS.md + CLAUDE.md). Use when Evidence + Product + Build Gate have all been approved and you're ready to start implementation in your coding agent of choice. |
| argument-hint | [brief.json] [--target spec-kit|kiro|gstack|claude|all] |
| allowed-tools | ["Read","Write","Bash"] |
| model | inherit |
Handoff — Build Gate → Downstream Coding Ecosystem
Running for: $ARGUMENTS
Core Goal
- hplan은 단독 도구가 아니라 전처리기. Build Gate가 통과하면 결과물을 spec-kit / kiro / gstack / claude code 어느 곳으로든 export.
- 단일 brief JSON → 4개 생태계 동시 export 가능 (
--target all).
- 각 생태계의 네이티브 컨벤션 (spec-kit의
specs/NNN-slug/, Kiro의 .kiro/specs/) 그대로 따름.
Trigger Gate
Use This Skill When
- Evidence + Product + Build Gate 모두 approved
- COGS sentinel GREEN 또는 CONDITIONAL_GO with mitigations
- 사용자가 명시적으로 "이제 Spec-Kit으로 가자" / "Kiro에서 구현" / "GStack /office-hours로"
- 팀 전체 onboarding — AGENTS.md + CLAUDE.md를 새 repo에 박을 때
Route to Other Skills When
- Build Gate 미통과 → 거꾸로 가서
cogs-sentinel, decision-log 확인
- Export 후 spec-kit/kiro 안에서의 개별 task 분해 → 각 생태계 native tool
- Export 후 PRD shape 정교화 →
deliver/prd
Boundary Checks
- ❌
hooks/gate_guard.py가 활성화된 프로젝트에서 Build Gate 미승인 → handoff 호출 차단 (의도된 동작).
- ❌ 단일 target만 지정해도 다른 target은 영향 받지 않음 (idempotent per target).
Inputs
python3 hplan/scripts/export_handoff.py brief.json --target all --root .
{
"product_name": "SocialDraft",
"problem": "1인 마케터가 SNS 게시글당 30-45분을 쓰는데 캠페인 데드라인을 자주 놓친다",
"icp": "주 10건+ SNS 콘텐츠 직접 작성하는 1인 마케터 (현재 범용 AI 챗봇 수동 사용)",
"jtbd": "When 미팅 끝나자마자, I want 액션 + 메일, so I can 같은 날 답신",
"functional_requirements": [...],
"acceptance_criteria": [...],
"cogs_ceiling": "$2.70/paid user/month",
"latency_budget": "p95 < 90초",
"counter_position": "범용 AI 챗봇은 단발성 답변, SocialDraft는 브랜드 톤 학습 + 5개 동시 생성",
"not_build": ["일반 음성 받아쓰기", "CRM first-class"],
"mvp_slice": "Zoom 종료 → 1분 안에 액션 + 메일",
"decision": "build"
}
Steps
- Confirm Build Gate decision is
build or CONDITIONAL_GO in decision-log.
- Confirm
cogs-sentinel result is GREEN (or CONDITIONAL_GO with mitigations).
- Run
export_handoff.py <brief.json> --target <target>.
- Verify generated files at
harness/exports/<target>/.
- Copy or symlink to actual project directory (spec-kit at repo root, kiro at
.kiro/, etc.).
Outputs
| Target | Path |
|---|
| spec-kit | harness/exports/spec-kit/specs/NNN-slug/{spec,plan,tasks}.md |
| kiro | harness/exports/kiro/.kiro/specs/<slug>/{requirements,design,tasks}.md |
| gstack | harness/exports/gstack/office-hours-brief.md |
| claude | harness/exports/claude/AGENTS.md + CLAUDE.md |
Verification
