Project Brief

project-brief.md yang anda simpan ialah source of truth untuk seluruh build.

Apa ini

Project brief ialah file pertama yang disimpan oleh Blueprint Coach. Ia berada dalam project folder anda sebagai project-brief.md dan memberitahu anda — dan Antigravity — dengan tepat apa yang anda bina.

Anda tidak menulis ini sebagai esei panjang. Coach interview anda satu soalan pada satu masa, tunjuk draft, dan simpan file yang diluluskan.

Kenapa penting

Setiap build prompt patut berpaksikan file ini. Tanpanya, AI membuat andaian, menambah perkara yang anda tidak minta, dan terpesong daripada idea anda. Dengannya, setiap peringkat seterusnya ada satu rujukan yang jelas.

Apa nak buat

Biar Blueprint Coach simpan brief

Dalam Website mode, biar coach bawa anda melalui phase brief. Confirm setiap section, kemudian biar ia simpan project-brief.md di project root anda.

Pastikan file ada section yang betul

Buka project-brief.md. Ia patut mengandungi kesemua ini:

✓ One-Line Idea — one sentence
✓ Real User Moment — when and why someone opens it
✓ Visitor Goal — what the visitor should understand or do
✓ Audience — who this is for
✓ Page / Section Map — 3-5 sections, each with one purpose
✓ Content I Have — what you already have
✓ Content I Will Fake — sample content you will use
✓ Core Features — max 3
✓ Non-Goals — what you are not building today
✓ Style Feeling — 3-5 words for the vibe
✓ Success Check — how you know version 1 is good enough
✓ Cut List — what you deliberately removed

Pilihan tool dan stack tidak termasuk di sini — ia datang seterusnya, dalam build blueprint. Kalau ada section yang hilang atau kabur, minta coach isi kekosongan itu.

Baca sekali sebelum sambung

• Adakah ini padan dengan apa yang saya betul-betul mahu bina?
• Adakah section dan features boleh dicapai dalam satu sesi?
• Ada apa-apa yang menyelinap masuk yang perlukan login, payment, database, atau backend?

Jauh lebih mudah mengubah plan di sini daripada mengubahnya di tengah-tengah build.

Contoh project brief yang bagus

# Project Brief

## One-Line Idea
A simple one-page website for Kopi Kita cafe in Subang.

## Real User Moment
A customer checks their phone before visiting to decide what to order.

## Visitor Goal
Find the menu, opening hours, and how to get there in under a minute.

## Audience
Nearby customers using their phone before or during a visit.

## Page / Section Map
- Home — short intro, best photo, opening hours
- Menu — drinks and food grouped clearly with prices
- Contact — address, Waze link, phone number

## Core Features
1. Display menu with prices
2. Show contact details and map link
3. Responsive layout for mobile

## Non-Goals
- No online ordering
- No payment
- No customer login

## Style Feeling
Warm, cozy, clean, local.

## Success Check
Someone can open the site on mobile, find the menu, check hours, and tap the Waze link in under one minute.

Rahsiakan data peribadi daripada brief: tiada password, API keys, data client, nombor IC/passport, atau butiran bank. Guna sample content bila perlu.

Common mistakes

• Menyimpan brief hanya dalam chat window dan bukan menyimpan file.
• Brief yang terlalu kabur — "build a nice website" bukan brief.
• Menambah stack, login, atau database di sini dan bukan mengekalkannya kepada idea dan scope.
• Menyimpan file di luar project root.