# AGENTS.md - Aturan Proyek <NAMA_PROYEK>

> v1 · <TANGGAL_HARI_INI> · ikut standar tim IT (Pola B)

<!-- Header di atas auto-isi oleh setup-pola-b.ps1 (nama proyek dari folder root, tanggal dari sistem). Kalau setup manual, isi sendiri. -->

---

## Pengantar

Proyek ini ikut **standar kerja tim IT** (kit terpasang di `./.claude-kit/`).
Aturan utama (cara coding, dokumentasi, larangan) ada di **`./.claude-kit/CLAUDE_universal_v1.md`**, dan dimuat **OTOMATIS** lewat `CLAUDE.md` di root proyek (yang `@import` file aturan itu + file `AGENTS.md` ini). Claude Code meng-auto-load `CLAUDE.md`, jadi aturan benar-benar masuk konteks tiap sesi — bukan sekadar "ditunjuk" lewat tulisan.
File `AGENTS.md` ini cuma berisi **override khusus proyek** + instruksi resolusi path; ikut di-`@import` oleh `CLAUDE.md`.

---

## Path resolution (PENTING - instruksi untuk AI)

Kit ini di-embed di subfolder `./.claude-kit/` (bukan di `%USERPROFILE%\.claude\`).
Saat baca/merujuk file kit, **kamu (AI) wajib mengganti** path lama jadi path lokal:

- `%USERPROFILE%\.claude\<NAMA_FILE>` → `./.claude-kit/<NAMA_FILE>`
- `~/.claude/<NAMA_FILE>` → `./.claude-kit/<NAMA_FILE>`

Kalau install global **dan** `./.claude-kit/` sama-sama ada → **`./.claude-kit/` menang** (version-locked per proyek).

---

## Versi kit aktif

- Versi kit di `./.claude-kit/`: **<VERSI_KIT>** <!-- ISI manual setelah cek `./.claude-kit/CHANGELOG.md`. Tulis literal (tanpa kurung siku). -->
- Sumber kit (repo standar tim): **<URL_REPO_STANDAR>** <!-- ISI: URL repo git tempat kit dirilis. -->

---

## Override khusus proyek

Centang `[x]` cuma yang **beda dari default kit**. Yang tidak dicentang = ikut default.
Contoh: `- [x] Bahasa docs: EN (override dari default ID karena klien minta)`.

- [ ] Bahasa docs: <!-- default ID -->
- [ ] Format commit: <!-- default Conventional Commits -->
- [ ] Folder `docs/`: <!-- default ikut `./.claude-kit/templates/architecture.md` -->
- [ ] Tech stack: <!-- default React/Next.js + Tailwind + shadcn -->
- [ ] Branch utama: <!-- default `main` -->
- [ ] Pakai GitHub Issue: <!-- default Tidak - pakai chat. Ubah ke `Ya` kalau ada klien eksternal yang tracking via Issue. -->
- [ ] Channel chat task: <!-- link Slack/Discord/Telegram/WhatsApp tempat staff posting task -->
- [ ] Lain-lain:

---

## Workflow & Komunikasi Task

Tim ini pakai workflow chat-driven (tanpa GitHub Issue by default). Detail di `./.claude-kit/templates/CLAUDE_TEAM_GUIDE.md` section 5b.

- **Channel chat task**: <!-- ISI: link Slack/Discord/Telegram/WhatsApp -->
- **Pakai GitHub Issue?** Tidak (default tim). Ubah ke "Ya" kalau proyek punya klien eksternal yang tracking via Issue.
- **Format prompt task**: lihat `./.claude-kit/templates/PROMPT_LIBRARY.md` section "Prompts untuk Workflow Chat-Driven Task".
- **Risk Level decision tree**: lihat `./.claude-kit/templates/CLAUDE_TEAM_GUIDE.md` section 7b (Low/Medium/High klasifikasi task).
- **Rollback playbook**: lihat `./.claude-kit/templates/CLAUDE_TEAM_GUIDE.md` section 13b (git revert <5 menit).
- **Feature flag** = advanced/post-launch (kit early-stage default = staging-only). Lihat `./.claude-kit/templates/feature-flags-advanced.md` kalau butuh.

---

## Skenario adopsi (AI WAJIB tanya popup di sesi pertama setelah setup)

> **AI: kalau section ini masih punya 4 opsi semua ([1]-[4]), berarti user belum pilih scenario. WAJIB tampilkan POPUP KLIK ke user (Tipe A — pakai `AskUserQuestion` kalau tersedia, fallback blok teks; ikut RULE-8 §14.1) di sesi sekarang per `./.claude-kit/POST_SETUP_CHECKLIST_PROMPT_v1.md` Popup #3. Opsi rekomendasi (posisi [1]) = "Proyek baru / from scratch". JANGAN auto-pick — tunggu user pilih. Setelah user pilih, HAPUS 3 opsi sisanya + execute Stage yang sesuai.**

- **[1] Proyek baru / from scratch (rekomendasi)** — pilihan paling umum untuk proyek yang baru dimulai dari nol; AI memandu dari awal lewat Kickoff → `./.claude-kit/PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage 1 (Proyek Baru): Kickoff)
- **[2] Proyek lama tanpa docs** → `./.claude-kit/PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage 2 (Bikin Catatan Proyek): Bootstrap Docs)
- **[3] Proyek setengah jadi (sudah ada sebagian docs)** → `./.claude-kit/PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage 4 (Rapikan ke Standar Tim): Migration)
- **[4] Sudah siap kerja task biasa (tidak butuh kickoff/migrasi)** → langsung pakai

Sesi pertama tim member baru: AI auto-trigger `./.claude-kit/POST_SETUP_CHECKLIST_PROMPT_v1.md` (Phase 5b — beberapa popup pilihan: cara pasang, ukuran tim, audit, pecah-repo bila relevan + tawaran Audit + daftar tugas-menunggu).

---

## Catatan tim

<!-- Kosongkan section ini kalau proyek solo. -->

- Owner standar tim: <!-- nama + email/handle PIC kit -->
- Channel diskusi: <!-- link Slack/Discord/Telegram -->

---

## Riwayat update kit di proyek ini

| Versi kit | Tanggal update     | Siapa update | Catatan              |
|-----------|--------------------|--------------|----------------------|
| <VERSI_KIT> | <TANGGAL_HARI_INI> | <NAMA_KAMU>  | Setup awal Pola B    |

<!-- Tambah baris baru tiap update isi `./.claude-kit/` ke versi lebih baru. -->