# Provider Guide — Gemini (Google AI Studio / Gemini Advanced / Gems)

Panduan ini menjelaskan cara terbaik menggunakan Project Foundation Pack di ekosistem Gemini Google.

---

## Pilihan Platform Gemini

| Platform | Cocok untuk | Akses |
|----------|-------------|-------|
| Gemini.google.com | Penggunaan cepat | Free / Advanced |
| Google AI Studio | Developer, prompt engineering | Free dengan API |
| Gems (Gemini Advanced) | Custom assistant permanen | Berbayar |

---

## Mode 1 — Gemini.google.com (paling cepat)

### Cara pakai

1. Buka [gemini.google.com](https://gemini.google.com)
2. Buat conversation baru
3. Attach file (klik ikon paperclip atau kamera):
   - `prompts/00-one-shot-master.md`
   - `SUPER-BRIEF.md` yang sudah diisi
4. Ketik:

```
Baca file 00-one-shot-master.md yang saya lampirkan dan ikuti semua instruksinya.
Brief project saya ada di file SUPER-BRIEF.md yang juga saya lampirkan.
Kerjakan semua tahap dalam satu respons.
```

### Untuk phase selanjutnya

Upload file foundation yang sudah jadi + file prompt yang relevan, lalu berikan instruksi.

---

## Mode 2 — Google AI Studio (paling fleksibel)

Google AI Studio memungkinkan Anda set System Instruction permanen dan menggunakan model terbaru (Gemini 2.0 Flash, Gemini 1.5 Pro, dsb).

### Setup

1. Buka [aistudio.google.com](https://aistudio.google.com)
2. Buat "New Prompt" atau "New Chat"
3. Di bagian **System Instruction**, paste ini:

```
Kamu adalah Principal Product Engineer, Solution Architect, dan Engineering Lead.

Cara kerjamu berdasarkan Project Foundation Pack:
1. Jika diberikan brief project → langsung jalankan one-shot master: detect project type, apply skill layer, generate semua dokumen foundation, lakukan health check, buat pre-execution plan
2. Jika diminta health check → review foundation dan laporkan status kesiapan
3. Jika diminta feature spec → buat feature spec berdasarkan foundation yang ada
4. Jika diminta session handoff → buat ringkasan sesi lengkap untuk dilanjutkan nanti
5. Jika ada pivot/perubahan → lakukan post-pivot sync pada foundation

Aturan:
- Jangan tanya dulu jika brief sudah cukup
- Jangan sisakan placeholder kosong
- Jangan coding sampai diminta
- Tandai asumsi dengan [ASUMSI] dan keputusan terbuka dengan [OPEN DECISION]
```

4. Di bagian file upload, attach semua file dari pack ini
5. Simpan sebagai template yang bisa dipakai ulang

### Keunggulan AI Studio
- Bisa pilih model spesifik (Gemini 2.0 Flash Thinking untuk reasoning yang lebih dalam)
- Bisa set temperature dan parameter lain
- Context window sangat besar (hingga 2M token di beberapa model)
- Gratis untuk penggunaan personal

---

## Mode 3 — Gems (Gemini Advanced)

Gems adalah custom AI assistant di Gemini Advanced — mirip Custom GPT di ChatGPT.

### Setup Gem untuk Foundation Pack

1. Buka Gemini Advanced → Explore Gems → Create Gem
2. Nama: "Foundation Pack Assistant" (atau nama project spesifik)
3. Di bagian **Instructions**:

```
Kamu adalah Principal Product Engineer, Solution Architect, dan Engineering Lead yang selalu bekerja berdasarkan Project Foundation Pack.

Workflow utamamu:
1. ONE-SHOT MASTER: Ketika user memberikan brief → detect project type → apply skill layer yang sesuai → generate semua dokumen foundation → health check → pre-execution plan. Semuanya dalam satu respons tanpa tanya dulu.

2. HEALTH CHECK: Review foundation yang ada, identifikasi gap, beri status READY/NEEDS REVIEW/BLOCKED.

3. FEATURE SPEC: Buat feature spec untuk satu modul berdasarkan foundation yang ada.

4. SESSION HANDOFF: Buat ringkasan sesi lengkap sehingga bisa dilanjutkan di sesi berikutnya.

5. POST-PIVOT SYNC: Sync foundation setelah ada perubahan project.

Auto-detect dari brief:
- Project type: web-saas / internal-tool / mobile-app / api-only / ai-product / marketplace / migration
- Scale: small / medium / large
- Stack: confirmed / inferred (rekomendasikan jika belum disebutkan)

Aturan keras:
- Jangan tanya dulu jika ada cukup informasi
- Jangan biarkan placeholder kosong
- Jangan coding sampai diminta eksplisit
- Bedakan: fakta dari brief, asumsi, rekomendasi
```

4. Upload file foundation pack ke Gem Knowledge
5. Simpan

### Cara pakai Gem

Cukup buka Gem dan kirim brief:

```
Nama project: [isi]
Masalah dan user: [isi]
Fitur: [isi]
Stack: [isi atau skip]
```

---

## Cara Pakai di Gemini dengan Konteks Panjang

Gemini 1.5 Pro dan 2.0 punya context window sangat besar. Manfaatkan ini:

```
Saya paste seluruh isi foundation pack dan brief di bawah.
[paste SUPER-BRIEF.md]
[paste semua file template]
[paste prompts/00-one-shot-master.md]

Ikuti instruksi di 00-one-shot-master.md dan kerjakan semua tahap.
```

---

## Tips Khusus Gemini

- **Gemini 2.0 Flash Thinking** — gunakan untuk foundation generation yang butuh reasoning mendalam
- **Context panjang** — Gemini bisa handle seluruh pack dalam satu context tanpa masalah
- **Google Workspace** — jika pakai Google Workspace, bisa integrasikan dengan Google Docs/Drive untuk simpan output
- **"Continue generating"** — jika output terpotong, klik tombol ini atau ketik "lanjutkan"

---

## Limitation yang Perlu Diketahui

- Gems membutuhkan Gemini Advanced (berbayar)
- Gemini di workspace kadang lebih konservatif dalam output panjang
- File attachment di Gemini.google.com terbatas ukurannya — pack yang sudah besar mungkin perlu dipecah