jikime-harness-release

name	jikime-harness-release
description	Harness Engineering release manager — generates CHANGELOG from pm:OK tasks, bumps version, creates git tag, and writes release notes
version	1.0.0
category	harness
tags	["harness","release","changelog","version","tag","plans.md","pm:OK","harness-engineering"]
triggers	{"keywords":["harness-release","harness release","릴리스","release","버전 릴리스","changelog 생성","배포 준비","ship"],"phases":["sync"],"agents":["orchestrator","manager-git","documenter"],"languages":[]}
progressive_disclosure	{"enabled":true,"level1_tokens":"~100","level2_tokens":"~5000"}
user-invocable	true
context	fork
agent	general-purpose
allowed-tools	["Read","Write","Edit","Bash","Grep","Glob","TodoWrite"]

Harness Release — 릴리스 자동화 스킬

Quick Reference

Plans.md의 pm:OK 태스크를 기반으로 릴리스를 자동화합니다. CHANGELOG 업데이트, 버전 범프, git 태그, 릴리스 노트 생성까지 처리합니다.

사용법:

/jikime:harness-release                → 대화형 릴리스 (버전 자동 제안)
/jikime:harness-release --patch        → 패치 버전 (v1.0.0 → v1.0.1)
/jikime:harness-release --minor        → 마이너 버전 (v1.0.0 → v1.1.0)
/jikime:harness-release --major        → 메이저 버전 (v1.0.0 → v2.0.0)
/jikime:harness-release --dry-run      → 릴리스 미리보기 (변경사항 없음)
/jikime:harness-release --version v2.1.0 → 직접 버전 지정

---

릴리스 전제 조건

# 1. Plans.md에 pm:OK 태스크가 1개 이상 존재
grep -c "pm:OK" Plans.md

# 2. cc:WIP 태스크가 없음 (진행 중인 작업 없음)
grep "cc:WIP" Plans.md | wc -l   # → 0이어야 함

# 3. pm:REVIEW 태스크가 없음 (검토 대기 없음)
grep "pm:REVIEW" Plans.md | wc -l  # → 0이어야 함 (또는 사용자 확인)

# 4. 워킹 디렉토리 클린
git status --porcelain | wc -l   # → 0이어야 함

전제 조건 미충족 시:

⚠️  릴리스 전제 조건 미충족:
  - cc:WIP 태스크 2개 존재 (Task 2.1, 2.2)
  - pm:REVIEW 태스크 1개 대기 중 (Task 1.3)

강제 진행하시겠습니까? (권장하지 않음)

---

실행 흐름

Step 1: 릴리스 대상 수집

Plans.md에서 릴리스할 태스크 목록 추출:

# pm:OK 태스크 전체
grep "pm:OK" Plans.md

# 마지막 릴리스 이후 pm:OK가 된 태스크
# (git tag 기준)
LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
if [ -n "$LAST_TAG" ]; then
  git log ${LAST_TAG}..HEAD --oneline -- Plans.md
fi

수집 결과:

릴리스 대상 태스크 (pm:OK):
  ✅ 1.1 — JWT 토큰 생성 (commit: abc1234)
  ✅ 1.2 — 로그인 API (commit: def5678)
  ✅ 1.3 — 리프레시 토큰 (commit: ghi9012)
  ✅ 2.1 — 통합 테스트 추가 (commit: jkl3456)

Step 2: 버전 결정

현재 버전 감지:

# package.json
node -p "require('./package.json').version" 2>/dev/null

# go.mod
grep "^module" go.mod | head -1

# version 파일
cat version/VERSION 2>/dev/null || cat VERSION 2>/dev/null

# git tag
git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0"

버전 범프 자동 제안:

태스크 분석으로 적절한 버전 변화 추천:

태스크 내용 분석	권장 버전 범프
BREAKING CHANGE 포함 커밋 존재	major
신규 기능 (feat:) 커밋 존재	minor
버그수정/개선만 존재	patch

현재 버전: v1.2.0
권장 버전: v1.3.0 (minor — 신규 기능 3개 포함)

버전을 선택하세요:
1. v1.3.0 (권장: minor)
2. v1.2.1 (patch)
3. v2.0.0 (major)
4. 직접 입력

Step 3: CHANGELOG.md 생성/업데이트

CHANGELOG 항목 형식:

## [v1.3.0] — 2026-03-15

### ✨ 새 기능
- JWT 토큰 생성 및 검증 구현 ([1.1] abc1234)
- 로그인 API 엔드포인트 추가 ([1.2] def5678)
- 리프레시 토큰 지원 ([1.3] ghi9012)

### 🧪 테스트
- 통합 테스트 커버리지 80% 달성 ([2.1] jkl3456)

### 📋 Plans.md 참조
이 릴리스의 상세 구현 현황은 Plans.md의 Phase 1, Phase 2를 참조하세요.

커밋 메시지 → CHANGELOG 카테고리 매핑:

커밋 프리픽스	CHANGELOG 섹션
feat:	✨ 새 기능
fix:	🐛 버그 수정
perf:	⚡ 성능 개선
test:	🧪 테스트
docs:	📚 문서
refactor:	🔧 개선
security:	🔒 보안
BREAKING CHANGE	💥 주요 변경 (호환성 깨짐)
chore(plans):	건너뜀 (Plans.md 관리 커밋)

기존 CHANGELOG.md가 있으면 맨 위에 추가, 없으면 신규 생성.

Step 4: 버전 파일 업데이트

감지된 버전 파일 유형에 따라 자동 업데이트:

# package.json
npm version ${NEW_VERSION} --no-git-tag-version 2>/dev/null

# version/VERSION 또는 VERSION
echo "${NEW_VERSION}" > version/VERSION

# go: 태그만 사용 (go.mod 수정 불필요)

# Cargo.toml
sed -i '' "s/^version = .*/version = \"${NEW_VERSION_BARE}\"/" Cargo.toml

Step 5: Plans.md 릴리스 기록

Plans.md 하단에 릴리스 메타데이터 추가:

---

## Release: v1.3.0 — 2026-03-15

| 항목 | 내용 |
|------|------|
| **버전** | v1.3.0 |
| **릴리스 태스크** | 4개 (Task 1.1, 1.2, 1.3, 2.1) |
| **git 태그** | v1.3.0 (commit: xyz7890) |
| **CHANGELOG** | [CHANGELOG.md](./CHANGELOG.md) |

릴리스된 태스크는 pm:OK 상태로 유지됩니다.
다음 개발 사이클을 시작하려면 /jikime:harness-plan create로 새 Plans.md를 생성하거나,
새 Phase를 추가하세요.

Step 6: Git 커밋 및 태그

# 변경된 파일 커밋
git add CHANGELOG.md Plans.md package.json   # (해당하는 것만)
git commit -m "chore(release): v${NEW_VERSION}

Release v${NEW_VERSION} — ${TASK_COUNT}개 태스크 완료.

Included tasks:
$(for task in ${TASK_LIST}; do echo "  - [${task}] ${TASK_CONTENT[$task]}"; done)

Co-Authored-By: Claude Sonnet 4.6 <[e-mail]>"

# 태그 생성
git tag -a "v${NEW_VERSION}" -m "Release v${NEW_VERSION}"

# 푸시 (사용자 확인 후)

푸시 전 반드시 확인:

태그 v1.3.0을 원격에 푸시하시겠습니까?
  git push origin main
  git push origin v1.3.0

(y/n)

Step 7: 릴리스 완료 보고

✅ Harness Release v1.3.0 완료

릴리스 내역:
  버전:     v1.3.0
  태스크:   4개 (모두 pm:OK)
  커밋:     xyz7890
  태그:     v1.3.0 ✅
  CHANGELOG: 업데이트됨 ✅

다음 단계:
  /jikime:harness-sync retro  → 레트로스펙티브 생성
  /jikime:harness-plan create → 다음 개발 사이클 시작
  gh release create v1.3.0   → GitHub Release 생성 (선택)

---

--dry-run 모드

실제 변경 없이 릴리스 내용 미리보기:

🔍 Harness Release 미리보기 (dry-run)

버전: v1.2.0 → v1.3.0

CHANGELOG 추가 예정:
---
## [v1.3.0] — 2026-03-15
### ✨ 새 기능
- JWT 토큰 생성 ([1.1] abc1234)
...
---

변경 예정 파일:
  CHANGELOG.md (추가)
  Plans.md (릴리스 기록 추가)
  package.json (version: "1.3.0")

git 태그: v1.3.0

실제 릴리스를 진행하려면 --dry-run 없이 실행하세요.

---

릴리스 후 Plans.md 상태

릴리스 후 Plans.md는 그대로 유지됩니다:

| 1.1 | JWT 토큰 생성 | ... | pm:OK |   ← 유지
| 1.2 | 로그인 API    | ... | pm:OK |   ← 유지

다음 개발 사이클:

• 계속 추가: harness-plan add로 새 태스크 추가
• 새 시작: 새 Plans.md 생성 (이전 Plans.md는 Plans-v1.3.0.md로 보관)

---

통합 포인트

스킬/커맨드	연관 방식
jikime-harness-sync	릴리스 전 sync retro 권장
jikime-harness-plan	릴리스 후 다음 사이클 시작
jikime-workflow-changelog	CHANGELOG 생성 패턴 공유
/jikime:3-sync	harness-release 진입점 중 하나

---

Version: 1.0.0 Status: Active Last Updated: 2026-03-15