작업 마무리

개요

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

마무리 없이 끝내면:

변경사항이 흩어짐
다음에 어디까지 했는지 모름
불필요한 파일이 남음
배운 것이 사라짐

시작할 때 알림: "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 삭제 완료

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

08-wrap