Markdown 버전

AI-translated from English; not yet reviewed by a fluent editor.

# 승인된 기능을 Jira와 검증한 Claude Code 변경으로 구현하기

> 승인된 기능을 실제 Jira 에픽, 모든 스토리, 의미 있는 하위 작업으로 진행하세요. 각 Claude Code 변경을 검사하고 이슈 업데이트를 확인하며 프로젝트 지침에 대한 결정을 검토합니다.

By BIG CHANGE Editorial

Published: 2026-10-20T13:23:38.288Z
Updated: 2026-10-20T13:23:38.288Z
Canonical: https://bigchange.ai/blog/claude-code-jira-approved-feature-guide

![Conceptual charcoal illustration of a developer at a standing counter reviewing a generic two-column code diff on an arm-mounted display.](https://bigchange.ai/api/media/file/claude-code-jira-feature-review-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

승인된 기능은 완료되기 전 요구 사항 문서, Jira 이슈 계층, 저장소라는 세 시스템을 거칠 수 있습니다. Claude Code는 문서 초안과 구현을 도울 수 있지만 시스템 사이의 연결은 사람의 승인과 직접 확인이 필요합니다. 이 가이드는 개발자나 팀 책임자가 실제 기능 하나를 진행하도록 안내합니다. 여기에는 **승인된 모든 스토리**, 원래 테스트, 권한에 따른 Jira 업데이트, 검토를 거친 프로젝트 지침 결정이 포함됩니다.

이 절차는 문서를 바탕으로 작성했습니다. BIG CHANGE는 Jira 프로젝트에 접근하거나 Claude Code를 실행하거나 저장소를 변경하거나 기능 제공 시간을 측정하지 않았습니다. 정확한 이슈 유형, 필드, 전환, 명령, 비용은 사용자의 프로젝트와 계정에 따라 다릅니다.

## 핵심 변화

- **달라진 점:** 승인된 요구 사항부터 실제 Jira 상위 이슈와 모든 스토리를 거쳐 검토한 코드, 원래 검사, 권한에 따른 이슈 업데이트까지 기능을 추적할 수 있습니다.
- **중요한 이유:** 이슈 대응표, 테스트 기록, Jira에서 직접 다시 읽은 정보로 승인된 작업 중 무엇이 완료되었고 어떤 스토리가 남았는지 확인할 수 있습니다.
- **주의할 점:** 프로젝트별 필드와 전환, 결과가 불명확한 쓰기, 실패한 검사는 사람이 해결해야 합니다. Claude Code 지침 자체가 작업 권한을 부여하지는 않습니다.

## 시작하기 전에

책임자가 승인한 개요, 편집 권한이 있는 저장소, 실행할 수 있는 원래 인수 검사가 있는 기능을 선택하세요. 실제 작업에는 선택한 Jira Cloud 프로젝트의 에픽 수준 상위 이슈 하나, 승인된 스토리, 스토리 아래의 의미 있는 하위 작업이 적어도 하나 필요해야 합니다. 실제 하위 작업이 없다면 이 가이드가 요구하는 전체 결과는 아직 미완료입니다. 형식적인 이슈를 추가하면 계획을 왜곡하게 됩니다. 요청자, 승인 권한자, 원본 리비전, 허용 데이터, 시작 Git 커밋, 격리 또는 복구 경로, 코드를 검토하고 Jira 상태를 변경할 수 있는 사람을 기록하세요.

설치 환경의 [Claude Code 버전, 인증, 권한](https://code.claude.com/docs/en/permissions)을 확인하세요. 저장소의 `CLAUDE.md` 파일은 프로젝트 지침을 제공할 뿐 편집, 명령 실행, 데이터 전송 권한을 부여하지 않는지 확인합니다. Claude에 줄 수 있는 요구 사항과 코드, 실행을 허용할 명령, 이 기능의 사용량 한도를 정하세요. Claude Code 사용은 구독 할당량을 소모하거나 제공업체 요금을 발생시킬 수 있습니다. [Anthropic 비용 가이드](https://code.claude.com/docs/en/costs) 내용만으로 실제 청구액이 미리 정해지지는 않습니다.

Jira에서는 관련 이슈 유형을 조회하고 생성할 권한과, 이후 권한 있는 사용자로 댓글을 달거나 이슈를 전환할 권한을 확보하세요. 비공개 스크립트에는 [Atlassian이 설명하는 이메일과 API 토큰 방식](https://developer.atlassian.com/cloud/jira/platform/basic-auth-for-rest-apis)을 사용할 수 있으며 통합에는 OAuth가 필요할 수 있습니다. 자격 증명은 비공개 비밀 저장소에 보관하세요. 프롬프트, 이슈 본문, `CLAUDE.md`, 로그, 버전 관리에 넣지 마세요. 요구 사항을 Jira에 보내기 전에 이슈 공개 범위를 합의합니다.

진행하면서 비공개 기록 일곱 가지를 유지하세요. `docs/feature-prd.md`, `ticket-plan.json`, 추가만 가능한 이슈 쓰기 로그, `ticket-map.json`, 스토리별 구현 증빙, Jira 업데이트 로그, 회고 결정입니다. 이는 사용자의 기능에 관한 기록이며 BIG CHANGE가 제공하거나 실행한 파일이 아닙니다.

## 1. 정확한 PRD 하나 승인하기

실제로 승인된 기능 개요를 Claude Code에 주고 `docs/feature-prd.md` 초안을 쓰기 전에 미해결 질문을 찾도록 요청하세요. 문서에는 요청자와 승인 책임자, 입력 리비전, 문제와 대상 사용자, 범위와 제외 사항, 번호가 붙은 요구 사항 ID, 인수 검사와 증거 출처, 비기능 제약, Jira 프로젝트, 미해결 질문이 필요합니다. 책임자가 초안을 원래 개요와 비교하고 정확한 내용 리비전과 해시를 승인해야 합니다. 이슈 생성이나 코드 편집 전에 중요한 질문을 해결하세요.

해시는 이후 기록이 참조할 원본을 정확하게 식별합니다. PRD가 바뀌면 영향을 받는 이슈 계획과 검사를 다시 검토하세요. 구현 실패를 이유로 인수 기준을 통과하도록 바꾸면 안 됩니다.

## 2. 이 프로젝트의 Jira 계층과 필드 조사하기

권한을 받은 **읽기 전용** Jira REST API v3 요청으로 `GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes`의 모든 페이지를 조회하세요. 제안한 이슈 유형마다 `GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId}`의 모든 페이지를 조회하여 생성 필수 필드와 허용 값을 찾습니다. Atlassian은 범위가 넓은 `GET /issue/createmeta` 작업을 더 이상 권장하지 않는 것으로 표시합니다. 자세한 내용은 [이슈 API 참조 문서](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/)를 확인하세요.

이 프로젝트의 실제 에픽 상당 상위 이슈, 스토리 수준 하위 이슈, 지원되는 하위 작업을 확인하세요. Atlassian은 [기본 계층과 구성 방법](https://support.atlassian.com/jira-cloud-administration/docs/configure-the-issue-type-hierarchy/)을 설명하지만 유형 이름과 ID는 모든 프로젝트에 동일하지 않습니다. 프로젝트의 Parent 필드가 각 하위 수준에서 어떻게 작동하며 생성에 어떤 사용자 지정 필드나 공개 범위 설정이 필요한지 조사하세요. 승인된 구조를 프로젝트에서 표현할 수 없다면 부족한 유형, 필드, 권한을 기록하고 생성을 보류합니다. 일반 이슈 링크만으로는 상하 관계가 만들어지지 않습니다.

## 3. 쓰기 전에 전체 이슈 계획 검토하기

모든 PRD 요구 사항과 인수 검사를 `ticket-plan.json`에 대응시키세요. 해당 `planVersion`, PRD 해시, Jira 사이트와 프로젝트 키, 로컬 실행 ID, 계획 승인자와 시각을 기록합니다. 각 예정 이슈에 고유 로컬 ID, 예정 상위 이슈의 로컬 ID, 조사한 이슈 유형 ID, 프로젝트 필수 필드, 요약, 설명, 요구 사항 및 인수 ID, 책임자, 허용 공개 범위를 기록하세요. 스토리와 하위 작업 수는 승인된 작업에 따라 정해집니다. 각 하위 작업은 실제 소속 스토리 아래에서 진짜 작업을 수행해야 합니다.

Jira REST v3는 여러 줄 이슈 설명과 댓글에 **Atlassian Document Format (ADF)** 형식의 구조화된 JSON 문서를 사용합니다. 승인된 내용으로 문서를 준비하고 각 요청을 만들기 전에 사이트가 반환한 필드 메타데이터를 확인하세요. [이슈 API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/)는 생성 작업을 설명하지만 알 수 없는 프로젝트에 맞는 완성된 필드 객체를 제공하지는 않습니다. 어떤 `POST` 요청보다도 먼저 사람이 전체 구조, 모든 요구 사항의 포함 여부, 상하 관계, 정확한 쓰기 대상을 승인해야 합니다.

## 4. 상위 이슈부터 만들고 각 이슈 다시 읽기

승인된 상위 이슈를 `POST /rest/api/3/issue`로 생성한 다음 스토리와 실제 하위 작업을 순서대로 만드세요. **각** 요청 전에 비공개 로그에 실행 ID, 로컬 이슈 ID, 해당할 경우 확인된 상위 키, 대상, 정확한 승인 요청의 해시, UTC 시도 시각, `pending` 상태를 추가합니다. 토큰은 넣지 마세요. HTTP 201을 받으면 Jira가 반환한 이슈 ID와 키를 기록한 뒤 직접 `GET /rest/api/3/issue/{issueIdOrKey}`를 호출합니다. 프로젝트, 유형, 요약, 설명 또는 PRD 참조, 상위 이슈를 승인 계획과 비교하세요. 이 재조회가 끝난 후에만 해당 행을 `confirmed`로 표시합니다. 상위 이슈가 확인되어야 그 아래 이슈를 만들 수 있습니다.

요청 시간이 초과되거나 응답을 잃었다면 `unknown`로 표시하세요. 프로젝트, 시간, 승인 요약, 계획 참조로 Jira를 조사하고 일치할 가능성이 있는 이슈를 직접 열어 권한 있는 책임자가 동일성을 확인하도록 요청합니다. [Atlassian은 쓰기 후 검색에 지연이 있을 수 있다고 경고합니다](https://developer.atlassian.com/cloud/jira/platform/search-and-reconcile/). 검색 결과가 없다고 생성 실패가 입증되는 것은 아닙니다. 실행 ID와 로그는 대조에 도움이 되지만 서버가 중복 생성을 거부하게 만들지는 않습니다. 결과가 불분명한 `POST`를 무작정 재전송하지 마세요.

완성된 구조를 직접 읽어 `ticket-map.json`에 각 로컬 ID, 실제 Jira ID와 키, 표준 이슈 URL, 프로젝트, 유형, 상위 키, PRD 및 인수 ID, 재조회 시각, 로그 참조를 기록하세요. **모든** 승인 이슈와 기준을 PRD와 비교합니다. 이슈가 없거나 상위 관계가 잘못되었으면 추가 쓰기를 중단하고 프로젝트의 검토된 수정 절차를 사용하세요.

## 5. 승인된 모든 스토리 구현 및 독립 검토하기

승인된 스토리를 의존성 순서대로 처리하세요. 각 스토리의 Jira 키, 시작 Git 커밋과 브랜치 또는 워크트리, 원래 인수 명령, 허용 경로와 명령을 기록합니다. Claude Code에 [Plan mode](https://code.claude.com/docs/en/common-workflows)를 사용하여 해당 스토리 기준을 저장소에 대응시키도록 요청하세요. 개발자가 계획을 확인하고 범위가 제한된 편집을 승인합니다. 스토리 경계는 변경을 검토하기 쉽게 만드는 것이며 남은 승인 스토리를 기능에서 제외하는 것이 아닙니다.

편집 후 정확한 diff, 원래 검사 명령과 전체 출력 및 종료 상태, 관련 대상별 테스트, 요구 사항 ID별 판정을 보관하세요. 실제 코드와 로그를 확인합니다. 작성된 계획, 생성 파일, 테스트가 통과했다는 Claude의 말만으로는 변경이 작동함을 입증할 수 없습니다. 검사 실패, 예상하지 못한 비밀 정보, 의존성 변경, 외부 쓰기, 광범위한 리팩터링이 발생하면 스토리를 보류하세요. 승인 범위 내에서 수정한 뒤 원래 검사를 다시 실행합니다. 별도 코드 검토자가 결과 커밋을 수락할지 diff를 보류할지 결정합니다. 모든 스토리에 대해 결정을 기록하세요. [앞서 작성한 검토된 Claude Code 변경 한 건에 관한 가이드](https://bigchange.ai/blog/superpowers-claude-code-plan-test-review-change-guide)는 더 좁은 코드 검토 단계를 다룹니다. 여기의 PRD와 전체 Jira 구조는 더 넓은 기능 경계를 제공합니다.

## 6. 권한에 따른 Jira 업데이트 검증하기

검토한 각 스토리의 현재 Jira 상태를 읽고 `GET /rest/api/3/issue/{key}/transitions?expand=transitions.fields`를 요청하세요. 이 사용자에게 실제로 허용된 전환, 목적 상태, 필수 필드, 허용 값을 확인합니다. 권한 있는 책임자는 프로젝트에서 확인한 필드 값을 사용해 `POST /rest/api/3/issue/{key}/transitions`로 선택한 전환을 제출할 수 있습니다. 이슈를 직접 다시 읽고 새 상태를 확인하세요. 코드 검사 통과만으로 Done, 병합, 배포가 허용되지는 않습니다.

Jira 업데이트 로그에 쓰기 전 상태, 예정 전환, 작업 사용자, 요청, 응답을 기록하세요. `POST /rest/api/3/issue/{key}/comment`를 통해 사실에 근거한 ADF 증거 댓글을 게시합니다. 수락된 커밋이나 보류한 diff, 원래 검사와 대상별 테스트, 남은 실패, 검토자 결정을 포함하세요. 생성된 댓글 ID와 본문을 Jira의 [댓글 API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/)에서 다시 읽습니다. 어느 쓰기든 응답이 불확실하다면 다시 요청하기 전에 상태나 댓글을 직접 조사하세요. 전환 목록이 비었거나 필수 필드를 사용할 수 없는 것은 프로젝트 책임자와 해결할 워크플로 또는 권한의 빈틈이지, ID를 지어낼 이유가 아닙니다.

## 7. `CLAUDE.md` 변경 여부 결정하기

실제 PRD, 이슈, diff, 테스트, 검토, Jira 기록을 비교하세요. Claude에 관찰된 오해나 빠진 검사를 짚는 짧은 회고를 요청합니다. 사람이 정확한 지침 수정을 선택하거나 변경하지 않기로 결정하고 검토자와 시각을 기록합니다. 승인되면 해당 `CLAUDE.md` diff와 해시만 검토하고 커밋하세요. [Anthropic 메모리 가이드](https://code.claude.com/docs/en/memory)는 프로젝트 지침을 설명합니다. 이 검토가 향후 작업을 자동으로 허가하지는 않습니다. 비밀 정보를 추가하거나 추측한 교훈을 프로젝트 규칙으로 만들지 마세요.

## 완료 조건과 복구

승인된 PRD 리비전이 직접 확인한 에픽·스토리·하위 작업 구조와 대응하고, **승인된 각 스토리**에 시작 상태, 수락한 diff, 원래 검사와 대상별 테스트 증거, 독립 검토가 있어야 기능이 완료됩니다. 권한에 따른 모든 Jira 전환과 증거 댓글을 직접 다시 읽었고 사람이 회고에 대해 결정했어야 합니다. 빠진 항목이 있으면 정확히 어느 단계가 남았는지 기록하세요. [첫 AI 작업 선택하기](https://bigchange.ai/blog/map-work-choose-first-ai-task-guide)는 이보다 앞선 작업 선택과 검사 제안에서 끝나며 이 구현 결과를 입증하지 않습니다.

결과가 불확실한 Jira 생성은 사람이 동일성을 대조할 때까지 `unknown`로 둡니다. 상위 이슈가 잘못되면 하위 생성을 중단합니다. 테스트에 실패해도 원래 기준은 유지합니다. 전환이 없거나 사용량 한도에 도달했다면 날짜가 있는 부분 완료 기록을 책임자에게 남기세요. Claude와 Jira에 전달할 요구 사항 및 고객 데이터는 승인된 최소한으로 제한하고 현재 계정 비용과 권한을 확인하며 사람의 코드 검토 자원을 확보합니다. 이 가이드는 도구를 이용하는 조건부 절차를 설명합니다. BIG CHANGE가 기능 완료, Jira 쓰기, 모델 실행, 절약 측정, 병합, 배포를 했다고 보고하지 않습니다.

## 출처 및 추가 자료

- [Atlassian: Jira Cloud REST API v3 이슈 작업](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/): 범위가 제한된 생성 메타데이터, 이슈 생성 및 읽기, 전환 작업. 사용자 프로젝트의 필드와 ID는 해당 환경에서 조사해야 합니다.
- [Atlassian: 이슈 댓글](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/): ADF 댓글 생성과 재조회. 권한과 실제 응답은 사이트마다 다릅니다.
- [Atlassian: 검색과 대조](https://developer.atlassian.com/cloud/jira/platform/search-and-reconcile/): 쓰기 직후 검색되지 않는다는 사실만으로 불확실한 생성 결과를 확정할 수 없는 이유를 설명합니다.
- [Atlassian: 이슈 유형 계층](https://support.atlassian.com/jira-cloud-administration/docs/configure-the-issue-type-hierarchy/): 기본 수준과 구성. 선택한 프로젝트의 구조는 별도로 확인해야 합니다.
- [Anthropic: Claude Code 워크플로](https://code.claude.com/docs/en/common-workflows), [권한](https://code.claude.com/docs/en/permissions), [메모리](https://code.claude.com/docs/en/memory), [비용](https://code.claude.com/docs/en/costs): 계획, 편집 권한, `CLAUDE.md` 지침과 사용량을 설명합니다. 이 기능의 실행 기록은 아닙니다.

## Sources

- [Atlassian Jira Cloud REST API v3 이슈](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/) — 범위가 제한된 생성 메타데이터, 이슈 POST/GET, 전환을 설명합니다. 광범위한 생성 메타데이터 작업은 더 이상 권장되지 않습니다. 프로젝트 필드, ID, 허용 전환은 사용자 사이트에서 확인해야 합니다.
- [Atlassian Jira Cloud REST API v3 이슈 댓글](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/) — 실제 권한에 따라 ADF 댓글 생성과 재조회를 설명합니다. 이 가이드를 위해 댓글을 게시하지 않았습니다.
- [Atlassian 검색과 대조](https://developer.atlassian.com/cloud/jira/platform/search-and-reconcile/) — 검색의 최종 일관성을 설명합니다. 생성 응답이 불확실한 뒤 검색 결과가 없더라도 이슈가 존재하지 않음을 입증할 수 없습니다.
- [Atlassian 이슈 유형 계층 구성](https://support.atlassian.com/jira-cloud-administration/docs/configure-the-issue-type-hierarchy/) — 기본 계층과 구성 가능한 계층을 설명합니다. 선택한 프로젝트 수준과 Parent 동작은 직접 조사해야 합니다.
- [Atlassian REST API 기본 인증](https://developer.atlassian.com/cloud/jira/platform/basic-auth-for-rest-apis/) — 간단한 비공개 스크립트용 이메일과 API 토큰 방식 및 통합과의 차이를 설명합니다. 자격 증명은 비공개로 유지해야 합니다.
- [Anthropic Claude Code 일반 워크플로](https://code.claude.com/docs/en/common-workflows) — Plan mode와 코딩 작업 방식을 설명하며 사용자의 구현이나 검사를 입증하지 않습니다.
- [Anthropic Claude Code 권한](https://code.claude.com/docs/en/permissions) — 실제 도구 권한과 승인을 설명합니다. CLAUDE.md 지침만으로는 명령이나 쓰기가 허용되지 않습니다.
- [Anthropic Claude Code 메모리](https://code.claude.com/docs/en/memory) — CLAUDE.md 프로젝트 지침을 설명합니다. 회고에서 제안한 수정은 사람이 검토해야 하며 자동 학습이 아닙니다.
- [Anthropic Claude Code 비용](https://code.claude.com/docs/en/costs) — 사용량과 요금은 요금제와 제공업체에 따라 다릅니다. 문서만을 바탕으로 한 이 가이드에서는 요금이나 절약액을 측정하지 않았습니다.