# AI Invoke Guide — Project Foundation Pack v0.2.0

Panduan ini menjelaskan cara terbaik mengarahkan AI ke file yang tepat tanpa harus copy-paste isi prompt setiap saat.

---

## Konsep dasar

Pack ini bekerja dengan pola 4 komponen:

```
┌─────────────────┐    ┌──────────────────────┐
│  File prompt    │    │  Foundation pack      │
│  (cara kerja AI)│    │  (source of truth     │
│                 │    │   struktur dokumen)   │
└────────┬────────┘    └──────────┬───────────┘
         │                        │
         └──────────┬─────────────┘
                    ↓
              ┌─────────────┐
              │     AI      │
              └──────┬──────┘
                     │
         ┌───────────┴───────────┐
         │                       │
┌────────┴────────┐    ┌─────────┴──────────┐
│  Brief file     │    │  Feature spec file  │
│  (isi project   │    │  (scope per modul   │
│   Anda)         │    │   saat execution)   │
└─────────────────┘    └────────────────────┘
```

Dengan pola ini:
- AI selalu bekerja dari file, bukan dari memory chat
- Brief tidak perlu ditulis ulang setiap sesi
- Foundation tidak bisa diinventasi AI — harus mengacu ke template yang ada
- Feature spec menjaga scope execution tetap sempit

---

## Pola invocation per situasi

### Situasi 1: Mulai project baru dari nol

```
Baca file ini dan ikuti semua instruksinya:
[PATH]/prompts/00-one-shot-master.md

Gunakan folder ini sebagai source of truth:
[PATH]/docs/foundation-pack

Lalu baca brief project ini:
[PATH]/SUPER-BRIEF.md

Kerjakan semua tahap dalam satu respons.
```

### Situasi 2: Lanjut dari foundation yang sudah ada, masuk ke coding

```
Baca file ini dan ikuti instruksinya:
[PATH]/prompts/07-pre-execution-checklist.md

Foundation project ada di:
[PATH ke folder docs project Anda]

Feature spec modul ini:
[PATH ke feature spec yang akan dikerjakan]

Phase yang akan dikerjakan: [nama phase]
```

### Situasi 3: Sesi baru, ingin lanjut dari sesi sebelumnya

Paste session handoff dari sesi lama, lalu tambahkan:

```
Ini adalah handoff dari sesi sebelumnya. Baca dan pahami context-nya.

Foundation pack project ada di:
[PATH ke folder docs project Anda]

Lanjutkan dari NEXT ACTIONS nomor 1.
```

### Situasi 4: Foundation sudah ada, project berubah arah

```
Baca file ini dan ikuti instruksinya:
[PATH]/prompts/09-post-pivot-sync.md

Foundation pack project ada di:
[PATH ke folder docs project Anda]

Perubahan yang terjadi:
[deskripsi perubahan]
```

### Situasi 5: AI tidak bisa baca file (copy-paste mode)

1. Buka `prompts/00-one-shot-master.md`
2. Copy seluruh isinya
3. Paste di conversation AI
4. Di bawahnya, tambahkan:

```
---
Brief project saya:
- Nama: [isi]
- Untuk siapa dan masalahnya: [isi]
- Fitur utama: [isi]
- Stack: [isi atau "belum tahu"]
- Constraint: [isi atau kosongkan]
```

---

## Cara baca file di berbagai AI tool

| AI Tool | Cara referensikan file |
|---------|----------------------|
| Cursor | `@path/ke/file.md` atau `@folder/` |
| Claude Projects | Upload ke Project Knowledge, referensikan nama file |
| ChatGPT | Upload file ke conversation |
| Gemini | Attach file atau paste ke chat |
| GitHub Copilot | `#file:path/ke/file.md` |
| AGY | Path absolut atau relatif langsung |

Untuk panduan lengkap per tool, baca folder `providers/`.

---

## Tips penting

**Selalu sebutkan source of truth secara eksplisit.**
Jangan hanya bilang "gunakan foundation pack". Sebutkan path lengkapnya agar AI tahu persis file mana yang harus dibaca.

**Pisahkan sesi foundation dan sesi coding.**
Jangan mix generate foundation dan execution dalam satu conversation yang sama. Context tercampur akan membuat AI kurang fokus.

**Gunakan session handoff secara aktif.**
Setiap kali sesi panjang akan diakhiri, jalankan `08-session-handoff.md` lebih dulu. Handoff yang baik menghemat waktu setup di sesi berikutnya.

**Untuk team: simpan handoff di file.**
Jika bekerja dalam tim, simpan session handoff ke file di repo (misal `docs/ai/last-session-handoff.md`) agar bisa dipakai anggota tim lain.