FAQ

Pertanyaan umum, dalam urutan frekuensi.

Apa itu apothem?Copy Anchor Link

Apothem adalah pengelola konfigurasi agnostik-host untuk harness asisten-pengkodean. Anda menulis satu profil bersama, dan Apothem mematerialisasikannya ke permukaan konfigurasi native setiap peralatan — memadukan aturan perilaku, standar kreatif, perintah garis-miring, pekerja terdelegasi yang persisten, hook, dan skill menjadi satu korpus yang diatur dan tetap konsisten di setiap harness.

Harness asisten mana saja yang didukungnya?Copy Anchor Link

Apothem bersifat agnostik-harness. Adaptor per-harness di bawah src/apothem/harnesses/<harness>/ memproyeksikan profil bersama ke dalam direktori konfigurasi native setiap peralatan. Registri harness yang digunakan saat runtime adalah sumber otoritatif untuk kumpulan yang didukung; halaman harness mendokumentasikan setiap harness. Registri tersebut saat ini mencakup harness yang didukung berikut:

Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, Zed,
GLM (Z.ai), and Kimi Code

Adapter Claude Code mematerialisasikan ke dalam ~/.claude/; dispatcher hook-nya bersifat netral-host — ia me-resolve akar ekosistem dari $CLAUDE_PROJECT_DIR terlebih dahulu, lalu $LLM_PROJECT_DIR, kemudian mencoba pencarian relatif-skrip dan direktori kerja, dan akhirnya kembali ke $HOME/.claude.

Apakah saya perlu menggunakan pipeline suite rencana?Copy Anchor Link

Tidak. Pipeline suite rencana adalah salah satu komponen ekosistem. Aturan perilaku, standar kreatif, hook, dan rangkaian peralatan validator berguna secara independen.

Bagaimana saya mengustomisasi aturan tanpa mem-fork repositori?Copy Anchor Link

Tambahkan sebuah string ke daftar rules: di ~/.config/apothem/profile.yaml lalu jalankan ulang pemasangan atau pembaruan. Berkas aturan di bawah src/apothem/rules/ mengedit pohon sumber yang dipaketkan; pemasang arsip menggantinya ketika dijalankan dengan --yes.

Bagaimana saya menonaktifkan aturan untuk sementara?Copy Anchor Link

Bisa dengan mengganti nama berkas keluar dari pola src/apothem/rules/*.md atau memindahkannya ke direktori saudara yang tidak dipindai pemuat.

Apa perbedaan antara aturan, skill, dan pekerja terdelegasi?Copy Anchor Link

• Aturan mengatur perilaku — kewajiban selalu-aktif atau terfilter-jalur yang diikuti asisten.
• Skill adalah teknik yang dapat dideteksi dan digunakan kembali — sebuah sinyal deteksi, sebuah prosedur, dan sebuah hook penegakan.
• Pekerja terdelegasi adalah peran persisten dengan pembatasan peralatan dan prompt sistemnya sendiri, dikirim melalui protokol orkestrasi-pekerja.

Bagaimana saya melaporkan masalah keamanan?Copy Anchor Link

Lihat SECURITY.md. Kanal yang didukung adalah GitHub Security Advisories dan [email protected].

Bagaimana saya berkontribusi?Copy Anchor Link

Lihat Kontribusi. Versi singkatnya: baca CONTRIBUTING.md, fork repositori, buka PR dengan templat PR kanonis terisi, dan pastikan pemeriksaan CI lolos — panduan pengembang mencantumkan gerbang yang harus dilalui sebuah PR.

Di mana state ekosistem berada?Copy Anchor Link

• State rencana per-suite berada di bawah <project>/.apothem/plans/{suite}/.
• Memori Apothem berada di bawah .apothem/memory/ di dalam akar pemasangan (untuk Claude Code: ~/.claude/.apothem/memory/; ~/.apothem/memory/ ketika workspace.scope bernilai user-home; <project>/.apothem/memory/ untuk pemasangan berlingkup-proyek). Memori otomatis milik Claude Code sendiri berada di bawah akar konfigurasi harness, pada projects/{hash}/memory/ (untuk Claude Code: ~/.claude/projects/{hash}/memory/).
• Memori lintas-proyek berada di bawah akar konfigurasi harness yang sama, pada .apothem/memory/ (untuk Claude Code: ~/.claude/.apothem/memory/).
• Scratch per-sesi berada di bawah <project>/.apothem/plans/{suite}/_inputs/.

Bisakah saya melanjutkan pekerjaan jangka panjang di sesi baru atau di mesin lain?Copy Anchor Link

Bisa. Pekerjaan jangka panjang mengeksternalisasi seluruh state-nya ke sebuah suite .apothem/plans/ lokal-proyek — sebuah kontrak pelanjutan plus sebuah protokol mulai-dingin — sehingga pekerjaan itu tidak berada di dalam satu riwayat obrolan. Karena state-nya ada di berkas-berkas proyek Anda, sesi baru pada akun atau mesin mana pun yang diarahkan ke proyek yang sama melanjutkan pekerjaan di tempat. Apothem tidak mendorong berkas-berkas itu antar-akun sendiri; mereka berpindah dengan cara berkas proyek Anda sudah berpindah (kontrol versi, sebuah checkout bersama, sebuah direktori tersinkronisasi). Lihat Perencanaan yang dapat dilanjutkan.

Apakah Apothem memerlukan pip?Copy Anchor Link

Tidak — tidak untuk engine itu sendiri. Engine adalah pohon sumber mandiri dengan dependensi yang divendor — ia berjalan sebagai python -m apothem dari checkout mana pun, cache npx, atau pohon plugin pada Python sistem 3.10+, dan tidak menginstal kode miliknya sendiri ke dalam site-packages (click dan rich adalah satu-satunya prasyarat interpreter). Satu-satunya pengecualian opsional: jika click atau rich tidak ada, installer menawarkan untuk menjalankan pip install hanya untuk keduanya bagi Anda — dengan konfirmasi Anda, atau --yes / APOTHEM_AUTO_INSTALL_DEPS=1. Paket milik Apothem sendiri tidak pernah diinstal ke dalam site-packages.

Bagaimana hook berjalan tanpa paket yang terinstal?Copy Anchor Link

apothem install memateri dispatcher hook dan gerbang konformitas di bawah akar harness (untuk Claude Code: ~/.claude/.apothem/support/hooks/ dan ~/.claude/.apothem/support/conformity/), dan entri hook yang dirender memanggil skrip-skrip tersebut melalui jalur absolut. Keduanya adalah skrip stdlib mandiri, sehingga hook bekerja pada mesin yang belum pernah melihat pip install.

Bagaimana saya mencopot sepenuhnya?Copy Anchor Link

Jalankan apothem uninstall --harness <name> untuk setiap harness terpasang, hapus engine sesuai kanal instalasi Anda, dan hapus ~/.apothem/ (cadangan) plus ~/.config/apothem/ (profil Anda) jika Anda ingin nol residu. Panduan pencopotan memandu setiap kanal.

Lisensi apa yang digunakan ekosistem ini?Copy Anchor Link

MIT — lihat LICENSE.