Tulis File Konteks (AGENTS.md)

Satu hal yang paling berdampak tinggi (highest-leverage) yang bisa Anda lakukan adalah menulis sebuah file konteks yang dibaca AI secara otomatis. Alat yang berbeda mencari nama yang berbeda — AGENTS.md, CLAUDE.md, .cursorrules, atau .github/copilot-instructions.md — tapi idenya identik: dokumen hidup yang memberi tahu AI bagaimana proyek Anda bekerja dan bagaimana Anda ingin ia berperilaku.

Tanpanya, AI menebak-nebak. Dengannya, AI berhenti memformat ulang kode Anda, berhenti mengarang-ngarang library yang tidak Anda pakai, dan berhenti menjelaskan ulang keputusan yang sudah Anda buat. Bayangkan ini sebagai dokumentasi onboarding untuk rekan tim baru yang brilian tapi mengalami amnesia total di antara sesi kerja — segala yang mereka butuhkan agar produktif harus tersimpan di suatu tempat yang akan mereka baca setiap kali.

Contoh file starter yang praktis:

# Project: Invoice Manager

## What this is
A small web app for freelancers to create and track invoices.

## Tech stack
- TypeScript + React (Vite)
- Tailwind for styling
- SQLite via Prisma
- Vitest for tests

## Commands
- Install: `npm install`
- Run dev server: `npm run dev`
- Run tests: `npm test`
- Lint: `npm run lint`

## Conventions
- Use functional components and hooks; no class components.
- Keep components small; one component per file.
- Write a test for every new function in `src/lib`.
- Never edit files in `src/generated/` — they are auto-generated.

## Don'ts
- Don't add new dependencies without flagging it first.
- Don't commit secrets; use environment variables.

Jaga agar tetap singkat dan selalu mutakhir. File konteks yang membengkak jadi seribu baris berhenti dibaca dengan cermat — baik oleh Anda maupun modelnya — jadi pangkas file itu seagresif Anda menambahinya. Ketika AI berulang kali membuat asumsi yang salah sama, itu sinyal Anda untuk menambahkan satu baris; ketika sebuah aturan sudah tidak lagi sesuai kenyataan, hapus sebelum ia mulai aktif menyesatkan agen.

Ada beberapa pola yang membedakan file konteks yang efektif dari yang diabaikan begitu saja:

• Bersikaplah spesifik dan konkret. "Gunakan konvensi kita" itu tidak berguna. "Gunakan zod untuk validasi; kita tidak memakai yup" adalah aturan yang benar-benar bisa diikuti AI.
• Nyatakan larangan sekeras Anda menyatakan anjuran. Model bersemangat untuk membantu, artinya mereka akan dengan senang hati menambahkan dependency atau menulis ulang konfigurasi kecuali Anda melarangnya.
• Tunjukkan contoh. "Ikuti gaya src/features/invoices" memberi AI model konkret untuk ditiru, alih-alih instruksi samar yang harus ditafsirkan.

Perlakukan file konteks sebagai catatan setiap pelajaran yang seharusnya Anda ulangi lagi dan lagi. Ini adalah investasi termurah dan paling tahan lama di seluruh bab ini.