takeoff

name	takeoff
description	항공기 이륙 4단계 — develop 리베이스 → push → PR 생성 (원격 영향)
allowed-tools	Bash, Read, AskUserQuestion, TodoWrite, mcp__linear-server__get_issue, mcp__linear-server__update_issue
argument-hint	<Linear 이슈 ID> [--force]

이륙 시퀀스의 4단계 (Takeoff). develop 위에 리베이스하고 리모트에 push 한 뒤 PR 을 생성한다. 이 단계만 원격에 영향을 준다. 성공하면 임시 상태 파일(.claude/state/<ISSUE>.*) 을 모두 삭제한다.

$ARGUMENTS 형식: <ISSUE-ID> [--force]. 예: /takeoff CIR-15.

인자 파싱

1. --force 분리. 첫 토큰을 <ISSUE> 로.
2. <ISSUE> 없으면 사용법 안내 후 중단.

상태 파일 경로

• MAIN_REPO_ROOT = $(git rev-parse --path-format=absolute --git-common-dir | xargs dirname)
• STATE_FILE = $MAIN_REPO_ROOT/.claude/state/<ISSUE>.json
• ISSUE_FILE = $MAIN_REPO_ROOT/.claude/state/<ISSUE>.issue.md
• PLAN_FILE = $MAIN_REPO_ROOT/.claude/state/<ISSUE>.plan.md

자동 체이닝

상태 파일을 읽어 다음 순서로 실행:

0. STATE_FILE 이 없으면 다른 .claude/state/*.json 을 후보나 캐시로 사용하지 않는다. 사용자가 입력한 <ISSUE> 를 정답으로 보고 /boarding <ISSUE> [--force] 를 먼저 실행한 뒤 STATE_FILE 을 다시 읽는다. 그래도 없으면 boarding 실패로 보고 중단한다.
1. boarding.done_at == null 이거나 --force → /boarding <ISSUE> [--force]. 채워져 있으면 스킵 메시지 한 줄.
2. door_closing.done_at == null 이거나 --force → /door-closing <ISSUE> [--force]. 채워져 있으면 스킵.
3. taxiing.done_at == null 이거나 --force → /taxiing <ISSUE> [--force]. 채워져 있으면 스킵.
4. 본 단계 진행.

자동 체이닝은 본 단계까지만 — landing 은 자동으로 호출하지 않는다.

자기 단계 실행 절차

1. 스킵 판정: takeoff.done_at 이 채워져 있고 --force 가 없으면 종료. (다만 takeoff 성공 후 상태 파일은 삭제되므로 보통 이 케이스는 발생하지 않음.)

2. 워크트리 진입: worktree_path 로 cd. 경로가 없으면 사용자에게 안내 후 중단.

3. 상태 점검: git status 가 깨끗한지 확인. 미커밋 변경이 있으면 사용자에게 알리고 중단.

4. 티켓 상태 동기화: Linear 이슈가 Done/Canceled 가 아니면 상태를 In Progress 로 직접 변경한다.

5. GitHub 인증 확인: gh-auth-check 스킬로 GitHub CLI 로그인 상태와 active account 를 확인한다.

6. develop 리베이스: git fetch origin develop && git rebase origin/develop. 충돌 시 자동 해결 시도하지 말고 사용자에게 위임 후 중단.

7. 푸시:

   • 첫 push: git push -u origin <branch>.
   • 리베이스로 히스토리가 바뀌었고 리모트에 이미 같은 브랜치가 있으면 사용자 승인 후 git push --force-with-lease origin <branch>.
   • develop/main 으로의 직접 푸시는 금지.

8. PR 생성: gh pr create --base develop --head <branch>.

   • 제목: <ISSUE> <type>: <English summary> 예) CIR-15 fix: prevent white screen when adding waitlist entries.

   • 제목과 본문은 반드시 영어로 작성한다. 한국어를 쓰지 않는다.

   • 본문: HEREDOC 으로 다음 형식. 모든 placeholder 내용도 영어로 쓴다.

     ## Summary
     - <goal from plan.md / commit summary in 1-3 lines>
     
     ## Changes
     - <items based on commit log / changed files from plan.md>
     
     ## Test plan
     - [ ] <test strategy item from plan.md>
     
     Closes <ISSUE>
     

9. PR URL 출력: 사용자에게 한 줄로 PR URL 안내.

10. 상태 파일 갱신 후 정리:

• 먼저 takeoff.done_at = <UTC ISO8601> 로 저장 (혹시 정리 단계에서 실패해도 다음 호출이 takeoff 를 다시 돌리지 않도록).
• 이어서 임시 파일 삭제: rm -f $STATE_FILE $ISSUE_FILE $PLAN_FILE.
• 삭제 실패는 경고만 출력하고 PR URL 안내는 유지.

주의사항

• 이 커맨드 외 단계에서 git push / gh pr create 가 실행되어선 안 된다.
• 리베이스 충돌은 사용자에게 위임. 자동 해결 시도 금지.
• force push 는 반드시 사용자 확인 후 --force-with-lease 만 사용. --force 단독 금지.
• develop / main 직접 push 금지.
• PR 제목, PR 본문, 커밋 메시지는 반드시 영어로 작성한다. 한국어를 쓰지 않는다.
• Linear 티켓 상태는 자동화에 위임하지 않고 직접 Todo → In Progress → Done 으로만 처리한다. PR 생성 시 In Review 같은 중간 상태로 바꾸지 않는다.
• PR 머지 후 워크트리 정리는 /landing <ISSUE> 로 별도 진행.