7 template CLAUDE.md untuk Claude Code yang bisa langsung dipakai di proyek nyata

Banyak artikel CLAUDE.md berhenti di saran “jelaskan tech stack.” Itu tidak salah, tapi tidak cukup ketika Claude Code mulai menyentuh pekerjaan nyata.

Pertanyaan yang benar bukan “apakah saya butuh CLAUDE.md?” Pertanyaan yang benar adalah: apa yang harus ditulis agar Claude Code berhenti mengulangi kesalahan yang sama di repo ini?

Panduan ini mengisi celah antara panduan pemula dan CLAUDE.md Best Practices dengan tujuh template yang bisa langsung disalin.

Jalur singkat:

1. Simpan Claude Code Quick Reference Cheatsheet di dekat editor.
2. Salin template yang paling mirip dengan repo Anda.
3. Tambahkan dulu tiga aturan Do Not.
4. Jika Anda butuh lebih banyak contoh template, hooks, dan permissions, lanjut ke The Complete Claude Code Setup & Configuration Guide.
5. Jika Anda ingin menjadikannya standar tim, gunakan consultation page.

Apa yang dilakukan CLAUDE.md yang bagus

File yang bagus mengurangi tiga masalah:

• Claude Code mengedit area yang benar tetapi melanggar konvensi lokal
• tugas selesai tetapi verifikasi penting dilewati
• terlalu banyak file dieksplorasi karena batas repo tidak jelas

Karena itu file yang berguna biasanya berisi:

• stack dan command
• peta direktori
• aturan spesifik proyek
• urutan kerja yang direkomendasikan
• larangan

Dua poin terakhir paling cepat mengubah perilaku.

Template 1: solo web app

# Project Overview

Customer-facing Astro site with a small Node API.

## Tech Stack

- Frontend: Astro 5 + TypeScript
- Styling: Tailwind CSS
- Backend: Node.js 22
- Tests: Vitest

## Key Directories

- `site/src/pages/` route entrypoints
- `site/src/components/` reusable UI
- `site/src/content/` blog and docs content
- `scripts/` operational scripts

## Common Commands

- Build: `cd site && npm run build`
- Test: `npm run test`
- Search content: `rg "keyword" site/src/content`

## Working Rules

- Prefer minimal diffs over wide refactors
- Keep copy changes aligned with existing brand tone
- When editing UI, verify mobile width before calling the task done

## Do Not

- Do not rename routes unless required
- Do not delete analytics or SEO fields
- Do not claim deploy success without checking the public URL

Nilai terbesarnya bukan daftar stack, tetapi fakta bahwa verifikasi mobile dan pengecekan URL publik dijadikan syarat selesai.

Template lain yang berguna

Pola yang sama bisa dipakai untuk:

• situs konten dengan PDF gratis, Gumroad, dan funnel konsultasi
• API backend dengan validasi ketat
• repo tim yang butuh patch mudah direview
• codebase legacy yang lebih mementingkan kompatibilitas
• repo automasi dengan side effect
• monorepo dengan batas paket yang jelas

Di semua kasus itu, aturan paling bernilai biasanya:

• lakukan perubahan aman sekecil mungkin
• sebutkan langkah verifikasi yang tepat
• tulis apa yang tidak boleh dilakukan
• minta approval untuk deploy, secrets, dan external writes

Kegagalan yang harus dihindari

• mengubah CLAUDE.md menjadi wiki perusahaan
• menulis command tanpa workflow
• lupa aturan larangan
• tidak pernah memperbarui file

Kalau Claude Code mengulang kesalahan yang sama beberapa kali, biasanya masalahnya ada pada CLAUDE.md yang terlalu samar.

Template mana yang cocok

• pekerjaan produk atau UI: template solo app
• artikel multilingual, PDF, dan Gumroad: template content site
• validasi dan integritas data: template API
• koordinasi dan boundary: template tim atau monorepo
• biaya kesalahan tinggi: template legacy atau automasi

Anda tidak perlu menggabungkan ketujuhnya. Mulai dari satu, lalu tambahkan aturan yang benar-benar mengubah perilaku.

Langkah berikutnya

1. Salin satu template ke CLAUDE.md
2. Tambahkan tiga aturan Do Not yang spesifik untuk proyek
3. Tulis verifikasi yang tepat untuk mendefinisikan “selesai”

Untuk referensi cepat harian, mulai dari Claude Code Quick Reference Cheatsheet. Jika Anda ingin contoh CLAUDE.md, setup, hooks, permissions, dan workflow yang lebih lengkap, gunakan The Complete Claude Code Setup & Configuration Guide. Jika Anda ingin menjadikannya proses tim yang repeatable, buka consultation page.