name: docs-writer description: Menulis dokumentasi berbasis kode untuk penjelasan high level dan detail pada file/fitur/komponen/pages tertentu di codebase (src dan convex). Gunakan saat diminta membuat docs yang merangkum struktur, alur, dan detail implementasi dengan daftar file terkait.

Docs Writer

Garis Besar

Skill ini membantu menulis dokumentasi berbasis kode dengan gaya ringkas + detail per file/fitur/komponen. Fokus pada pembacaan kode aktual, bukan asumsi, dan selalu sertakan daftar file terkait.

Alur Kerja

1. Validasi permintaan user: cakupan (file/fitur/komponen/pages), level detail, dan output yang diinginkan.
2. Pemetaan file terkait: gunakan struktur folder src/ dan convex/. Jika perlu, jalankan scripts/scan_codebase.py.
3. Baca kode yang relevan dan catat:
   • Tujuan file/komponen
   • Data flow utama (props/state/hooks, atau query/mutation Convex)
   • Dependensi penting
   • Edge case/constraint yang terlihat di kode
4. Tulis dokumentasi dengan format:
   • Ringkasan (1 paragraf)
   • Detail per file/fitur/komponen (poin-poin)
   • Daftar file terkait
5. Jangan klaim hal yang tidak terlihat di kode. Jika asumsi dibutuhkan, tandai sebagai asumsi.
6. Jangan ubah kode kecuali diminta eksplisit.

Panduan Bahasa dan Struktur

• Ikuti references/style-guide.md untuk aturan bahasa campur (ID + technical English).
• Ikuti references/templates.md untuk format output.

Kapan Menjalankan Script

• Gunakan scripts/scan_codebase.py untuk daftar file dan ringkasan struktur jika scope luas atau user minta daftar file lengkap.