Pelajaran #1: Optimize My Prompt + Create an AGENTS.md File
30 Oktober 2026
Selamat pagi, Aulia. Ini pelajaran pertama. Hari ini ada dua prompt. Keduanya saling nyambung. Prompt pertama memperbaiki prompt yang hasilnya mengecewakan. Prompt kedua mengubah aturan kerja yang sudah terbukti menjadi berkas yang dibaca coding agent setiap kali membuka repo.
1. Optimize My Prompt
Apa itu dan kapan dipakai
Ini prompt untuk memperbaiki prompt. Kamu tempel prompt lamamu, plus contoh hasil yang jelek atau penjelasan apa yang salah. Lalu model mendiagnosis dan menulis ulang prompt itu. Pakai prompt ini saat hasil model terasa generik, faktanya ngawur, formatnya salah, tulisannya terlalu panjang, atau nadanya tidak cocok.
Mengapa bekerja
Prompt ini memaksa struktur yang biasanya hilang dari prompt asal. Ada peran yang jelas, ada tugas yang jelas, ada konteks, ada batasan, dan ada format output. Model juga diminta menjelaskan dulu mengapa prompt lama gagal, sebelum menulis ulang. Urutan itu penting. Diagnosis dulu membuat perbaikan terarah, bukan sekadar ganti kata. Versi pendek berguna untuk pemakaian harian. Versi panjang berguna untuk pekerjaan berulang atau pekerjaan berisiko. Tiga test case dan checklist lulus atau gagal membuat kamu bisa menguji hasil perbaikan, bukan sekadar merasa hasilnya lebih bagus. Satu catatan gaya. Kalau kolom tone dan constraints dibiarkan kosong, hasil perbaikan masih bisa generik dan terdengar seperti iklan. Isi tone dengan bahasa natural profesional, dan tulis larangan yang jelas di constraints.
Teks prompt
You are a prompt engineer who knows **[domain]**.
I need a better prompt so **[target user]** can complete **[task]**.
## Current prompt
[Paste your prompt.]
## What is going wrong
[Paste a bad output, or say what fails: generic, wrong facts, off-brand, missing edge cases, too long, wrong format.]
## Context the model needs
[Product, users, workflow, sources, constraints, examples, decisions already made.]
## Requirements
- Audience: [audience]
- Desired outcome: [outcome]
- Tone: [tone]
- Required facts or sources: [sources]
- Constraints: [constraints]
- Must include: [requirements]
- Must avoid: [prohibited content or behavior]
- Output format: [format]
- What "good" looks like: [definition]
Do this:
1. Say why the current prompt fails.
2. Call out ambiguity, missing context, conflicting instructions, and missing output rules.
3. Rewrite a structured prompt with role, objective, context, inputs, constraints, process, output format, and quality checks.
4. Give a short version for daily use.
5. Give a longer version for work you will repeat or that has high stakes.
6. Suggest 3 test cases, including one edge case.
7. Give a pass/fail checklist for the output.
Do not invent product facts. Ask short questions when you need missing context.Contoh terisi
Contoh ini untuk instruksi latihan chin tuck di program postur rumahan. Prompt lamanya terlalu pendek, jadi hasilnya generik.
You are a prompt engineer who knows web app kebugaran dan latihan postur rumahan.
I need a better prompt so Aulia can complete menulis instruksi latihan chin tuck yang jelas dan bisa langsung diikuti di rumah.
## Current prompt
Buatkan deskripsi latihan chin tuck.
## What is going wrong
Hasilnya generik dan terdengar seperti iklan. Tidak menyebut posisi duduk, durasi tiap repetisi, dan kapan harus berhenti.
## Context the model needs
Program postur untuk pemakaian pribadi di rumah. Latihan ini tanpa alat. Penjelasan memakai Bahasa Indonesia santai. Pengguna sudah tahu gerakan dasarnya, tapi butuh instruksi yang presisi.
## Requirements
- Audience: Aulia sendiri, pemula untuk latihan ini
- Desired outcome: Instruksi 4 langkah yang bisa langsung diikuti tanpa alat
- Tone: Bahasa Indonesia santai, kalimat pendek, natural profesional
- Required facts or sources: Durasi 10 detik per repetisi, 10 repetisi, berhenti bila nyeri tajam
- Constraints: Tanpa klaim iklan. Tanpa kata promosi. Tanpa saran medis di luar gerakan dasar ini.
- Must include: Posisi duduk, cara dagu ditarik, durasi, tanda berhenti
- Must avoid: Kalimat promosi, janji hasil, istilah medis yang tidak perlu
- Output format: Daftar bernomor, satu langkah per nomor
- What "good" looks like: Aulia bisa membaca sekali lalu langsung mempraktikkan tanpa bertanya lagi
Do this:
1. Say why the current prompt fails.
2. Call out ambiguity, missing context, conflicting instructions, and missing output rules.
3. Rewrite a structured prompt with role, objective, context, inputs, constraints, process, output format, and quality checks.
4. Give a short version for daily use.
5. Give a longer version for work you will repeat or that has high stakes.
6. Suggest 3 test cases, including one edge case.
7. Give a pass/fail checklist for the output.
Do not invent product facts. Ask short questions when you need missing context.Tugas praktik hari ini
Ambil satu prompt yang hasilnya mengecewakan minggu ini. Jalankan prompt Optimize My Prompt ini satu kali untuk prompt itu. Simpan versi pendek hasil perbaikannya, lalu pakai versi pendek itu untuk pekerjaan yang sama.
2. Create an AGENTS.md File
Apa itu dan kapan dipakai
Ini prompt untuk membuat berkas AGENTS.md. Berkas itu berisi instruksi di root repo, supaya coding agent tahu produknya apa, konvensinya apa, alat apa yang dipakai, dan apa yang butuh persetujuan. Pakai prompt ini saat kamu mulai memakai coding agent di sebuah repo, atau saat agent berulang kali melanggar aturan yang sebenarnya sudah kamu tahu.
Mengapa bekerja
Prompt ini memisahkan tiga hal yang sering tercampur. Konteks proyek menjelaskan produk dan tumpukan teknologi. Konvensi tim menjelaskan cara kerja yang diharapkan. Batasan agent menjelaskan apa yang boleh otomatis, apa yang butuh persetujuan, dan apa yang tidak boleh sama sekali. Pemisahan itu membuat instruksi mudah diuji. Kalau agent melanggar satu aturan, kamu tahu bagian mana yang kurang tegas. Aturan untuk menandai hal yang belum diketahui juga penting. Agent dilarang mengarang detail. Hal yang belum pasti ditulis sebagai perlu masukan tim. Hasil akhirnya punya 13 bagian, dari tujuan proyek sampai aturan eskalasi. Jadi berkas ini bukan sekadar catatan. Ini kontrak kerja yang dibaca agent sebelum mengubah apa pun.
Teks prompt
You write AGENTS.md files for coding agents. Create one for this project.
## Project context
- Product or project name: [name]
- What the product does: [description]
- Target users: [users]
- Product stage: [idea, MVP, growth, enterprise, etc.]
- Tech stack and tools: [stack/tools]
- Repository or workspace structure: [structure]
- Important files, folders, or documentation: [references]
## Team conventions
- Code, design, content, or documentation conventions: [conventions]
- Naming conventions: [rules]
- Design-system requirements: [rules]
- Testing and QA expectations: [expectations]
- Accessibility requirements: [requirements]
- Security, privacy, or compliance requirements: [requirements]
## Agent boundaries
- Actions the agent may take automatically: [actions]
- Actions that require approval: [actions]
- Actions the agent must never take: [actions]
- Available tools and integrations: [tools]
- Definition of done: [definition]
Write a short AGENTS.md with these sections:
1. Project purpose and target users
2. Workspace map
3. Source-of-truth hierarchy
4. Required conventions
5. How to work before making a change
6. Design and UX requirements
7. Tool-use rules
8. Approval and permission boundaries
9. Testing and verification requirements
10. Definition of done
11. Expected handoff or status-report format
12. Prohibited actions
13. Escalation rules for missing context, ambiguity, or risk
Use instructions you can test. Mark unknowns as [NEEDS TEAM INPUT]. Do not invent details.Contoh terisi
Contoh ini untuk BugarKu, aplikasi web latihan kebugaran untuk pengguna umum. Perhatikan bagian batasan. Program postur pribadi Aulia sengaja tidak dimasukkan, karena BugarKu adalah aplikasi publik dengan salinan netral.
You write AGENTS.md files for coding agents. Create one for this project.
## Project context
- Product or project name: BugarKu
- What the product does: Aplikasi web latihan kebugaran berbasis kamera untuk pengguna umum
- Target users: Pengguna umum yang berlatih di rumah
- Product stage: Live, versi awal untuk publik
- Tech stack and tools: HTML, CSS, dan JavaScript vanilla, deploy di Cloudflare Pages
- Repository or workspace structure: Satu folder proyek dengan berkas halaman utama, gaya, dan skrip
- Important files, folders, or documentation: Berkas halaman utama dan panduan gaya internal proyek
## Team conventions
- Code, design, content, or documentation conventions: Salinan antarmuka memakai label saja, satu bahasa penuh per halaman, konten panjang tampil satu bagian dalam satu waktu di balik menu
- Naming conventions: Nama berkas huruf kecil dan jelas maknanya
- Design-system requirements: Warna dan tipografi mengikuti token proyek, tanpa nilai hardcode yang tidak tercatat
- Testing and QA expectations: Uji alur penuh sebagai pengguna sebelum deploy, bukan hanya cek fungsi terpisah
- Accessibility requirements: Kontras teks terbaca, kontrol bisa dipakai dengan keyboard, gerakan bisa dikurangi
- Security, privacy, or compliance requirements: Kamera hanya aktif atas izin pengguna dan tidak ada data latihan yang dikirim tanpa persetujuan
## Agent boundaries
- Actions the agent may take automatically: Membaca berkas proyek dan mengusulkan perbaikan kecil
- Actions that require approval: Deploy ke situs live dan perubahan salinan yang tampil ke pengguna
- Actions the agent must never take: Menghapus riwayat proyek, memasukkan program pribadi Aulia ke aplikasi publik, dan mengklaim fitur sudah teruji di HP nyata sebelum diuji
- Available tools and integrations: Editor berkas lokal dan deploy Cloudflare Pages
- Definition of done: Perubahan tampil benar di ukuran layar HP, tidak ada bagian yang terpotong diam-diam, dan tidak ada pengumuman update di halaman
Write a short AGENTS.md with these sections:
1. Project purpose and target users
2. Workspace map
3. Source-of-truth hierarchy
4. Required conventions
5. How to work before making a change
6. Design and UX requirements
7. Tool-use rules
8. Approval and permission boundaries
9. Testing and verification requirements
10. Definition of done
11. Expected handoff or status-report format
12. Prohibited actions
13. Escalation rules for missing context, ambiguity, or risk
Use instructions you can test. Mark unknowns as [NEEDS TEAM INPUT]. Do not invent details.Tugas praktik hari ini
Jalankan prompt ini satu kali untuk satu repo kecil milikmu, misalnya folder proyek BugarKu atau satu proyek Kumbang. Simpan hasil awalnya sebagai draf AGENTS.md. Lalu uji draf itu dengan satu tugas kecil, dan perketat bagian yang diabaikan agent.
Sumber prompt: katalog AI UX Playground, halaman Optimize My Prompt dan Create an AGENTS.md File. Teks prompt di atas disalin lengkap dari halaman tersebut.