LDAPWeb/AI-Agent-Standards/prompts/bootstrap-new-project.md

Prompt: Bootstrap Project Docs dari AI-Agent-Standards

Cara pakai: Salin seluruh isi file ini ke chat agent, lalu isi blok INPUT di bawah (atau sebutkan path/nama project di pesan Anda). Alias: /bootstrap-docs Tujuan: Agent membaca template di AI-Agent-Standards/ lalu membuat struktur dokumentasi standar untuk satu atau lebih subproject baru di monorepo.

---

INPUT (isi sebelum / saat menjalankan)

Salin dan lengkapi:

projects:
  - path: {path/relatif/dari/root monorepo}   # contoh: lagercloud.com/my-service
    name: {Nama Project}
    description: {1-2 kalimat}
    stack: {tech stack singkat}
    type: app | api | library | infra | docs-only
    has_api: true | false          # true => buat docs/api/
    has_guide: true | false        # true => buat docs/guide/
    version: 0.1.0
    servers:                       # opsional; wajib diisi jika sudah diketahui
      - host: "{IP atau hostname}"
        env: dev|staging|prod
        role: app|db|reverse-proxy|worker
        apps:                       # docker, nginx, IIS, Apache, SQL Server, PostgreSQL, ...
          - name: "{service}"
            kind: Docker|nginx|IIS|Apache|SQL Server|PostgreSQL|other
            port: "{port}"
            path_or_container: "{compose service / site / instance}"
    critical_rules:               # 3-7 bullet
      - "{aturan kritis 1}"
      - "{aturan kritis 2}"
    initial_todos:                # opsional
      - priority: High
        item: "{task}"

Jika user hanya memberi daftar path tanpa YAML, tanyakan field yang kurang sekali, lalu lanjut. Jangan tanya berulang.

Asumsi default jika tidak disebut:

• type: app
• has_api: false (kecuali type = api atau nama/deskripsi menyebut API)
• has_guide: false
• version: 0.1.0
• critical_rules: minimal "No commit kecuali user minta", "No hardcoded URL/domain/IP — pakai .env.example", "Jangan commit .env", "Pengetahuan penting wajib ke docs bukan hanya chat"

---

Objective

Untuk setiap project di INPUT:

1. Baca template dari AI-Agent-Standards/templates/repo/
2. Buat struktur file sesuai standar
3. Isi field wajib (bukan meninggalkan semua placeholder {...})
4. Daftarkan project di Workspace-Context.md (root monorepo)
5. Laporkan hasil ke user

Jangan commit/push kecuali user meminta. Jangan menimpa file yang sudah ada tanpa konfirmasi (kecuali user bilang "overwrite").

---

Sumber template (WAJIB dibaca dulu)

Baca file berikut sebelum menulis (cukup file ini + template yang akan di-copy):

File	Kegunaan
AI-Agent-Standards/README.md	Ringkasan standar
AI-Agent-Standards/templates/repo/AGENTS.md	Cold start (ke ROOT project)
AI-Agent-Standards/templates/repo/ai-session-summary.md	Rolling session memory
AI-Agent-Standards/templates/repo/context-index.md	Peta domain
AI-Agent-Standards/templates/repo/todo.md	Priority
AI-Agent-Standards/templates/repo/changelog.md	Keep a Changelog
AI-Agent-Standards/templates/repo/version.md	Poin versi
AI-Agent-Standards/templates/repo/issues.md	Issues
AI-Agent-Standards/templates/repo/project-status.md	Status
AI-Agent-Standards/templates/repo/adr-template.md	ADR template
AI-Agent-Standards/templates/repo/api/README.md	Hanya jika has_api
AI-Agent-Standards/templates/repo/guide/README.md	Hanya jika has_guide
AI-Agent-Standards/templates/repo/server.md	Inventori server (selalu dibuat)
templates/repo/system-requirements.md	System requirements (selalu dibuat)
templates/repo/.env.example	Template URL/env (selalu dibuat)
templates/repo/guide/migration.md	Migrasi server/domain (selalu dibuat)
Workspace-Context.md	Daftarkan project + indeks server

Encoding: tulis file sebagai UTF-8 (tanpa UTF-16).

---

Struktur yang harus dibuat (per project)

{path}/
├── AGENTS.md                          # cold start
├── .env.example                       # template URL/env (WAJIB, commit OK)
└── docs/
    ├── ai-session-summary.md
    ├── context-index.md
    ├── project-status.md
    ├── todo.md
    ├── changelog.md
    ├── version.md
    ├── issues.md
    ├── adr/
    │   └── 000-template.md            # dari adr-template.md
    ├── server.md                       # WAJIB - inventori host/IP/runtime/DB
    ├── system-requirements.md          # WAJIB - OS, runtime, tool minimum
    ├── api/                           # HANYA jika has_api: true
    │   └── README.md
    └── guide/                         # WAJIB (minimal migration.md)
        ├── README.md
        └── migration.md                 # migrasi server/domain

Mapping copy

Sumber (AI-Agent-Standards/templates/repo/)	Tujuan
AGENTS.md	{path}/AGENTS.md
ai-session-summary.md	{path}/docs/ai-session-summary.md
context-index.md	{path}/docs/context-index.md
project-status.md	{path}/docs/project-status.md
todo.md	{path}/docs/todo.md
changelog.md	{path}/docs/changelog.md
version.md	{path}/docs/version.md
issues.md	{path}/docs/issues.md
server.md	{path}/docs/server.md
system-requirements.md	{path}/docs/system-requirements.md
.env.example	{path}/.env.example
guide/migration.md	{path}/docs/guide/migration.md
adr-template.md	{path}/docs/adr/000-template.md
api/README.md	{path}/docs/api/README.md (jika has_api)
guide/README.md	{path}/docs/guide/README.md

---

Isi wajib (ganti placeholder)

1. {path}/AGENTS.md (max ~40 baris)

• Project path monorepo
• Apa ini? = description
• Aturan kritis = critical_rules (+ default jika kurang dari 3)
• Sertakan aturan no hardcoded URL + link .env.example, docs/system-requirements.md, docs/guide/migration.md
• Pertahankan urutan baca stop-early dari template

2. {path}/docs/context-index.md

Zona A wajib diisi:

• Nama, path, deskripsi/stack, tipe, versi, link AGENTS + session + todo
• Last updated = tanggal hari ini

Zona B: biarkan tabel kosong atau minimal; hapus baris api/guide jika has_api/has_guide false.

3. {path}/docs/ai-session-summary.md (max 80 baris)

Isi sesi init:

session: {YYYY-MM-DD}-init
project: {path}
version: {version}
status: ready
next: {item High pertama dari initial_todos, atau "Isi todo dan mulai implementasi"}
agent: {nama agent jika diketahui, else Unknown}
branch: main

TL;DR:

• Bootstrap dokumentasi standar AI-Agent-Standards
• Project {name} siap dilanjutkan agent berikutnya

Lanjut dari sini:

1. {dari initial_todos High, atau "Lengkapi spesifikasi / implementasi"}

Jangan:

• Jangan simpan pengetahuan penting hanya di chat
• Jangan commit secret

Hapus blok Detail jika tidak perlu.

4. {path}/docs/version.md

Entri pertama:

## [{version}] - {YYYY-MM-DD}

- Bootstrap dokumentasi standar (AGENTS.md + docs/)
- Inisialisasi project `{name}`

5. {path}/docs/changelog.md

Di [Unreleased] atau langsung versi:

## [{version}] - {YYYY-MM-DD}

### Added
- Struktur dokumentasi standar AI-Agent-Standards

6. {path}/docs/todo.md

• Masukkan initial_todos ke High/Medium/Low
• Seksi "Selesai (Sesi Ini)": bootstrap docs

7. {path}/docs/project-status.md

• Ringkasan = description
• Progress: Documentation = Done; implementasi sesuai status awal
• Next priority link ke todo.md

8. {path}/docs/issues.md

Biarkan struktur template (belum ada issue), ganti placeholder generik seminimal mungkin.

9. {path}/docs/server.md (WAJIB)

Salin dari templates/repo/server.md, lalu:

• Isi Project path dan Last updated
• Jika INPUT punya servers:: isi tabel Host/Server, Aplikasi & Runtime, Database, Endpoint
• Isi Mapping ke path project dengan path monorepo project ini
• Jika server belum diketahui: biarkan tabel dengan satu baris placeholder dan catatan TODO: isi saat infra diketahui — jangan hapus file
• Credential location saja, jangan password/secret

10. {path}/docs/system-requirements.md (WAJIB)

• Isi tipe project, stack dari INPUT
• Tabel runtime/tool (JDK, Docker, Android Studio, SQL, dll.) — placeholder OK dengan TODO
• Seksi Variabel URL & konfigurasi — list variabel dari .env.example
• Cantumkan aturan no hardcode

11. {path}/.env.example (WAJIB, root project)

• Salin dari templates/repo/.env.example
• Sesuaikan nama variabel project (API_BASE_URL, dll.)
• Nilai = placeholder dev, bukan production secret
• Tambah komentar variabel khusus project (Android: AGENT_API_BASE_URL, dll.)

12. {path}/docs/guide/migration.md (WAJIB)

• Salin template; isi tabel inventori jika server/domain sudah diketahui
• Jika belum: biarkan checklist + catatan TODO: isi saat migrasi pertama
• Pastikan guide/README.md mengindeks migration.md

---

Update Workspace-Context.md (root monorepo)

Untuk setiap project baru, tambah baris di tabel Project Aktif:

Repository	Path	Deskripsi	Status	Cold start	Context
{name}	{path}/	{description}	New	AGENTS.md	docs/context-index.md

Tambah baris Quick Navigation:

| Mulai kerja {name} | {path}/AGENTS.md -> docs/ai-session-summary.md |

Jangan hapus project yang sudah ada.

Jika ada seksi Server Index di Workspace-Context.md, tambah baris per host yang diketahui:

Host / IP	Project	Role	Runtime ringkas	Detail
{ip}	{path}	{role}	{docker/nginx/SQL/...}	server.md

Jika seksi belum ada, buat seksi ## Server Index (lintas project) dengan tabel di atas (hanya indeks + link, detail di docs/server.md).

Jangan overwrite Workspace-Session.md kecuali user minta (boleh sebut di laporan bahwa sesi berikutnya bisa menambahkan Active focus).

---

Aturan keamanan & kualitas

• Encoding UTF-8
• Tidak menulis secret/credential
• Tidak menghapus project/docs existing tanpa izin
• Jika {path} sudah punya AGENTS.md atau docs/: stop dan tanya overwrite / merge / skip
• Ikuti single owner: jangan menduplikasi backlog ke session summary
• Pengetahuan penting tidak boleh hanya di chat (sudah masuk docs lewat bootstrap ini)

---

Urutan eksekusi

1. Parse INPUT (semua project)
2. Baca template AI-Agent-Standards
3. Untuk tiap project:
   a. Cek path belum ada konflik
   b. Buat folder
   c. Copy + isi file wajib
4. Update Workspace-Context.md
5. Final report

---

Final Report (wajib ke user)

Untuk setiap project:

• Path dibuat
• File dibuat (daftar)
• has_api / has_guide
• server.md, system-requirements.md, .env.example, guide/migration.md
• Version awal
• Link cold start: {path}/AGENTS.md

Workspace:

• Baris yang ditambahkan ke Workspace-Context.md

Langkah user berikutnya:

Buka {path}/AGENTS.md lalu docs/ai-session-summary.md untuk lanjut kerja.
Akhir sesi: ikuti AI-Agent-Standards/prompts/end-of-session-handover.md

---

Contoh pemanggilan singkat (user)

Ikuti AI-Agent-Standards/prompts/bootstrap-new-project.md

projects:
  - path: lagercloud.com/billing
    name: Billing
    description: Service tagihan Training Center
    stack: Python FastAPI
    type: api
    has_api: true
    has_guide: false
  - path: lagercloud.com/notify
    name: Notify
    description: Notifikasi WA/email
    stack: Python
    type: app
    has_api: true
    has_guide: true
  - path: tools/report-cli
    name: Report CLI
    description: CLI laporan internal
    stack: Node.js
    type: app

Agent wajib membuat ketiga project sesuai template tanpa menunggu instruksi tambahan selain field yang benar-benar hilang.