LDAPWeb/AI-Agent-Standards/recommendations.md

Rekomendasi Standar Dokumentasi AI

Status: diadopsi ke template (termasuk optimasi token 2026-07-04).

---

Diadopsi

1. Session ID + yaml metadata di session summary
2. STRATEGY badge
3. Tier handover (Minimal / Relevan / Monorepo)
4. Single owner
5. Keep a Changelog saja
6. omit-if-N/A
7. todo "Selesai sesi ini" overwrite
8. context-index boleh tebal, berlapis (Zona A / Zona B)
9. Monorepo model
10. docs/api/ dan docs/guide/
11. docs/version.md — wajib append setiap deploy / naik versi (poin-poin perubahan)
12. Pengetahuan penting tidak boleh hanya di chat
13. AGENTS.md cold start (root project, max ~40 baris)
14. Session summary: TL;DR + Lanjut + Jangan; max 80 baris
15. Satu rolling memory: hanya ai-session-summary; WORKLOG/development-log = arsip
16. Read budget + urutan stop-early (< 2000 token)
17. Workspace-Session Active focus
18. docs/server.md - inventori host/IP, runtime, port
19. docs/system-requirements.md - OS, runtime, tool minimum
20. .env.example - template URL/env (dynamic, no hardcode)
21. docs/guide/migration.md - migrasi server/domain + checklist cutover

---

Opsional (belum diwajibkan)

• docs/.handover-meta.json untuk CI
• Pre-commit hook otomatis: kode berubah => session summary + version harus berubah
• Wiring slash commands per agent tool

---

Estimasi token cold start

Skenario	File	Estimasi
Lanjut task (satu project)	AGENTS + session (TL;DR)	~700-2000
Multi-project	Workspace-Session Active focus + AGENTS + session	~1000-2500
Ambil task baru	+ todo High	+200-500
Debug	+ issues ID	+300-800

Target: < 2000 token sebelum coding pada jalur panas.