# AGENTS.md — Cold Start

> Project: `Mailcow/`
> Sesi terakhir: [docs/ai-session-summary.md](./docs/ai-session-summary.md)
> Peta lengkap: [docs/context-index.md](./docs/context-index.md)
> Env template: [.env.example](./.env.example)

## Apa ini?

Self-hosted mail server (Mailcow dockerized) untuk `geonet.co.id` + `gisportal.id`. Inbox canonical di `sync.geonet.co.id`; POP3 drain cPanel (geonet); `gisportal.id` langsung ke Mailcow tanpa cPanel.

## Aturan kritis

- **No hardcoded URL/domain/IP** — baca dari `.env` / `docs/environment.md`
- Copy `.env.example` → `.env` lokal; **jangan commit** `.env`
- No commit kecuali user minta eksplisit
- **Deploy / rilis:** append [docs/version.md](./docs/version.md) (poin perubahan) + [docs/changelog.md](./docs/changelog.md)
- `support@geonet.co.id` = **authsource ldap** (password AD); fetchmail POP3 tetap dari hosting
- SSH ke server **wajib persetujuan user** (`ssh mailcow` → `10.100.1.28`)
- Pengetahuan penting **wajib ke docs**, bukan hanya chat

## Lanjut kerja (urutan baca)

```
1. AGENTS.md                         <- Anda di sini
2. docs/ai-session-summary.md        <- TL;DR + Lanjut + Jangan
3. STOP - mulai kerja
4. On-demand:
   - docs/todo.md
   - docs/issues.md
   - docs/guide/outlook-imap-setup.md
   - docs/guide/migration.md
   - docs/system-requirements.md
   - docs/server.md
   - .env.example
   - docs/context-index.md
```

**Rolling session memory = hanya** `docs/ai-session-summary.md`.

## Pointer cepat

| Butuh | Buka |
|-------|------|
| Priority | [docs/todo.md](./docs/todo.md) |
| Versi / deploy | [docs/version.md](./docs/version.md) |
| Bug / RCA | [docs/issues.md](./docs/issues.md) |
| IMAP client (Outlook) | [docs/guide/outlook-imap-setup.md](./docs/guide/outlook-imap-setup.md) |
| Migrasi MX/domain | [docs/guide/migration.md](./docs/guide/migration.md) |
| Multi-domain gisportal.id | [docs/notes/gisportal-id-mail.md](./docs/notes/gisportal-id-mail.md) |
| Hybrid cPanel geonet | [docs/notes/hybrid-migration-cpanel-mailcow.md](./docs/notes/hybrid-migration-cpanel-mailcow.md) |
| System requirements | [docs/system-requirements.md](./docs/system-requirements.md) |
| Server / infra | [docs/server.md](./docs/server.md) |
| Env vars | [docs/environment.md](./docs/environment.md) |

## Multi-project

`Workspace-Context.md` → `AGENTS.md` → `docs/ai-session-summary.md`