Cara Menulis program.md yang Baik: Panduan Praktis untuk Instruksi Agen AI

Autoresearch Andrej Karpathy membuktikan bahwa file Markdown yang ditulis dengan baik dapat mengarahkan agen AI untuk membuat penemuan ilmiah nyata semalam. Tetapi tidak semua file program.md diciptakan sama.

Kualitas instruksi Markdown Anda secara langsung menentukan kualitas output agen AI.

Struktur program.md yang Baik

Setiap program.md yang efektif membutuhkan lima bagian:

1. Konteks: Apa yang Perlu Diketahui Agen?

Agen mulai tanpa pemahaman tentang proyek Anda. Sertakan: apa yang dilakukan proyek, bagaimana tampilan codebase, file kunci dan tujuannya, terminologi khusus domain.

2. Tujuan: Apa yang Harus Dioptimalkan Agen?

Ini adalah bagian paling kritis. Agen membutuhkan tujuan yang jelas dan terukur.

Dalam autoresearch: kurangi val_bpb. Definisikan sukses dalam istilah yang dapat dievaluasi agen: “Kurangi waktu muat halaman di bawah 2 detik”, “Tingkatkan cakupan tes di atas 80%“.

3. Batasan: Apa yang Tidak Boleh Dilakukan Agen?

Tanpa batasan, agen akan menemukan jalur paling mudah. Contoh: jangan modifikasi file tes, jangan ubah API publik, jangan perkenalkan dependensi baru.

4. Strategi: Bagaimana Agen Harus Mendekati Masalah?

Di sinilah keahlian domain Anda bersinar. Berikan panduan arah: “Mulai dengan penyesuaian hiperparameter sebelum perubahan arsitektur.”

5. Evaluasi: Bagaimana Agen Harus Menilai Keberhasilan?

Definisikan kriteria evaluasi: metrik mana yang penting, ambang batas mana yang dihitung sebagai peningkatan.

Kesalahan Umum

• Terlalu samar: “Buat model lebih baik” tidak memberikan arah
• Terlalu spesifik: Jangan micromanage implementasi
• Melupakan batasan: Agen akan mengambil jalan pintas yang tidak Anda inginkan
• Tidak beriterasi: program.md pertama Anda tidak akan sempurna

---

Save mengonversi halaman web apa pun ke Markdown bersih — sempurna untuk membangun perpustakaan referensi yang mendukung file program.md yang efektif. Coba Save gratis.