Kalau 2024 adalah tahun autocomplete AI, maka 2025–2026 adalah era coding agent: AI yang tidak hanya menyarankan baris kode, tapi bisa membaca seluruh repository, menjalankan perintah, memperbaiki test yang gagal, dan menyiapkan pull request. Claude Code, Codex CLI, dan Gemini CLI berlomba di terminal developer. Artikel ini membahas workflow yang terbukti efektif — fokus pada Claude Code, tapi prinsipnya berlaku untuk agent lain.
Instalasi
npm install -g @anthropic-ai/claude-code
cd project-kamu
claude
Di sesi pertama, jalankan /init agar agent membaca struktur project dan membuat file CLAUDE.md.
CLAUDE.md: Memori Project
CLAUDE.md dibaca otomatis di setiap sesi. Isinya adalah hal-hal yang tidak bisa ditebak dari kode:
# Blog Novan — Catatan untuk Agent
## Perintah
- Jalankan lokal: `php -S localhost:8000 index.php`
- Test: `vendor/bin/phpunit`
- Lint: `vendor/bin/phpstan analyse --level=6`
## Aturan
- PHP murni tanpa framework; jangan tambahkan Composer package tanpa izin.
- Semua query wajib prepared statement (PDO).
- Output HTML selalu lewat fungsi `e()` untuk escape.
- `config.php` berisi kredensial: JANGAN dibaca isinya atau di-commit.
## Struktur
- app/public = halaman publik, app/admin = panel admin
- Tema di assets/css/style.css (variabel CSS di :root)
Pendek, spesifik, dan berisi larangan yang penting. Agent yang tahu aturannya akan jauh lebih jarang membuat kesalahan.
Workflow yang Efektif
1. Minta rencana dulu untuk tugas besar
Saya mau menambah fitur "artikel terkait" di halaman post.
Jangan ubah kode dulu. Baca post.php dan functions.php,
lalu jelaskan rencanamu dalam langkah-langkah.
Rencana yang keliru jauh lebih murah diperbaiki daripada kode yang keliru.
2. Berikan cara memverifikasi
Agent bekerja paling baik jika punya "hakim" objektif: test, linter, atau perintah yang bisa dijalankan. Kalimat seperti "pastikan phpunit hijau sebelum selesai" sangat berpengaruh.
3. Pecah tugas, commit sering
Satu tugas, satu sesi, satu commit. Jika hasilnya buruk, git checkout . dan coba lagi dengan instruksi yang lebih jelas.
Hooks: Pagar Otomatis
Hooks menjalankan perintah otomatis pada momen tertentu — misalnya merapikan format setiap kali agent mengedit file:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{ "type": "command", "command": "vendor/bin/php-cs-fixer fix --quiet || true" }
]
}
]
}
}
Simpan di .claude/settings.json agar seluruh tim memakai aturan yang sama.
Mode Headless untuk Otomasi
Agent juga bisa dijalankan tanpa interaksi, cocok untuk CI atau script:
claude -p "Baca CHANGELOG.md dan buat ringkasan rilis dalam Bahasa Indonesia" \
--output-format json > ringkasan.json
Kesalahan yang Sering Terjadi
| Kesalahan | Akibat | Solusi |
|---|---|---|
| Instruksi terlalu umum | Perubahan melebar ke mana-mana | Sebut file dan batasannya |
| Tidak ada test | Bug lolos tanpa disadari | Minta agent tulis test dulu |
| Tidak membaca diff | Kode aneh masuk ke main | Review seperti PR rekan kerja |
| Memberi akses penuh tanpa batas | Risiko perintah berbahaya | Atur izin tool & gunakan sandbox |
Penutup
Coding agent bukan pengganti developer — ia adalah rekan kerja yang sangat cepat tapi butuh arahan jelas. Investasikan waktu di CLAUDE.md, sediakan cara verifikasi, dan tetap review setiap diff. Dengan begitu, kamu mendapatkan kecepatan AI tanpa kehilangan kendali atas kualitas kode.
0 Komentar