Mulai Cepat & Instalasi

Pasang paket skill ke setiap agent harness yang terdeteksi oleh installer di mesin Anda, dengan satu perintah:

git clone https://github.com/belajarcarabelajar/vivera.git
cd vivera
./install.sh

./install.sh tanpa argumen menjalankan tier standard (lihat Prasyarat) dan melakukan hal berikut:

Periksa dulu sebelum memasang, lalu cek lagi sesudahnya:

./install.sh --dry-run   # prints what it would do, writes nothing
./install.sh --check     # reports whether the install is current, changes nothing
./install.sh -h          # lists every flag

--check mencetak check: CURRENT dan keluar dengan 0 bila setiap target yang dipilih beres, keluar dengan 1 bila menemukan masalah, dan keluar dengan 2 bila tidak ada target terpilih yang memiliki skill dan tidak ada direktori sprite yang bisa diperiksa (misalnya --only codex dengan --tier minimal, atau di mesin tanpa bun; bila bun ada, --only codex memeriksa direktori sprite dan keluar dengan 1 jika direktori itu tidak ada). Mesin yang belum terpasang apa pun keluar dengan 1. Flag yang salah, target id yang tidak dikenal, atau HOME yang tidak disetel keluar dengan 2.

Kanal instalasi

Git clone adalah satu-satunya jalur yang sudah dijalankan dari awal sampai akhir. Jalur lainnya ada di repository, dan kolom Status menyebut sejauh mana masing-masing diuji. "Terverifikasi" berarti dijalankan di Linux x86_64 (Arch Linux, Bun 1.4.2) pada 2026-10-11 di home sekali pakai, dengan exit code diperiksa.

Apa yang dibuktikan oleh checksum bootstrap: checksum disajikan dari origin release yang sama dengan arsipnya, sehingga ia mendeteksi unduhan yang rusak atau arsip yang ditukar. Checksum tidak mendeteksi release yang dikompromikan, karena siapa pun yang bisa mengganti arsip juga bisa mengganti checksum-nya.

Mengapa marketplace ditunda. Sebuah spike pada 2026-10-11 menjalankan claude plugin validate, marketplace add, install, dan details di home yang terisolasi. Packaging-nya berfungsi: validasi lolos dan 8 skill terdaftar. Marketplace ditunda karena tiga alasan:

• Master skill memuat phase skill-nya dengan nama polos (sucp-rules, sucp-plan) dan berhenti bila salah satunya tidak bisa dimuat. Dokumentasi menampilkan skill plugin dengan nama plugin sebagai prefiks (/vivera:sucp-rules). Apakah tool Skill milik model menerima nama polos tidak didokumentasikan, dan tidak ada sesi live yang dijalankan, jadi hal ini belum terverifikasi.
• Path fallback ~/vivera/skills/<name>/SKILL.md tidak ada di mesin yang hanya memiliki plugin.
• Plugin yang berakar di repository memasang sekitar 498 MB dependensi ke cache, dibandingkan 720 KB untuk salinan yang hanya berisi skill.

Keputusannya berubah menjadi build bila satu sesi live di home terisolasi menunjukkan nama polos berhasil dimuat, atau bila pemilik mengajarkan kedua nama itu kepada master skill.

Mengapa Antigravity plugin menunggu. agy plugin validate menerima salinan skill (8 diproses), tetapi tidak ada yang dipasang. Ke mana instalasi lewat CLI mendarat, apakah staging mempertahankan symlink paket skill, dan bagaimana update bekerja belum diukur. Sebuah plugin akan menambah satu kanal dan tidak akan menggantikan tautan ke direktori skill Antigravity.

Prasyarat

Pilih tier dengan --tier minimal|standard|full (default standard). Daftar tool-nya adalah scripts/install/tiers.tsv, yang dibaca oleh install.sh maupun scripts/validate-skill.mjs, sehingga installer dan validator tidak mungkin berbeda pendapat soal tier.

Tool-tool tersebut, dari scripts/install/tiers.tsv:

• Tool wajib yang tidak ada membuat exit 1. Yaitu git dan bun di standard, ditambah gh dan tgrep di full.
• Tool opsional yang tidak ada memberi peringatan. Di standard dan full, tool yang tidak diwajibkan oleh tier pilihan mencetak satu peringatan yang menyebut apa yang hilang, dan proses tetap berjalan. Installer mencari tool di PATH, lalu di ~/.local/bin, lalu di ~/.bun/bin.
• --check dan --uninstall tidak meminta tool apa pun, di tier mana pun. Direktori sprite agent diperiksa dan dihapus hanya bila bun ada: tanpanya, --check melewati direktori itu dan --uninstall mempertahankan file-nya serta meminta Anda menghapus file yang bertanda secara manual.
• Bun >= 1.1.0 (bun.sh) adalah runtime untuk skrip dan test repository ini, dan package.json mematok bun@1.4.2. Semua instalasi dependensi memakai bun install / bun add, dan semua eksekusi JS/TS memakai bun test / bun run. npm install, npm test, yarn, dan pnpm dilarang keras. Pasang Bun dengan curl -fsSL https://bun.sh/install | bash. ./install.sh sendiri tidak butuh bun install lebih dulu: tree tanpa node_modules berhasil memasang dan merender sprite.
• Node.js tidak diperlukan untuk instalasi, maupun untuk menjalankan skrip Bun. Node.js diperlukan untuk merender diagram Mermaid (scripts/render-diagrams.sh dan bagian Mermaid dari scripts/validate-skill.mjs): mmdc dari @mermaid-js/mermaid-cli diawali dengan #!/usr/bin/env node, dan package.json meminta Node >= 22.13.0. Satu-satunya lockfile adalah bun.lock.
• ripgrep (rg) & tgrep: Pencarian kode utama memakai rg (binary langsung v15.2+ dengan smart-case). tgrep (microsoft/tgrep) dipakai untuk pencarian berindeks trigram di repository yang terindeks dan untuk penyaringan shell pipe. GNU grep mentah dilarang keras. tgrep hanya wajib di tier full: di standard, install.sh mencetak satu peringatan bila tool ini tidak ada (tidak ada peringatan di minimal) dan aturan pencarian skill (skills/sucp-rules/SKILL.md) menerima rg atau tgrep, sehingga rg saja sudah memenuhinya.

Matriks platform

"Terverifikasi" memakai definisi yang sama seperti di Kanal instalasi: dijalankan di Linux x86_64 (Arch Linux, Bun 1.4.2) di home sekali pakai, dengan exit code diperiksa. Selain itu berarti "belum terverifikasi".

• macOS: skrip bootstrap menyatakan berjalan di bash 3.2, tetapi installer tidak pernah dijalankan di bash 3.2 atau dengan tool BSD.
• "Belum terverifikasi" berarti belum diuji, bukan diketahui gagal.
• HOME yang read-only membuat instalasi keluar dengan 1 dan tidak menulis apa pun (terverifikasi di Linux).

Harness yang Didukung & Path Target

Installer memiliki 10 target, dicantumkan di sini sesuai urutan instalasi. Dua yang pertama selalu dipasang. Target lainnya hanya dipasang bila harness-nya terdeteksi, atau bila Anda menyebutnya dengan --only.

Setiap direktori skill di atas kecuali ~/.config/ai berisi super-ultra-code-plan/ (SKILL.md, templates/, examples/, dan dua konfigurasi Mermaid) di samping tujuh phase skill, sucp-<name>/SKILL.md. Pengujian di Linux pada home sekali pakai memeriksa deteksi berbasis direktori dan berbasis CLI serta path skill dan sprite untuk ke-10 target, dengan CLI tiruan (stub) untuk deteksi.

Gemini CLI (gemini) bukan target. Google berhenti menyediakannya untuk akun gratis, AI Pro, dan Ultra pada 2026-06-18 dan menggantinya dengan Antigravity CLI (agy), yang dicakup oleh target antigravity-cli (https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/). Gemini CLI masih tersedia dengan lisensi Code Assist Standard atau Enterprise, atau dengan API key berbayar; pengguna tersebut dapat menautkan paket skill ke ~/.gemini/skills/ sendiri. Revisi installer yang lebih lama memiliki target gemini-cli; --only gemini-cli kini keluar dengan 2 sebagai target yang tidak dikenal.

• Hanya yang terdeteksi yang dipasang. Target yang tidak ada setelah ./install.sh berhasil berarti harness-nya tidak terdeteksi, bukan berarti instalasinya gagal. Installer tidak membuat tree konfigurasi kosong untuk harness yang tidak Anda miliki. ./install.sh --dry-run mencantumkan target yang memenuhi syarat di mesin Anda. Home yang masih kosong hanya mendapat ~/.config/ai dan ~/.agents/skills.
• Menyebut target. --only ID,ID memasang tepat id-id tersebut, terdeteksi atau tidak, dan tidak menambahkan dua target yang selalu dipasang (--only claude memasang claude dan tidak ada yang lain). --skip ID,ID mengeluarkan id dan menang atas --only. Kedua flag bisa diulang dan nilainya terakumulasi, dan id yang tidak dikenal keluar dengan 2. Versi installer yang lebih lama membuat target OpenCode dan Antigravity bahkan saat harness-nya tidak ada; --only opencode,antigravity,antigravity-cli,antigravity-builtin mengembalikan perilaku itu.
• Dua direktori skill Antigravity. Target antigravity (~/.gemini/config/skills) adalah tempat Antigravity 2.0 dan IDE membaca skill, sedangkan CLI membaca ~/.gemini/antigravity-cli/skills (target antigravity-cli), menurut dokumentasi Antigravity yang dibaca untuk riset agy plugin. Tidak satu pun path itu dikonfirmasi dengan memuat skill.
• Codex, Cursor, dan Copilot tidak punya target skill. Installer menganggap skill mereka berasal dari ~/.agents/skills, yang belum diperiksa terhadap ketiga harness itu. Mereka hanya mendapat sprite agent.
• Sprite agent dirender, dan hanya OpenCode yang dikonfirmasi mencantumkannya (tidak ada harness yang dijalankan dengan prompt model). Enam harness mendapatkannya (Claude Code, OpenCode, Codex, Cursor, Copilot, dan target antigravity). antigravity-cli dan antigravity-builtin tidak mendapat satu pun, dan tier minimal tidak merender satu pun. OpenCode v2.0.24 mencantumkan ketujuh sprite di opencode debug agents. Antigravity 1.3.3 belum terkonfirmasi: agy agents hanya mencantumkan agent yang ditulis dengan mainAgent: true, sedangkan sprite ditulis dengan mainAgent: false. Claude Code 2.1.296 tidak memiliki lister non-interaktif untuk definisi subagent (claude agents --json mencantumkan sesi background dan mencetak [] saat sprite terpasang), dan Codex, Cursor, serta Copilot tidak pernah dijalankan.

Flag

./install.sh -h mencetak daftar ini. Sumber kebenaran untuk target adalah tabel di atas, dan untuk tier adalah scripts/install/tiers.tsv.

Instalasi biasa menyebutkan harness mana yang dilewatinya, dengan [INFO] not detected, skipped: <ids> (name one with --only to install anyway). Untuk codex, cursor, dan copilot, installer mencetak [INFO] <id>: no skills target of its own (its skills come from ~/.agents/skills); installing its sprite agents only. Tier minimal, --check, dan --uninstall tidak mencetak peringatan tentang tool opsional.

Backup, restore, update, pemeriksaan, dan uninstall

Sebelum menempatkan apa pun, installer menilai setiap tujuan dari apa yang ada di disk. Tidak ada file state, sehingga instalasi yang dibuat oleh versi lama, atau secara manual, dinilai dengan aturan yang sama.

Verdict --check:

Uninstall, per tujuan:

Baris penutupnya adalah ==> Vivera uninstalled: N link(s) removed, R restored, K kept, dan berbunyi link(s) or copy/copies jika ada salinan yang dihapus. Link yang dipulihkan akan menggantung jika checkout yang ditunjuknya sudah dihapus sementara itu.

Mode copy

--copy menyalin file alih-alih me-link-nya, sehingga instalasi tetap berfungsi saat checkout dipindahkan atau hilang. Konsekuensinya, salinan tidak mengikuti checkout: jalankan ./install.sh --update --copy setelah Anda melakukan pull.

Setiap salinan terkelola dinilai terhadap sumbernya dan terhadap digest yang tercatat:

Aturan lain:

• Git Bash, MSYS, dan Cygwin memakai --copy secara default. Di sana ln -s menyalin file atau gagal kecuali symlink diaktifkan, sehingga instalasi biasa akan melaporkan link yang tidak dibuatnya. Installer mencetak [NOTE] lalu menyalin. Ini hanya teramati dengan uname tiruan (stub), tidak di Windows (belum diverifikasi).
• .gitattributes memaksa LF untuk *.sh dan scripts/install/tiers.tsv, karena clone Windows dengan core.autocrlf akan mengubah setiap skrip installer menjadi CRLF, dan carriage return setelah set -euo pipefail bukan perintah bash yang valid.
• Instalasi copy harus diperiksa dengan --check --copy. Tanpa --copy, --check mengharapkan link, menyebut salinan-salinan itu [stale], dan mencetak [hint] those are copies made by --copy: run ./install.sh --check --copy.
• install.ps1 selalu menyalin dan mengikuti aturan identical, pristine, dan modified yang sama, dengan digest-nya sendiri (entri ps-sha256 di marker): digest yang dicatat oleh install.sh (sha256:) tidak pernah dipercaya, sehingga salinan seperti itu dihitung sebagai modified. Satu perbedaan: di balik direktori yang di-link, skrip ini membiarkan link APA PUN, termasuk milik installer sendiri, sedangkan install.sh dalam mode link tetap mengarahkan ulang link miliknya (install.sh --copy, mode yang setara dengan install.ps1, juga membiarkannya). Skrip ini hanya dijalankan di PowerShell 7.6.6 di Linux, tidak di Windows.

Mode offline dan tier minimal

Batasan yang diketahui

Harvest Sprites

Tujuh Harvest Sprites sedang bekerja. Karya seni resmi Back to Nature © pemiliknya.

Bagian ini mengikuti game PlayStation Harvest Moon: Back to Nature (Victor Interactive Software, Jepang 16 Desember 1999, rilis bahasa Inggris oleh Natsume pada 22 November 2000), bukan Friends of Mineral Town, yang sprite-nya bekerja dengan cara berbeda (lihat glosarium). Di dalam game itu, tujuh Harvest Sprites (コロボックル, Korobokkuru) tinggal di sebuah pondok kecil di belakang Gereja. Ajak bicara salah satunya dua kali untuk meminta bantuan setelah ia memiliki setidaknya 2 hati kasih sayang, lalu sewa ia selama 1 hari, 3 hari, atau seminggu, mulai keesokan harinya, untuk menyiram tanaman, memanen tanaman, atau merawat hewan. Pada Musim Semi mereka hanya membicarakan Pesta Teh (Tea Party) mereka, dan Anda harus mengajak bicara sprite yang sama lima kali agar ia mau bekerja. Mereka tampak identik kecuali warna topi dan bajunya, dan ketujuh warna itu bersama-sama membentuk pelangi. Di Vivera setiap sprite adalah subagent bernama: nama dan warnanya tetap, tetapi sprite mendapat peran tetap di agents/crew.json, bukan bebas memilih pekerjaan.

Sprite	Di dalam game (PlayStation)	Peran di Vivera	Afinitas default	Yang dilakukannya
Chef	Merah. Ulang tahun Musim Gugur 14. Suka memasak. Pada tahun keempat ia ditemukan dalam keadaan takut gelap, membawa lentera.	implementer	panen (harvesting)	Mengimplementasikan satu chunk dari plan yang sudah disetujui, test terlebih dahulu, di dalam file yang diizinkan.
Nappy	Oranye. Ulang tahun Musim Dingin 22. Para saudara itu tinggal bersama di rumahnya.	implementer	merawat hewan (animal care)	Peran yang sama dengan Chef, pada chunk yang berbeda.
Hoggy	Kuning. Ulang tahun Musim Gugur 10. Suka tidur dan malas bekerja.	implementer	panen (harvesting)	Peran yang sama dengan Chef, pada chunk yang berbeda.
Timid	Hijau. Ulang tahun Musim Panas 16. Mudah takut.	researcher	merawat hewan (animal care)	Menyelidiki satu pertanyaan sempit tentang kode, riwayat, atau web, dan tidak mengedit file apa pun.
Aqua	Biru muda. Ulang tahun Musim Semi 26. Suka berpakaian rapi.	researcher	menyiram (watering)	Peran yang sama dengan Timid, pada pertanyaan yang berbeda.
Staid	Biru tua (sumber lain juga menyebut biru atau indigo). Ulang tahun Musim Semi 15.	reviewer	merawat hewan (animal care)	Mengaudit diff, laporan subagent, atau klaim penyelesaian terhadap bukti baru, dan tidak mengedit file apa pun.
Bold	Ungu. Ulang tahun Musim Semi 4. Pemberani, dan mengusir yang lain dengan teriakan perang.	debugger	menyiram (watering)	Mengisolasi akar penyebab satu test yang gagal atau bug yang dapat direproduksi lewat hipotesis dan probe, lalu memperbaikinya pada penyebab bersamanya.

Empat hal yang perlu diketahui:

• Game mencatat dua angka per sprite. Kasih sayang naik satu hati setiap 25 poin dan turun 2 untuk setiap hari sprite bekerja untuk Anda. Level keterampilan tersembunyi per pekerjaan dimulai dari 0, naik 1 setiap kali ia melakukan pekerjaan itu, dan maksimal 255.
• Kebutuhan berpengaruh, cuaca tidak. Anda tidak dapat menyewa sprite untuk pekerjaan yang tidak ada yang perlu dikerjakan hari itu, tetapi sprite yang disewa tetap datang saat badai topan atau badai salju, sehingga berguna untuk memberi makan hewan saat badai.
• Pekerjaan adalah default, bukan aturan. Di dalam game, sprite mana pun dapat melakukan salah satu dari tiga pekerjaan, satu per permintaan. Di Vivera peran ditetapkan oleh roster, sedangkan kolom afinitas hanya default untuk fan-out (menyiram atau watering adalah pekerjaan keep-alive, merawat hewan atau animal care adalah aset berumur panjang, panen atau harvesting adalah pengiriman atau shipping). Parent boleh mengirim sprite mana pun ke chunk mana pun. Lihat Glosarium Vivera.
• Warna agent berbeda untuk dua sprite. agents/crew.json memberi Aqua blue dan Staid cyan, sedangkan di dalam game Aqua berwarna biru muda dan Staid biru tua.

Potret sprite di tabel adalah karya seni Harvest Moon dari Harvest Moon Wiki, © pemiliknya masing-masing. Fakta game dan sumbernya tercantum di glosarium. Vivera adalah proyek independen dan tidak berafiliasi dengan franchise Harvest Moon.

Agent Claude Code

Subagent-nya adalah tujuh Harvest Sprites. Claude Code memberi label pada subagent yang sedang berjalan dengan nama agent-nya, sehingga gelombang chunk paralel yang dikirim ke satu agent peran bersama akan menampilkan satu nama berulang-ulang. Setiap sprite adalah salinan bernama dan berwarna dari salah satu dari empat template peran di agents/roles/, dan agents/crew.json menetapkan sprite ke peran. Setiap peran memuat lebih dulu (preload) skill fase tempat ia bekerja, sehingga chunk yang didelegasikan dimulai dengan aturan fasenya, bukan harus menemukannya sendiri.

bun run agents:gen me-render sprite ke .claude/agents/; edit template atau roster, jangan pernah file hasil generate, yang memuat baris # Generated by di frontmatter-nya. bun run agents:check gagal ketika file hasil generate menyimpang (drift) dari sumbernya. ./install.sh me-render crew yang sama ke ~/.claude/agents/ jika Claude Code terdeteksi (~/.claude ada) atau disebut dengan --only claude, dan ke lima harness lain dalam format masing-masing (lihat Agent sprite di enam harness di bawah). Sprite kemudian tersedia di setiap proyek, dengan path hook dipatok ke repositori ini karena $CLAUDE_PROJECT_DIR di proyek lain tidak memiliki skrip penjaga. Installer hanya menulis dan menghapus file yang memuat marker. Warna Staid berbeda-beda antarsumber (lihat docs/vivera-glossary.md), dan Claude Code tidak memiliki indigo, sehingga cyan menjadi penggantinya. Claude Code menggambar nama agent di atas warnanya tanpa padding, sehingga setiap name: adalah nama sprite yang diapit no-break space (U+00A0), tanpa tanda kutip, yang dipertahankan YAML sementara spasi biasa akan hilang. Label kemudian terbaca chef, bukan chef, dan panggilan dengan chef biasa tetap ter-resolve.

Setiap peran membawa hook frontmatter PreToolUse, .claude/hooks/block-git-writes.mjs, yang keluar dengan exit 2 pada subcommand git yang menulis state (commit, add, push, checkout, switch, merge, rebase, reset, dan lainnya), pada bentuk penulisan dari perintah campuran seperti stash, branch, tag, remote, dan config, serta pada setiap panggilan gh, termasuk di dalam rantai a && b. Bentuk baca seperti git stash list dan git branch --show-current lolos. Hook ini menegakkan aturan git khusus parent dari kontrak subagent. Hook memeriksa kata perintah di setiap segmen, mencocokkan git dan gh berdasarkan basename, dan membaca satu tingkat ke dalam string sh -c, sehingga /usr/bin/git commit dan sh -c "git commit" diblokir. Alias, command substitution yang bukan nilai dari sebuah assignment (x=$(git commit) diblokir), -c bersarang, eval, atau teks skrip yang di-pipe ke shell masih bisa lolos: hook ini adalah lapisan kedua di belakang teks kontrak, bukan satu-satunya. Hook ini juga tidak mencegah panggilan Bash menulis file biasa, sehingga aturan "tidak mengedit file" untuk researcher dan reviewer adalah kontrak, bukan batasan yang ditegakkan.

Hal-hal yang mudah keliru:

• Sengaja tidak ada CLAUDE.md. Claude Code membaca AGENTS.md sendiri hanya jika tidak ada CLAUDE.md di direktori kerja atau di direktori mana pun di atasnya. Menambahkan file itu di sini akan menghentikan pemuatan AGENTS.md kecuali file baru tersebut mengimpornya.
• Nama di skills: di-resolve dari skill yang sudah terpasang di Claude Code, bukan dari folder skills/ di repositori ini. Jalankan ./install.sh terlebih dahulu, atau preload dilewati dengan hanya peringatan di debug log.
• Hook frontmatter dari agent proyek baru berjalan setelah dialog kepercayaan workspace diterima untuk folder ini. Sebelum itu agent tetap berjalan, tanpa penjaga.
• Claude Code mengabaikan field frontmatter yang tidak dikenal tanpa pesan apa pun, sehingga maxTurn: alih-alih maxTurns: tidak berpengaruh apa-apa. bun run agents:check (juga bagian dari bun run ci) menolaknya, dan menolak hook yang path skripnya di bawah $CLAUDE_PROJECT_DIR tidak ada, karena salah ketik di sana mematikan penjaga tanpa pesan apa pun. Daftar field yang diizinkan dipatok ke dokumentasi Claude Code tanggal 2026-10-10.

Agent OpenCode

Jika OpenCode terdeteksi atau disebut dengan --only opencode, ./install.sh me-render crew ke ~/.config/opencode/agents/ dengan gen-sprite-agents.mjs --target opencode, sehingga OpenCode menjalankan tujuh nama yang sama, bukan general bawaannya. Formatnya berbeda, dan perbedaannya diukur di OpenCode v2.0.24:

• OpenCode melewati file agent Claude Code tanpa pesan apa pun. Nama warna (color: red) atau field lama tools: membuat seluruh agent dibuang, sehingga file Claude Code tidak bisa sekadar di-link ke sana. File OpenCode memakai warna hex, mode: subagent, dan steps sebagai pengganti maxTurns.
• OpenCode mengabaikan skills: dan hooks:. Body dimulai dengan baris yang menyuruh agent memuat skill fasenya, dan penjaga git menjadi permissions shell: setiap perintah git dan gh ditolak, lalu bentuk baca yang umum (git status, git diff, git log, git show, dan lainnya) diizinkan kembali. Aturan terakhir yang cocok yang menang, dan setiap perintah dalam rantai a && b dicocokkan sendiri-sendiri. git -C diblokir, sehingga agent menjalankan cd <dir> && git ... sebagai gantinya.
• Plugin rtk menulis ulang git x menjadi rtk git x sebelum pencocokan, sehingga setiap aturan memiliki bentuk rtk. Tanpa bentuk itu, aturan git commit* tidak memblokir apa pun di mesin ini.
• Seperti hook, aturan ini tidak menangkap string sh -c dan alias. Researcher dan reviewer mendapat edit: deny, sehingga di OpenCode mereka tidak dapat memakai tool edit, tetapi shell tetap dapat menulis file.

Tidak ada file OpenCode yang di-commit: file-file itu di-render dari template yang sama saat instalasi. Hal yang sama berlaku untuk setiap harness di bawah, kecuali .claude/agents/ milik Claude Code sendiri di repositori ini.

Agent sprite di enam harness

scripts/gen-sprite-agents.mjs me-render tujuh Harvest Sprites untuk enam harness, dari empat template peran di agents/roles/ dan roster di agents/crew.json. Setiap harness adalah satu file di scripts/sprite-agents/targets/. ./install.sh me-render-nya untuk setiap harness yang terdeteksi atau disebut dengan --only, dan tier minimal tidak me-render apa pun karena generator memerlukan bun. antigravity-cli dan antigravity-builtin tidak mendapat apa pun.

• Peran read-only adalah timid, aqua, dan staid. chef, nappy, hoggy, dan bold tidak memiliki key tools di template-nya. Di Claude Code mereka mewarisi tool parent, dan mereka tidak mendapat aturan edit di OpenCode, tidak ada sandbox_mode di Codex, tidak ada readonly di Cursor, dan tidak ada baris tools di Copilot dan Antigravity.
• Read-only adalah daftar tool atau flag, bukan jaminan. Claude Code, OpenCode, Copilot, dan Antigravity tetap menyediakan shell, sehingga perintah shell tetap dapat menulis file. Flag Cursor dan Codex tidak diuji.
• Tanpa hook berarti penjaga prosa. Di Codex, Cursor, Copilot, dan Antigravity, file memuat komentar # guard: instruction only, not enforced by this harness (di frontmatter untuk Cursor, Copilot, dan Antigravity, di bagian atas file TOML untuk Codex), dan body-nya menyuruh sprite menyerahkan git kepada sesi parent. Tidak ada yang mencegah sprite melanggar aturan itu.
• Arti key tools yang dihilangkan belum diverifikasi. Halaman Antigravity mendokumentasikan daftar kosong sebagai default, sehingga empat sprite penulis mungkin mulai tanpa tool di sana, dan Copilot diasumsikan membaca key tools yang tidak ada sebagai semua tool. Keduanya tidak dijalankan.
• Komentar YAML di dalam frontmatter memuat marker # Generated by dan label penjaga. Parser YAML Bun menerimanya di setiap file Markdown hasil render, dan agy menerima komentar # di frontmatter agent kontrolnya. Cursor dan Copilot tidak dijalankan, sehingga hal ini belum diverifikasi di sana.
• Batas giliran dan skill fase. maxTurns menjadi steps di OpenCode dan dihapus di empat harness lainnya, yang halamannya tidak mencantumkan key seperti itu. Claude Code melakukan preload skill fase dari skills:; di tempat lain baris pertama body menyuruh sprite memuatnya.
• Nama key dan direktori Codex, Cursor, Copilot, dan Antigravity berasal dari halaman dokumentasi vendor yang dibaca pada 2026-10-11, dan setiap file target tersebut menyebut halaman dan tanggalnya dalam komentar di bagian atas. Milik Claude Code berasal dari dokumentasinya tanggal 2026-10-10, dan milik OpenCode dari pengukuran di v2.0.24.

Untuk me-render, memeriksa, atau menghapus satu harness secara manual:

bun scripts/gen-sprite-agents.mjs --target <id> --out <dir>           # render
bun scripts/gen-sprite-agents.mjs --target <id> --out <dir> --check   # exit 1 when the files differ
bun scripts/gen-sprite-agents.mjs --target <id> --out <dir> --clean   # remove the marked files

<id> adalah claude, opencode, codex, cursor, copilot, atau antigravity. Hanya claude yang memiliki direktori default (.claude/agents di repositori ini); yang lain memerlukan --out, dan --clean selalu memerlukan --out. --hook-root hanya untuk claude. Generator hanya menulis dan menghapus file yang memuat baris # Generated by scripts/gen-sprite-agents.mjs, dan menolak file yang ditulis manual dengan nama sebuah sprite.