# Checklist Coding dengan AI: Alur Kerja untuk Coding Agent

> Checklist coding dengan AI gratis untuk bekerja dengan coding agent: beri konteks, rencanakan, kerjakan bertahap, verifikasi dengan output nyata, commit.

URL: https://www.matthewswong.com/id/toolkit/ai-coding-workflow-checklist/

- Author: Matthews Wong (https://www.matthewswong.com/id/about/)
- Diperbarui: 13 November 2026

> **Poin utama:** Checklist satu halaman untuk mendapatkan hasil kerja yang bisa diandalkan dari coding agent. Enam fase: pahami tujuan dan cara mengujinya, beri konteks, minta rencana, kerjakan dalam langkah kecil, verifikasi dengan output nyata, lalu tutup dengan commit dan catatan pelajaran. Checklist ini netral terhadap tool dan cocok untuk agent apa pun yang membaca repositori dan menjalankan perintah.

- Jenis: Panduan
- Bisa dipakai di: Claude Code, Codex, Cursor, Any coding agent
- Unduh: [ai-coding-workflow-checklist.md](https://www.matthewswong.com/downloads/toolkit/ai-coding-workflow-checklist/ai-coding-workflow-checklist.md) (2.7 KB)
- Lisensi: Bebas dipakai, diubah, dan dibagikan, termasuk untuk pekerjaan.

## File-nya

Persis isi unduhannya. Baca dulu, lalu salin atau unduh.

### ai-coding-workflow-checklist.md

```markdown
# AI coding workflow checklist

One page for working with a coding agent. It works with any agent that can
read your repository and run commands. Skip a box only on purpose.

## 1. Before you prompt

- [ ] I can state the goal in one sentence.
- [ ] I know the acceptance check: the test, command or screen that proves it
      is done.
- [ ] I know which files are involved, or I will ask the agent to find them
      first.
- [ ] The working tree is clean, so the agent's changes are easy to see and
      easy to undo.

## 2. Give context

- [ ] I point at files by path instead of describing them.
- [ ] I state the constraints: no new libraries, follow this pattern, keep
      this interface.
- [ ] I say what not to touch.
- [ ] I paste the real error, log or screenshot, not my summary of it.
- [ ] I give what the code cannot tell: a decision, a deadline, a rule of the
      business.

## 3. Plan first

- [ ] For anything non-trivial, I ask for a plan before any code.
- [ ] The plan lists the files it will change and how each step is verified.
- [ ] The agent lists its assumptions and the decisions it needs from me.
- [ ] I answer those questions. I do not let it guess.
- [ ] If the plan is wrong, I fix the plan, not the code that comes after.

## 4. Work in small steps

- [ ] One logical change at a time.
- [ ] The agent runs the tests or the build after each step.
- [ ] I read the diff of every step before the next one starts.
- [ ] I stop it the moment it drifts, and I restate the goal.
- [ ] After two failed corrections, I start a fresh session with a better
      prompt.

## 5. Verify

- [ ] I ask for evidence: the command that ran and its output.
- [ ] I never accept "it works" without that output.
- [ ] I run it myself at least once: the tests, the build, the real screen.
- [ ] For a bug, the failure is reproduced first, and the cause is stated
      with evidence before any fix.
- [ ] After the fix, the same reproduction runs again and passes.
- [ ] The diff contains nothing I did not ask for.

## 6. Finish

- [ ] One commit per logical unit, with a message that says what and why.
- [ ] The reproduction is kept as a regression test where practical.
- [ ] I write down what was learned: the gotcha, the decision, the command.
- [ ] I update the instructions file the agent reads, so the next session
      starts with it.
- [ ] Temporary logging and scratch files are removed.

## When it goes wrong

- The agent built something else: the goal or the context was missing. Go
  back to sections 1 and 2.
- It says done but it is not: it had no check to run. Go back to section 5.
- It keeps making the same mistake: write the rule into the instructions
  file, or enforce it with a script.
```

## Pakai saat

- Agent terus membuat sesuatu yang berbeda dari yang Anda maksud.
- Anda menerima perubahan karena terlihat selesai, lalu belakangan ternyata belum.
- Anda memperkenalkan coding agent ke tim dan ingin satu rutinitas bersama.
- Sebuah sesi menghasilkan diff besar yang tidak sanggup di-review siapa pun.

## Dari unduh sampai jalan

1. **Buka di samping agent.** Unduh file Markdown-nya lalu buka di editor atau cetak. Kotak centangnya tampil di penampil Markdown apa pun.
2. **Kerjakan bagian 1 sampai 3 sebelum ada kode.** Nyatakan tujuan, sebutkan cara mengujinya, beri konteks, lalu minta rencana. Untuk perbaikan satu baris ini hanya semenit. Untuk sebuah fitur, di sinilah sebagian besar hasilnya ditentukan.
3. **Ulangi bagian 4 dan 5 untuk tiap langkah.** Satu perubahan logis, lalu tes, lalu baca diff-nya, lalu minta perintah beserta output-nya. Ulangi sampai rencananya selesai.
4. **Tutup dengan bagian 6.** Commit per unit dan tuliskan pelajarannya ke file instruksi yang dibaca agent Anda, supaya sesi berikutnya tidak mengulang kesalahan yang sama.
5. **Sesuaikan dengan tim Anda.** Hapus kotak yang sudah ditegakkan oleh tooling Anda dan tambahkan yang dibutuhkan proyek, misalnya pemeriksaan migrasi atau security review.

## Kenapa ditulis seperti ini

- **Enam fase, sesuai urutan kerjanya.** Sebelum prompt, beri konteks, rencanakan dulu, kerjakan dalam langkah kecil, verifikasi, selesaikan. Tiap fase berisi empat sampai enam kotak, cukup pendek untuk dicentang tanpa meninggalkan pekerjaan.
- **Cara menguji ditentukan paling awal.** Kotak kedua meminta tes, perintah, atau layar yang membuktikan pekerjaan selesai. Agent yang punya pemeriksaan untuk dijalankan bisa menemukan kesalahannya sendiri. Tanpa itu, Anda yang menjadi test suite-nya.
- **Asumsi dituliskan, bukan ditebak.** Fase rencana membuat agent menuliskan asumsinya dan keputusan yang ia butuhkan dari Anda. Asumsi yang salah murah diperbaiki di rencana dan mahal diperbaiki di kode.
- **Bukti, bukan klaim.** Fase verifikasi meminta perintah yang dijalankan beserta output-nya, dan untuk bug meminta reproduksi sebelum ada perbaikan. Reproduksi yang sama dijalankan lagi setelah perbaikan.
- **Bagian singkat saat ada yang salah.** Tiga kegagalan yang umum masing-masing menunjuk kembali ke fase pencegahnya: tujuan yang tidak ada, pemeriksaan yang tidak ada, atau aturan yang tidak pernah dituliskan.

## Yang sering salah

- Checklist tidak menggantikan membaca diff. Bila Anda mencentang kotak tanpa melihat perubahannya, risikonya hanya berpindah tempat.
- Checklist ini terlalu berat untuk sekadar salah ketik. Pakai bagian 1, 5, dan 6 untuk perubahan kecil, dan daftar lengkapnya untuk apa pun yang menyentuh lebih dari satu file.
- Aturan yang harus selalu berlaku tidak cocok ditaruh di checklist yang bisa dilewati orang. Tegakkan dengan script, hook, atau langkah pipeline yang wajib.

## FAQ

### Apakah checklist ini hanya untuk Claude Code?

Tidak. Checklist ini tidak menyebut perintah atau fitur produk tertentu. Ia cocok untuk coding agent apa pun yang bisa membaca repositori dan menjalankan perintah, dan sebagian besar isinya juga berlaku untuk asisten chat tempat Anda menempelkan kode.

### Kenapa perlu meminta rencana dulu ke coding agent?

Rencana memperlihatkan file yang akan diubah agent dan asumsi yang ia pakai sebelum ada kode. Mengoreksi rencana cukup dengan satu pesan. Mengoreksi kode yang dibangun di atas asumsi keliru berarti membaca, membatalkan, dan mengerjakan ulang.

### Kenapa ucapan agent bahwa semuanya jalan belum cukup?

Agent berhenti saat pekerjaan terlihat selesai. Halaman best practices Claude Code menyebutnya begini: klaim bahwa semua tes lolos nyaris tidak memberi tahu apa-apa, jadi mintalah perintah yang dijalankan beserta output-nya. Membaca output itu lebih cepat daripada menjalankan ulang pemeriksaannya sendiri.

### Apa yang dimaksud file instruksi di bagian terakhir?

Itu adalah file yang dimuat agent di awal sesi, misalnya CLAUDE.md di Claude Code. Tuliskan hanya hal yang tidak bisa disimpulkan agent dari kode: sebuah perintah, konvensi, atau jebakan. File yang pendek dibaca lebih andal daripada yang panjang.

## Pelajari apa yang dikemas file ini

- Pelajaran gratis: [Rewind dan Plan Mode Claude Code: Batalkan Perubahan Berisiko](https://www.matthewswong.com/id/learn/claude-code-tips/claude-code-rewind-plan-mode-safe-changes/)
- Pelajaran gratis: [Git di Claude Code: Commit, PR, dan Aturan Push yang Aman](https://www.matthewswong.com/id/learn/claude-code-tips/claude-code-git-workflow-safe-commits/)
- Pelajaran gratis: [CLAUDE.md Adalah: Contoh File, Lapisan, dan Urutan Memuatnya](https://www.matthewswong.com/id/learn/claude-code-tips/claude-md-file-example/)
- [Agentic Coding Workflow: Best Practices for AI Agents](https://www.matthewswong.com/id/blog/agentic-coding-workflow-best-practices/)
- [Verification Loop: Skill Inti Agentic Coding](https://www.matthewswong.com/id/blog/verification-loops-agentic-coding/)
- [TDD dengan AI Coding Agent: Alur Kerja Praktis](https://www.matthewswong.com/id/blog/tdd-with-ai-coding-agents/)
- [Spec-Driven Development With AI Coding Agents](https://www.matthewswong.com/id/blog/spec-driven-development-ai-agents/)

## Sumber

- [Claude Code docs: best practices for Claude Code](https://code.claude.com/docs/en/best-practices)

[Semua item toolkit](https://www.matthewswong.com/id/toolkit/)

---

- HTML version: https://www.matthewswong.com/id/toolkit/ai-coding-workflow-checklist/
- English: https://www.matthewswong.com/en/toolkit/ai-coding-workflow-checklist/
- Site index for agents: https://www.matthewswong.com/llms.txt
- Sitemap: https://www.matthewswong.com/sitemap.xml
- API description (OpenAPI): https://www.matthewswong.com/openapi.json
