Prompt AI Agent - End of Session Project Knowledge Preservation

Trigger: akhir sesi / sebelum commit-push. Alias: /handover Workspace: monorepo (satu git root, banyak subproject)

Objective

Pindahkan pengetahuan sesi ke docs agar agent berikutnya lanjut dengan token minimal (< 2000 token cold start).

Chat bukan penyimpanan pengetahuan. Catatan penting, arsitektur, flow, keputusan teknis wajib masuk docs (owner yang benar).

Scope

Identifikasi subproject yang berubah. Project tanpa perubahan: skip.

Tier Handover

Tier 1 - Minimal (WAJIB jika ada perubahan kode/config)

OVERWRITE docs/ai-session-summary.md
- Max 80 baris / ~1500 token
- Wajib: yaml + TL;DR + Lanjut dari sini + Jangan
- Detail opsional (omit-if-N/A)
- Satu-satunya rolling session memory - jangan andalkan WORKLOG/development-log
UPDATE docs/todo.md
- Seksi "Selesai (Sesi Ini)" di-overwrite (bukan menumpuk)
APPEND docs/changelog.md (Keep a Changelog saja)
APPEND docs/version.md (poin-poin versi) — wajib jika deploy / naik versi / install ke device atau server; format bullet seperti entri semver yang ada; jangan overwrite entri lama
UPDATE AGENTS.md (root project) hanya jika aturan kritis / pointer berubah

Tier 2 - Jika relevan

Kondisi	Aksi
Bug / limitation	`docs/issues.md`
Keputusan arsitektur / flow sistem	`docs/adr/`
Flow / prosedur step-by-step	`docs/guide/`
Host/IP, runtime (Docker/nginx/IIS/Apache), DB, port berubah	`docs/server.md`
System requirement (OS, JDK, Docker, DB versi) berubah	`docs/system-requirements.md`
Migrasi server/domain / cutover URL	`docs/guide/migration.md` + `.env.example`
Variabel env/URL baru	`.env.example` (root project); kode baca env — no hardcode
Progress area	`docs/project-status.md`
Dokumen/struktur baru	`docs/context-index.md`
API berubah	`docs/api/`

Tier 3 - Monorepo

OVERWRITE Workspace-Session.md:

Seksi Active focus di atas (1-3 baris per project)
Tabel project + link session summary + version
Cross-project impact
Jangan duplikasi isi session summary

Single Owner

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

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

Read budget (untuk AI berikutnya)

Tujuan	Baca maksimal
Lanjut task yang sama	`AGENTS.md` + `ai-session-summary` (TL;DR/Lanjut/Jangan)
Ambil task baru	+ `todo.md` (High saja)
Debug	+ `issues.md` (ID terkait)
Ubah API	+ `docs/api/`
Ikuti prosedur	+ `docs/guide/`
Deploy / debug koneksi / infra	+ `docs/server.md`
Migrasi / ganti domain	+ `docs/guide/migration.md` + `.env.example`
Setup tool chain	+ `docs/system-requirements.md`
Keputusan arsitektur	+ `docs/adr/` terkait
Navigasi domain	+ `context-index.md` Zona B

Urutan cold start:

Workspace-Session.md (jika multi-project; baca Active focus dulu)
  -> {project}/AGENTS.md
  -> {project}/docs/ai-session-summary.md
  -> STOP - mulai kerja

Target: < 2000 token sebelum coding.

No hardcoded URL (wajib)

Semua URL, domain, base path, host:port di aplikasi harus dari environment atau config yang dibaca saat runtime/build (.env, env var, BuildConfig, gradle.properties).
Dilarang hardcode di source code kecuali unit test mock atau .env.example placeholder.
Saat migrasi domain/server: ubah .env / server config + update .env.example, server.md, guide/migration.md — bukan scatter edit URL di banyak file kode.
Android/Kotlin: base URL lewat BuildConfig/flavor, bukan string literal di Activity/Service.
Commit: .env.example boleh; .env dengan secret tidak.

Knowledge compression

Ringkas; omit-if-N/A; referensi jangan salin
Harus masuk docs: solusi bug, troubleshooting, config, deploy, keputusan teknis, arsitektur, flow, system requirements, inventori server, langkah migrasi server/domain, root cause, workaround, dependency, versi
Jangan: secret, log mentah, chat verbatim, info yang sudah di kode

Validation

Lihat templates/handover-checklist.md.

Minimal:

Tier 1 lengkap
Session summary punya TL;DR + Lanjut + Jangan, <= 80 baris
Tidak ada pengetahuan penting hanya di chat
Tidak ada secret di diff

Git

Commit Conventional Commits hanya jika user meminta. Push hanya jika diminta.

Final Report

Project, tier, file, version, TODO/issue/ADR baru, ringkasan, next steps.

5.2 KiB Raw Blame History