작업 마무리

개요

구현이 끝나면 깔끔하게 마무리하세요.

마무리 없이 끝내면:

• 변경사항이 흩어짐

• 다음에 어디까지 했는지 모름

• 불필요한 파일이 남음

• 배운 것이 사라짐

시작할 때 알림: "wrap 스킬을 사용하여 작업을 마무리하겠습니다."

┌──────────────────────────────────────────────────────────────────────┐ │ Wrap 워크플로우 (Enhanced) │ └──────────────────────────────────────────────────────────────────────┘

┌─────────────────┐ │ 구현 완료 │ └────────┬────────┘ │ ▼ ┌─────────────────┐ │ 1. 테스트 확인 │ npm test / pytest └────────┬────────┘ │ ┌─────┴─────┐ │ │ ▼ ▼ ┌──────┐ ┌──────┐ │ PASS │ │ FAIL │──▶ 테스트 먼저 수정! └──┬───┘ └──────┘ │ ▼ ┌─────────────────┐ │ 2. 상태 확인 │ git status / branch └────────┬────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 3. 세션 인사이트 추출 │ │ ┌──────────────────────────────────────────────────────────┐ │ │ │ Phase 1: 병렬 분석 │ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ │ │ doc-updater │ │ automation- │ │ learning- │ │ │ │ │ │ │ │ scout │ │ extractor │ │ │ │ │ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │ │ │ │ │ │ │ │ │ │ │ └────────────────┼────────────────┘ │ │ │ │ ▼ │ │ │ │ Phase 2: 순차 검증 │ │ │ │ ┌────────────────────────────────┐ │ │ │ │ │ duplicate-checker │ │ │ │ │ └────────────────┬───────────────┘ │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ ┌────────────────────────────────┐ │ │ │ │ │ followup-suggester │ │ │ │ │ └────────────────────────────────┘ │ │ │ └──────────────────────────────────────────────────────────┘ │ └────────────────────────┬────────────────────────────────────────┘ │ ▼ ┌─────────────────┐ │ 4. 옵션 선택 │ └────────┬────────┘ │ ┌────────┼────────┬────────┐ │ │ │ │ ▼ ▼ ▼ ▼ ┌────┐ ┌────┐ ┌────┐ ┌────┐ │ 1 │ │ 2 │ │ 3 │ │ 4 │ │로컬│ │ PR │ │유지│ │삭제│ │머지│ │생성│ │ │ │ │ └─┬──┘ └─┬──┘ └─┬──┘ └─┬──┘ │ │ │ │ ▼ ▼ │ ▼ ┌─────┐ ┌─────┐ │ ┌─────┐ │main │ │push │ │ │확인 │ │머지 │ │+PR │ │ │후 │ │ │ │ │ │ │삭제 │ └──┬──┘ └──┬──┘ │ └──┬──┘ │ │ │ │ └───────┴──────┴───────┘ │ ▼ ┌─────────────────┐ │ 5. Worktree │ (사용했다면) │ 정리 │ └────────┬────────┘ │ ▼ ┌─────────────────┐ │ 완료! 🎉 │ └─────────────────┘

═══════════════════════════════════════════════════════════════════ 옵션 1: 로컬 머지 → merge + branch 삭제 + worktree 정리 옵션 2: PR 생성 → push + gh pr create + worktree 정리 옵션 3: 유지 → 그대로 (나중에 처리) 옵션 4: 삭제 → 확인 후 강제 삭제 ═══════════════════════════════════════════════════════════════════

전문 에이전트 (2-Phase Pipeline)

세션 인사이트 추출을 위해 5개의 전문 에이전트가 협력합니다.

Phase 1: 병렬 분석 (동시 실행)

에이전트 역할 모델

doc-updater CLAUDE.md, context.md, decision-record 업데이트 분석 sonnet

automation-scout 반복 작업을 skill/command/agent로 자동화할 기회 탐지 sonnet

learning-extractor 세션에서 배운 것, 실수, 새 발견 추출 sonnet

Phase 2: 순차 검증

에이전트 역할 모델

duplicate-checker Phase 1 제안의 중복 여부 검증 haiku

followup-suggester 미완성 작업, 개선 포인트, 다음 세션 작업 정리 opus

에이전트 실행 방법

Phase 1: 병렬 실행 (Task tool로 동시 호출)

Task(subagent_type="general-purpose", prompt="doc-updater 에이전트 실행...") Task(subagent_type="general-purpose", prompt="automation-scout 에이전트 실행...") Task(subagent_type="general-purpose", prompt="learning-extractor 에이전트 실행...")

Phase 2: Phase 1 결과를 입력으로 순차 실행

Task(subagent_type="general-purpose", prompt="duplicate-checker: Phase 1 결과 검증...") Task(subagent_type="general-purpose", prompt="followup-suggester: 후속 작업 정리...")

에이전트 상세

각 에이전트의 상세 프롬프트는 references/ 폴더에 있습니다:

references/ ├── automation-scout.md # 자동화 기회 탐지 ├── doc-updater.md # 문서 업데이트 분석 ├── duplicate-checker.md # 중복 검증 (Phase 2) ├── followup-suggester.md # 후속 작업 제안 └── learning-extractor.md # 학습 포인트 추출

절차

1단계: 테스트 확인

마무리 전에 테스트가 통과해야 합니다.

프로젝트에 맞는 테스트 명령어

npm test

또는

pytest

또는

go test ./...

테스트 실패 시:

테스트 실패:

• 실패: 2개
• 통과: 45개

[실패 내용 표시]

테스트를 먼저 수정해야 합니다. 마무리를 진행할 수 없습니다.

테스트 통과 시: 2단계로 진행

2단계: 현재 상태 확인

어떤 브랜치에 있는지

git branch --show-current

변경사항 확인

git status --short

worktree인지 확인

git worktree list

3단계: 옵션 선택

사용자에게 4가지 옵션을 제시합니다:

작업이 완료되었습니다. 어떻게 마무리할까요?

1. 로컬에서 main에 머지
2. PR 생성
3. 브랜치 유지 (나중에 처리)
4. 작업 취소 (삭제)

어떤 옵션을 선택하시겠습니까?

4단계: 선택에 따른 실행

옵션 1: 로컬 머지

메인 브랜치로 이동

git checkout main

최신 상태로 업데이트

git pull

기능 브랜치 머지

git merge feature/my-feature

테스트 재확인

npm test

브랜치 삭제

git branch -d feature/my-feature

옵션 2: PR 생성

원격에 푸시

git push -u origin feature/my-feature

PR 생성

gh pr create --title "기능 제목" --body "$(cat <<'EOF'

요약

• 변경 내용 1
• 변경 내용 2

테스트

• 확인 사항 1
• 확인 사항 2 EOF )"

PR URL을 사용자에게 알려줍니다.

옵션 3: 브랜치 유지

브랜치 feature/my-feature를 유지합니다. 다음에 이어서 작업하거나 마무리할 수 있습니다.

워크트리도 그대로 유지합니다.

옵션 4: 작업 취소

확인을 받습니다:

정말로 삭제하시겠습니까?

삭제될 항목:

• 브랜치: feature/my-feature
• 커밋: abc1234, def5678
• 워크트리: .worktrees/my-feature (있는 경우)

'삭제'를 입력하면 실행됩니다.

확인 후:

git checkout main git branch -D feature/my-feature

5단계: Worktree 정리

옵션 1, 2, 4를 선택한 경우 worktree 정리:

worktree 목록 확인

git worktree list

해당 worktree가 있으면 삭제

git worktree remove .worktrees/my-feature

옵션 3을 선택한 경우 worktree 유지.

마무리 체크리스트

• 테스트 통과 확인

• 적절한 마무리 옵션 선택

• 커밋 메시지 명확

• PR 설명 (옵션 2의 경우)

• worktree 정리 (해당되는 경우)

옵션별 요약

옵션 머지 푸시 브랜치 삭제 Worktree 정리

1. 로컬 머지 O

O O

2. PR 생성

O

O

3. 유지

4. 삭제

O (강제) O

주의사항

• 테스트 실패 상태로 머지하지 마세요

• 삭제는 되돌릴 수 없습니다 - 반드시 확인

• PR은 리뷰 후 머지하세요

예시 흐름

사용자: /wrap

Claude: wrap 스킬을 사용하여 작업을 마무리하겠습니다.

[테스트 실행] npm test 결과: 12개 통과, 0개 실패 ✅

[상태 확인] 브랜치: feature/login 변경사항: 5개 파일, 커밋 3개

[옵션 제시] 작업이 완료되었습니다. 어떻게 마무리할까요?

1. 로컬에서 main에 머지
2. PR 생성
3. 브랜치 유지
4. 작업 취소

사용자: 2

Claude: PR을 생성합니다.

[푸시] git push -u origin feature/login

[PR 생성] gh pr create --title "로그인 기능 추가" --body "..."

PR이 생성되었습니다: https://github.com/...

[Worktree 정리] .worktrees/login 삭제 완료

마무리가 완료되었습니다!