| 1 | # Konfigurasi Codewhale |
| 2 | |
| 3 | Codewhale membaca konfigurasi dari berkas TOML ditambah variabel lingkungan (environment variables). Saat startup proses, Codewhale juga dapat membaca kredensial penyedia dari berkas `.env` lokal di ruang kerja. Gunakan contoh templat `.env.example` yang tersedia; salin ke `.env`, lalu tambahkan hanya nilai kredensial. |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | ## Konstitusi, Instruksi Proyek, dan Wewenang Repositori |
| 8 | |
| 9 | Codewhale memiliki beberapa lapisan instruksi yang sengaja dipisahkan agar konstitusi pribadi, kebijakan repositori, instruksi proyek, dan kontrol keamanan runtime tidak saling bertabrakan: |
| 10 | |
| 11 | 1. **Konstitusi Global Bawaan (Bundled Constitution)**: |
| 12 | - Hukum dasar yang terkompilasi di dalam biner. Menjadi batas dasar bawaan untuk setiap sesi. |
| 13 | |
| 14 | 2. **Konstitusi Global Pengguna (User-Global Constitution)**: |
| 15 | - Dikelola melalui perintah `/constitution` atau `/setup`. Ditinggalkan dalam format terstruktur pada `$CODEWHALE_HOME/constitution.json` (bawaan `~/.codewhale/constitution.json`). |
| 16 | |
| 17 | 3. **Konstitusi Lokal Repositori (Repo-Local Constitution)**: |
| 18 | - Kebijakan proyek opsional pada `.codewhale/constitution.json`. |
| 19 | |
| 20 | 4. **Instruksi Proyek (`AGENTS.md`)**: |
| 21 | - Berkas instruksi proyek lintas-agen. Berkas ini adalah dokumen kanonik untuk "bagaimana agen bekerja di repositori ini". Jalankan `/init` untuk membuatnya secara otomatis. `CLAUDE.md` dibaca sebagai fallback kompatibilitas. |
| 22 | |
| 23 | 5. **Memori dan Serah Terima (Memory & Handoffs)**: |
| 24 | - Riwayat dan konteks yang dipanggil kembali. Berfungsi membantu, namun memiliki tingkat wewenang lebih rendah dari konstitusi dan instruksi proyek. |
| 25 | |
| 26 | --- |
| 27 | |
| 28 | ## Lokasi Berkas Konfigurasi |
| 29 | |
| 30 | - Berkas Konfigurasi Utama: `~/.codewhale/config.toml` |
| 31 | - Berkas Konstitusi Pengguna: `~/.codewhale/constitution.json` |
| 32 | - Berkas Konfigurasi MCP: `~/.codewhale/mcp.json` |
| 33 | - Berkas Sesi: `~/.codewhale/sessions/` |
| 34 |