# Finishing A Development Branch

> Use when implementation is complete and tests pass. Runs the test gate one final time and emits a single termination message; user manually decides merge / PR / keep / discard. (v1.1.14 슬림화 — AskUserQuestion 게이트 + boilerplate 제거)

- Skill: `deokjinlog/finishing-a-development-branch` (Agent Skill)
- Install (CLI): `npx skillmds@latest add deokjinlog/finishing-a-development-branch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/deokjinlog/finishing-a-development-branch/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: deokjinlog (https://skillmd.com/u/deokjinlog)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/deokjinlog/finishing-a-development-branch

---


# Finishing a Development Branch (v1.1.14 slim)

implementation 완료 + 모든 테스트 통과 시점에 호출. 1인 개발자가 다음 행동 (merge / PR / keep / discard) 을 이미 알고 있다는 가정 하에, 추가 게이트는 두지 않고 **테스트 자동 실행 안전망 + 종료 메시지** 만 제공.

**Announce at start:** "I'm using the finishing-a-development-branch skill to verify tests then emit a termination summary."

## When to Use

- `executing-plans` / `subagent-driven` 가 모든 task 완료 후 자동 호출
- 사용자가 명시적으로 마무리 단계 진입 시 호출

## Process

### Step 1 — 테스트 자동 실행 (필수 안전망)

자동으로 프로젝트 표준 테스트 명령 실행:

```bash
# Python (이 저장소 기본)
source .venv/bin/activate && pytest -v

# 다른 stack 의 경우 README / package.json scripts 확인
```

- 모든 테스트 PASS → Step 2 진행
- FAIL 1건 이상 → **즉시 STOP**. 실패한 테스트 출력을 사용자에게 노출 + 한 줄 안내: "❌ 테스트 실패. 마무리 진행 안 함. 실패 원인 확인 후 다시 호출."

이 단계는 **유일한 자동 게이트**. 깨진 코드가 main / PR 로 흘러 들어가는 것 방지.

### Step 2 — 완료 메시지 노출 (한 메시지, 게이트 X)

```
✅ 모든 task 완료 + 테스트 통과.
   - 변경 commit: <SHA list>
   - RISK 트리거: <카테고리 카운트>
   - 누락/초과: <list 또는 "없음">

마무리하세요. (예: git checkout main && git merge <branch>, 또는 PR 생성, 또는 그대로 두기)
```

→ AskUserQuestion 게이트 없음. 사용자가 직접 git/gh 명령 실행. boilerplate 자동 생성 X.

## Worktree Cleanup (manual)

워크트리 정리는 자동 안 함 (마무리 시점이라고 자동 정리하면 사용자가 "그대로 두기" 의도일 때 자료 손실 가능). 사용자가 직접 처리:

```bash
git worktree remove <path>
```

## Anti-Patterns

| Wrong | Right |
|---|---|
| AskUserQuestion 4-option 게이트 추가 | 게이트 X. 1인 개발자 마찰 회피. |
| base branch 자동 추정 | 사용자가 본인 브랜치 알고 있음. 추정 시간 낭비. |
| git/gh boilerplate 자동 생성 | 종료 메시지 한 줄 안내만. 명령 직접 실행. |
| Step 1 테스트 실패 시 무시 | NEVER. 유일한 안전망. STOP 강제. |

## Why slim (v1.1.14)

- 1인 개발 철학: 사전 verifying-spec + TDD + RISK + 변경이력으로 안전성 분산. 종료 게이트는 중복.
- v1.1.9~12 게이트 합리화 흐름의 자연스러운 연장 (partial 제거 / fix→no / #12 복원 같은 마찰 정리).
- discard 안전망 의도적 트레이드오프: 사용자가 직접 `git branch -D` 시 confirm 없음. 1인 개발자는 git 동작 알고 있음.

## Related Skills

- `executing-plans` — 인라인 모드 종료 시 호출
- `subagent-driven` — 서브에이전트 모드 End-of-Run consolidator 끝 호출