# AGENTS.md — Apotek Siaga

Instruksi singkat untuk agent AI (Cursor / Cloud). **Jangan mengarang aturan bisnis** di luar dokumentasi.

## Sumber kebenaran

1. Baca dulu [`docs/README.md`](docs/README.md).
2. Domain pricing / DPB / harga modal → [`docs/pricing-dpb-rules.md`](docs/pricing-dpb-rules.md).
3. Bug & keterbatasan → [`docs/known-issues.md`](docs/known-issues.md).
4. Backlog → [`docs/pending-work.md`](docs/pending-work.md).
5. Pola kode → [`docs/coding-standards.md`](docs/coding-standards.md).

Kode di branch **`main`** adalah kebenaran implementasi. Sync docs jika kode berubah.

## Git

- Kerja dari `main` terbaru: `git checkout main && git pull`.
- Branch: `feat/<modul>-<tujuan>` (satu tujuan sempit).
- Setelah PR merge: hapus branch lokal + remote.
- Jangan merge feature↔feature tanpa sync `main`.
- Conflict di `User` / form transaksi: jangan buang helper role atau `penjualan._form` (lihat known-issues §7b).

## Agent & modul

- **Cukup chat Agent baru** + baca `docs/` untuk improve modul berbeda.
- **Jangan** membuat agent khusus per modul kecuali domain pricing yang sudah punya kamus di `pricing-dpb-rules.md`.
- Knowledge permanen = file di `docs/` + file ini + `.cursor/rules/`, bukan history chat lama.

## Stack ringkas

Laravel 13 + Blade + Tailwind 4 + Alpine. Controller tipis → Service (`DB::transaction`) → Eloquent. UI & enum Bahasa Indonesia. Jangan over-engineer (tanpa Form Request / Policy / Job kecuali diminta).