LDAPWeb/AI-Agent-Standards/templates/repo/context-index.md

Context Index

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
Sesi terakhir	ai-session-summary.md
Priority aktif	todo.md
Server / infra	server.md
System requirements	system-requirements.md
Env / URL template	../.env.example
Versi	{x.y.z} - 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. 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	Narasi sesi (overwrite)	Setelah AGENTS
todo.md	Priority aktif	Ambil / ubah task
project-status.md	Progress area	Butuh status luas
issues.md	Bug / RCA	Debug
changelog.md	Keep a Changelog	Audit riwayat
version.md	Poin per versi	Cek versi / rilis
server.md	Host/IP, runtime, DB, port	Deploy / debug koneksi / ubah infra
system-requirements.md	OS, runtime, tool minimum	Setup / upgrade / migrasi
guide/migration.md	Migrasi server/domain	Cutover URL/env
../.env.example	Variabel URL/host (template)	Konfigurasi dynamic URL
adr/	Keputusan arsitektur	Ubah arsitektur

API dan guide (jika berlaku)

Kondisi	Path	Kapan baca
Project API / framework API	api/	Ubah / konsumsi endpoint
Prosedur step-by-step	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 (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