Cara Setup Documentation System untuk Vibe Coding

Setup dokumentasi untuk project yang pakai AI assistance itu kayak bikin kontrak kerja — tanpa kontrak yang jelas, AI bakal ngawur dan kamu yang repot clean up.

Masalahnya, kebanyakan developer yang pakai AI (Cursor, Claude, Coploit) cuma prompt tanpa struktur. Hasilnya? File dokumentasi berantakan, AI lupa konteks, dan project makin susah di-maintain.

Ini solusi yang gue pakai sekarang.

Apa itu docs-ai?

docs-ai adalah template sistem dokumentasi yang dirancang khusus untuk vibe coding — workflow di mana AI bantu kamu nulis kode. Konsepnya sederhana:

• Satu folder ai-rules/ = source of truth yang IMUTABLE
• AI hanya boleh baca template di ai-rules/
• AI yang buat folder output (planning/, dev-docs/, reports/, dll)
• Developer tetap kontrol semua keputusan besar

Jadi kamu setup aturannya sekali, terus AI yang kerja berdasarkan aturan itu. Kalau AI mau nulis dokumentasi, dia harus baca template dulu dari ai-rules/. Kalau AI mau refactor, dia harus ikut coding standards yang sudah ditetapkan.

Kenapa ini penting?

Tanpa struktur, AI punya kebiasaan buruk:

• Bikin file 5000 baris tanpa batas
• Campur aduk credential di file yang di-push ke git
• Skip security setup karena "nanti aja"
• Bikin dokumentasi yang gak pernah di-update

docs-ai enforce aturan ini lewat AGENTS.md — kontrak kerja yang WAJIB dibaca AI sebelum mulai kerja. File ini isi:

• Git location rules (harus cd ke folder kode dulu)
• Branch policy (main = stabil, dev = development)
• Security standards (17 Parts!)
• Coding standards (file size limits, separation of concerns)
• Workflow wajib (plan → implement → self-review → commit)

Struktur folder

Ini yang bikin docs-ai beda dari sekadar README:

project-root/
├── ai-rules/              ← IMMUTABLE (AI hanya baca)
│   ├── AGENTS.md          ← Root contract
│   ├── planning-templates/
│   ├── dev-docs-ai-templates/
│   ├── coding-standards/
│   ├── security/
│   └── deployment/
│
├── planning/              ← AI creates (New/Revamp)
├── dev-docs/              ← AI creates (All scenarios)
├── prod-docs/             ← AI creates (Server docs)
└── reports/               ← AI creates (Task reports)

Prinsip emas: ai-rules/ = IMMUTABLE, folder lain = OUTPUT.

6 Skenario yang tersedia

docs-ai bukan cuma buat project baru. Ada 6 skenario:

1. New Project — Belum ada kode, mulai dari nol
2. Revamp 1:1 — Rewrite 1 app lama ke stack baru
3. Merger N:1 — Gabung beberapa app jadi satu
4. Adopsi — Existing app mau di-vibe-coding-in
5. Maintenance — App udah production, maintenance rutin
6. Docs Migration — Dokumentasi existing mau dipindah ke template

Plus 9 skenario tambahan (Emergency Hotfix, API-First, Plugin, Microservice Extraction, dll).

Security by default

Yang paling gue suka: 17 Parts security standards yang AI WAJIB terapkan tanpa diminta.

• Part A: Credential management (hanya di .env)
• Part B: HTTP security headers (CSP, HSTS, X-Frame-Options)
• Part D: Input validation (POST/PUT/DELETE)
• Part I: Pre-merge security checklist

Jadi kalau kamu setup docs-ai di project, AI otomatis apply security best practices. Gak perlu ngingetin.

Cara pakai

Copy folder ai-rules/ ke project baru:

cp -r ai-rules/ /path/to/new-project/

Terus prompt AI:

"Baca AGENTS.md, lalu setup planning/ dan dev-docs/"

AI akan baca kontrak kerja, buat folder output dari template, dan mulai generate dokumentasi. Semua terstruktur, semua terkontrol.

Limitasi

• No license — Gak jelas boleh dipakai komersial atau gak
• Baru 100 stars — Masih niche, belum proven di scale besar
• Fokus Laravel/PHP — Template-nya banyak referensi Laravel, tapi bisa diadaptasi
• No automated validation — Semua manual, gak ada CLI tool bantu enforce

Bottom line

Kalau kamu pakai AI buat nulis kode dan dokumentasi berantakan, docs-ai worth dicoba. Setup sekali, dapat struktur yang konsisten.

GitHub: github.com/frandika06/docs-ai