Lewati ke konten

Petunjuk Pengoperasian

Panduan pengguna lengkap. Untuk konsep, lihat Pengantar.

Daftar di eastagiletracker.com/register dengan email dan kata sandi, atau lanjutkan dengan GitHub jika Anda lebih suka OAuth. Verifikasi email Anda dari tautan yang kami kirim; hingga saat itu Anda bisa masuk tetapi beberapa fitur terbatas.

Jika Anda telah diundang ke proyek atau organisasi, ikuti tautan di email undangan — akun Anda dibuat (atau Anda masuk) dan Anda mendarat langsung di papan yang sesuai.

Lupa kata sandi? Gunakan Forgot Password di halaman masuk; kami mengirim tautan reset lewat email.

Dari avatar di kanan atas → Account Settings:

  • Profile — Nama tampilan, inisial (digunakan dalam avatar pemilik), email.
  • Bio — Deskripsi diri singkat (hingga 4 KiB). Muncul di /me dan pada daftar anggota organisasi sehingga agen (atau rekan setim) bisa memilih orang yang tepat untuk ditanya. Biarkan kosong untuk tidak ikut serta.
  • Password — Ubah kapan saja.
  • Avatar — Unggah gambar, atau jatuh kembali ke inisial Anda.
  • API Keys — Buat token API pribadi; lihat Panduan API.
  • Theme — Agile, Labs, Dark, atau Light (juga dapat diubah dari sidebar).
  • Delete Account — Konfirmasi dua-langkah. Menghapus Anda dari semua organisasi dan proyek.

Dari avatar di kanan atas → Security:

  • Dua faktor (TOTP) — Siapkan kode dari aplikasi autentikator mana pun (1Password, Authy, Google Authenticator, …). Dapatkan 10 kode pemulihan sekali-pakai — mereka ditampilkan satu kali, jadi simpanlah. Nonaktifkan nanti dengan kode saat ini atau kode pemulihan.
  • Passkey — Tambahkan passkey WebAuthn yang terikat-perangkat (Touch ID, Windows Hello, kunci keamanan perangkat keras). Masuk tanpa kata sandi setelahnya. Tambah, beri nama, dan hapus kunci dari halaman yang sama.

Sebuah sign-in yang berhasil mencetak dua token: access JWT berumur pendek dan refresh token berumur panjang (30 hari, dirotasi pada setiap penggunaan). SPA me-refresh access token secara otomatis ketika kedaluwarsa; Anda tetap masuk sampai refresh token kedaluwarsa atau Anda keluar. Sign-out mencabut refresh token di sisi server, sehingga salinan yang dicuri tidak dapat diputar ulang.

Sebagian besar akun bersifat Free Forever untuk penggunaan pribadi. Jika akun Anda memiliki saldo kredit terukur, temukan di bawah Account → Billing — isi ulang lewat checkout Paddle, lihat riwayat transaksi.

Setiap akun termasuk dalam satu atau lebih organisasi. Pendaftaran baru mendapatkan organisasi pribadi (“Organisasi <Nama>”) yang dibuat otomatis ala Linear/Vercel. Proyek berada di dalam organisasi, dan keanggotaan organisasi menggerbangi keanggotaan proyek.

Klik pengalih organisasi di topbar untuk berpindah antar organisasi tempat Anda berada. Organisasi aktif mewarnai sidebar, mencakupkan daftar “Projects”, dan terpilih lebih dulu saat Anda membuat proyek baru.

Klik blok organisasi di sidebar → Manage organization → Anda mendarat di /organization/{id}/projects. Sidebar menampilkan tiga tab admin:

  • Projects — Semua proyek dalam organisasi ini.
  • Members — Anggota saat ini, peran, dan undangan tertunda. Undang lewat email; undangan dipasak-email dengan token TTL dan plafon peran (anggota tidak dapat mengundang admin).
  • Settings (hanya owner) — Nama organisasi, slug, paket. Transfer kepemilikan ke anggota lain di sini.

Menghapus anggota dari organisasi berjenjang: keanggotaan per-proyek mereka di proyek-proyek organisasi itu dicabut dalam transaksi yang sama. URL papan yang di-bookmark berhenti bekerja begitu mereka kehilangan akses organisasi — tidak ada jejak yatim.

Dari halaman Projects, klik New Project. Formulir pembuatan hanya menanyakan dua hal:

  • Title — Wajib.
  • Description — Opsional; terlihat oleh semua anggota.

Selebihnya — panjang iterasi, hari mulai, velocity awal, skala estimasi, done state, sakelar task — diatur kemudian di Project Settings dan diisi dengan default yang masuk akal.

Di bawah menu Settings proyek, empat tab:

  • Project — Edit judul, deskripsi, panjang iterasi dan hari mulai, strategi velocity (rata-rata 3 / 5 / 10 terakhir), done state, skala estimasi, sakelar task.
  • Member — Undang, naikkan/turunkan, dan hapus anggota manusia (lihat Anggota dan undangan, di bawah).
  • Agent — Cetak dan cabut kunci API agen untuk proyek ini (lihat Agen, di bawah). Hanya-owner.
  • Import — Bawa story masuk dari tracker lain (lihat Mengimpor dari tracker lain, di bawah).

Di tab Member pada Project Settings, undang manusia lewat email. Undangan tertunda berada di keranjang terpisah sampai diterima; Anda melihat siapa yang diundang dan dapat mengirim ulang atau mencabut. Anggota aktif dapat dinaikkan/diturunkan antara viewer, member, dan owner. Owner dapat mengubah pengaturan proyek; viewer dapat membaca tetapi tidak menulis.

Riwayat proyek ada di halamannya sendiri — setiap perubahan pengaturan proyek, setiap perubahan keanggotaan, dengan aktor (manusia atau agen).

Gunakan fasilitas + Add story pada panel papan mana pun (Current, Backlog, Icebox, atau yang kustom) — ketik judul dan tekan Enter.

Story baru yang dibuat di Current default ke current_state = 'unstarted'. Itu paritas PT: iterasi Current adalah rencana pekerjaan, bukan partisi berdasarkan status. Pemilik secara eksplisit men-Start story ketika mereka mulai mengerjakan — jam cycle-time tidak mulai berjalan sampai saat itu.

Wajib: judul. Pilih tipe (default feature). Tambahkan deskripsi, estimasi (hanya feature), label, pemilik, pengikut, blocker — semua ini dapat diisi nanti dari panel detail.

Menekan Enter dua kali dengan cepat? Tidak masalah — tombolnya terjaga; Anda mendapatkan tepat satu story.

Feature adalah satu-satunya tipe yang menerima poin. Klik lingkaran poin pada kartu (atau di panel detail) dan pilih dari skala. Feature yang belum diestimasi menampilkan lingkaran kosong.

  • Skala Fibonacci0, 1, 2, 3, 5, 8, 13. XP standar. Apa pun yang lebih besar dari 13 harus dipecah menjadi story yang lebih kecil.
  • Skala East Agile0, 1, 2, 3. Lebih ketat. Angka 3 berarti satu iterasi penuh waktu satu orang. Tidak ada yang muat melebihi 3.
  • Skala 3-Point1, 2, 3 (Small / Medium / Large). Penilaian ukuran t-shirt ketat — tanpa opsi nol, tanpa setengah-poin.

Pilih skala sekali di Project Settings; Anda dapat mengubahnya nanti (estimasi yang ada dipetakan ulang).

Tiga cara untuk menggerakkan story melalui daur hidup:

  1. Klik tombol aksi inline pada kartu — Start, Finish, Deliver, Accept, Reject. Teks tombol mencerminkan status valid berikutnya untuk tipe story.
  2. Seret kartu ke kolom yang berbeda. Sistem menerapkan transisi yang tersirat oleh penyeberangan kolom itu. Pergerakan mundur meminta konfirmasi.
  3. Transisi massal — Pilih beberapa story, Transition all — setiap story bertransisi secara independen. Jika satu ilegal, yang lain tetap lolos.

Klik di mana saja pada baris story untuk memperluasnya inline. Panel detail menampilkan:

  • Judul (dapat diedit), deskripsi (Markdown), tipe, estimasi, requestor.
  • Pemilik (tambah/hapus anggota atau agen), pengikut, label.
  • Task (jika diaktifkan), komentar, lampiran, blocker, link, review.
  • Menu 3-titik untuk duplikat, hapus, dan aksi lain yang kurang umum.

Tekan Escape untuk menutup story yang terakhir dibuka (ia mengingat tumpukannya — ciutkan satu per satu).

Hingga 10.000 karakter, Markdown dirender. Edit dan hapus komentar Anda sendiri; log audit menyimpan riwayatnya. @-sebut anggota dan autocomplete menangkapnya.

Seret file ke panel detail, atau gunakan tombol unggah. Hingga 2 GB per file — ya, cukup besar untuk panduan video rekaman layar. Gunakan pemutar video inline.

Dari halaman Labels di sidebar: buat label dengan nama dan warna, arsipkan saat usang (label terarsip hilang dari papan tetapi tetap dapat dicari). Tambahkan label per story di panel detail.

  • Blocker — Catatan teks-bebas “ini diblokir oleh X”. Tandai resolved/unresolved. Filter papan dengan has:blocker.
  • Link — Enam tipe relasi: relates to, duplicates, blocks, is blocked by, pull request, branch. Tempel URL GitHub dan tipenya terdeteksi otomatis.
  • Review — Tugaskan reviewer (manusia atau agen) dengan status (pending, approved, rejected) dan komentar opsional.

Jika diaktifkan di Project Settings, story mendapat sub-task — sebuah checklist di dalam story. Centang saat Anda berjalan; jumlahnya muncul di kartu.

Setiap variabel pilihan pada permukaan detail-story membawa ikon kecil [?] di samping labelnya. Klik di dalam aplikasi untuk melihat panduan yang sama seperti diringkas di bawah. Penerjemah mengirim teks dalam-aplikasi bersama bagian UI lainnya; bagian ini adalah referensi kanonik bentuk-panjang.

Field-field tercantum dalam urutan kemunculannya di tab Overview.

Tempat story dalam daur hidup: Unstarted → Started → Finished → Delivered → Accepted (atau Rejected kembali ke Started).

Status kritisnya adalah Delivered: engineer menandainya delivered, tetapi ia belum selesai sampai product owner secara eksplisit Accepts terhadap kriteria penerimaan — atau menolaknya, mengembalikannya. Ini menanamkan loop umpan balik pelanggan ke dalam setiap story alih-alih menunda penerimaan ke demo akhir-sprint.

Jika story menumpuk di Delivered, itu sinyal bahwa loop accept/reject telah macet. Perhatikan jumlah Delivered di akhir setiap iterasi — jika bertambah, itu sinyal Anda bahwa product owner kekurangan sumber daya atau kriteria penerimaan kurang jelas di muka.

Iterasi mana story direncanakan. Biarkan sebagai None untuk menjaga story di Backlog, di mana sistem akan mengelompokkannya secara otomatis di bawah iterasi mendatang berdasarkan velocity.

Penggantian manual di sini berguna ketika Anda ingin menyematkan story ke iterasi tertentu terlepas dari urutan — mis. mengikat story release ke tanggal tetap. Jika tidak, biarkan urutan di Backlog menggerakkan penugasan iterasi; itulah yang menjaga proyeksi velocity tetap jujur.

Siapa yang melakukan pekerjaan. Pemilik bisa manusia atau agen — keduanya dirender sebagai partisipan bernama dalam log audit, kepengarangan komentar, dan analitik. Tidak ada cara untuk menyamarkan pemilik agen sebagai manusia.

Pemilik ganda adalah ekspresi terlihat dari pair programming (atau pair-dengan-agen). Tambahkan agen yang mengambil story dan manusia yang me-review — kedua nama muncul di kartu. Ini menjaga work-in-progress tetap rendah; menyelesaikan sebelum memulai story berikutnya adalah tuas tunggal terbesar pada cycle time.

Pemilik tidak sama dengan Pengikut (field terpisah di kartu). Pengikut adalah orang yang peduli pada story tetapi tidak melakukan pekerjaan — biasanya pelanggan notifikasi.

Keempat tipe tidak dapat dipertukarkan — perbedaannya adalah inti keseluruhan dari model data.

  • Feature — Nilai baru yang dapat diamati pengguna. Satu-satunya tipe yang membawa poin dan dihitung ke velocity. Ini memaksa Anda mengiris pekerjaan menjadi nilai yang dapat dilihat pengguna.
  • Bug — Sebuah cacat. Tanpa poin. Cacat tidak menghasilkan kredit velocity, yang menjaga biaya pengerjaan ulang tetap terlihat alih-alih diberi imbalan.
  • Chore — Pekerjaan yang perlu tanpa nilai pengguna langsung (refactor, infra, penyiapan). Tanpa poin. Tim ditekan untuk menggabungkan chore ke dalam feature di mana pun memungkinkan agar pembingkaian nilai tetap jujur.
  • Release — Penanda nol-poin untuk tonggak. Langsung dari Unstarted ke Accepted, menambatkan tanggal untuk proyeksi.

Jika Anda mendapati diri ingin memberi poin pada bug atau chore: jangan. Itu memecah proyeksi yang membuat seluruh sistem jujur. Velocity adalah instrumen pengukuran; Anda tidak mengutak-atik instrumen Anda sendiri.

Jangan gunakan ini jika bisa dihindari. Backlog adalah prioritas — dari atas ke bawah, prioritas tunggal, tanpa seri. Product owner memiliki urutannya.

Field “prioritas” adalah anti-pola klasik yang diam-diam mengubah backlog yang empiris dan berurutan kembali menjadi perencanaan angan-angan. Jika Anda mendapati diri dengan tiga P1, Anda tidak punya prioritas — Anda punya Backlog dengan urutan yang salah. Perbaiki urutannya; hapus sinyal prioritas.

Field ini ada demi kompatibilitas dengan impor dari tracker yang menggunakannya (Jira, Asana, …) agar story yang diimpor tidak kehilangan informasi saat masuk. Biarkan di “None” pada pekerjaan baru.

Ukuran relatif story. Feature mendapat poin; bug, chore, dan release tetap di nol.

Estimasi adalah percakapan tentang ukuran, bukan janji. Jangan menerjemahkan poin ke jam; jangan membengkakkan poin agar terlihat cepat. Velocity adalah instrumen pengukuran — Anda tidak mengutak-atik instrumen Anda sendiri.

Tiga skala hadir:

  • Fibonacci0, 1, 2, 3, 5, 8, 13. Skala XP klasik. Apa pun yang lebih besar dari 13 harus dipecah.
  • East Agile0, 1, 2, 3. Skala yang lebih ketat. Angka 3 berarti satu iterasi penuh waktu satu orang.
  • 3-Point1, 2, 3 (Small / Medium / Large). Penilaian ukuran t-shirt yang ketat.

Jika Anda sering mengestimasi dalam 5, 8, atau 13, story Anda terlalu besar. Pecah sampai masing-masing dapat di-deliver secara independen (huruf S dan I dalam INVEST).

Siapa yang meminta story. Biasanya satu orang — product owner, pemangku kepentingan, atau agen yang bertindak atas nama seseorang.

Requester bukan pemilik. Pemilik adalah siapa pun yang melakukan pekerjaan; requester adalah siapa pun yang peduli pada hasil dan akan (atau tidak akan) menerimanya. Mereka bisa orang yang sama, tetapi mereka adalah peran terpisah. Mencatat requester adalah yang memberi Anda jawaban audit atas “siapa yang meminta ini?” enam bulan kemudian.

Tag berwarna. Story dapat membawa beberapa. Digunakan untuk kategorisasi lintas-sektoral — mvp, tech-debt, security, nama release tertentu — dan untuk pemfilteran papan (label:mvp di kotak pencarian, atau simpan sebagai panel filter kustom).

Label bersifat lingkup-proyek. Kelola di halaman Labels di sidebar. Arsipkan label usang alih-alih menghapus; arsip menjaga riwayat tetap dapat dicari sambil membersihkan papan.

Catatan teks-bebas yang menjelaskan apa yang mencegah story ini maju. Tandai resolved ketika halangan terangkat.

Blocker adalah sinyal aliran, bukan antrean. Gunakan standup harian untuk memunculkannya; selesaikan di luar jalur. Jika Anda memiliki lebih dari satu atau dua blocker terbuka per story selama lebih dari sehari, perencanaannya salah — pecah story atau ubah dependensi. Tujuannya agar panel Blocked sebagian besar kosong sepanjang waktu.

Apa itu story dan bagaimana mengenali bahwa ia selesai. Markdown.

Kriteria penerimaan ada di sini — idealnya dalam bentuk Given / When / Then sehingga memetakan langsung ke acceptance test:

Given I am signed in as a member
When I click "Add a story" in Current
Then the story is created in state "unstarted"

INVEST adalah pengecekan kewarasan apakah suatu story terbentuk dengan baik:

  • Independent — dapat dirilis tanpa story lain.
  • Negotiable — menangkap niat, bukan spesifikasi beku.
  • Valuable — bagi pengguna atau pemangku kepentingan.
  • Estimable — tim dapat mengukurnya.
  • Small — muat nyaman dalam satu iterasi.
  • Testable — memiliki kriteria penerimaan yang dapat dijalankan.

Sebuah story di bagian atas backlog dengan kriteria penerimaan yang kabur adalah bug perencanaan — bukan masalah masa depan yang bisa diabaikan. Perbaiki sebelum membiarkannya maju.

Pilih beberapa story di papan (shift-klik rentang, atau Select all in panel). Lalu:

  • Transisi massal
  • Hapus massal
  • Duplikat massal

Papan adalah layar beranda setiap proyek. Tiga kolom secara default:

  • Current — Story dalam iterasi aktif. Dikelompokkan berdasarkan header iterasi (current, lalu mendatang, lalu tertutup). Kartu muncul dalam urutan urutan-waktu iterasi dengan statusnya terlihat di setiap kartu; kolom tidak diiris berdasarkan status — itu memecah urutan-waktu iterasi yang digunakan tim untuk merencanakan.
  • Backlog — Antrean berurutan ketat. Sistem mengelompokkan otomatis iterasi mendatang berdasarkan velocity. Product owner memiliki urutan dari atas ke bawah; kejelasan boleh menurun saat Anda menggulir ke bawah, tetapi tidak pernah di bagian atas.
  • Icebox — Ide tanpa tanggal. Tidak berurutan, tidak diestimasi. Icebox boleh menjadi kuburan.

Panel yang dapat dikonfigurasi — kotak centang sidebar

Section titled “Panel yang dapat dikonfigurasi — kotak centang sidebar”

Bagian Board di sidebar mencantumkan setiap kolom preset dengan kotak centang: centang sebuah kotak untuk menampilkan kolom itu, hapus centang untuk menyembunyikan. Sakelar tersimpan per-proyek per-pengguna (disinkronkan melalui GET/PUT /preferences). Presetnya adalah:

  • Current Iteration (aktif secara default)
  • Backlog (aktif secara default)
  • Icebox (aktif secara default)
  • Done — Story yang diterima.
  • My Work — Story di mana Anda adalah pemilik.
  • Blocked — Story dengan blocker yang belum terselesaikan.
  • Epics — Rollup tingkat-epic.
  • Chat — Kolom chat lingkup-proyek.

Sematkan pencarian sebagai panel: tempel kueri seperti type:feature label:mvp owner:claire, simpan. Ubah ukuran kolom sesuai keinginan; lebar tersimpan lintas sesi.

Bilah pencarian menerima sintaks filter yang dijelaskan di Pengantar. Hasil pencarian berada di panel hasil; klik mana pun untuk melompat ke sana di papan.

Bilah atas menampilkan nomor iterasi saat ini, rentang tanggal, dan poin diterima vs direncanakan. Klik untuk melompat ke kolom Current.

Sistem membuat iterasi secara otomatis berdasarkan panjang dan hari mulai Anda. Anda tidak perlu “membuka” atau “menutup” mereka.

Untuk merencanakan ke depan, seret story dari Backlog ke grup iterasi mendatang. Sistem menandai grup merah jika melampaui velocity Anda. Untuk merencanakan lebih jauh, gulir backlog — ia menampilkan tiga atau empat iterasi ke depan.

Untuk memutar mundur: klik header iterasi lampau mana pun di kolom Current untuk menelusuri laporan iterasi.

Release adalah tipe story, bukan objek terpisah. Buat release dengan cara yang sama seperti Anda membuat story apa pun: pilih Release sebagai tipe, beri nama (mis., v2.4), seret ke iterasi tempat Anda berniat merilis.

Release melewati status Started/Finished/Delivered/Rejected — mereka langsung dari Unstarted ke Accepted dalam satu langkah. Terima release ketika Anda merilis; tampilan analitik menampilkan penanda release.

Tab Analitik (di atas proyek) memberi Anda enam laporan:

  • Project Overview — Tren velocity, KPI iterasi terkini, burnup, burndown, cumulative flow.
  • Iteration — Telusuri satu iterasi: KPI, burndown, aliran status.
  • Releases & Burndowns — Lini masa release, burndown per release.
  • Story Activity — Siapa melakukan apa, dapat difilter berdasarkan aktor, tipe, rentang tanggal.
  • Cycle Time — Rata-rata dan distribusi waktu dari Started ke done state Anda.
  • Projections — Perkiraan kapan backlog akan selesai pada velocity saat ini.

Inilah bagian dari produk yang membedakannya. Sebuah agen adalah rekan setim bernama — tetapi ia adalah AI.

Anda harus menjadi owner proyek (atau admin). Buka Project Settings → Agents:

  1. Create new agent key.
  2. Beri agen sebuah nama (akan muncul sebagai nama itu di log audit, kepengarangan komentar, dan avatar pemilik).
  3. Pilih peran — viewer (hanya-baca) atau member (dapat menulis). Peran owner dibatasi untuk manusia.
  4. Kunci ditampilkan satu kali — salin; kami tidak menyimpannya secara dapat-diambil. Awalannya adalah ea_agent_….

Agen dengan peran member dapat melakukan apa pun yang dapat dilakukan anggota manusia:

  • Membuat, mengedit, mentransisikan, menghapus story
  • Berkomentar, melampirkan file, menambah label, mengatur pemilik
  • Memilih dirinya sebagai pemilik story
  • Membaca aktivitas, mengikuti event

Log audit mencatat setiap write dengan identitas agen. Tidak ada cara untuk membuat aksi agen terlihat seperti aksi manusia.

Di Project Settings → Agents Anda melihat semua kunci aktif, nama, peran, dan stempel-waktu terakhir-digunakan. Cabut kunci kapan saja; agen kehilangan akses seketika. Aktivitas masa lalu agen tetap di log audit selamanya.

Lihat Panduan API → Kunci agen untuk contoh kode.

Jika Anda datang dari alat lain, kami punya importer untuk delapan sumber:

  • Pivotal Tracker
  • Jira
  • Asana
  • GitLab
  • Shortcut
  • Trello
  • Linear
  • Plane

Dari Project Settings → Import, unggah sebuah ekspor (CSV dari sebagian besar, JSON dari Plane). Story, pemilik, komentar, label, dan status dipetakan otomatis; beberapa sumber juga membawa iterasi.

Pratinjau menunjukkan apa yang akan diimpor. Ketidaksesuaian (mis. label yang tidak ada di proyek Anda) memunculkan prompt — buat-atau-lewati, pilihan Anda.

Empat tema hadir. Beralih di footer sidebar (atau di Account Settings → Theme):

  • Agile — Palet halaman landing pemasaran. Putih hangat, aksen merek biru-tua (#1f6f9f), ikon tipe-story yang jenuh. Opsi utama di switcher.
  • Labs — Palet Pivotal Tracker, dipelihara dengan penuh kasih. Chrome gelap, topbar biru, jeda kolom pastel. Yang asli.
  • Dark — Gelap netral murni.
  • Light — Terang netral murni. Tinta di atas kertas.

Tema Anda tersimpan lintas sesi.

UI diterjemahkan ke dalam 15 bahasa: Inggris, Prancis, Jerman, Spanyol, Jepang, Mandarin, Korea, Portugis, Italia, Belanda, Swedia, Denmark, Ceko, Finlandia, Polandia. Beralih dari footer sidebar — chrome, halaman autentikasi, area akun/keamanan, daftar proyek, dan landing pemasaran dilokalkan seketika. Lokalisasi detail-story / analitik / pengaturan menyusul.

Beberapa yang berguna:

  • Escape — Ciutkan story yang terakhir dibuka.
  • Enter dalam input inline — Kirim (tidak akan menciutkan baris).
  • Shift-klik — Pilih rentang story.

Lebih banyak ditambahkan dari waktu ke waktu; lihat Help di sidebar untuk daftar terkini.

East Agile Tracker adalah open source. Sumber lengkap ada di github.com/EastAgile/agile-tracker — kloning, build, jalankan di infrastruktur Anda sendiri. Set fitur sama dengan versi yang di-host.

Untuk penyiapan, lihat README proyek.