Dokumentasi

Cara memakai Blueprint Builder

Halaman ini menemanimu dari layar kosong sampai berkasnya keluar, lalu membedah sepuluh berkas Agent Kit yang bisa kamu serahkan ke AI coding agent: satu per satu, apa isinya dan untuk apa berkas itu ada.

Yang tertulis di sini adalah perilaku aplikasi sebagaimana berjalan hari ini. Jika ada kalimat yang berbeda dengan yang kamu lihat di layar, yang benar adalah layarnya — beri tahu kami.

Mulai cepat

Dari halaman kosong sampai blueprint siap dibangun, urutannya selalu sama, dan tidak satu langkah pun bisa dilompati.

  1. Masuk dengan Google. Ini yang menjaga project-mu tetap privat dan batas biayanya tetap di tanganmu. Untuk sekarang, hanya akun yang terdaftar yang bisa masuk.
  2. Buat project. Satu ide, satu project. Satu project memegang tepat satu blueprint.
  3. Tulis idemu apa adanya. Ketik di kotak tulis; tidak perlu rapi, tidak perlu urut. Apa yang sudah kamu sebutkan langsung dihitung terjawab.
  4. Jawab yang tersisa. Pertanyaan pertama muncul sebagai satu layar formulir; sisanya satu per satu, dan hanya yang belum terjawab. Tiap pertanyaan membawa jawaban usulan; melewatinya berarti memakai usulan itu, dan ia dicatat sebagai asumsi AI atas namamu.
  5. Bangun sebelas dokumen. Setelah wawancara lengkap, tekan Bangun 11 bagian. Dokumen disusun berurutan; kamu bisa menghentikan kapan saja dan melanjutkan nanti. Yang sudah jadi tetap tersimpan.
  6. Bawa pulang. Ada empat jalan keluar: satu berkas Markdown, halaman cetak, prompt siap salin, dan Agent Kit. Lihat Membawanya keluar.

Tiga tahap

Penunjuk tahap di atas layar selalu memberi tahu kamu ada di mana. Jumlahnya tiga tahap, dan itu ada alasannya: hanya ada dua titik tempat kamu benar-benar mengambil keputusan, yaitu menyelesaikan wawancara dan menekan Bangun 11 bagian, ditambah satu tahap tempat kamu membaca hasilnya.

Wawancara
Kamu bercerita, lalu mengisi pertanyaan yang tersisa. Pertanyaannya berhenti ketika sepuluh butir daftarnya sudah terjawab semua, bukan ketika AI merasa cukup.
Bangun
Wawancara sudah lengkap dan sebelas dokumen belum ada. Tekan Bangun 11 bagian; dokumen disusun berurutan dan dapat dilanjutkan kalau rantainya berhenti. Tidak ada gerbang persetujuan tambahan di sini.
Blueprint
Sebelas dokumen selesai. Isinya final untuk project ini; perubahan berarti project baru. Bawa pulang lewat Export — Markdown, PDF, prompt, atau Agent Kit.

Yang akan ditanyakan

Ada sepuluh hal yang perlu diketahui sebelum dokumenmu bisa dibuat. Daftarnya tetap sejak awal, jadi kamu selalu bisa melihat sisa berapa. Pertanyaannya juga tidak melebar sendiri di tengah jalan.

#Yang ditanyakanDiminta di
01Produk apaWawancara
02Problem dan outcomeWawancara
03Persona dan permissionWawancara
04Core journeyWawancara
05Scope P0 dan P1Wawancara
06Visual DirectionWawancara
07Platform dan PWAWawancara
08Constraint deliveryWawancara
09Integrasi pihak ketigaWawancara
10Constraint teknisWawancara

Tiap pertanyaan berakhir di salah satu dari tiga keadaan:

  • Kamu yang menjawab. Bisa lewat cerita bebas di awal, bisa lewat formulir.
  • AI yang mengisikan. Terjadi jika kamu menekan salah satu pilihan cepat: Belum tahu, Bantu pilihkan, atau Lewati dulu. Jawabannya dicatat sebagai asumsi AI atas namamu, dan tercatat di Decision Ledger.
  • Belum terjawab. Selama masih ada yang berstatus begini, dokumen belum bisa dibuat. Jawabannya tidak dikarang, dan tidak diam-diam dilewati.

Sebelas dokumen

Empat dokumen fondasi lebih dulu, tujuh bab teknis menyusul — semuanya dalam satu alur Bangun. Tiap dokumen dibangun sendiri-sendiri. Jika satu gagal di tengah jalan, yang sudah jadi tetap aman dan jatahnya tidak hangus.

DokumenKelompokIsinya
Ringkasan dan kerangka
structure
FondasiCakupannya sampai mana, bab apa saja yang akan ada, asumsi AI yang tercatat, dan pertanyaan yang masih terbuka
Arah visual
visual_direction
FondasiGaya, palet warna, dan daftar layar
Keputusan produk
prd
FondasiMasalah, siapa pemakainya, apa yang masuk dan tidak masuk, serta apa yang dihitung berhasil
Daftar pekerjaan
task_list
FondasiPekerjaan dibagi lima area, berikut urutan dan kriteria selesainya
Alur pemakai
user_flow
TeknisPerjalanan orang di dalam produkmu, berikut diagramnya
Model data
erd
TeknisApa saja yang disimpan, bagaimana semuanya terhubung, dan asumsi di baliknya
Arsitektur sistem
architecture
TeknisBagian-bagian besarnya, batas tanggung jawab tiap bagian, dan sambungan ke luar
Pilihan teknologi
stack_recommendation
TeknisRekomendasi teknologi, wajib menyebut sumber dan tanggalnya
Keamanan dan data
security
TeknisRisiko yang perlu dijaga, data mana yang sensitif, dan apa yang harus dipasang, wajib bersumber
Rencana pengujian
test_plan
TeknisApa yang harus diuji, termasuk saat semuanya gagal
Fase pengerjaan
phases
TeknisUrutan pengerjaan, berikut syarat naik ke fase berikutnya

Baris kedua di kolom pertama adalah nama berkasnya saat diekspor. Nama itu ditampilkan apa adanya supaya kamu mengenalinya kembali ketika membuka hasil ekspor.

Rekomendasi dan sumbernya

Dua dokumen, Pilihan teknologi dan Keamanan dan data, membuat klaim tentang dunia di luar produkmu. Karena itu keduanya wajib menyebut sumber, dan hanya keduanya yang membutuhkan pencarian ke web.

Pencarian itu tidak pernah berjalan tanpa persetujuanmu, dan persetujuanmu ikut tercatat.

1officialdokumentasi resmi pembuatnya
2vendorcatatan rilis dan blog resmi
3standardsspesifikasi dan badan standar
4primarysumber tangan pertama lainnya
5secondarytidak boleh berdiri sendirian
  • Sumber di tingkat terlemah tidak boleh menjadi satu-satunya dasar sebuah rekomendasi.
  • Sumber punya masa berlaku: 90 hari untuk dokumentasi rilis, 180 hari untuk standar. Lewat itu dokumennya ditandai, supaya kamu tahu bagian mana yang perlu dicek ulang.
  • Tanda kutipan yang menunjuk sumber yang tidak ada di daftar dihitung sebagai memalsukan bukti, dan dokumennya dicegat sebelum sampai ke tanganmu.

Membawanya keluar

Satu berkas Markdown
Isinya menyesuaikan sendiri: dokumen yang sudah selesai bila build belum lengkap, atau seluruh blueprint setelah kesebelasnya jadi. Bisa langsung ditempel ke Notion, Google Docs, atau ke mana pun kamu biasa menyimpan dokumen.
Halaman cetak
Halaman siap cetak untuk dijadikan PDF lewat dialog cetak browser. Diagramnya ikut tergambar. Jika ada diagram yang gagal, tombol cetaknya menahan diri dan menyebut diagram mana, supaya kamu tidak pernah dapat PDF berlubang tanpa sadar.
Prompt siap salin
Satu prompt per sesi kerja: foundation, frontend, backend, integration, qa_release, ditambah satu prompt pembuka yang memuat peta kelimanya. Tinggal salin-tempel ke asisten AI mana pun. Promptnya disusun dari dokumen yang sudah ada, jadi menyusunnya berkali-kali tidak memotong jatahmu.
Agent Kit
Satu berkas ZIP berisi sepuluh berkas yang tinggal diekstrak ke folder project. Dibedah di bagian berikutnya.

Agent Kit, 10 berkas

Tombol Export untuk AI coding agent di tahap blueprint menghasilkan satu berkas <nama-project>-agent-kit.zip. Ekstrak seluruh isinya ke folder project, termasuk folder .claude/ di dalamnya, sebab di sanalah letak ketiga perintah slash-nya.

folder-project/
├── AGENTS.md                     ← agent membaca ini lebih dulu
├── CLAUDE.md                     ← penunjuk tiga baris ke AGENTS.md
├── constitution.md               ┐
├── spec.md                       │  empat berkas isi
├── design.md                     │  DIBACA SAJA oleh agent
├── tasks.md                      ┘
├── PROGRESS.md                   ← satu-satunya yang agent SUNTING
└── .claude/
    └── commands/
        ├── next-task.md          → /next-task
        ├── gate-check.md         → /gate-check
        └── report.md             → /report

Kenapa satu berkas ZIP, bukan sepuluh tombol unduh

Karena ketiga perintah slash tinggal di dalam folder .claude/commands/, dan folder itu hanya ikut jika seluruh isinya diekstrak sebagai satu paket. Diunduh satu per satu, ketiganya akan mendarat di akar folder, padahal tidak ada satu pun alat yang mencarinya di sana. Tidak ada pesan galat pada jalan itu; yang terjadi hanya perintah yang tidak pernah ada.

Isi tiap berkas

AGENTS.mddibaca saja

Pintu masuk. Berkas inilah yang dibuka agent tanpa kamu suruh.

  • Urutan baca keempat berkas isi, berikut mana yang menang saat isinya bertentangan.
  • Satu kalimat yang menyebut PROGRESS.md sebagai satu-satunya berkas yang boleh agent sunting.
  • Lima larangan keras, termasuk larangan menebak nomor versi, harga, tanggal rilis, dan sisa waktu pengerjaan.
  • Batas aman: daftar hal yang boleh agent lakukan tanpa bertanya, dan hal yang wajib menunggu izinmu.
  • Berapa banyak asumsi dan pertanyaan terbuka yang ada, angkanya saja. Agent yang membaca “3 asumsi” lalu tidak menemukannya akan tahu ada yang tidak sesuai.

kenapa Hampir semua alat coding agent hari ini membuka berkas bernama AGENTS.md dari akar folder tanpa disuruh. Tanpa berkas ini, satu-satunya petunjuk “mulai dari mana” adalah kalimat yang kamu ketik sendiri di kotak chat, dan itu hilang begitu sesinya ditutup.

CLAUDE.mddibaca saja

Penunjuk tiga baris ke AGENTS.md.

  • Tiga baris: isinya menyuruh pembaca membuka AGENTS.md, dan tidak lebih.

kenapa Sebagian alat mencari AGENTS.md, sebagian mencari CLAUDE.md. Keduanya disertakan supaya alat mana pun menemukan pintunya. Sebab kegagalannya berbentuk paling buruk: paket terunduh lengkap, ditaruh di folder yang benar, lalu tidak pernah dibaca, tanpa satu pun pesan galat.

constitution.mddibaca saja

Aturan mainnya, dan apa saja yang BELUM diputuskan.

  • Cakupan pekerjaan dan aturan yang berlaku di seluruhnya.
  • Daftar asumsi yang AI isi atas namamu karena kamu melewati pertanyaannya, berikut nilai yang ia pakai.
  • Daftar pertanyaan yang memang belum punya jawaban.

kenapa Hanya berkas ini yang menyatakan apa yang BELUM diputuskan. Agent yang melewatinya akan membangun di atas asumsi sambil mengira ia membangun di atas keputusan.

spec.mddibaca saja

APA yang dibangun, dan untuk siapa.

  • Keputusan produk, alur pemakai, dan arah visual, disusun jadi satu berkas.

kenapa Berkas ini memuat keputusan produkmu. Jika isinya bertentangan dengan design.md, berkas ini yang menang, dan agent diperintahkan MENYEBUTKAN pertentangannya kepadamu, bukan diam-diam memilih salah satu.

design.mddibaca saja

BAGAIMANA: data, arsitektur, teknologi, keamanan.

  • Model data, arsitektur sistem, pilihan teknologi, dan bab keamanan.
  • Daftar sumber di kaki berkas. Klaim yang bertanda seperti [S1] punya sumbernya di sana; yang tanpa tanda adalah keputusan produkmu sendiri, bukan fakta dari luar.

kenapa Daftar sumbernya ikut HANYA di berkas yang benar-benar memuat tandanya. Menempelkannya ke keempat berkas akan membuat tiga di antaranya mendaftar bukti untuk klaim yang tidak ada di dalamnya.

tasks.mddibaca saja

Pekerjaannya, urutannya, dan syarat naik ke fase berikutnya.

  • Daftar pekerjaan, pembagian fase, dan rencana pengujian.

kenapa Daftar ini sudah kamu setujui. Yang dicentang bukan berkas ini melainkan PROGRESS.md, dan memisahkan keduanya membuat daftar yang sudah disepakati tidak bisa berubah diam-diam saat agent menandai kemajuannya.

PROGRESS.mdboleh disunting

Satu-satunya berkas yang agent BOLEH sunting.

  • Satu kotak centang per butir pekerjaan, dikelompokkan per fase.
  • Tiap butir menyebut apa yang harus selesai lebih dulu, dan apa yang membuatnya dianggap selesai.
  • Tiap fase membawa syarat keluarnya sendiri.
  • Total butirnya disebut di kepala berkas, jadi kamu bisa membaca kemajuannya dalam satu detik.

kenapa Namanya PROGRESS.md, bukan TASKS.md, supaya ia tidak bertabrakan dengan tasks.md yang ada di paket yang sama. Di Windows dan macOS dua nama itu terhitung sama, dan yang belakangan akan menimpa yang lebih dulu, tanpa peringatan dan tanpa error.

.claude/commands/next-task.mdperintah slash

/next-task: ambil satu pekerjaan yang sudah bisa dikerjakan, lalu kerjakan.

  • Menyuruh agent membaca AGENTS.md lebih dulu jika ia belum melakukannya di sesi itu.
  • Mengambil butir PERTAMA yang seluruh pekerjaan pendahulunya sudah selesai.
  • Satu butir, bukan dua, dan bukan satu fase penuh.
  • Kotaknya baru boleh dicentang sesudah syarat selesainya benar-benar terpenuhi.

kenapa Agent yang dilepas tanpa batas akan mengerjakan satu fase penuh dalam satu giliran, dan yang menanggungnya adalah kamu, yang belum tentu bisa memeriksanya baris per baris.

.claude/commands/gate-check.mdperintah slash

/gate-check: buktikan sebuah fase memang boleh ditutup.

  • Mengambil fase pertama yang kotaknya belum habis.
  • Memeriksa syarat keluarnya satu per satu terhadap keadaan sungguhan, bukan terhadap centangnya.
  • Dilarang melunakkan laporannya sendiri.

kenapa Kotak yang tercentang membuktikan seseorang mencentangnya, bukan bahwa pekerjaannya selesai. Perintah ini memisahkan keduanya.

.claude/commands/report.mdperintah slash

/report: laporan kemajuan dalam bahasa sehari-hari.

  • Berapa yang sudah selesai dari berapa, per fase dan keseluruhan.
  • Apa yang sedang menghambat, disebut namanya.
  • Tanpa taksiran waktu. Taksiran yang tidak bisa ditopang lebih menyesatkan daripada tidak ada taksiran sama sekali.

kenapa Perintah ini menutup jarak yang paling sering membunuh project seperti ini: pemiliknya tidak bisa menilai kemajuan dari kode, dan agent tidak pernah diminta bicara dalam bahasa yang bisa ia nilai.

Cara memakainya

  1. Ekstrak berkas ZIP-nya ke folder project yang masih kosong. Jika folder itu sudah punya AGENTS.md atau CLAUDE.md sendiri, pindahkan dulu. Paket ini akan menimpanya.
  2. Buka folder itu dengan AI coding agent pilihanmu. Agent yang mengenali AGENTS.md akan membukanya sendiri; jika tidak, suruh ia membaca AGENTS.md lebih dulu.
  3. Nyalakan pengaman milik alatmu sendiri sebelum mulai: mode konfirmasi, daftar perintah yang boleh dan tidak boleh, dan batas folder kerja. Daftar batas di dalam AGENTS.md adalah instruksi, bukan pagar: ia memberi tahu agent apa yang tidak boleh ia lakukan, tetapi yang benar-benar menghentikannya adalah setelan alatmu.
  4. Jalankan /next-task. Perintah ini mengambil satu pekerjaan yang sudah bisa dikerjakan, mengerjakannya, lalu mencentangnya.
  5. Sebelum pindah fase, jalankan /gate-check. Perintah ini memeriksa syarat keluar fase terhadap keadaan sungguhan, bukan terhadap kotak yang sudah tercentang.
  6. Kapan pun kamu ingin tahu posisinya, jalankan /report. Jawabannya memakai bahasa sehari-hari, dengan angka yang dihitung, dan sengaja tanpa taksiran waktu.
Satu hal yang mudah terlewat. Keempat berkas isi hanya boleh dibaca agent, tidak disunting. Jika agent menemukan salah satunya keliru, ia diperintahkan mengatakannya kepadamu, bukan menyuntingnya supaya cocok dengan kode yang baru saja ia tulis. Keputusan yang diam-diam ditulis ulang adalah keputusan yang tidak pernah diambil siapa pun.

Jatah harian

Membuat dokumen memakai layanan AI, dan layanan itu ada biayanya. Supaya biaya tetap terkendali, aplikasi ini memakai batas harian. Begitu batasnya tercapai, aplikasi berhenti membuat dokumen baru alih-alih terus jalan.

  • Jatahnya diukur dari biaya, bukan dari jumlah klik. Itu yang membuat perbaikan kecil tetap murah, dan pekerjaan besar tetap terbatas.
  • Angka sisa jatah belum ditampilkan di layar, dan panel kanan mengatakannya apa adanya alih-alih menampilkan angka yang belum ada. Batasnya sendiri sudah berjalan penuh.
  • Menekan tombol dua kali tetap dihitung sekali. Jika jaringan lambat lalu kamu menekannya lagi, yang kembali hasil yang sama, bukan pekerjaan kedua.
  • Permintaan yang ditolak tidak memakan biaya. Semua pemeriksaan selesai sebelum layanan AI-nya dipanggil.
  • Prompt siap salin dan Agent Kit tidak memakai jatah sama sekali. Keduanya disusun dari dokumen yang sudah ada, jadi kamu bisa mengunduhnya berkali-kali.

Batas yang perlu diketahui

Ini bukan daftar kekurangan yang menunggu diperbaiki. Semuanya keputusan sadar, dan disebut di sini supaya kamu tidak menemukannya di tengah pekerjaan.

  • Satu project memegang satu blueprint, dan hasilnya final. Sesudah sebelas dokumen selesai, tidak ada jalan mengubahnya di dalam project ini. Arsipmu adalah berkas yang sudah kamu Export; karena itu Export disediakan sejak awal.
  • Isi dokumen tidak bisa disunting manual. Perubahan terjadi di tahap wawancara, bukan sesudah dokumennya jadi.
  • Tidak ada berbagi lewat tautan publik, kolaborasi tim, unggah berkas, maupun tagihan.
  • Tidak ada kode yang dihasilkan. Yang keluar dokumen dan instruksi; kodenya ditulis oleh alatmu sendiri, di mesinmu.
  • Tidak ada aplikasi Android/iOS. Ia web yang menyesuaikan layar, dan bisa dipasang seperti aplikasi.
  • Akses belum dibuka untuk umum. Hanya akun yang sudah ada di daftar izin yang bisa masuk.

Pertanyaan yang sering muncul

Apakah perlu bisa koding untuk memakainya?

Tidak untuk membuat blueprint-nya. Kamu menjawab pertanyaan dengan bahasa sehari-hari, dan hasilnya dokumen. Kemampuan teknis baru dibutuhkan pada tahap sesudahnya, yaitu membangun produknya — dan Agent Kit ada persis untuk menyerahkan tahap itu ke AI coding agent.

Berapa lama sampai dokumennya jadi?

Sebagian besar waktunya ada di tanganmu: seberapa cepat kamu bercerita dan menjawab pertanyaan. Setelah kamu menekan Bangun 11 bagian, dokumen menyusul satu per satu selama tab dibiarkan terbuka. Jika kamu menutupnya di tengah jalan, yang sudah jadi tetap tersimpan dan kamu tinggal melanjutkan.

Bisakah dokumen diubah setelah dibuat?

Tidak dari dalam project ini. Dokumennya saling bergantung: jika satu bab diganti sendirian, bab-bab sesudahnya tetap memakai isi yang lama dan tidak ada yang menandai dirinya basi. Hasilnya satu paket yang bertentangan dengan dirinya sendiri, tanpa satu pun peringatan. Karena itu Export disediakan sejak awal; jika isinya perlu berubah, jalurnya adalah membuat project baru.

Apakah AI-nya bisa mengarang sumber?

Tidak sampai ke dokumenmu. Setiap tanda kutipan dicocokkan dengan daftar sumber sebelum dokumen disimpan; kutipan yang menunjuk sumber yang tidak ada akan dicegat. Jika memang tidak ada sumbernya, aplikasi menuliskannya di sebelah entri itu, bukan mengarang satu.

Apakah orang lain bisa melihat project-mu?

Tidak. Seluruh project privat: tidak ada tautan publik, dan tidak ada kolaborasi. Tidak ada yang bisa mengintip punyamu.

Kenapa akun bisa ditolak saat mencoba masuk?

Akses belum dibuka untuk umum: hanya akun yang sudah ada di daftar izin yang diterima. Akun di luar daftar ditolak dan tidak membuat data apa pun. Itu perilaku yang disengaja, bukan kegagalan.

Apakah aplikasi ini menghasilkan kode?

Tidak. Hasilnya dokumen dan instruksi. Agent Kit adalah teks yang dibaca AI coding agent milikmu sendiri. Kodenya ditulis di mesinmu, oleh alat yang kamu pilih, dengan izin yang kamu atur sendiri.

Halaman ini tergambar, tetapi programnya nol berjalan.

JavaScript menyala di browser ini, tetapi skrip aplikasi ini nol dapat berjalan. Yang biasanya menyebabkannya: pemblokir iklan atau ekstensi yang menahan skrip halaman ini, Lockdown Mode, atau jaringan yang memutus pemuatan di tengah jalan. Coba muat ulang sekali, lalu buka alamat yang sama di browser lain.