# Workspace Context

<!-- STRATEGY: UPDATE JARANG | Konteks global monorepo -->

> Workspace ini adalah **monorepo** (satu git root, banyak subproject).
> "Repository" = **subproject** (folder project), bukan git repo terpisah.
> Sesi hari ini: [Workspace-Session.md](./Workspace-Session.md)
> Standar: `AI-Agent-Standards/`

---

## Overview

| Field | Value |
|-------|-------|
| Workspace | {NAMA_WORKSPACE} |
| Tipe | Monorepo |
| Root Git | `{path-root}` |
| Remote | `{url}` |
| Owner | {nama/team} |
| Last updated | {YYYY-MM-DD} |

---

## Urutan baca AI (hemat token)

```
1. Workspace-Session.md          <- Active focus dulu
2. {project}/AGENTS.md           <- cold start (~200-400 token)
3. {project}/docs/ai-session-summary.md  <- TL;DR + Lanjut + Jangan
4. STOP - mulai kerja
5. On-demand: todo, issues, api, guide, server.md, context-index, adr
```

**Target cold start: < 2000 token.**

**Jangan baca di cold start:** changelog penuh, version history, WORKLOG, development-log, seluruh context-index.

**Rolling session memory per project = hanya** `docs/ai-session-summary.md`.

---

## Read budget

| Tujuan | Baca maksimal |
|--------|----------------|
| Lanjut task yang sama | AGENTS + ai-session-summary |
| Ambil task baru | + todo.md (High) |
| Debug | + issues.md (ID terkait) |
| Ubah API | + docs/api/ |
| Ikuti prosedur / flow | + docs/guide/ |
| Deploy / debug koneksi / infra | + docs/server.md |
| Arsitektur | + docs/adr/ |
| Navigasi domain | + context-index.md (Zona B) |

---

## Project Index

| Project | Path | Deskripsi | Cold start | Context |
|---------|------|-----------|------------|---------|
| {name} | `{path/}` | | [`AGENTS.md`]({path}/AGENTS.md) | [`docs/context-index.md`]({path}/docs/context-index.md) |

### Shared resources (bukan project)

| Folder | Fungsi |
|--------|--------|
| | |

---

## Dependency antar project

| From | To | Tipe | Catatan |
|------|-----|------|---------|
| | | | |

---

## Single owner (anti-duplikasi)

| Informasi | Owner |
|-----------|-------|
| Cold start / aturan kritis | `{project}/AGENTS.md` |
| Narasi sesi (rolling) | `{project}/docs/ai-session-summary.md` |
| Priority / TODO | `{project}/docs/todo.md` |
| Bug / RCA | `{project}/docs/issues.md` |
| Changelog | `{project}/docs/changelog.md` |
| Poin versi | `{project}/docs/version.md` |
| API | `{project}/docs/api/` |
| Flow / step-by-step | `{project}/docs/guide/` |
| Server / IP / runtime / DB | `{project}/docs/server.md` |
| System requirements | `{project}/docs/system-requirements.md` |
| URL/env template | `{project}/.env.example` |
| Migrasi server/domain | `{project}/docs/guide/migration.md` |
| Peta domain (on-demand) | `{project}/docs/context-index.md` |
| Lintas project sesi | `Workspace-Session.md` |
| Peta monorepo stabil | `Workspace-Context.md` |

Arsip (bukan jalur wajib): WORKLOG, development-log.

---

## Tier handover

### Tier 1 - Minimal

1. OVERWRITE `docs/ai-session-summary.md` (max 80 baris; TL;DR + Lanjut + Jangan)
2. UPDATE `docs/todo.md`
3. APPEND `docs/changelog.md` + `docs/version.md`
4. UPDATE `AGENTS.md` hanya jika aturan kritis berubah

### Tier 2 - Jika relevan

issues, adr, guide, server.md, system-requirements.md, .env.example, guide/migration.md, project-status, context-index, api/

### Tier 3 - Monorepo

OVERWRITE `Workspace-Session.md` (wajib **Active focus**)

---

## Environment global

| Env | Catatan |
|-----|---------|
| dev | |

Credential: {vault/path} - jangan simpan secret.

---

## Server Index (lintas project)

> Indeks saja. Detail per project: `{project}/docs/server.md`.
> Inventori host bersama juga boleh di `SSH-HOSTS.md` — tetap link ke server.md project terkait.

| Host / IP | Project monorepo | Role | Runtime ringkas | Detail |
|-----------|------------------|------|-----------------|--------|
| {10.x.x.x} | `{path}` | app/db/proxy | Docker, nginx, SQL Server, ... | [server.md]({path}/docs/server.md) |

Satu host boleh muncul di beberapa project jika di-share; detail role per project tetap di `docs/server.md` masing-masing.

---

## Standar dan perintah

Standar: `AI-Agent-Standards/`

| Perintah | Aksi |
|----------|------|
| `/handover` | Full tiered preservation |
| `/session-summary` | Overwrite ai-session-summary.md |
| `/workspace-summary` | Overwrite Workspace-Session.md |

Pengetahuan penting, arsitektur, flow, **dan inventori server (IP + runtime)** yang disepakati **tidak boleh** hanya di chat AI.