# Provider Guide — Cursor

Panduan ini menjelaskan cara terbaik menggunakan Project Foundation Pack di Cursor.

---

## Kenapa Cursor Berbeda

Cursor bisa membaca file workspace secara langsung via `@file`, `@folder`, atau dengan mengetik path. Ini membuat pack bekerja lebih mulus karena Anda tidak perlu copy-paste isi prompt — cukup arahkan Cursor ke file yang benar.

---

## Cara Tercepat: One-Shot dari Chat

Gunakan Cursor Chat (bukan Composer dulu) untuk foundation generation:

```
Baca file ini dan ikuti instruksinya:
@prompts/00-one-shot-master.md

Gunakan folder ini sebagai source of truth:
@docs/foundation-pack

Lalu baca brief project ini:
@SUPER-BRIEF.md

Kerjakan semua tahap dalam satu respons.
```

Ganti `@SUPER-BRIEF.md` dengan path ke brief yang sudah Anda isi.

---

## Setup yang Direkomendasikan

### 1. Simpan pack di workspace yang sama
Letakkan folder `project-foundation-pack` di dalam workspace Cursor Anda, atau dalam repo yang sama. Ini memungkinkan referensi `@file` langsung.

```
your-project/
  docs/
    foundation-pack/      ← copy dari pack
    features/             ← feature specs akan masuk sini
  project-brief.md        ← brief project aktif Anda
  .cursor/
    rules/
      foundation.mdc      ← lihat bagian .cursorrules di bawah
```

### 2. Gunakan Global Rules
Agar setiap sesi Cursor otomatis tahu tentang arsitektur proyek tanpa Anda perintahkan ulang, copy template dari folder `rules/` di pack ini:

- Copy file `rules/.cursorrules` ke folder *root* proyek Anda.
- (Atau jika Anda menggunakan format MDC terbaru, Anda bisa mengubah ekstensinya menjadi `.cursor/rules/foundation.mdc`).

Isi file tersebut sudah otomatis memerintahkan AI untuk menjadikan `docs/foundation-pack/` sebagai *Source of Truth* dan mematuhi *guardrails* yang ada di dalamnya.

### 3. Gunakan Composer untuk execution

Setelah foundation selesai, gunakan **Cursor Composer** untuk phase execution:

```
Gunakan foundation pack yang sudah final sebagai source of truth.
Baca file ini:
@prompts/07-pre-execution-checklist.md

Lalu baca feature spec ini:
@docs/features/[nama-feature].md

Kerjakan phase ini sesuai scope.
```

---

## Alur Lengkap di Cursor

```
1. Isi SUPER-BRIEF.md
          ↓
2. Cursor Chat → kirim dengan @prompts/00-one-shot-master.md
          ↓
3. Copy output ke file-file foundation (atau minta Cursor yang simpan)
          ↓
4. Cursor Chat → @prompts/06-foundation-health-check.md
          ↓
5. Selesaikan open decisions
          ↓
6. Untuk modul besar: Cursor Chat → susun feature spec
          ↓
7. Cursor Composer → @prompts/07-pre-execution-checklist.md
          ↓
8. Cursor Composer → execution berdasarkan feature spec
```

---

## Tips Khusus Cursor

- **`@Codebase`** — Gunakan ini untuk memberi context seluruh repo sekaligus saat health check
- **Context window penuh?** — Jalankan `@prompts/08-session-handoff.md` sebelum mulai sesi baru
- **Perubahan besar?** — Gunakan `@prompts/09-post-pivot-sync.md` untuk sync foundation
- **Jangan mix** foundation generation dengan coding dalam satu Composer session — pisahkan

---

## Limitation yang Perlu Diketahui

- Cursor context window terbatas — untuk project besar, bagi foundation generation per dokumen
- Jika output terpotong, minta Cursor melanjutkan dari dokumen terakhir yang belum selesai
- Cursor kadang "improvisasi" format dokumen — selalu ingatkan untuk mengikuti template yang ada