Aturan Rekayasa Konteks Baru untuk Model Claude 5

• Pada Claude Opus 5 dan Claude Fable 5, meski system prompt Claude Code dikurangi lebih dari 80%, tidak ada penurunan performa yang terukur dalam evaluasi coding
• Aturan terperinci yang dulu mencegah skenario terburuk pada model lama dapat bertabrakan antara system prompt, Skills, CLAUDE.md, dan permintaan pengguna, sehingga untuk model terbaru lebih baik membiarkan model memanfaatkan konteks sekitar dan penilaiannya sendiri
• Alih-alih menyediakan semua instruksi dan contoh tool di awal, diterapkan progressive disclosure: antarmuka yang ekspresif serta pemanggilan informasi dan tool saat dibutuhkan
• Disarankan konfigurasi yang mencatat secara ringkas hanya jebakan pada repository di CLAUDE.md, memisahkan instruksi panjang ke Skills, serta memanfaatkan materi referensi yang kaya seperti spesifikasi, test suite, mockup HTML, kode, dan rubric evaluasi
• Dengan /doctor dan claude doctor, ukuran Skills dan CLAUDE.md dapat disesuaikan; konteks untuk model terbaru harus disusun agar mengurangi pengulangan dan batasan berlebihan serta menemukan informasi relevan saat diperlukan

---

Rekayasa Konteks Melampaui Prompt

• Saat Claude memproses pesan, prompt pengguna hanyalah sebagian dari keseluruhan konteks; sisanya dirakit dari system prompt, Skills, CLAUDE.md, memory, dan lain-lain
• Rekayasa konteks berlaku umum untuk banyak permintaan, sehingga sulit ditulis sespesifik prompt individual, tetapi berdampak besar pada hasil Claude Code dan agent buatan sendiri
• Prompt dan instruksi umum harus dirancang tanpa mengetahui lebih dulu permintaan pengguna, dan seiring kemampuan Claude berkembang, pendekatan yang sesuai juga berubah
• Pada Claude Opus 5 dan Claude Fable 5, meski lebih dari 80% system prompt Claude Code dihapus, tidak ada penurunan performa yang terukur dalam evaluasi coding
• Praktik terbaik ini telah tercermin di claude doctor, dan di Claude Code, /doctor dapat digunakan untuk menyesuaikan Skills dan CLAUDE.md ke ukuran yang tepat

Membebaskan Model dari Batasan Berlebihan

• Claude Code sebelumnya dibatasi oleh terlalu banyak batasan, tidak hanya dari system prompt tetapi juga dari CLAUDE.md dan Skills
  • Dalam satu permintaan, instruksi seperti “tinggalkan dokumentasi yang sesuai” dan “jangan tambahkan komentar” dapat bertabrakan melalui system prompt, Skills, dan permintaan pengguna
  • Meski Claude dapat menafsirkan maksud pengguna, instruksi yang tumpang tindih atau bertentangan membuatnya harus berpikir lebih hati-hati sebelum menentukan tindakan
• Dulu batasan seperti ini diperlukan untuk menghindari skenario terburuk, tetapi model terbaru dapat diminta menghapus banyak batasan dan memanfaatkan konteks sekitar serta penilaiannya sendiri
• Tool yang dapat dimanfaatkan Claude Code juga bertambah
  • Dulu CLAUDE.md adalah tempat utama untuk menyimpan memory, informasi, dan instruksi
  • Sekarang konteks dapat dipanggil dan dibagikan antar-sesi melalui memory, artifact, dan Skills

Memanfaatkan Penilaian Berbasis Konteks, Bukan Aturan Tetap

• Pada Claude Code awal, instruksi kuat yang tidak selalu tepat dimasukkan untuk mencegah skenario terburuk seperti penghapusan file
• System prompt sebelumnya meminta agar kode secara default tidak diberi komentar, melarang docstring beberapa paragraf atau komentar multi-baris, dan meminta agar dokumen rencana, keputusan, atau analisis tidak dibuat kecuali diminta pengguna
• Aturan seperti ini bisa tidak tepat pada sebagian permintaan
  • Pengguna mungkin memiliki preferensi dokumentasi terpisah
  • Bagian tertentu dari kode yang kompleks mungkin membutuhkan komentar multi-baris
• Model lama sering menulis komentar yang keliru tanpa guardrail, sehingga kompromi seperti ini diperlukan, tetapi model terbaru menangani keputusan terkait dengan lebih baik meski tanpa aturan eksplisit
• System prompt baru menggunakan instruksi berbasis konteks: “tulis kode yang terasa menyatu dengan kode di sekitarnya, dan sesuaikan kepadatan komentar, penamaan, serta idiom”

Mendesain Antarmuka yang Ekspresif, Bukan Mengandalkan Contoh

• Aturan utama penggunaan tool dulu adalah menyediakan contoh penggunaan kepada Claude
• Pada model terbaru, contoh dapat membatasi ruang eksplorasi ke area tertentu, sehingga ekspresivitas antarmuka dan parameter tool, script, dan file harus diprioritaskan
• Jika status pada tool Todo didefinisikan sebagai enum pending, in_progress, completed, cara penggunaannya dapat tersirat secara alami
• Instruksi untuk mempertahankan hanya satu item sebagai in_progress mengonkretkan perilaku yang diminta di level antarmuka

Progressive Disclosure: Membuka Informasi Saat Dibutuhkan

• Pada masa awal ketika Claude Code berfokus pada coding, cara melakukan code review dan verifikasi dimasukkan secara detail ke system prompt
• Informasi seperti ini tidak selalu diperlukan, tetapi penting untuk tugas tertentu
• Sekarang progressive disclosure dapat digunakan untuk memanggil konteks yang tepat pada saat dibutuhkan
  • Instruksi verifikasi dan code review masing-masing dipindahkan ke Skill terpisah agar Claude Code dapat memanggilnya secara selektif
  • Sebagian tool dimuat secara lazy loading, dan agent harus mencari definisi lengkapnya dengan ToolSearch sebelum menggunakannya
  • Seperti tool Task, banyak tool dapat disediakan tanpa mengambil tempat dalam konteks sebelum diperlukan
• CLAUDE.md dan Skill.md tidak perlu dijadikan repositori pusat untuk semua praktik yang mungkin
• Sebagai gantinya, keduanya dapat disusun sebagai file tree yang dipanggil saat dibutuhkan; pendekatan ini juga dibahas dalam harness workflow dinamis per tugas

Menggabungkan Instruksi Berulang Menjadi Deskripsi Tool Sederhana

• Model Claude sebelumnya kadang perlu diberi instruksi yang sama berulang kali, dan terkadang lebih baik mengikuti instruksi di bagian akhir konteks daripada di bagian awal
• Karena itu, instruksi atau contoh penggunaan tool yang sama dimasukkan baik di isi system prompt maupun di deskripsi tool
• Pada model terbaru, contoh yang berulang dapat dihapus dan cara penggunaan tool cukup ditempatkan hanya di deskripsi tool

Beralih dari CLAUDE.md ke Memory Otomatis

• Dulu, pengguna dianjurkan menyimpan memory Claude secara langsung dengan menulis informasi otomatis ke CLAUDE.md menggunakan shortcut #
• Sekarang Claude secara otomatis mememorikan informasi yang relevan dengan tugas dan pengguna

Materi Referensi Kaya Melampaui Spesifikasi Sederhana

• Claude Code dalam mode perencanaan sangat bergantung pada file rencana Markdown agar dapat dirujuk kembali saat dibutuhkan, dan pada proyek jangka panjang spesifikasi kadang disimpan di dalam codebase
• Claude terbaru dapat menangani materi referensi dalam format yang lebih kompleks
  • Artifact HTML yang dibuat dengan fitur artifact baru
  • Kode seperti fungsi yang akan dipindahkan dari codebase lain
  • Spesifikasi yang dinyatakan sebagai test suite mendetail
• Rubric evaluasi adalah bentuk referensi lain yang membuat Claude dapat mencoba dan memverifikasi selera atau standar kualitas bidang tertentu
  • Dapat mendefinisikan kriteria seperti apa itu desain API yang baik
  • Melalui workflow dinamis, dapat dibuat agent verifikasi yang menggunakan rubric evaluasi tersebut

Peran Tiap Komponen Konteks

• System Prompt

  • Terkait erat dengan konteks produk, dan memberi tahu Claude pekerjaan apa yang sedang dilakukan di dalam produk apa
  • Pengguna Claude Code hampir tidak perlu mengubahnya, tetapi jika membuat agent harness sendiri, ini adalah area yang perlu banyak waktu

• CLAUDE.md

  • Pertahankan tetap ringan dan jelaskan secara singkat tujuan repository, tetapi sebagian besar token sebaiknya digunakan untuk mencatat jebakan yang perlu diwaspadai di dalam codebase
  • Aturan repository bahwa semua tipe harus diletakkan hanya dalam satu file tunggal layak dicatat
  • Hindari informasi yang sudah jelas dan bisa diketahui Claude dengan melihat filesystem atau repository
  • Jika ada banyak instruksi unik untuk verifikasi pekerjaan, buat Skill verifikasi dan rujuk dari CLAUDE.md untuk menerapkan progressive disclosure

• Skills

  • Susun sebagai panduan ringan yang membantu Claude menemukan informasi saat dibutuhkan
  • Hindari batasan berlebihan kecuali untuk area yang sangat penting
  • Skill yang panjang lebih baik dipecah menjadi beberapa file agar dapat dipanggil secara bertahap
  • Paling berguna ketika berisi pandangan, pengetahuan, dan praktik terbaik yang spesifik untuk individu, tim, atau produk

• Materi Referensi

  • Dengan me-mention file menggunakan @, Claude dapat memeriksa detail yang terkait dengan rencana saat ini
  • File spesifikasi, mockup, dan seluruh codebase juga dapat menjadi materi referensi
  • Karena kode memberikan instruksi yang jelas dan setia dalam bahasa yang sangat dipahami Claude, umumnya lebih baik memprioritaskan file dalam bentuk kode
  • Mockup desain HTML umumnya menghasilkan hasil yang lebih baik daripada deskripsi desain atau screenshot

Menyederhanakan Konteks yang Ada

• Konteks harus disederhanakan dengan menghapus aturan, pengulangan, dan informasi yang tidak perlu di seluruh system prompt, Skills, dan CLAUDE.md
• Perintah claude doctor secara otomatis membantu pekerjaan penyederhanaan ini
• Cara menulis prompt untuk model tingkat lanjut dapat dilihat lebih lanjut di panduan lapangan Claude Fable