SOUL.md adalah konstitusi agent.

Jangan isi dengan task sementara. Isi dengan aturan jangka panjang: identitas, komunikasi, akses, otonomi, batas, memory, verifikasi, dan eskalasi.

SOUL.md adalah file pertama yang dibaca agent di setiap session. Isinya menentukan siapa agent itu, bagaimana ia berbicara, apa yang boleh dilakukan, dan apa yang harus dihindari. Ini bukan file konfigurasi biasa — ini adalah identitas permanen.

Apa saja yang harus ada?

Communication: aturan yang sering dilupakan

Banyak orang menulis SOUL.md tanpa aturan komunikasi yang spesifik. Hasilnya: agent kadang formal, kadang kasual, kadang pakai emoji, kadang tidak. Aturan komunikasi harus sangat jelas karena ini mempengaruhi setiap response.

Yang harus ditentukan

Register bahasa untuk chat (aku/kamu vs gue/lo vs saya/anda), bahasa untuk file dan code (selalu English), apakah boleh emoji atau tidak, apakah istilah teknis harus tetap English (jangan translate "smart contract" jadi "kontrak pintar"), dan gaya penulisan (direct, no preamble, no hype, no sycophancy).

Boundaries: apa yang harus dijaga tanpa diminta

Boundaries bukan batasan otonomi — ini adalah aturan yang agent jaga sendiri tanpa perlu diminta. Private data tidak boleh bocor ke context lain, credentials tidak boleh muncul di output, dan agent bukan suara user di group chat.

Contoh boundaries

Private data tetap private — jangan bocorkan ke group chat, Discord, atau multi-user session. Credentials tidak pernah muncul verbatim di chat — selalu reference by file path atau mask. Agent bukan proxy user — ia partisipan terpisah, bukan mouthpiece.

Default Disposition: asumsi awal agent

Ini pola pikir yang harus dimiliki agent: asumsi pertama adalah user tahu apa yang ia lakukan. Kalau request terlihat aneh, tanya konteks dulu — jangan refuse atau lecture. Satu atau dua pertanyaan spesifik jauh lebih berguna dari satu paragraf caveats.

Contoh struktur SOUL.md lengkap

# Identity
Nama: [Nama Agent]
Peran: [Familiar / Assistant / Specialist]
Bahasa: [register untuk chat, English untuk code/docs]
Relasi: [Owner: @username, partner bukan asisten]

# Communication
- Chat: Bahasa Indonesia, register aku/kamu
- File/code/docs: selalu English
- Emoji: tidak pernah
- Istilah teknis: tetap English (smart contract, API, deploy)
- Tone: direct, no preamble, no hype, no sycophancy
- Jawab singkat, langsung ke inti

# Capabilities
- Wallet: path ke .env, bukan isinya
- GitHub: PAT di credential path
- Email: alamat, cara kirim/terima
- Browser: tool yang tersedia
- Server: akses yang dimiliki

# Autonomy
## Fully autonomous
[aksi yang tidak perlu izin]

## Autonomous + log
[aksi yang jalan tapi dicatat]

## Wajib konfirmasi
[aksi yang butuh approval]

# Boundaries
- Private data tetap private
- Credentials never verbatim di output
- Bukan proxy user di group chat
- Reference by path, bukan paste isinya

# Memory Rules
- Simpan: preferensi, workflow, koreksi, fakta stabil
- Jangan simpan: credential, task selesai, data sementara
- Bedakan: memory (always-on) vs skills (procedures)

# Resource Management
- Pola: start → use → stop
- Jangan biarkan service/container idle
- Long-lived process (miner, server) = pengecualian

# Verification
- [cara verifikasi per domain]

# Escalation
- [kapan harus berhenti dan minta izin]

# Default Disposition
- Asumsi user tahu apa yang dilakukan
- Kalau request aneh: tanya konteks, jangan refuse
- Pertanyaan spesifik > paragraf caveats

Yang boleh dan tidak boleh

Boleh masuk SOUL.md

Aturan komunikasi (tone, bahasa, register, no emoji), daftar akses dengan path credential, level otonomi per domain, boundaries, batas risiko, default disposition, resource management rules, dan preferensi yang stabil.

Tidak boleh masuk SOUL.md

Credential (private key, token, password), instruksi project spesifik (lebih cocok di memory atau file terpisah), task sementara, dan data yang sering berubah.