Dokumentasi

Cara memakai Blueprint Builder

Halaman ini menemanimu dari layar kosong sampai berkasnya keluar, lalu membedah sepuluh berkas yang bisa kamu serahkan ke AI coding agent — satu per satu, apa isinya dan buat apa ia ada.

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

Mulai cepat

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

Masuk dengan Google. Ini yang menjaga project-mu tetap privat dan batas biayanya tetap milikmu. Untuk sekarang, hanya akun yang terdaftar yang bisa masuk.
Buat project. Satu ide, satu project. Satu project memegang tepat satu blueprint.
Tulis idemu apa adanya. Ketik di kotak tulis. Tidak perlu rapi, tidak perlu urut. Apa yang sudah kamu sebutkan akan langsung dihitung terjawab.
Jawab yang tersisa. Muncul sebagai satu layar formulir, dan hanya yang belum terjawab. Tiap pertanyaan sudah membawa jawaban usulan; melewatinya berarti memakai usulan itu, dan ia dicatat sebagai asumsi AI atas namamu.
Tinjau, lalu kunci. Kamu membaca ringkasan dan arah visualnya, mencentang tiap asumsi satu per satu, menjawab dua pertanyaan teknis terakhir, lalu menekan Kunci dan Bangun. Tombol setujunya baru menyala setelah semua asumsi kamu tandai sudah dibaca.
Bawa pulang. 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 menunjukkan kamu ada di mana. Ia tiga tahap, dan jumlah itu ada alasannya: cuma ada dua titik tempat kamu benar-benar mengambil keputusan — mengisi wawancara, dan menekan Kunci dan Bangun — ditambah satu tahap tempat kamu membaca.

Wawancara: Kamu bercerita, lalu mengisi pertanyaan yang tersisa. Pertanyaannya berhenti ketika daftar sepuluhnya sudah terjawab semua, bukan ketika AI merasa cukup.
Tinjau: Ringkasan dan arah visualmu sudah jadi, dan kamu membacanya. Tiap asumsi AI punya kotak centangnya sendiri, dan dua pertanyaan teknis terakhir diisi di sini. Ini gerbang terakhir sebelum ada biaya besar keluar.
Blueprint: Dokumen dibangun satu per satu, berurutan. Setelah dikunci, isinya tidak bisa diubah lagi lewat jalan mana pun, dan tidak ada tombol yang membukanya kembali. Perubahan berarti project baru.

Yang akan ditanyakan

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

#	Yang ditanyakan	Perlu untuk
01	Produk apa	Quick Plan
02	Problem dan outcome	Quick Plan
03	Persona dan permission	Quick Plan
04	Core journey	Quick Plan
05	Scope P0 dan P1	Quick Plan
06	Visual Direction	Quick Plan
07	Platform dan PWA	Quick Plan
08	Constraint delivery	Quick Plan
09	Integrasi pihak ketiga	Build Blueprint
10	Constraint teknis	Build Blueprint

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 kalau kamu menekan salah satu pilihan cepat — Belum tahu, Bantu pilihkan, atau Lewati dulu. Ia dicatat atas namamu, dan kamu wajib mencentangnya sebelum boleh lanjut.
Belum terjawab. Selama masih ada yang begini, dokumennya belum bisa dibuat. Ia tidak dikarang, dan ia tidak diam-diam dilewati.

Sebelas dokumen

Empat dibuat di Quick Plan, tujuh menyusul di Build Blueprint. Tiap dokumen dibangun sendiri-sendiri. Kalau satu gagal di tengah jalan, yang sudah jadi tetap aman dan jatahnya tidak hangus percuma.

Dokumen	Tahap	Isinya
Ringkasan dan kerangka `structure`	Quick Plan	Cakupannya sampai mana, bab apa saja yang akan ada, asumsi yang menunggu kamu setujui, dan pertanyaan yang masih terbuka
Arah visual `visual_direction`	Quick Plan	Gaya, palet warna, dan daftar layar
Keputusan produk `prd`	Quick Plan	Masalah, siapa pemakainya, apa yang masuk dan tidak masuk, serta apa yang dihitung berhasil
Daftar pekerjaan `task_list`	Quick Plan	Pekerjaan dibagi lima area, berikut urutan dan kriteria selesainya
Alur pemakai `user_flow`	Build Blueprint	Perjalanan orang di dalam produkmu, berikut diagramnya
Model data `erd`	Build Blueprint	Apa saja yang disimpan, bagaimana semuanya terhubung, dan asumsi di baliknya
Arsitektur sistem `architecture`	Build Blueprint	Bagian-bagian besarnya, batas tanggung jawab tiap bagian, dan sambungan ke luar
Pilihan teknologi `stack_recommendation`	Build Blueprint	Rekomendasi teknologi — wajib menyebut sumber dan tanggalnya
Keamanan dan data `security`	Build Blueprint	Risiko yang perlu dijaga, data mana yang sensitif, dan apa yang harus dipasang — wajib bersumber
Rencana pengujian `test_plan`	Build Blueprint	Apa yang harus diuji, termasuk saat semuanya gagal
Fase pengerjaan `phases`	Build Blueprint	Urutan pengerjaan, berikut syarat naik ke fase berikutnya

Rekomendasi dan sumbernya

Dua dokumen, Pilihan teknologi dan Keamanan dan data, membuat klaim tentang dunia di luar produkmu. Keduanya karena itu wajib menyebut sumber, dan 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: Kamu memilih isinya: empat dokumen Quick Plan saja, atau seluruh blueprint. Bisa langsung ditempel ke Notion, Google Docs, atau ke mana pun kamu terbiasa menyimpan dokumen.
Halaman cetak: Halaman siap cetak untuk dijadikan PDF lewat dialog cetak browser. Diagramnya ikut tergambar. Kalau 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. Ia 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 — sepuluh 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 situ 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 cuma ikut kalau seluruh isinya diekstrak sebagai satu paket. Diunduh satu-satu, ketiganya akan mendarat di akar folder, di tempat yang tidak satu pun alat mencarinya. Tidak ada pesan galat pada jalan itu; yang terjadi cuma 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 ia sunting.
Lima larangan keras — termasuk larangan menebak nomor versi, harga, tanggal rilis, dan sisa waktu pengerjaan.
Batas aman: daftar hal yang boleh ia 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 tahu ada yang tidak beres.

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. Ia menyuruh pembacanya 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 Ia satu-satunya berkas yang menyatakan apa yang BELUM selesai. 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 Ia keputusan produkmu. Kalau 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 Ia daftar pekerjaan yang 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 beres.
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 duluan — 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 bila 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 beres. 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 Ia menutup jarak yang paling sering membunuh project seperti ini: pemiliknya tidak bisa menilai kemajuan dari kode, dan agent-nya tidak pernah diminta bicara dalam bahasa yang bisa ia nilai.

Cara memakainya

Ekstrak berkas ZIP-nya ke folder project yang masih kosong. Kalau folder itu sudah punya AGENTS.md atau CLAUDE.md sendiri, pindahkan dulu. Paket ini akan menimpanya.
Buka folder itu dengan AI coding agent pilihanmu. Agent yang mengenali AGENTS.md akan membukanya sendiri; kalau tidak, suruh ia membaca AGENTS.md lebih dulu.
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.
Jalankan /next-task. Ia mengambil satu pekerjaan yang sudah bisa dikerjakan, mengerjakannya, lalu mencentangnya.
Sebelum pindah fase, jalankan /gate-check. Ia memeriksa syarat keluar fase terhadap keadaan sungguhan, bukan terhadap kotak yang sudah tercentang.
Kapan pun kamu ingin tahu posisinya, jalankan /report. Jawabannya bahasa sehari-hari, dengan angka yang dihitung, dan sengaja tanpa taksiran waktu.

Satu hal yang mudah terlewat. Kelima berkas isi hanya boleh dibaca agent, tidak disunting. Kalau 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 biayanya tidak bisa lari, aplikasi ini memakai batas harian. Begitu batasnya tercapai, ia 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. Kalau 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 penguncian bersifat satu arah. Tidak ada nomor versi, tidak ada riwayat, tidak ada perbandingan antar versi. Sesudah dikunci, tidak ada jalan yang membukanya kembali. Arsipmu adalah berkas yang sudah kamu Export, dan dialog penguncian menawarkan Export lebih dulu justru karena itu.
Isi dokumen tidak bisa disunting manual. Perubahan terjadi di tahap wawancara, bukan sesudah dokumennya jadi.
Tidak ada berbagi lewat tautan publik, kerja bareng satu 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. Cuma akun yang sudah ada di daftar izin yang bisa masuk.

Pertanyaan yang sering muncul

Apakah saya harus bisa ngoding untuk memakainya?

Tidak, untuk membuat blueprint-nya. Kamu menjawab pertanyaan dalam bahasa sehari-hari, dan yang keluar adalah dokumen. Yang butuh kemampuan teknis adalah tahap sesudahnya — membangun produknya — dan Agent Kit ada persis untuk menyerahkan tahap itu ke AI coding agent.

Berapa lama sampai dokumennya jadi?

Sebagian besar waktunya habis di tangan kamu sendiri: seberapa cepat kamu bercerita dan menjawab pertanyaannya. Sesudah kamu menekan Kunci dan Bangun, dokumennya menyusul sendiri satu per satu selama tab-nya kamu biarkan terbuka — dan kalau kamu menutupnya di tengah jalan, yang sudah jadi tetap tersimpan dan kamu tinggal melanjutkan.

Kenapa saya tidak bisa mengubah blueprint setelah dikunci?

Karena dokumennya saling bergantung. Kalau satu bab bisa diganti sendirian, bab-bab di bawahnya tetap memakai isi yang lama dan tidak satu pun menandai dirinya basi — hasilnya satu paket yang bertentangan di dalam dirinya sendiri, tanpa satu pun peringatan. Kalau isinya perlu berubah, jalannya membuat project baru. Karena itu dialog penguncian menawarkan Export lebih dulu.

Apakah AI-nya bisa mengarang sumber?

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

Apakah project saya bisa dilihat orang lain?

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

Kenapa saya ditolak saat mencoba masuk?

Aksesnya 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 ia menghasilkan kode?

Tidak. Ia menghasilkan 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.

Sudah siap?

Masuk dengan Google→Kembali ke beranda