Rapikan PRD, rules, data contract, dan catatan schema menjadi context pack. Tambahkan AGENTS.md dan DESIGN.md di root agar agent tahu cara bekerja dan batasan UI/copy.
Sekarang project-mu sudah punya beberapa dokumen:
textdocs/prd-mini.md
docs/project-rules.md
docs/data-contract.md
docs/schema-catatan.mdMasalah baru muncul: kalau dokumen makin banyak, agent bisa bingung harus mulai dari mana. Kamu juga bisa bingung dokumen mana yang menjawab kebutuhan, mana yang menjawab rules, dan mana yang menjawab schema.
Kalau setiap prompt menjelaskan ulang semua dari awal, lama-lama konteksnya bisa beda-beda. Hari ini kamu bilang status donation verified, besok kamu lupa dan menulis paid. Agent akan mengikuti prompt terbaru walaupun bertentangan dengan schema.
Solusinya adalah context pack.
Context pack bukan satu file raksasa. Ia adalah susunan file yang punya tugas jelas.
Banyak coding agent mencari instruksi project dari root repo. Karena itu, instruksi kerja agent sebaiknya ada di root:
textAGENTS.mdIsi file ini bukan PRD. Isinya adalah cara agent bekerja di repo:
Dengan AGENTS.md, kamu tidak perlu menulis ulang “jangan ubah schema tanpa izin” di setiap prompt. Cukup minta agent membaca instruksi root itu dulu.
Platform Donasi Amanah menyentuh kepercayaan. UI-nya tidak boleh asal template, terlalu agresif, atau memakai elemen yang tidak pantas.
Karena itu kita buat:
textDESIGN.mdIsi file ini mengatur arah UI/copy:
Ini penting secara syar'i dan juga penting secara produk. Donasi butuh kepercayaan, bukan gimmick.
Folder docs/ tetap menjadi tempat referensi domain. Tapi ia perlu index:
textdocs/README.mdFile ini menjawab:
Tanpa README, docs/ cepat berubah menjadi tumpukan catatan.
Buat struktur ini:
textproject-root/
├── AGENTS.md
├── DESIGN.md
└── docs/
├── README.md
├── prd-mini.md
├── project-rules.md
├── data-contract.md
└── schema-catatan.mdUrutannya seperti ini:
AGENTS.md = cara agent bekerja;DESIGN.md = batasan UI/copy;docs/README.md = peta referensi domain;docs/ = isi keputusan produk, rules, data, dan schema.Gunakan prompt ini:
textSaya ingin merapikan context pack Platform Donasi Amanah.
Baca dulu:
- docs/prd-mini.md
- docs/project-rules.md
- docs/data-contract.md
- docs/schema-catatan.md
- supabase/migrations/20260829_vertical_slice.sql
Tugas:
1. Buat AGENTS.md di root project.
2. Buat DESIGN.md di root project.
3. Buat docs/README.md.
4. Jangan mengubah isi prd-mini.md, project-rules.md, data-contract.md, schema-catatan.md, atau migration.
5. Setelah membuat tiga file baru, laporkan jika ada kontradiksi antara dokumen docs/ dan migration.
Isi AGENTS.md minimal:
- project summary: Platform Donasi Amanah, Next.js App Router, Supabase, npm.
- mulai setiap tugas dengan membaca AGENTS.md, DESIGN.md, dan docs/README.md.
- command verifikasi: npm run lint dan npm run build.
- batasan: jangan ubah schema, auth, RLS, payment, atau secret tanpa instruksi eksplisit.
- laporan: file yang diubah, alasan, cara verifikasi.
- security: jangan commit .env.local, secret, service role key, token, atau data donor sensitif.
Isi DESIGN.md minimal:
- prinsip visual: sederhana, amanah, jelas, mobile-first.
- tone copy: empatik, transparan, tidak manipulatif.
- komponen penting: campaign card, donation form, confirmation state, progress amount.
- aksesibilitas: label form jelas, error terbaca, focus state, kontras cukup.
- batas syar'i: tanpa aurat, musik, simbol agama lain, dark pattern, atau copy hiperbolis.
Isi docs/README.md minimal:
- tabel berisi nama file, fungsi, kapan diubah.
- urutan baca untuk tugas fitur baru.
- catatan bahwa migration menjadi sumber kebenaran schema.Perhatikan batasannya: agent boleh membuat tiga file baru, tapi tidak boleh mengubah dokumen domain lama. Ini menjaga scope.
md# AGENTS.md — Platform Donasi Amanah
## Project summary
Platform Donasi Amanah adalah aplikasi donasi berbasis Next.js App Router, Supabase, dan npm.
## Mulai dari konteks
Sebelum mengubah kode, baca:
1. DESIGN.md
2. docs/README.md
3. dokumen domain yang relevan dengan tugas
## Command verifikasi
- npm run lint
- npm run build
## Batasan perubahan
- Jangan ubah schema, migration, RLS, auth, payment, atau secret tanpa instruksi eksplisit.
- Jangan melebar ke fitur baru di luar acceptance criteria.
- Kalau perlu mengubah lebih dari scope, jelaskan dulu sebelum edit.
## Security
- Jangan commit .env.local.
- Jangan tampilkan secret, service role key, token, password, atau data donor sensitif.
- Gunakan placeholder [REDACTED] saat perlu menyebut nilai rahasia.
## Laporan setelah bekerja
Laporkan:
- file yang diubah,
- alasan perubahan,
- cara verifikasi,
- risiko atau asumsi yang tersisa.# DESIGN.md — Platform Donasi Amanah
## Prinsip visual
- Sederhana, amanah, dan mudah dipahami.
- Mobile-first.
- Informasi donasi harus jelas: campaign, nominal, status, dan langkah berikutnya.
## Copy
- Transparan dan empatik.
- Tidak menekan, menakut-nakuti, atau memanipulasi emosi.
- Jelaskan konsekuensi tindakan user dengan jujur.
## Komponen utama
- Campaign card.
- Donation form.
- Confirmation state.
- Progress amount.
- Status badge.
## Aksesibilitas
- Semua input punya label.
- Error form terbaca dekat field terkait.
- Focus state terlihat.
- Kontras teks cukup.
## Batas syar'i
- Tidak memakai gambar aurat.
- Tidak memakai musik.
- Tidak memakai simbol agama lain.
- Tidak memakai dark pattern.
- Tidak memakai klaim hiperbolis yang tidak bisa dibuktikan.# Docs — Platform Donasi Amanah
| File | Fungsi | Diubah ketika |
|---|---|---|
| prd-mini.md | tujuan, user, alur utama, batasan v1 | arah produk berubah |
| project-rules.md | aturan bisnis yang bisa diuji | batas nominal/status/akses berubah |
| data-contract.md | entity, field, status, relasi | schema atau kebutuhan data berubah |
| schema-catatan.md | ringkasan migration yang sudah dipahami | migration berubah |
## Urutan baca untuk fitur baru
1. AGENTS.md
2. DESIGN.md
3. docs/README.md
4. prd-mini.md
5. project-rules.md
6. data-contract.md
7. schema-catatan.md
8. file kode yang relevan
## Sumber kebenaran schema
Migration Supabase adalah sumber kebenaran struktur database. Jika dokumen berbeda dengan migration, catat gap dan perbaiki dokumen sebelum mengubah kode.Jalankan dari root project:
bashtest -f AGENTS.md && echo "AGENTS.md ada"
test -f DESIGN.md && echo "DESIGN.md ada"
test -f docs/README.md && echo "docs/README.md ada"
grep -n "npm run lint\|npm run build" AGENTS.md
grep -n "aurat\|musik\|dark pattern" DESIGN.md
grep -n "prd-mini.md\|project-rules.md\|data-contract.md\|schema-catatan.md" docs/README.mdYang kamu harapkan:
AGENTS.md menyebut command verifikasi;DESIGN.md menyebut batas desain/copy yang aman;docs/README.md memetakan semua dokumen domain.Setelah file dibuat, lakukan spot-check:
bashgrep -n "pending\|verified\|rejected\|cancelled\|refunded" docs/project-rules.md docs/data-contract.md supabase/migrations/20260829_vertical_slice.sql
grep -n "qris\|va" docs/project-rules.md docs/data-contract.md supabase/migrations/20260829_vertical_slice.sql
grep -n "published" docs/prd-mini.md docs/project-rules.md docs/data-contract.md supabase/migrations/20260829_vertical_slice.sqlTujuannya bukan membuktikan semua dokumen sempurna. Tujuannya menangkap kontradiksi besar lebih awal.
Kalau ada dokumen menyebut paid sebagai status donation, sementara migration hanya mengizinkan verified, perbaiki dokumennya dulu. Jangan meminta AI membangun fitur dari konteks yang saling bertentangan.
Context pack membuat prompt lebih pendek tanpa kehilangan konteks.
Daripada menulis ulang semua aturan setiap kali, kamu bisa memulai prompt dengan:
textMulai dari AGENTS.md, DESIGN.md, dan docs/README.md.
Untuk detail domain, baca dokumen yang relevan di docs/.
Ikuti acceptance criteria di bawah ini.Ini bukan sekadar hemat token. Ini membuat kerja agent lebih konsisten karena sumber konteksnya menetap di repo.
AGENTS.md ada di root.DESIGN.md ada di root.docs/README.md ada.AGENTS.md memuat command verifikasi dan batasan scope.DESIGN.md memuat prinsip visual, copy, aksesibilitas, dan batas syar'i.docs/README.md memetakan PRD, rules, data contract, dan schema notes.Nah, sekarang project-mu mulai punya “ingatan” yang rapi di repo, bukan cuma di chat. Mulai Module 03, setiap prompt fitur campaign bisa diawali dari AGENTS.md, DESIGN.md, dan docs/README.md, sehingga agent bekerja dengan pagar yang sama dari awal.
Kuis ini wajib untuk sertifikat. Kamu tetap bisa lanjut ke pelajaran berikutnya dan mengerjakannya nanti.
Ajukan pertanyaan, beri solusi, atau diskusikan materi pelajaran ini.
Belum ada komentar untuk pelajaran ini.
Jadilah yang pertama memulai diskusi atau mengajukan pertanyaan!