# Provider Guide — Claude (Claude.ai / Claude Projects)

Panduan ini menjelaskan cara terbaik menggunakan Project Foundation Pack di Claude.ai, khususnya dengan fitur Projects.

---

## Kenapa Claude Projects Ideal untuk Pack Ini

Claude Projects memungkinkan Anda upload file sebagai "Project Knowledge" yang selalu tersedia di setiap conversation dalam project tersebut. Ini adalah cara terbaik untuk menggunakan pack ini karena:
- Foundation pack tidak perlu di-paste ulang setiap sesi
- Context selalu tersedia tanpa memakan conversation window
- Bisa diupdate kapanpun foundation berubah

---

## Setup Awal — Satu Kali Saja

### 1. Buat Project baru di Claude.ai

Buat satu project per project development Anda. Contoh: "Sistem Absensi Klinik".

### 2. Upload ke Project Knowledge

Upload file-file berikut ke Project Knowledge:
```
wajib:
- docs/foundation-pack/01-project-brief-template.md
- docs/foundation-pack/02-prd-template.md
- docs/foundation-pack/03-architecture-blueprint-template.md
- docs/foundation-pack/04-engineering-guidelines-template.md
- docs/foundation-pack/05-ai-guardrails-template.md
- docs/foundation-pack/06-implementation-roadmap-template.md
- docs/foundation-pack/07-feature-spec-template.md
- prompts/00-one-shot-master.md
- prompts/06-foundation-health-check.md
- prompts/07-pre-execution-checklist.md
- prompts/08-session-handoff.md
- prompts/09-post-pivot-sync.md

setelah foundation jadi, tambahkan:
- project-brief.md (hasil isian)
- prd.md (hasil isian)
- architecture-blueprint.md (hasil isian)
- engineering-guidelines.md (hasil isian)
- ai-guardrails.md (hasil isian)
- implementation-roadmap.md (hasil isian)
- docs/features/*.md (feature specs per modul)
```

### 3. Set Project Instructions

Di bagian "Project Instructions" Claude (atau Custom Instructions), Anda tidak perlu mengetik panjang lebar secara manual. 
Cukup **buka dan copy seluruh isi file** `rules/claude.md` dari pack ini, lalu paste ke kotak instruksi Claude.

File tersebut otomatis memberikan konteks ketat agar Claude mematuhi arsitektur yang sudah di-*generate* di dalam `docs/foundation-pack/`.

---

## Cara Pakai Sehari-hari

### Foundation generation (pertama kali)

Paste ini di conversation baru dalam Project:

```
Baca file prompts/00-one-shot-master.md dari Project Knowledge dan ikuti semua instruksinya.

Brief project saya:
[paste isi SUPER-BRIEF.md yang sudah diisi]

Kerjakan semua tahap dalam satu respons.
```

### Health check

```
Baca foundation pack yang sudah ada di Project Knowledge.
Lalu baca prompts/06-foundation-health-check.md dan jalankan review menyeluruh.
```

### Sebelum execution

```
Baca prompts/07-pre-execution-checklist.md dari Project Knowledge.
Phase yang akan dikerjakan: [nama phase/modul]
Jalankan checklist dan buat rencana implementasi.
```

### Session handoff (context window hampir habis)

```
Baca prompts/08-session-handoff.md dari Project Knowledge.
Buat session handoff yang lengkap untuk sesi ini.
```

---

## Alur Lengkap di Claude

```
1. Buat Project baru di Claude.ai
          ↓
2. Upload foundation pack ke Project Knowledge
          ↓
3. Set Project Instructions
          ↓
4. Isi SUPER-BRIEF.md
          ↓
5. Conversation baru → one-shot master
          ↓
6. Copy hasil ke file, upload kembali ke Project Knowledge
          ↓
7. Health check → selesaikan open decisions
          ↓
8. Conversation baru per phase → pre-execution → coding
```

---

## Tips Khusus Claude

- **Upload ulang** setiap kali file foundation diupdate — Project Knowledge tidak auto-sync
- **Conversation terpisah per phase** — jangan mix foundation dan coding dalam 1 conversation
- **Context window Claude panjang** — tapi tetap gunakan session handoff jika sesi sudah sangat panjang
- **Artifacts** — Claude bisa generate file foundation sebagai artifact yang langsung bisa di-copy
- **Jika output terpotong** — minta "lanjutkan dari dokumen [X] yang belum selesai"

---

## Limitation yang Perlu Diketahui

- Project Knowledge di Claude.ai butuh plan berbayar (Pro/Team)
- File yang diupload harus dalam format teks (MD, TXT) — tidak bisa binary
- Jika Project Knowledge terlalu banyak file, Claude mungkin skip beberapa — prioritaskan file yang paling penting
- Tanpa Projects (Free plan): paste isi prompt langsung di conversation, tidak ada persistent context