# Provider Guide — Antigravity / AGY (Google Antigravity CLI)

Panduan ini menjelaskan cara terbaik menggunakan Project Foundation Pack dengan Antigravity (AGY) dari Google.

---

## Kenapa AGY Ideal untuk Pack Ini

AGY memiliki beberapa keunggulan yang membuat Foundation Pack bekerja sangat baik:
- Bisa membaca file workspace secara langsung
- Mendukung AGENTS.md untuk instruksi permanen
- Mendukung skill system yang align dengan konsep skill layer di pack ini
- Context window besar dengan Gemini model
- Bisa run command untuk verifikasi langsung

---

## Setup Permanen (Satu Kali)

### 1. Gunakan Template `AGENTS.md`
Agar AGY otomatis mengetahui konteks arsitektur proyek, Anda cukup **mengkopi file `rules/AGENTS.md`** dari pack ini ke dalam *root* direktori proyek Anda.

File template tersebut sudah dilengkapi instruksi yang mengunci `docs/foundation-pack/` sebagai *Source of Truth* tertinggi. Anda bebas mengeditnya lebih lanjut jika diperlukan.

### 2. Letakkan pack di posisi yang mudah direferensikan

```
your-project/
  docs/
    foundation-pack/      ← copy dari pack (template + isian)
    features/             ← feature specs
  project-brief.md
  AGENTS.md               ← instruksi permanen untuk AGY
  SUPER-BRIEF.md          ← untuk input awal
```

---

## Cara Pakai: Foundation Generation

```
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.
```

Ganti `[path]` dengan path relatif atau absolut ke file tersebut.

### Lebih singkat (jika AGENTS.md sudah ada)

Karena AGENTS.md sudah berisi instruksi dasar, cukup:

```
Baca dan ikuti:
prompts/00-one-shot-master.md

Brief ada di:
SUPER-BRIEF.md

Kerjakan semuanya sekarang.
```

---

## Cara Pakai: Execution Phase

AGY sangat powerful untuk execution karena bisa run command langsung.

```
Baca pre-execution checklist:
prompts/07-pre-execution-checklist.md

Foundation ada di docs/foundation-pack/
Feature spec ada di docs/features/[nama-feature].md

Jalankan checklist, buat rencana, lalu implementasikan.
Setelah selesai, jalankan command verifikasi yang relevan.
```

---

## Skill System AGY vs Skill Layer Pack

Jika Anda menggunakan AGY skill system, buat skill yang memuat skill layer dari pack:

Buat file di `~/.gemini/config/skills/foundation-web-saas/SKILL.md`:

```markdown
---
name: foundation-web-saas
description: Applies web SaaS specific context to the Foundation Pack workflow
---

# Web SaaS Skill Layer

Ketika bekerja di project web-saas, terapkan asumsi berikut secara otomatis:

## Stack defaults (jika belum disebutkan)
- Backend: pilih yang paling sesuai dengan konteks (NestJS, Laravel, Rails, dsb)
- Frontend: Next.js atau Nuxt
- Database: PostgreSQL dengan soft delete
- Auth: JWT + refresh token atau session-based

## Architecture defaults
- Multi-tenant dengan row-level isolation
- API-first design
- Subscription atau freemium model assumption

## Guardrails tambahan
- Selalu pertimbangkan tenant isolation sebelum query apapun
- Error messages jangan expose internal details
- Rate limiting wajib di semua public endpoint
```

---

## Alur Lengkap di AGY

```
1. Setup AGENTS.md
          ↓
2. Isi SUPER-BRIEF.md
          ↓
3. AGY: one-shot master → generate foundation
          ↓
4. AGY: health check → review kesiapan
          ↓
5. AGY: selesaikan open decisions
          ↓
6. AGY: susun feature spec per modul
          ↓
7. AGY: pre-execution checklist
          ↓
8. AGY: execution + run verification commands
          ↓
9. AGY: session handoff jika perlu
```

---

## Tips Khusus AGY

- **AGENTS.md** — gunakan ini sebagai "always-on context" yang tidak perlu disebut setiap saat
- **Path lokal** — AGY bisa baca path absolut/relatif langsung, tidak perlu upload
- **Run command** — manfaatkan kemampuan AGY untuk run lint, test, build setelah execution
- **Subagents** — untuk foundation kompleks, AGY bisa spawn subagents untuk tiap dokumen secara paralel

---

## Limitation yang Perlu Diketahui

- AGY butuh akses ke file workspace — pastikan pack ada di path yang bisa dibaca
- Untuk project yang sangat besar, pertimbangkan generate foundation per dokumen, bukan sekaligus