Free Tier, Revisi AI Assistant, dan Project ZIP

Panduan ini menjelaskan alur produk AI Blueprint yang berlaku sekarang: apa yang tersedia pada Free Tier, cara merevisi Blueprint dengan AI Assistant tanpa mengubah dokumen secara diam-diam, cara membuka Project ZIP, dan cara menyerahkan ZIP tersebut kepada AI coding agent.

1. Pahami Dua Jenis Akses Gratis

Free preview biasa tersedia satu kali untuk pendaftar baru yang memenuhi syarat dan belum pernah membeli paket. Preview dibuat sampai App Map dan bersifat hanya-baca. Download, AI Assistant, approval final, Project ZIP, dan dokumen setelah App Map tidak tersedia.

Kupon Credit AI khusus free trial berbeda dari preview biasa. Kupon ini menambah Credit AI dan membuka seluruh fitur workspace selama 7 hari. Sisa credit promosi berakhir bersama akses 7 hari. Nilai credit mengikuti campaign yang tampil dan tidak boleh ditebak dari contoh lama.

Jika preview biasa sudah selesai lalu pembayaran paket dikonfirmasi, Anda dapat memilih meregenerasi ide trial menjadi Blueprint penuh atau memulai ide baru.

2. Siapkan Blueprint Sebelum Revisi

1. Buka Blueprint dan tunggu seluruh proses yang sedang berjalan selesai.
2. Baca dokumen yang berkaitan dengan perubahan Anda.
3. Catat hasil yang diinginkan, dokumen target, alasan, dan bagian yang harus tetap sama.
4. Pastikan paket atau akses campaign masih aktif dan Credit AI mencukupi untuk tindakan berbayar.

AI Assistant menggunakan konteks Blueprint yang disetujui. Jangan memasukkan kata sandi, API key, token, OTP, atau data pribadi customer ke percakapan.

3. Buat Proposal lewat AI Assistant

Buka AI Assistant dari Blueprint Summary atau dari tombol bertanya pada bagian dokumen. Untuk perubahan, minta proposal secara eksplisit.

Buat proposal untuk menambahkan approval manager sebelum pengeluaran dibayar.
Target: Access & Security dan alur pengeluaran yang terdampak.
Pertahankan login, role lain, dan proses audit yang sudah disetujui.

Jika Assistant hanya memberi saran, lanjutkan dengan: Buatkan proposal dari rekomendasi itu. Proposal masih berupa draft. Dokumen belum berubah sampai Anda menekan Apply.

4. Pilih Jenis Revisi yang Tepat

• Direct edit untuk nilai literal yang presisi, seperti warna, label, angka, atau durasi dalam satu dokumen. Pastikan proposal menyebut nilai lama dan nilai pengganti.
• Rewrite satu dokumen ketika isi dan penalaran satu dokumen perlu ditulis ulang. Jelaskan apa yang harus membaik dan apa yang harus dipertahankan.
• Revisi besar untuk aktor, fitur, aturan, integrasi, atau scope. Pecah perubahan terkait menjadi proposal terpisah agar setiap dampak dapat direview.
• Regenerasi dari proposal untuk menulis ulang dokumen yang terdampak dari sumber Blueprint yang sudah disetujui.

Tinjau ringkasan, scope, tingkat dampak, target dokumen, dan biaya credit pada setiap kartu proposal. Tolak proposal yang memperluas scope tanpa persetujuan.

5. Apply, Verifikasi, dan Versi

1. Tekan Apply hanya pada proposal yang benar.
2. Untuk beberapa perubahan terkait, simpan proposal terlebih dahulu lalu gunakan Apply all agar regenerasi tidak berjalan berulang tanpa perlu.
3. Tunggu proses selesai. Jangan membuat proposal duplikat ketika run masih aktif.
4. Buka setiap versi dokumen baru dan bandingkan hasilnya dengan permintaan.
5. Gunakan Revision history jika perlu melihat versi sebelumnya.
6. Selesaikan review notes, lalu lakukan Sign Approve kembali bila Blueprint berubah.

Jika credit kurang, proposal tetap aman untuk dicoba kembali setelah top-up. Jika hasil tidak sesuai, jangan menimpa manual tanpa jejak; buat proposal koreksi yang lebih spesifik.

6. Buka dan Download Project ZIP

Project ZIP hanya terbuka untuk Blueprint penuh setelah semua dokumen versi saat ini dibuka dan direview, tidak ada proses yang masih berjalan, serta Sign Approve Blueprint selesai.

Setelah status menunjukkan Project ZIP sudah terbuka:

1. Buka Blueprint Summary.
2. Tekan Ekspor ZIP Proyek.
3. Simpan file ZIP di folder kerja lokal.
4. Jangan coding di dalam file terkompresi. Gunakan Extract all terlebih dahulu.

Isi ZIP dapat berbeda sesuai proyek. Gunakan manifest.json, implementation guide, PRD, schema, dokumen di docs/, dan prompt yang benar-benar ada sebagai sumber kebenaran.

7. Mulai Coding dengan AI Coding Agent

Setelah extract:

1. Pastikan .env.local tidak memuat secret production dan tetap masuk .gitignore.
2. Buat Git baseline sebelum agent mengubah file.
3. Minta agent membaca manifest.json, implementation guide, AGENTS.md, PRD, schema, dan dokumen terkait.
4. Jalankan PROMPT_1.md untuk analisis dan rencana. Jangan langsung meminta agent membangun semuanya.
5. Review PLAN.md, konflik, risiko, dan acceptance criteria.
6. Implement satu tahap atau satu vertical slice.
7. Jalankan lint, typecheck, test, build, inspeksi UI, dan review git diff.
8. Commit perubahan yang sudah terverifikasi sebelum tahap berikutnya.

Lanjutkan dengan tutorial lengkap Dari Project ZIP ke Code.

8. Checklist Sebelum Development

• Semua revisi yang benar sudah di-Apply.
• Semua dokumen hasil perubahan sudah direview.
• Blueprint sudah mendapat approval final terbaru.
• Project ZIP berhasil di-download dan diekstrak.
• Secret tidak masuk repository atau prompt.
• Git baseline tersedia.
• Coding agent memahami source of truth dan acceptance criteria.
• Tahap pertama cukup kecil untuk diverifikasi.

Sumber dan Panduan Lanjutan

• AI Blueprint Terms: /terms
• Project ZIP ke Code: /learning/ai-coding/blueprint-to-code
• Git documentation: https://git-scm.com/docs
• OpenAI Codex documentation: https://developers.openai.com/codex