agency-agents: 300+ Definisi Peran untuk Coding Agent Anda, dan Apa yang Tidak Bisa Mereka Pegang

Agent coding Anda punya satu kepribadian bawaan: generalis yang mumpuni. Minta ia meninjau alur autentikasi, dan Anda akan mendapat saran yang masuk akal tapi mudah dilupakan. Minta peninjau keamanan yang dilengkapi threat model dan checklist, dan Anda akan mendapat temuan. Perbedaan itu tidak memakan biaya apa pun selain satu file markdown, itulah sebabnya agency-agents menembus 149.312 bintang.

Pustaka ini benar-benar berguna. Tapi ia juga hanya sekumpulan file di satu mesin, dan itu langsung menjadi keterbatasan begitu lebih dari satu orang butuh peran-peran tersebut punya arti nyata. Artikel ini membahas apa yang Anda dapatkan, cara memasang hanya bagian yang Anda inginkan, dan perbedaan antara definisi peran dan Agent yang bisa diberi tugas oleh tim.

TL;DR

Ini salah satu dari lima ulasan mendalam dari rangkuman kami tentang alat open source yang memperluas kemampuan coding agent.

agency-agents adalah kumpulan lebih dari 300 definisi peran agent di sekitar 20 kategori, berlisensi MIT, dan bisa dipasang ke Claude Code, Cursor, Codex, Gemini CLI, OpenCode, serta sekitar selusin alat lain dengan satu perintah. Setiap file mendeskripsikan identitas, proses kerja, hasil yang diharapkan, dan definisi selesai. Sebuah peran mengubah cara agent membingkai sebuah tugas; peran itu tidak memberi agent informasi yang tidak dimilikinya, dan tidak bertahan setelah sesi berakhir. Pasang satu divisi, sunting filenya agar sesuai dengan stack Anda, dan promosikan peran yang Anda pakai setiap minggu menjadi konfigurasi tersimpan yang bisa ditugaskan ke tim.

Apa yang Anda pasang

Berdasarkan penghitungan dari struktur repositori pada 1 September 2026, ada 312 file markdown di 20 folder kategori tingkat atas. README repositori masih menyebut “230+”, yang sudah kedaluwarsa.

Divisi engineering adalah titik awal sebagian besar tim, dan tingkat spesifikasinya lebih tinggi daripada yang biasanya dicapai kumpulan prompt. Selain Frontend Developer dan Backend Architect, ada Network Engineer yang khusus menangani Cisco IOS-XE dan Juniper Junos, Embedded Firmware Engineer untuk target ESP32 dan STM32, Incident Response Commander untuk post-mortem dan kesiapan on-call, serta Codebase Onboarding Engineer yang dirancang untuk menelusuri repositori secara read-only dan menyatakan fakta, bukan mengusulkan perubahan.

Yang terakhir menunjukkan pola ini bekerja. Peran read-only dengan mandat larangan menyunting yang eksplisit adalah alat yang berbeda dari agent bawaan Anda, dan harganya hanya satu file.

Memasang hanya yang Anda butuhkan

git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents

./scripts/install.sh                                       # interactive
./scripts/install.sh --tool claude-code --division engineering,security
./scripts/install.sh --tool cursor --agent frontend-developer
./scripts/install.sh --list teams
./scripts/install.sh --tool opencode --division engineering --dry-run

Satu peringatan yang didokumentasikan repositori ini tapi dilewatkan sebagian besar artikel: runtime OpenCode mendaftarkan sekitar 119 agent dan diam-diam membuang sisanya. Memasang sebagian dengan --division membuat Anda tetap di bawah batas tersebut, dan installer akan memperingatkan Anda ketika pilihan yang dipasang akan melewatinya. Pemotongan diam-diam adalah mode kegagalan terburuk yang mungkin terjadi, karena peran yang Anda inginkan hilang dan tidak ada yang memberi tahu.

Bahkan tanpa bug itu, memasang semua 300 adalah kesalahan. Daftar peran yang tidak bisa Anda ingat adalah daftar yang tidak akan Anda pakai. Pasang divisi tempat Anda bekerja, baca lima file, lalu hapus yang tidak sesuai dengan cara tim Anda bekerja.

Batas kemampuan definisi peran

Peran adalah sebuah bingkai. Peran menentukan apa yang dicari agent, format apa yang dihasilkannya, dan apa yang dianggapnya selesai. Nilainya lebih besar dari yang terdengar, karena banyak hal yang membuat keluaran agent lemah bukanlah model yang salah, melainkan model yang mengoptimalkan bentuk jawaban yang keliru.

Ada dua hal yang tidak bisa dilakukan sebuah peran.

Peran tidak bisa menyediakan informasi yang tidak dimiliki model. Peran Backend Architect menghasilkan kode yang tertata rapi berdasarkan antarmuka yang ia simpulkan sendiri. Peran itu memperbaiki strukturnya. Tapi tidak membuat hasilnya benar.

Peran tidak bisa bertahan melewati sesi. Anda mengaktifkan peran, ia mengerjakan tugas, terminal ditutup. Besok Anda mengetik aktivasi itu lagi. Sembilan divisi di repositori ini mendeskripsikan pekerjaan yang hanya ada di dalam sebuah organisasi, sementara alat yang memasangnya tidak punya konsep organisasi sama sekali. Tidak ada penugasan, tidak ada catatan tentang apa yang ditemukan peninjau keamanan Selasa lalu, dan tidak ada cara bagi rekan kerja untuk melihatnya.

Dari definisi peran menjadi Agent yang bisa diberi tugas

Definisi peran adalah prompt yang Anda ketik ulang. Agent di Sharkly adalah konfigurasi tersimpan: instruksi, runtime, skill, repositori, dan environment. Itulah versi awet dari apa yang ingin dicapai file di ~/.claude/agents/.

Setiap komponen punya satu tugas. Agent menentukan bagaimana pekerjaan harus ditangani. Computer menyediakan host dan sumber daya lokal. Runtime menjalankan sesi agent yang sebenarnya, menggunakan alat coding yang sudah dipasang tim Anda. Task tetap menjadi catatan bersama.

Sharkly bukan pengganti Claude Code, Codex, atau peran-peran di repositori ini. Sharkly menambahkan lapisan task bersama, Computer, konteks, kontrol, dan tinjauan di sekelilingnya. Penggunaan model tetap berjalan melalui langganan atau API key yang dikonfigurasi di alat-alat tersebut.

Konsep divisi ini terpetakan secara langsung. Crew adalah kelompok People dan Agent yang bisa dipakai ulang dan dikoordinasikan oleh satu Agent pemimpin. Crew berjalan dengan pola leader-first: pemimpin membaca konteks tugas, memutuskan anggota mana yang perlu dilibatkan, lalu membawa hasil mereka kembali ke dalam satu Task, bukan setiap spesialis mulai bekerja sendiri-sendiri. Itulah yang coba disiratkan agency-agents dengan delapan divisinya tapi tidak bisa dijalankan, karena folder berisi file tidak punya pemimpin dan tidak punya task bersama sebagai tempat kembali.

Eksekusi, hambatan, hasil, dan diskusi lanjutan kembali ke timeline task. Saat seseorang bertanya apa yang ditemukan peninjau keamanan, jawabannya ada di Task.

Gunakan repositori sebagai pustaka, bukan sebagai tim

Gunakan agency-agents secara langsung bila Anda bekerja sendiri, secara lokal, dan ingin bingkai yang lebih baik untuk pekerjaan hari ini. Pasang satu divisi, baca filenya, dan dapatkan manfaatnya dalam dua puluh menit.

Gunakan Agent tersimpan ketika peran itu harus dipakai ulang oleh lebih dari satu orang, ketika keluarannya perlu ditinjau sebelum dianggap sah, atau ketika tiga bulan dari sekarang ada yang bertanya apa yang dihasilkan sebuah peran dan mengapa. Ambangnya bukan ukuran tim, melainkan apakah peran itu harus bertahan lebih lama dari sesi.

Alur kerja praktisnya adalah memperlakukan repositori ini sebagai bahan mentah. Ambil struktur filenya, yang merupakan bagian yang benar-benar bisa dipakai ulang, ganti konten generiknya dengan stack dan definisi selesai milik Anda, lalu promosikan apa pun yang Anda pakai dua kali seminggu menjadi konfigurasi tersimpan. File-file yang bagus punya bentuk yang sama: identitas, misi, proses berurutan, hasil yang diharapkan beserta formatnya, dan kriteria keberhasilan. Peran peninjau dengan proses tujuh langkah menghasilkan keluaran yang konsisten di setiap sesi. Peran tanpa itu menghasilkan apa pun yang sedang diinginkan model hari itu.

Agent meneliti, mengeksekusi, menguji, dan melaporkan. Manusia menentukan arah, memberikan wewenang, dan menerima hasilnya.

Pertanyaan yang sering diajukan

Apakah agency-agents bisa dipakai dengan alat selain Claude Code? Bisa. Skrip konversi menghasilkan file integrasi untuk setiap alat, dan install.sh --tool menargetkan satu alat tertentu. Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Copilot, Windsurf, Aider, dan Kimi Code termasuk di antara target yang didukung. Tersedia juga aplikasi desktop untuk macOS, Linux, dan Windows.

Haruskah saya memasang semua 300 peran? Tidak. Di OpenCode Anda tidak bisa, karena sekitar 119 peran terdaftar dan sisanya dibuang tanpa peringatan. Di alat lain Anda bisa, tapi tidak akan memakai sebagian besarnya. Pasang per divisi.

Apakah peran membuat agent lebih mumpuni? Peran membuatnya lebih terarah. Konsistensi dan format keluaran meningkat. Pengetahuan tentang fakta yang tidak pernah dimiliki model tidak berubah.

Apakah ini sama dengan framework agent? Tidak. Framework memberi Anda orkestrasi runtime dalam bentuk kode. agency-agents memberi Anda file markdown yang mengubah perilaku agent yang sudah ada. Lapisan yang berbeda, tidak ada tumpang tindih.

Apa hubungannya dengan Sharkly Skills? Skill adalah kemampuan yang Anda lampirkan ke konfigurasi Agent, sehingga bisa dipakai ulang bersama Agent tersebut alih-alih dipasang ulang di setiap mesin. Definisi peran dari repositori ini adalah bahan mentah yang bagus untuk menulisnya.

Ringkasnya

agency-agents adalah versi terbaik yang tersedia dari satu gagasan: agent bekerja lebih baik ketika ia tahu peran apa yang dimainkannya. Pasang satu divisi, baca filenya, sunting agar sesuai dengan tim Anda.

Lalu pahami batasnya dengan jelas. Peran-peran itu tidak mengetahui fakta yang tidak pernah diberikan ke model Anda, dan tidak bertahan menjadi sesuatu yang bisa dilihat atau ditinjau tim. Sebuah daftar peran adalah awal yang baik. Tapi itu bukan organisasi. Sharkly memegang separuh lainnya: Task adalah catatan bersama, eksekusi berjalan di Computer yang Anda hubungkan melalui runtime yang sudah Anda bayar, dan hasilnya kembali ke tempat di mana seseorang bisa meninjau dan menerimanya.