Edisi Markdown

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

# Jalankan fitur yang disetujui melalui Jira dan perubahan Claude Code yang diperiksa

> Jalankan fitur yang disetujui melalui epik Jira yang nyata, semua cerita, dan subtugas yang bermakna. Periksa setiap perubahan Claude Code, pastikan pembaruan isu, dan tinjau keputusan tentang panduan proyek.

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.

Sebuah fitur yang disetujui dapat melewati tiga sistem sebelum selesai: dokumen persyaratan, hierarki isu Jira, dan repositori. Claude Code dapat membantu menyusun dan menerapkan pekerjaan, tetapi hubungan antarsistem memerlukan persetujuan manusia dan pemeriksaan langsung. Panduan ini membawa pengembang atau pemimpin tim melalui satu fitur nyata, termasuk **setiap cerita yang disetujui**, pengujian aslinya, pembaruan Jira yang berwenang, dan keputusan yang ditinjau tentang panduan proyek.

Prosedur ini berdasarkan dokumentasi. BIG CHANGE tidak mengakses proyek Jira, menjalankan Claude Code, mengubah repositori, atau mengukur waktu penyelesaian fitur. Jenis isu, kolom, transisi, perintah, dan biaya yang tepat bergantung pada proyek dan akun Anda.

## Perubahan besar

- **Apa yang berubah:** Fitur dapat dilacak dari persyaratan yang disetujui melalui induk Jira yang nyata dan setiap cerita hingga kode yang ditinjau, pemeriksaan asli, dan pembaruan isu yang diizinkan.
- **Mengapa penting:** Peta isu, catatan pengujian, dan pembacaan ulang langsung dari Jira menunjukkan pekerjaan yang disetujui mana yang selesai dan cerita mana yang masih terbuka.
- **Yang perlu diperhatikan:** Kolom dan transisi khusus proyek, penulisan dengan hasil tidak pasti, serta pemeriksaan yang gagal perlu diselesaikan manusia; panduan Claude Code sendiri tidak memberi wewenang untuk bekerja.

## Sebelum memulai

Pilih fitur dengan ringkasan yang disetujui penanggung jawab, repositori yang boleh Anda edit, dan pemeriksaan penerimaan asli yang bisa dijalankan. Pekerjaan nyatanya harus memang memerlukan satu induk setingkat epik, cerita yang disetujui, dan setidaknya satu subtugas bermakna di bawah sebuah cerita dalam proyek Jira Cloud yang dipilih. Jika pekerjaan tidak memiliki subtugas nyata, hasil menyeluruh khusus ini masih tertunda; menambah isu hiasan akan memalsukan rencana. Catat peminta, pihak berwenang menyetujui, revisi sumber, data yang diizinkan, commit awal Git, jalur isolasi atau pemulihan, dan orang yang boleh meninjau kode serta mengubah status Jira.

Periksa [versi, autentikasi, dan izin Claude Code](https://code.claude.com/docs/en/permissions) yang terpasang. Pastikan berkas `CLAUDE.md` pada repositori memberikan panduan proyek tanpa mengizinkan pengeditan, menjalankan perintah, atau mengirim data. Tentukan persyaratan dan kode yang boleh diterima Claude, perintah yang boleh dijalankan, serta batas pemakaian untuk fitur ini. Pemakaian Claude Code dapat mengurangi kuota langganan atau menimbulkan biaya penyedia; [panduan biaya Anthropic](https://code.claude.com/docs/en/costs) tidak menetapkan tagihan Anda sebelumnya.

Untuk Jira, dapatkan izin melihat dan membuat jenis isu terkait, lalu memberi komentar atau melakukan transisi sebagai pengguna berwenang. Skrip privat dapat memakai [metode email dan token API yang didokumentasikan Atlassian](https://developer.atlassian.com/cloud/jira/platform/basic-auth-for-rest-apis); integrasi mungkin memerlukan OAuth. Simpan kredensial di penyimpanan rahasia privat. Jangan masukkan ke prompt, teks isu, `CLAUDE.md`, log, atau kontrol versi. Sepakati visibilitas isu sebelum mengirim persyaratan ke Jira.

Simpan tujuh catatan privat selama proses: `docs/feature-prd.md`, `ticket-plan.json`, jurnal penulisan isu yang hanya menerima tambahan, `ticket-map.json`, satu bukti implementasi per cerita, jurnal pembaruan Jira, dan keputusan retrospektif. Semuanya merupakan catatan fitur Anda, bukan berkas yang disediakan atau dijalankan BIG CHANGE.

## 1. Setujui satu PRD yang tepat

Berikan ringkasan fitur yang benar-benar disetujui kepada Claude Code dan minta identifikasi pertanyaan yang belum terjawab sebelum menyusun `docs/feature-prd.md`. Dokumen perlu memuat peminta dan penanggung jawab pemberi persetujuan, revisi masukan, masalah dan pengguna yang dituju, cakupan dan pengecualian, ID persyaratan bernomor, pemeriksaan penerimaan dan sumber buktinya, batasan nonfungsional, proyek Jira, dan pertanyaan terbuka. Orang yang bertanggung jawab harus membandingkan draf dengan ringkasan asli serta menyetujui satu revisi isi dan hash yang tepat. Selesaikan pertanyaan penting sebelum membuat isu atau mengedit kode.

Hash memberi sumber yang tepat bagi catatan berikutnya. Jika PRD berubah, tinjau kembali rencana tiket dan pemeriksaan yang terdampak; kegagalan implementasi bukan alasan menulis ulang kriteria penerimaan agar lolos.

## 2. Temukan hierarki dan kolom Jira proyek ini

Dengan permintaan Jira REST API v3 yang diizinkan dan **hanya membaca**, telusuri semua halaman `GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes`. Untuk setiap jenis isu yang diusulkan, telusuri semua halaman `GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId}` untuk menemukan kolom wajib pembuatan dan nilai yang diizinkan. Atlassian menandai operasi luas `GET /issue/createmeta` sebagai usang dalam [referensi API isu](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/) mereka.

Pastikan adanya induk nyata setara epik, anak setingkat cerita, dan subtugas yang didukung proyek ini. Atlassian menjelaskan [hierarki bawaan dan konfigurasinya](https://support.atlassian.com/jira-cloud-administration/docs/configure-the-issue-type-hierarchy/); nama dan ID jenis tidak berlaku universal. Periksa cara kerja kolom Parent proyek pada setiap tingkat anak serta kolom khusus atau pengaturan visibilitas yang diperlukan untuk membuat isu. Jika proyek tidak mampu mewakili struktur yang disetujui, catat jenis, kolom, atau izin yang kurang dan tahan pembuatan. Tautan isu umum tidak menjadikan isu sebagai anak.

## 3. Tinjau seluruh rencana tiket sebelum menulis

Petakan setiap persyaratan PRD dan pemeriksaan penerimaan ke `ticket-plan.json`. Catat `planVersion` miliknya, hash PRD, situs dan kunci proyek Jira, ID eksekusi lokal, serta pemberi persetujuan rencana dan waktunya. Untuk setiap isu yang diusulkan, catat ID lokal unik, ID lokal induk yang dituju, ID jenis isu yang ditemukan, kolom wajib proyek, ringkasan, deskripsi, ID persyaratan dan penerimaan, penanggung jawab, dan visibilitas yang diizinkan. Pekerjaan yang disetujui menentukan jumlah cerita dan subtugas. Setiap subtugas harus melakukan pekerjaan nyata di bawah cerita yang sebenarnya.

Jira REST v3 memakai **Atlassian Document Format (ADF)**, dokumen JSON terstruktur, untuk deskripsi isu dan komentar multibaris. Siapkan dokumen dari isi yang disetujui dan periksa metadata kolom yang dikembalikan situs sebelum menyusun setiap permintaan. [API isu](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/) mendokumentasikan operasi pembuatan; API itu tidak dapat menyediakan objek kolom siap pakai bagi proyek yang tidak diketahui. Manusia harus menyetujui struktur lengkap, cakupan semua persyaratan, hubungan induk, dan tujuan penulisan yang tepat sebelum `POST` apa pun.

## 4. Buat induk dahulu dan baca kembali setiap isu

Buat induk yang disetujui melalui `POST /rest/api/3/issue`, lalu cerita-ceritanya, kemudian setiap subtugas nyata. Sebelum **setiap** permintaan, tambahkan baris jurnal privat berisi ID eksekusi, ID isu lokal, kunci induk terkonfirmasi jika berlaku, tujuan, hash permintaan tepat yang disetujui, waktu percobaan UTC, dan status `pending`. Jangan sertakan token. Saat menerima HTTP 201, catat ID dan kunci isu yang dikembalikan Jira, lalu langsung panggil `GET /rest/api/3/issue/{issueIdOrKey}`. Bandingkan proyek, jenis, ringkasan, deskripsi atau rujukan PRD, dan induk dengan rencana yang disetujui. Tandai baris sebagai `confirmed` hanya setelah pembacaan ulang tersebut. Induk yang terkonfirmasi memungkinkan pembuatan anaknya.

Jika permintaan kehabisan waktu atau respons hilang, tandai sebagai `unknown`. Periksa Jira berdasarkan proyek, waktu, ringkasan yang disetujui, dan rujukan rencana, lalu buka langsung kemungkinan kecocokan dan minta penanggung jawab berwenang memastikan identitasnya. [Atlassian memperingatkan bahwa pencarian setelah penulisan bisa tertunda](https://developer.atlassian.com/cloud/jira/platform/search-and-reconcile/). Tidak ada hasil pencarian bukan bukti bahwa pembuatan gagal. ID eksekusi dan jurnal membantu pencocokan, tetapi tidak membuat server menolak pembuatan duplikat. Jangan pernah mengulangi `POST` yang hasilnya tidak pasti secara membabi buta.

Baca langsung struktur yang selesai ke `ticket-map.json`: setiap ID lokal, ID dan kunci Jira sebenarnya, URL kanonis isu, proyek, jenis, kunci induk, ID PRD dan penerimaan, waktu pembacaan ulang, serta rujukan jurnal. Bandingkan **semua** isu dan kriteria yang disetujui dengan PRD. Hentikan penulisan berikutnya jika isu hilang atau induknya salah; gunakan proses koreksi proyek yang telah ditinjau.

## 5. Implementasikan dan tinjau secara independen setiap cerita yang disetujui

Kerjakan cerita yang disetujui menurut urutan ketergantungan. Untuk masing-masing, catat kunci Jira, commit awal Git dan cabang atau pohon kerja, perintah penerimaan asli, serta jalur dan perintah yang diizinkan. Minta Claude Code memakai [Plan mode](https://code.claude.com/docs/en/common-workflows) untuk memetakan kriteria cerita ke repositori. Pengembang memeriksa rencana dan mengizinkan edit dengan cakupan terbatas. Batas cerita menjaga perubahan mudah ditinjau; batas itu tidak menghapus cerita lain yang disetujui dari fitur.

Setelah mengedit, simpan diff yang tepat, perintah pemeriksaan asli beserta keluaran lengkap dan status keluarnya, pengujian terarah yang relevan, serta putusan untuk setiap ID persyaratan. Periksa kode dan log sebenarnya. Rencana tertulis, berkas yang dihasilkan, atau pernyataan Claude bahwa pengujian lolos tidak membuktikan perubahan berfungsi. Tahan cerita jika pemeriksaan gagal, muncul rahasia tak terduga, perubahan dependensi, penulisan eksternal, atau perombakan kode besar; perbaiki dalam cakupan yang disetujui dan jalankan ulang pemeriksaan asli. Peninjau kode terpisah memutuskan menerima commit hasilnya atau menahan diff. Catat keputusan itu untuk setiap cerita. [Panduan kami sebelumnya untuk satu perubahan Claude Code yang ditinjau](https://bigchange.ai/blog/superpowers-claude-code-plan-test-review-change-guide) mencakup tahap peninjauan kode yang lebih sempit; PRD dan struktur lengkap Jira di sini memberi batas fitur yang lebih luas.

## 6. Verifikasi pembaruan Jira yang diizinkan

Untuk setiap cerita yang ditinjau, baca status Jira saat ini dan minta `GET /rest/api/3/issue/{key}/transitions?expand=transitions.fields`. Periksa transisi yang benar-benar tersedia bagi pengguna ini, tujuannya, kolom wajib, dan nilai yang diizinkan. Penanggung jawab berwenang kemudian dapat mengirim transisi terpilih melalui `POST /rest/api/3/issue/{key}/transitions` dengan nilai kolom yang ditentukan untuk proyek. Baca kembali isu secara langsung dan pastikan status barunya. Lolos pemeriksaan kode sendiri tidak mengizinkan Done, penggabungan, atau penerapan.

Catat status sebelum penulisan, transisi yang dituju, pengguna pelaksana, permintaan, dan respons dalam jurnal pembaruan Jira. Kirim komentar bukti ADF yang faktual melalui `POST /rest/api/3/issue/{key}/comment`: commit yang diterima atau diff yang ditahan, pemeriksaan asli dan pengujian terarah, kegagalan tersisa, serta keputusan peninjau. Baca kembali ID dan isi komentar yang dibuat melalui [API komentar](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/) Jira. Jika respons salah satu penulisan tidak pasti, periksa status atau komentar secara langsung sebelum mempertimbangkan permintaan lain. Daftar transisi kosong atau kolom wajib yang tidak tersedia adalah kekurangan alur kerja atau izin yang perlu diselesaikan bersama penanggung jawab proyek, bukan alasan mengarang ID.

## 7. Putuskan apakah `CLAUDE.md` perlu diubah

Bandingkan catatan PRD, tiket, diff, pengujian, peninjauan, dan Jira sebenarnya. Minta Claude membuat retrospektif singkat yang menunjuk salah paham yang diamati atau pemeriksaan yang kurang. Manusia memilih edit panduan yang tepat atau mencatat keputusan tanpa perubahan, beserta peninjau dan waktunya. Jika disetujui, periksa dan buat commit hanya untuk diff `CLAUDE.md` dan hash-nya. [Panduan memori Anthropic](https://code.claude.com/docs/en/memory) menjelaskan panduan proyek; tinjauan ini tidak otomatis mengizinkan pekerjaan mendatang. Jangan menambahkan rahasia atau menjadikan pelajaran spekulatif sebagai aturan proyek.

## Penyelesaian dan pemulihan

Fitur selesai hanya jika revisi PRD yang disetujui sesuai dengan struktur epik, cerita, dan subtugas yang dikonfirmasi langsung; **setiap cerita yang disetujui** memiliki keadaan awal, diff yang diterima, bukti pemeriksaan asli dan pengujian terarah, serta tinjauan independen; setiap transisi Jira dan komentar bukti yang diizinkan telah dibaca kembali langsung; dan manusia telah memutuskan hasil retrospektif. Catat tahap tersisa yang tepat jika ada bagian yang kurang. [Memilih tugas AI pertama](https://bigchange.ai/blog/map-work-choose-first-ai-task-guide) berakhir lebih awal, pada pemilihan tugas dan usulan pemeriksaan; itu tidak membuktikan hasil implementasi ini.

Pembuatan Jira yang tidak pasti tetap `unknown` sampai manusia mencocokkan identitasnya. Induk yang salah menghentikan pembuatan anak. Pengujian gagal tetap mempertahankan kriteria aslinya. Transisi yang hilang atau batas pemakaian habis menyisakan catatan sebagian bertanggal bagi penanggung jawab. Batasi persyaratan dan data pelanggan pada minimum yang disetujui untuk Claude dan Jira, periksa biaya serta izin akun saat ini, dan anggarkan peninjauan kode oleh manusia. Panduan ini mendokumentasikan jalur bersyarat melalui alat; tidak melaporkan fitur selesai, penulisan Jira, eksekusi model, penghematan terukur, penggabungan, atau penerapan oleh BIG CHANGE.

## Sumber dan bacaan lanjutan

- [Atlassian, operasi isu Jira Cloud REST API v3](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/): metadata pembuatan dengan cakupan terbatas, pembuatan dan pembacaan isu, serta operasi transisi. Kolom dan ID proyek pembaca harus ditemukan di proyek tersebut.
- [Atlassian, komentar isu](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/): pembuatan dan pembacaan ulang komentar ADF. Izin dan respons sebenarnya tetap bergantung pada situs.
- [Atlassian, pencarian dan pencocokan](https://developer.atlassian.com/cloud/jira/platform/search-and-reconcile/): menjelaskan mengapa ketiadaan hasil pencarian segera setelah penulisan tidak dapat memastikan pembuatan yang hasilnya tidak jelas.
- [Atlassian, hierarki jenis isu](https://support.atlassian.com/jira-cloud-administration/docs/configure-the-issue-type-hierarchy/): tingkat bawaan dan konfigurasi; struktur proyek terpilih tetap perlu diperiksa.
- [Anthropic, alur kerja Claude Code](https://code.claude.com/docs/en/common-workflows), [izin](https://code.claude.com/docs/en/permissions), [memori](https://code.claude.com/docs/en/memory), dan [biaya](https://code.claude.com/docs/en/costs): perencanaan, wewenang mengedit, panduan `CLAUDE.md`, dan pemakaian. Dokumen itu tidak mencatat eksekusi fitur ini.

## Sources

- [Atlassian Jira Cloud REST API v3, isu](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/) — Mendokumentasikan metadata pembuatan dengan cakupan terbatas, POST/GET isu, dan transisi; metadata pembuatan yang luas sudah usang. Kolom proyek, ID, dan transisi yang diizinkan harus berasal dari situs pembaca.
- [Atlassian Jira Cloud REST API v3, komentar isu](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/) — Mendokumentasikan pembuatan dan pembacaan ulang komentar ADF sesuai izin sebenarnya. Tidak ada komentar yang dikirim untuk panduan ini.
- [Atlassian, pencarian dan pencocokan](https://developer.atlassian.com/cloud/jira/platform/search-and-reconcile/) — Menjelaskan konsistensi pencarian yang tercapai setelah jeda; tidak adanya hasil tidak membuktikan isu tidak ada setelah respons pembuatan yang tidak pasti.
- [Atlassian, konfigurasi hierarki jenis isu](https://support.atlassian.com/jira-cloud-administration/docs/configure-the-issue-type-hierarchy/) — Menjelaskan hierarki bawaan dan yang dapat dikonfigurasi. Tingkat proyek terpilih serta perilaku Parent harus ditemukan langsung.
- [Atlassian, autentikasi dasar untuk REST API](https://developer.atlassian.com/cloud/jira/platform/basic-auth-for-rest-apis/) — Mendukung email dan token API untuk skrip privat sederhana serta menjelaskan perbedaan untuk integrasi; kredensial harus tetap privat.
- [Anthropic Claude Code, alur kerja umum](https://code.claude.com/docs/en/common-workflows) — Mendokumentasikan Plan mode dan pola alur pemrograman; tidak membuktikan implementasi atau pemeriksaan pembaca.
- [Anthropic Claude Code, izin](https://code.claude.com/docs/en/permissions) — Mendokumentasikan izin alat yang berlaku dan persetujuan; panduan CLAUDE.md saja tidak mengizinkan perintah atau penulisan.
- [Anthropic Claude Code, memori](https://code.claude.com/docs/en/memory) — Menjelaskan panduan proyek CLAUDE.md; edit retrospektif yang diusulkan memerlukan tinjauan manusia dan bukan pembelajaran otomatis.
- [Anthropic Claude Code, biaya](https://code.claude.com/docs/en/costs) — Pemakaian dan tagihan bervariasi menurut paket dan penyedia; tidak ada biaya atau penghematan yang diukur dalam panduan berbasis dokumentasi ini.