LDAPWeb/AI-Agent-Standards/templates/workspace/Workspace-Context.md

Workspace Context

Workspace ini adalah monorepo (satu git root, banyak subproject). "Repository" = subproject (folder project), bukan git repo terpisah. Sesi hari ini: 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	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

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.