---
name: jira-local-merge
description: Locally merge a Jira task branch into the base branch without a remote or PR. Handles merge strategy selection, Jira status transition, and MCP config removal. Outputs worktree cleanup instructions for manual execution after session ends. Use when user says "local merge", "merge task", "jira-task merge", "로컬 병합", "원격 없이 병합", or wants to merge without a remote origin.
user-invocable: false
argument-hint: "<TASK-ID>"
allowed-tools:
  - Read
  - Write
  - Bash
  - Glob
  - mcp__atlassian__jira_get_issue
  - mcp__atlassian__jira_transition_issue
  - mcp__atlassian__jira_get_transitions
  - mcp__atlassian__jira_add_comment
---

# jira-local-merge: Local Branch Merge

**Language Rule**: 프로젝트 CLAUDE.md의 Conventions 섹션 참고 (한국어 출력, Jira 코멘트 제목은 영어).

remote origin 없이 feature 브랜치를 base 브랜치로 로컬 병합하고,
Jira 상태 전환 및 worktree 정리까지 일괄 처리한다.

## Prerequisites
- feature 브랜치에 커밋이 존재
- Jira MCP 서버 연결됨

## Workflow

### Context Optimization

이 스킬에서 `mcp__atlassian__jira_get_issue`를 호출하는 경우 다음 파라미터를 사용한다 (병합/전환에 필요한 메타만):
- `fields="summary,status,issuetype"`
- `comment_limit=0`

### Step 1: Load Context

`.jira-context.json`을 읽어 태스크 컨텍스트 로드:
- `taskId`, `branch`, `baseBranch`, `worktreePath`, `repoRoot`

인자로 TASK-ID가 전달된 경우 해당 값 우선 사용.

`repoRoot`가 없으면 `git worktree list`의 첫 번째 줄로 폴백:
```bash
# git worktree list 첫 번째 줄이 항상 메인 레포 경로
git worktree list | head -1 | awk '{print $1}'
```
`git worktree list --porcelain | awk 'NR==2{print $2; exit}'`도 동일 결과.
`git rev-parse --show-toplevel`은 워크트리 안에서는 워크트리 경로를 반환하므로 사용하지 않음.

`baseBranch`가 없으면 `repoRoot`에서 감지:
```bash
git -C "<repoRoot>" rev-parse --verify develop 2>/dev/null
git -C "<repoRoot>" rev-parse --verify main 2>/dev/null
git -C "<repoRoot>" rev-parse --verify master 2>/dev/null
```

### Step 2: Pre-flight Checks

```bash
# 1. feature 브랜치 존재 확인
git branch --list "feature/<TASK-ID>"

# 2. 워크트리 내 미커밋 변경사항 확인
git -C "<worktreePath>" status --porcelain
```

미커밋 변경사항이 있으면 사용자에게 알리고 중단. 계속할지 확인 후 진행.

### Step 3: Choose Merge Strategy

사용자에게 병합 전략 선택 요청:

```
병합 전략을 선택하세요:

1. --no-ff (기본 권장)
   merge commit을 생성, feature 브랜치 히스토리가 그대로 보존됨
   GitHub "Create a merge commit"과 동일

2. --squash
   feature 브랜치의 모든 커밋을 하나로 합쳐 병합
   GitHub "Squash and merge"와 동일

3. rebase
   feature 브랜치 커밋을 base 브랜치 위에 재배치, 선형 히스토리
   GitHub "Rebase and merge"와 동일
```

### Step 4: Perform Merge

**`.jira-context.json`의 `repoRoot`를 사용**한다. `git rev-parse --show-toplevel`은 워크트리 안에서 실행하면 워크트리 경로를 반환하므로 사용하지 않음.

#### 전략별 명령:

**--no-ff (기본)**
```bash
git -C "<repoRoot>" checkout <baseBranch>
git -C "<repoRoot>" merge --no-ff feature/<TASK-ID> -m "Merge feature/<TASK-ID>: <issue summary>"
```

**--squash**
```bash
git -C "<repoRoot>" checkout <baseBranch>
git -C "<repoRoot>" merge --squash feature/<TASK-ID>
git -C "<repoRoot>" commit -m "feat(<TASK-ID>): <issue summary>"
```

**rebase**
```bash
git -C "<repoRoot>" checkout feature/<TASK-ID>
git -C "<repoRoot>" rebase <baseBranch>
git -C "<repoRoot>" checkout <baseBranch>
git -C "<repoRoot>" merge --ff-only feature/<TASK-ID>
```

merge 충돌 발생 시 사용자에게 알리고 중단. 충돌 해결 후 재실행 안내.

### Step 5: Post Completion Report to Jira

`mcp__atlassian__jira_add_comment`로 병합 결과 게시:

```
## Task Merged Locally: <TASK-ID>

**브랜치**: feature/<TASK-ID> → <baseBranch>
**전략**: <merge strategy>
**커밋 수**: <count>개
**변경 파일**: <count>개 (+<추가> -<삭제>)

### Changes
<git log --oneline 요약>
```

### Step 6: Transition Issue

`mcp__atlassian__jira_get_transitions`로 전환 목록 조회 후 `mcp__atlassian__jira_transition_issue`로 상태 전환:
- "In Review" 우선 시도 (PR 생성 단계가 남아있으므로 Done이 아님)
- "In Review"가 없으면 가능한 전환 목록을 사용자에게 안내하고 선택 요청
- Done으로 전환하지 않는다 (PR 생성 후 `jira-task done`에서 처리)

**주의**: `jira_transition_issue`에 `comment` 파라미터를 절대 사용하지 말 것. `comment` 필드는 Atlassian Document Format(ADF) JSON을 요구하므로 일반 텍스트를 넣으면 오류가 발생한다. 코멘트는 반드시 별도로 `jira_add_comment`를 호출하여 추가한다.

### Step 7: Cleanup Instructions

현재 Claude Code가 워크트리 디렉토리에서 실행 중이므로 워크트리를 직접 삭제할 수 없다.
병합이 완료된 후 사용자에게 아래 안내를 출력한다:

```
⚠️  워크트리 정리가 필요합니다.
    이 세션을 닫고 메인 레포에서 아래 명령을 실행하세요:

    git worktree remove "<worktreePath>" --force

    ⚠️  feature 브랜치(feature/<TASK-ID>)는 삭제하지 마세요.
    PR 생성에 필요합니다. PR 머지 후 삭제하세요.
```

실제 명령 실행은 하지 않는다.

### Step 8: Update Context & Completion Summary

워크트리의 `.jira-context.json`과 `<repoRoot>/.jira-context.json` 양쪽을 업데이트:
- `completedSteps`에 `"merge"` 추가
- `status`를 `"In Review"`로 변경
- `mergedAt`에 현재 ISO 8601 타임스탬프 추가

**중요**: 두 컨텍스트 파일은 형태가 다르다. 형태별로 다르게 처리해야 메인 레포의 누적 이력이 손상되지 않는다.

- **워크트리 컨텍스트** (`{taskId, branch, ...}`): 기존처럼 최상위 필드 갱신
- **메인 레포 aggregate 컨텍스트** (`{tasks: [...], worktreeBase, ...}`): `tasks` 배열에서 해당 `taskId` 항목을 찾아 그 항목 내부의 필드만 갱신. 절대 최상위에 워크트리 필드를 쓰지 말 것 (과거 사이드 이펙트로 메인 컨텍스트가 워크트리 형태로 덮어써져 누적 이력 유실 사례 있음).

```bash
python3 - "<TASK-ID>" "<worktree>/.jira-context.json" "<repoRoot>/.jira-context.json" << 'PYEOF'
import json, datetime, os, sys

task_id, *ctx_files = sys.argv[1], *sys.argv[2:]
now = datetime.datetime.now().isoformat()

def update_worktree_ctx(ctx, task_id):
    """워크트리 형태: 최상위에 직접 갱신."""
    steps = ctx.get("completedSteps", [])
    if "merge" not in steps:
        steps.append("merge")
    ctx["completedSteps"] = steps
    ctx["status"] = "In Review"
    ctx["mergedAt"] = now
    return True

def update_aggregate_ctx(ctx, task_id):
    """aggregate 형태: tasks[]에서 해당 taskId 항목만 갱신. 최상위 미변경."""
    tasks = ctx.get("tasks", [])
    for t in tasks:
        if t.get("taskId") == task_id:
            steps = t.get("completedSteps", [])
            if "merge" not in steps:
                steps.append("merge")
            t["completedSteps"] = steps
            t["status"] = "In Review"
            t["mergedAt"] = now
            return True
    return False  # 항목이 없으면 추가하지 않음 (init 누락)

for ctx_file in ctx_files:
    if not os.path.isfile(ctx_file):
        print(f"No context file at {ctx_file}, skipping")
        continue
    with open(ctx_file, "r", encoding="utf-8") as f:
        ctx = json.load(f)
    is_aggregate = isinstance(ctx.get("tasks"), list)
    if is_aggregate:
        updated = update_aggregate_ctx(ctx, task_id)
        if updated:
            print(f"Aggregate context updated for {task_id}: {ctx_file}")
        else:
            print(f"No {task_id} entry in aggregate {ctx_file}, skipping")
            continue
    else:
        update_worktree_ctx(ctx, task_id)
        print(f"Worktree context updated: {ctx_file}")
    with open(ctx_file, "w", encoding="utf-8") as f:
        json.dump(ctx, f, indent=2, ensure_ascii=False)
PYEOF
```

호출 예: `python3 - "MAE-178" "/Users/.../worktree/MAE-178/.jira-context.json" "/Users/.../repo/.jira-context.json" << 'PYEOF' ...`

아래 형식으로 완료 요약 출력:

```
---
✅ **Local Merge Complete** — <TASK-ID>

- 병합: feature/<TASK-ID> → <baseBranch> (<strategy>)
- Jira 상태: In Review
- Worktree 정리: 세션 종료 후 수동 실행 필요 (위 안내 참고)
- feature 브랜치(feature/<TASK-ID>)는 PR 생성을 위해 보존됨
- 완료 리포트 Jira에 게시됨

**Progress**: init → start → plan → design → impl → test → review → **merge ✓** → pr → done

**Next**: 세션 종료 후 메인 레포에서 `/jira-task pr <TASK-ID>` — PR을 생성합니다
---
```