# Context Index

<!-- STRATEGY: UPDATE | Peta navigasi domain - boleh tebal, berlapis -->
<!-- READ: on-demand. Cold start = ../AGENTS.md dulu, lalu ai-session-summary.md -->

> Multi-project: `Workspace-Session.md` (root) -> `{project}/AGENTS.md` -> `docs/ai-session-summary.md` -> **STOP**.
> File ini hanya jika perlu navigasi domain.

Boleh tebal (spec, architecture, parent/sibling, checklist) seperti pola Kotlin.
Tetap **indeks + link**, bukan salinan isi dokumen lain.

---

## Zona A - Always-read pointers

| Item | Value |
|------|-------|
| Nama | {REPO_NAME} |
| Path monorepo | `{path/relatif/dari/root}` |
| Cold start | [../AGENTS.md](../AGENTS.md) |
| Sesi terakhir | [ai-session-summary.md](./ai-session-summary.md) |
| Priority aktif | [todo.md](./todo.md) |
| Server / infra | [server.md](./server.md) |
| System requirements | [system-requirements.md](./system-requirements.md) |
| Env / URL template | [../.env.example](../.env.example) |
| Versi | {x.y.z} - [version.md](./version.md) |
| Stack | {TECH_STACK} |
| Tipe | {app / api / library / infra / docs-only} |
| Last updated | {YYYY-MM-DD} |

**Rolling session memory:** hanya [ai-session-summary.md](./ai-session-summary.md).
Arsip (jangan cold-start): WORKLOG, development-log, changelog penuh, version history penuh.

---

## Zona B - On-demand map

> Baca baris di bawah **hanya jika tugas menyentuh area tersebut**.

### Dokumentasi inti

| Dokumen | Isi | Kapan baca |
|---------|-----|------------|
| [ai-session-summary.md](./ai-session-summary.md) | Narasi sesi (overwrite) | Setelah AGENTS |
| [todo.md](./todo.md) | Priority aktif | Ambil / ubah task |
| [project-status.md](./project-status.md) | Progress area | Butuh status luas |
| [issues.md](./issues.md) | Bug / RCA | Debug |
| [changelog.md](./changelog.md) | Keep a Changelog | Audit riwayat |
| [version.md](./version.md) | Poin per versi | Cek versi / rilis |
| [server.md](./server.md) | Host/IP, runtime, DB, port | Deploy / debug koneksi / ubah infra |
| [system-requirements.md](./system-requirements.md) | OS, runtime, tool minimum | Setup / upgrade / migrasi |
| [guide/migration.md](./guide/migration.md) | Migrasi server/domain | Cutover URL/env |
| [../.env.example](../.env.example) | Variabel URL/host (template) | Konfigurasi dynamic URL |
| [adr/](./adr/) | Keputusan arsitektur | Ubah arsitektur |

### API dan guide (jika berlaku)

| Kondisi | Path | Kapan baca |
|---------|------|------------|
| Project API / framework API | [api/](./api/) | Ubah / konsumsi endpoint |
| Prosedur step-by-step | [guide/](./guide/) | Ikuti runbook / setup |

### Spesifikasi / architecture

| Dokumen | Path | Kapan baca |
|---------|------|------------|
| | | |

### Environment / development

| Dokumen | Path | Kapan baca |
|---------|------|------------|
| | | |

### Parent / sibling (monorepo)

| Dokumen | Path | Kapan baca |
|---------|------|------------|
| | | |

---

## Struktur kode

```
{root-project}/
├── AGENTS.md      # cold start (wajib)
├── .env.example   # template URL/env (commit OK)
├── docs/          # dokumentasi standar
└── {modul}/       # {deskripsi}
```

---

## Dependency

| Project / Service | Relasi |
|-------------------|--------|
| | |

---

## Environment

> Detail inventori server: **[server.md](./server.md)** (single owner).

| Env | URL / Host | Catatan |
|-----|------------|---------|
| dev | | ringkas; detail di server.md |

Credential: {lokasi vault/env} - jangan simpan secret di docs.

---

## Aturan kritis AI

> Duplikat singkat dari AGENTS.md - detail aturan di AGENTS.md.

- Minimal diff - fokus scope project ini.
- No commit kecuali user minta.
- Single owner: priority -> todo; bug -> issues; sesi -> ai-session-summary.
- Perubahan material -> version.md + changelog.md.
- Host/IP/runtime/DB berubah -> update server.md.
- Tool/OS requirement berubah -> update system-requirements.md.
- Migrasi server/domain -> update guide/migration.md, .env.example, server.md; **no hardcoded URL** di kode.
- Pengetahuan penting tidak boleh hanya di chat.
- Implementasi tanpa Tier 1 handover = belum selesai.

---

## Checklist

### Sebelum implementasi
- [ ] Baca AGENTS.md + ai-session-summary (TL;DR / Lanjut / Jangan)
- [ ] todo / issues hanya jika perlu

### Setelah implementasi (Tier 1)
- [ ] Overwrite ai-session-summary (max 80 baris; TL;DR wajib)
- [ ] Update todo.md
- [ ] Append changelog.md + version.md
- [ ] Update AGENTS.md hanya jika aturan kritis berubah