# Quickstart — Project Foundation Pack v0.2.0

Panduan ini mengantarkan Anda dari nol sampai foundation project siap dieksekusi.

---

## Cara tercepat — 2 langkah

**Langkah 1.** Isi `SUPER-BRIEF.md` (5 baris, kurang dari 1 menit)

**Langkah 2.** Kirim ke AI bersama `prompts/00-one-shot-master.md`

Selesai. AI akan otomatis:
- Mendeteksi tipe project Anda (SaaS, internal tool, mobile app, API, atau AI product)
- Menerapkan asumsi dan guardrails yang sesuai
- Menghasilkan 6 dokumen foundation lengkap
- Melakukan health check sendiri
- Membuat pre-execution plan untuk Phase 1

---

## Pilih AI Anda terlebih dahulu

Sebelum mulai, baca panduan untuk AI tool yang Anda pakai:

| AI tool | Panduan |
|---------|---------|
| Cursor | `providers/cursor.md` |
| Claude.ai / Claude Projects | `providers/claude.md` |
| ChatGPT / Custom GPT | `providers/chatgpt.md` |
| Gemini / Google AI Studio | `providers/gemini.md` |
| GitHub Copilot | `providers/github-copilot.md` |
| Antigravity / AGY | `providers/antigravity.md` |
| AI lainnya | `providers/universal.md` |

---

## Alur kerja lengkap

### Mode 1 — One-shot (paling cepat, 1 prompt)

```
Isi SUPER-BRIEF.md
        ↓
Kirim ke AI dengan 00-one-shot-master.md
        ↓
Foundation lengkap + health check + execution plan
```

Cocok untuk: mulai project baru, ingin hasil cepat.

---

### Mode 2 — Recommended (2 prompt)

```
Prompt 1: 00-one-shot-master.md → foundation draft
        ↓
Prompt 2: 06-foundation-health-check.md → validasi + selesaikan open decisions
```

Cocok untuk: project yang akan langsung dieksekusi, ingin lebih yakin sebelum coding.

---

### Mode 3 — Modular safe flow (4 prompt)

```
Prompt 1: 00-one-shot-master.md → foundation draft
        ↓
Prompt 2: 06-foundation-health-check.md → validasi
        ↓
Prompt 3: feature spec untuk modul pertama
        ↓
Prompt 4: 07-pre-execution-checklist.md → checklist → 03-phase-execution.md → coding
```

Cocok untuk: team project, scope besar, atau saat Anda ingin kontrol penuh di setiap tahap.

---

## Prompt reference — kapan pakai yang mana

| Prompt | Kapan dipakai |
|--------|---------------|
| `00-one-shot-master.md` | **Awal project baru** — satu prompt untuk segalanya |
| `01-foundation-generator.md` | Generate foundation via diskusi interaktif dengan AI |
| `02-foundation-finalizer.md` | Rapikan dan sinkronkan foundation draft yang sudah ada |
| `03-phase-execution.md` | **Mulai coding** — jalankan setelah feature spec siap |
| `04-foundation-filler.md` | Isi foundation dari brief yang lebih panjang |
| `05-ultra-short-foundation-filler.md` | Isi foundation dari brief sangat singkat |
| `06-foundation-health-check.md` | **Validasi sebelum coding** — cek kesiapan foundation |
| `07-pre-execution-checklist.md` | **Sebelum setiap coding phase** — verifikasi scope & kesiapan |
| `08-session-handoff.md` | **Saat context window hampir habis** — buat ringkasan untuk sesi berikutnya |
| `09-post-pivot-sync.md` | **Setelah project berubah arah** — sync semua dokumen foundation |

---

## Struktur folder yang direkomendasikan di repo Anda

Setelah foundation dihasilkan, simpan hasilnya di sini:

```
your-project/
  docs/
    project-brief.md                ← dari 01-project-brief-template.md
    product/
      prd.md                        ← dari 02-prd-template.md
    architecture/
      overview.md                   ← dari 03-architecture-blueprint-template.md
    standards/
      engineering-guidelines.md     ← dari 04-engineering-guidelines-template.md
    ai/
      guardrails.md                 ← dari 05-ai-guardrails-template.md
    roadmap/
      implementation-plan.md        ← dari 06-implementation-roadmap-template.md
    features/
      auth.md                       ← dari 07-feature-spec-template.md (per modul)
      user-management.md
      [nama-modul].md
```

---

## Prinsip yang harus selalu diingat

- **Brief file dulu, prompt belakangan.** Isi `SUPER-BRIEF.md` sebelum kirim apapun ke AI.
- **Jangan skip health check.** Foundation yang lemah akan membuat execution liar.
- **Feature spec wajib untuk modul besar.** Jangan langsung execution dari foundation umum.
- **Gunakan session handoff.** Jangan biarkan context penting hilang saat sesi AI berganti.
- **Sync setelah pivot.** Gunakan `09-post-pivot-sync.md` setiap kali ada perubahan arah yang signifikan.

---

## Yang tidak boleh dilakukan AI (guardrails universal)

Ingatkan AI ini di setiap sesi:

- Jangan tambah dependency tanpa approval eksplisit
- Jangan keluar dari scope yang didefinisikan di feature spec
- Jangan sisakan scaffold, demo content, atau placeholder yang belum diisi
- Jangan refactor area lain di luar scope yang sedang dikerjakan
- Jangan mulai coding sebelum foundation final dan feature spec ada

---

## FAQ

**Q: Apakah saya harus isi semua 8 template dokumen?**
Tidak harus semua. Minimum yang dibutuhkan sebelum coding: project brief, architecture blueprint, engineering guidelines, AI guardrails, dan implementation roadmap.

**Q: Apakah brief harus panjang?**
Tidak. `SUPER-BRIEF.md` cukup 5 baris. AI yang akan mengisi sisanya dengan professional assumptions.

**Q: Bagaimana jika AI saya tidak bisa baca file lokal?**
Copy isi `prompts/00-one-shot-master.md` lalu paste langsung ke chat, tambahkan brief Anda di bawahnya.

**Q: Apakah pack ini terikat ke satu framework atau bahasa tertentu?**
Tidak. Pack ini framework-agnostic. Sebutkan stack Anda di brief, AI akan menyesuaikan semua rekomendasinya.

**Q: Berapa lama proses generate foundation?**
Untuk one-shot mode: 1-3 menit tergantung model dan panjang output. Foundation yang dihasilkan siap direview langsung.