Context Management: Atur File Biar AI Nggak Ngawur

Di episode 6 kemarin kita belajar spec-driven development: menulis spesifikasi dulu sebelum AI menyentuh kode. Tapi ada satu masalah yang sering bikin spesifikasi sebagus apa pun gagal total. AI-nya membaca file yang salah, melewatkan file yang penting, atau tenggelam dalam tumpukan kode yang tidak relevan. Masalah ini punya nama: context management, alias mengatur apa saja yang boleh masuk ke kepala AI saat ia bekerja.

Catatan jujur dulu. Penjelasan di bawah disusun dari dokumentasi resmi tools AI coding dan laporan komunitas developer per Oktober 2026. Saya tidak mengklaim sudah menguji setiap tools sampai ke batas context window-nya. Anggap ini panduan praktis yang aman untuk proyek seukuran tugas sekolah sampai portofolio.

Apa Itu Context bagi AI Coding

Context adalah semua informasi yang sedang "diingat" AI saat menjawab perintahmu. Isinya bisa berupa isi chat kalian, file yang ia baca, hasil perintah terminal, sampai potongan kode yang kamu tempel manual. Bayangkan AI seperti teman yang kamu ajak mengerjakan PR bareng: ia hanya bisa memakai informasi yang ada di meja. Kalau di meja hanya ada separuh soal, jawabannya pasti meleset.

Setiap AI punya batas context window, yaitu kapasitas maksimum informasi yang bisa ia tampung sekaligus. Kalau proyekmu kecil, seluruh kodenya muat dan tidak ada masalah. Tapi begitu proyekmu membesar, file-file lama mulai "terdorong keluar" dari ingatan AI. Inilah momen berbahayanya: AI tetap menjawab dengan percaya diri, tapi ia menjawab berdasarkan ingatan yang sudah tidak lengkap. Hasilnya ya itu, kode yang ngawur.

Kabar baiknya, kamu tidak perlu menghafal angka kapasitas tiap model. Yang perlu kamu kuasai adalah prinsipnya: beri AI sedikit informasi yang tepat, bukan banyak informasi yang acak. Context yang ramping dan relevan mengalahkan context yang gemuk dan berantakan, setiap saat.

Kenapa AI "Ngawur" Kalau Context Berantakan

Ada tiga pola ngawur yang paling sering terjadi, dan ketiganya berakar dari context yang buruk. Pertama, AI mengarang API yang tidak ada. Kamu memintanya memakai fungsi dari file lain, tapi file itu tidak ia baca, jadi ia menebak nama fungsinya. Tebakannya salah, kodemu error. Kedua, AI mengubah gaya kode seenaknya. Ia tidak membaca file contoh yang menunjukkan konvensimu, jadi ia menulis dengan gayanya sendiri yang tidak konsisten dengan proyekmu. Ketiga, AI "lupa" keputusan yang sudah dibuat. Di awal chat kamu bilang pakai penyimpanan lokal, tiga puluh pesan kemudian ia menyarankan database. Bukan karena ia bodoh, tapi karena keputusan itu sudah terdorong keluar dari context window.

Ketiga pola ini punya satu kesamaan: bukan salah AI-nya, tapi salah bahan bacaannya. Menyalahkan AI untuk ini sama seperti menyalahkan teman yang salah mengerjakan PR padahal kamu memberinya separuh soal. Solusinya bukan mengganti AI yang lebih pintar, tapi merapikan apa yang ia baca.

Atur Struktur Folder Supaya AI Mudah Membaca

AI membaca proyekmu seperti manusia membaca lemari arsip: kalau labelnya jelas, ia cepat menemukan yang dicari. Kalau semua file ditumpuk di satu folder dengan nama seperti final2_revisi_beneran.js, jangan harap ia paham. Berikut struktur sederhana yang ramah AI untuk proyek web kecil.

proyekku/
  README.md          (penjelasan proyek + cara menjalankan)
  index.html         (halaman utama)
  css/
    style.css        (semua tampilan)
  js/
    app.js           (logika utama)
    data.js          (data dan penyimpanan)
  assets/
    logo.png         (gambar dan aset)

Prinsipnya tiga. Satu, pisahkan berdasarkan peran, bukan berdasarkan asal file. CSS berkumpul dengan CSS, logika berkumpul dengan logika. Dua, nama file menjelaskan isinya. Nama data.js langsung memberi tahu AI (dan kamu) bahwa urusan penyimpanan ada di sana. Tiga, sediakan satu pintu masuk. File README.md di folder utama adalah tempat AI pertama kali "berkenalan" dengan proyekmu sebelum membaca file lainnya.

File README Konteks: Kartu Nama Proyekmu

README bukan sekadar formalitas. Bagi AI, README adalah ringkasan context yang murah: sedikit teks, banyak informasi. README yang baik untuk AI coding menjawab lima pertanyaan dalam waktu kurang dari satu menit baca: proyek ini ngapain, cara menjalankannya bagaimana, struktur foldernya seperti apa, keputusan pentingnya apa, dan apa yang sedang dikerjakan saat ini.

Contoh isi README yang ramah AI tidak perlu panjang. Cukup satu paragraf deskripsi, perintah untuk menjalankan (misalnya "buka index.html di browser" atau "npm run dev"), daftar folder beserta perannya, dan satu bagian "Keputusan" berisi hal-hal yang tidak boleh dilanggar, misalnya "penyimpanan memakai localStorage, bukan database" dan "tanpa framework, vanilla JS saja". Lima belas sampai tiga puluh baris sudah lebih dari cukup.

Satu kebiasaan emas: perbarui README setiap kali ada keputusan baru. Keputusan yang hanya hidup di riwayat chat akan hilang. Keputusan yang tertulis di README bisa dibaca AI di sesi mana pun, bahkan minggu depan saat kamu sudah lupa pernah memutuskannya.

File Apa yang Perlu dan Tidak Perlu Dibaca AI

Tidak semua file layak masuk context. Memberi AI terlalu banyak file itu seperti menyuruh teman membaca seluruh perpustakaan untuk menjawab satu soal. Berikut panduan cepatnya.

Wajib bisa dibaca AI: README, file yang sedang kamu ubah, file yang berkaitan langsung (misalnya fungsi yang dipanggil dari file lain), dan file konfigurasi penting. Tidak perlu dibaca: folder library pihak ketiga (node_modules dan sejenisnya), file hasil build, gambar dan video berukuran besar, serta file lama yang sudah tidak dipakai tapi belum dihapus. File-file ini hanya menggemukkan context tanpa menambah pemahaman.

Kebanyakan tools AI coding modern sudah pintar mengabaikan folder seperti node_modules secara otomatis. Tapi file sampah buatanmu sendiri tidak bisa ia bedakan dari file penting. Jadi bersih-bersih proyek adalah bagian dari context management. Hapus file yang tidak dipakai, atau pindahkan ke folder arsip yang jelas bukan bagian proyek aktif.

Perintah context yang rapi untuk AI:

"Bantu saya perbaiki bug di js/app.js.
 File terkait yang boleh kamu baca: js/data.js dan README.md.
 Abaikan folder assets dan file lain kecuali kamu memintanya dulu.
 Keputusan yang harus dipatuhi: penyimpanan tetap memakai
 localStorage, jangan tawarkan database."

Perhatikan pola perintah di atas: tentukan file yang relevan, larang yang tidak relevan, dan tegaskan keputusan penting. Tiga kalimat itu menghemat ratusan baris context yang tidak perlu dan mencegah dua dari tiga pola ngawur yang kita bahas tadi.

Tips Menjaga Context Tetap Ramping di Proyek Besar

Semakin besar proyek, semakin disiplin kamu harus menjaga context. Lima tips ini dipakai banyak developer profesional. Pertama, mulai sesi baru untuk tugas baru. Chat lama yang sudah ratusan pesan itu context yang mahal dan kotor. Tugas baru layak dapat meja yang bersih. Kedua, rangkum keputusan penting ke file. Jangan biarkan keputusan hidup hanya di chat. Ketiga, kerjakan satu fitur per sesi. Mencampur lima fitur dalam satu percakapan membuat AI mencampuradukkan context antar fitur. Keempat, minta AI merangkum sebelum sesi berakhir. Perintah sederhana seperti "rangkum apa yang sudah kita kerjakan dan keputusan apa yang kita buat" menghasilkan teks yang bisa kamu tempel di sesi berikutnya. Kelima, percayai file aturan proyek. File seperti AGENTS.md atau CLAUDE.md dibaca otomatis oleh banyak tools di setiap sesi, jadi aturanmu tidak perlu diulang-ulang. File aturan ini akan kita bedah tuntas di episode berikutnya.

Latihan Minggu Ini

Latihanmu minggu ini adalah operasi bersih-bersih, tiga langkah saja. Pertama, rapikan satu proyekmu mengikuti struktur folder contoh di atas: pisahkan CSS, JS, dan aset, lalu beri nama file yang menjelaskan isinya. Kedua, tulis atau perbarui README.md dengan lima jawaban tadi: proyek ini ngapain, cara menjalankannya, struktur foldernya, keputusan pentingnya, dan apa yang sedang dikerjakan. Ketiga, mulai sesi AI baru dan uji: tempel perintah context rapi seperti contoh di atas, lalu minta AI menjelaskan kembali struktur proyekmu. Kalau penjelasannya tepat tanpa kamu memberi tahu apa-apa, context management-mu berhasil. Kalau masih meleset, berarti ada file sampah yang belum dibersihkan atau README yang kurang jelas.

Di episode 8 kita lanjut ke "Aturan Proyek (AGENTS.md/CLAUDE.md) yang Efektif", yaitu cara menulis file aturan yang dibaca otomatis oleh AI di setiap sesi supaya kamu tidak perlu mengulang instruksi yang sama seratus kali. Sampai jumpa besok jam 21:00. Bakar semangat kodingmu seperti api kompor.