---
name: jira-task-impl
description: Implement a Jira task based on plan/design documents. Loads Jira context, implements based on the design document, then posts progress to Jira. Use when user says "implement task", "start coding", "jira-task impl", "구현 시작", "코딩 시작", or wants to begin implementation based on design.
user-invocable: false
argument-hint: "<TASK-ID>"
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash
  - Glob
  - Grep
  - mcp__atlassian__jira_get_issue
  - mcp__atlassian__jira_add_comment
---

# jira-task-impl: Implement a Jira Task

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

## Prerequisites
- Design document should exist at `docs/design/<TASK-ID>.design.md` (warn if missing)
- Feature branch `feature/<TASK-ID>` should already exist (suggest `/jira-task start` if not)

## Workflow

### Step 1: Load Context

1. Read `.jira-context.json` for active task info
2. **Cache-first**: `.jira-context.json`의 `cachedIssue`를 먼저 확인 (CLAUDE.md "Issue Cache" 참고). hit이면 호출 생략. miss이면 `mcp__atlassian__jira_get_issue` 호출 (`fields="summary,status,description,issuetype"`, `comment_limit=0` — 구현은 design 문서가 1차 소스이므로 이슈 본문은 최소만) 후 cache 갱신.
3. Read `docs/design/<TASK-ID>.design.md` if it exists
4. Read `docs/plan/<TASK-ID>.plan.md` if it exists

### Step 2: Implement Based on Design Document

`docs/design/<TASK-ID>.design.md`의 Implementation Plan에 따라 구현.

구현 원칙:
1. Implementation Plan의 순서를 따름
2. 기존 코드 컨벤션과 패턴을 준수
3. Design 문서의 Error Handling, Security Checklist 반영
4. **구현과 단위테스트를 함께 작성** (아래 Step 2.5 참조)
5. 각 단계 완료 시 간단한 검증 수행

Design 문서가 없으면, Jira 이슈 설명과 Acceptance Criteria 기반으로 구현.

### Step 2.5: Write Unit Tests Alongside Implementation

Design 문서의 Test Plan 섹션에 명세된 단위테스트 케이스를 구현과 병행하여 작성한다.

**원칙:**
- 기능 코드를 작성한 직후 해당 단위테스트를 작성 (구현 → 테스트 → 다음 구현)
- 프로젝트의 기존 테스트 프레임워크와 패턴을 따름 (vitest, jest, pytest 등)
- 테스트 파일 위치는 프로젝트 컨벤션을 따름 (`__tests__/`, `*.test.*`, `*.spec.*` 등)

**Test Plan이 없는 경우:**
- Acceptance Criteria 기반으로 핵심 경로의 단위테스트만 작성
- 과도한 테스트보다 핵심 로직 검증에 집중

**테스트 프레임워크가 없는 프로젝트:**
- 단위테스트 작성을 스킵하고 `/jira-task test` 단계에서 처리

### Step 3: Post Progress to Jira

구현 완료 후 `mcp__atlassian__jira_add_comment`:

```
## Implementation Complete

**브랜치**: feature/<TASK-ID>

### Changes Made
- 생성: <신규 파일 목록>
- 수정: <변경 파일 목록>
- 테스트 추가: <테스트 파일 목록, 없으면 "없음">

### Implementation Notes
- <구현 중 주요 결정 사항>
- <설계와의 차이점>

### Next Steps
- 테스트 실행: `/jira-task test <TASK-ID>`
- 코드 리뷰: `/jira-task review <TASK-ID>`
```

### Step 4: Completion Summary

`.jira-context.json`의 `completedSteps`에 `"impl"` 추가 후, 아래 형식으로 완료 요약 출력:

```
---
✅ **Implementation Complete** — <TASK-ID>

- 생성된 파일: <list>
- 수정된 파일: <list>
- Jira 코멘트 게시됨

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

**Next**: `/jira-task test <TASK-ID>` — 테스트를 실행합니다
---
```

테스트 프레임워크가 없는 프로젝트면 `/jira-task review <TASK-ID>`를 대신 추천.