Setiap framework AI agent mendefinisikan agent dengan caranya sendiri, dan pindah framework berarti menulis ulang semuanya. OpenGAP, singkatan dari Git Agent Protocol, menjawab dengan ide sederhana: agent adalah repo itu sendiri. Definisikan agent kamu sebagai file biasa di dalam repo git, dan satu definisi bisa diekspor ke Claude Code, OpenAI Agents SDK, CrewAI, dan lainnya. Standar dan CLI referensinya tinggal di satu repositori, open-gitagent/opengap di GitHub: berlisensi MIT, ditulis dengan TypeScript, dengan 2.981 stars dan 354 forks.
Poin Penting
OpenGAP adalah standar terbuka untuk AI agent yang portabel: agent adalah sekumpulan file di dalam repo git, dan meng-clone repo itu memberi kamu agent yang lengkap.
Hanya dua file yang wajib ada, `agent.yaml` (manifest) dan `SOUL.md` (identitas). Selebihnya, rules, duties, skills, tools, memory, bersifat opsional.
CLI referensinya, diterbitkan di npm sebagai `@open-gitagent/opengap` (rilis terbaru 0.5.0), memvalidasi, menjalankan, mengimpor, dan mengekspor agent ke 16 adapter.
Kepatuhan regulasi dibangun sejak awal, bukan tempelan: pemisahan tugas, pemetaan FINRA dan Federal Reserve, serta perintah audit khusus.
OpenGAP bukan proyek yang sama dengan GitAgent, repo framework terpisah dari organisasi yang sama. Riwayat namanya dijelaskan di bawah.
Standarnya: Repomu Menjadi Agentmu
OpenGAP mendefinisikan agent sebagai sebuah direktori berisi file yang bisa dibaca manusia di dalam repo git. Dokumen spesifikasinya ada di repo pada `spec/SPECIFICATION.md` (saat ini v0.1.0), lengkap dengan JSON Schema untuk validasi di sebelahnya. Hanya dua file yang wajib:
File | Fungsi |
|---|---|
`agent.yaml` | Manifest: nama, versi, model, skills, tools, kepatuhan |
`SOUL.md` | Identitas, kepribadian, gaya komunikasi, nilai-nilai |
Di sekitarnya ada struktur opsional yang mencakup seluruh siklus hidup agent:
`RULES.md` untuk batasan keras dan batas keamanan, serta `DUTIES.md` untuk kebijakan pemisahan tugas.
`skills/` untuk modul kemampuan yang bisa dipakai ulang, `tools/` untuk definisi tool yang kompatibel dengan MCP dalam format YAML, dan `workflows/` untuk playbook multitahap.
`knowledge/` untuk dokumen referensi dan `memory/` untuk memori persisten antar sesi, termasuk folder `runtime/` tempat agent menulis state live seperti log harian dan catatan konteks.
`hooks/` untuk handler siklus hidup, `compliance/` untuk artefak regulasi, dan `agents/` untuk sub-agent yang secara rekursif mengikuti struktur yang sama.
Karena semuanya adalah file, semua operasi git standar berlaku. `git diff` menunjukkan persis apa yang berubah dalam perilaku agent, `git blame` melacak siapa menulis setiap baris, dan `git revert` mengembalikan prompt yang buruk seperti kamu mengembalikan commit yang buruk.
Pola-Pola yang Muncul dari Git
Memperlakukan repo sebagai agent menghasilkan serangkaian pola yang didokumentasikan proyek ini secara detail:
Review human-in-the-loop. Ketika agent mempelajari skill baru atau menulis ke memory, ia membuka branch dan pull request untuk direview manusia sebelum di-merge.
Deployment berbasis branch. Promosikan perubahan agent melalui `dev`, `staging`, dan `main`, beri tag pada rilis stabil seperti `v1.1.0`, dan kunci production ke tag tertentu.
CI/CD untuk agent. Jalankan `opengap validate` di GitHub Actions setiap push, blokir merge yang buruk, dan perlakukan kualitas agent seperti kualitas kode.
Fork dan remix. Fork repo agent publik mana pun, sesuaikan `SOUL.md`-nya, tambah skill, dan kirim perbaikan kembali ke upstream.
Konteks bersama dalam monorepo. File skills, tools, dan konteks di level root otomatis dibagikan ke setiap agent di dalam repositori.
Secret tetap lokal. Tool membaca API key dari file `.env` lokal yang tidak masuk version control, sehingga definisi agent tetap aman dibagikan.
Workflow punya format deterministiknya sendiri, SkillsFlow: file YAML di `workflows/` yang merangkai langkah skill, agent, dan tool dengan dependensi eksplisit dan aliran data template, sehingga proses multitahap mengikuti jalur yang sama di setiap eksekusi.
Kepatuhan Regulasi sebagai Warga Kelas Satu
Kebanyakan standar agent mengabaikan industri yang diatur regulasi. OpenGAP jelas dibangun dengan memikirkan mereka. Model pemisahan tugasnya memungkinkan kamu mendefinisikan peran seperti maker, checker, executor, dan auditor di `agent.yaml` dan `DUTIES.md`, menyatakan matriks konflik (maker tidak bisa menyetujui pekerjaannya sendiri), dan mewajibkan handoff multi-agent untuk tindakan kritis. Validator menangkap pelanggaran sebelum deployment, dan penegakannya bisa bersifat ketat atau sekadar peringatan.
Lapisan kepatuhannya memetakan regulasi keuangan sungguhan: FINRA Rule 3110 (supervisi), 4511 (pencatatan), dan 2210 (komunikasi), panduan Federal Reserve SR 11-7 tentang manajemen risiko model dan SR 23-4 tentang risiko pihak ketiga, Regulation S-P dari SEC tentang privasi nasabah, dan CFPB Circular 2022-03 tentang penjelasan adverse action. Menjalankan `opengap audit` menghasilkan laporan kepatuhan berdasarkan konfigurasi agent kamu. Desainnya mengakui inspirasi dari arsitektur agent Salient AI dan FINOS AI Governance Framework.
Tulis Sekali, Jalan di Mana Saja: 16 Adapter
Imbalan dari model berbasis file adalah portabilitas. CLI referensinya membawa 16 adapter yang dipakai untuk ekspor maupun menjalankan agent: system-prompt (prompt gabungan yang bekerja dengan LLM apa pun), Claude Code, OpenAI Agents SDK, CrewAI, Lyzr, GitHub Models, OpenCode, Google Gemini CLI, OpenClaw, Nanobot, Cursor, dan GitClaw, ditambah target khusus ekspor untuk GitHub Copilot, OpenAI Codex, dan Kiro, serta adapter eksekusi git-native untuk menjalankan agent langsung dari repo.
CLI-nya bekerja dua arah. `opengap import` mengubah agent yang sudah ada dari Claude, Cursor, CrewAI, dan OpenCode menjadi format OpenGAP. Agent juga bisa mewarisi agent induk yang di-host di repo git mana pun, atau menyatakan dependensi berversi pada agent lain yang dipasang sebagai sub-agent, sehingga tim bisa menyusun agent seperti menyusun library.
Coba dalam Lima Menit
Kamu membutuhkan Node.js 18 atau lebih baru dan git (GitHub, diakses 2026-10-22).
Instal CLI-nya secara global dengan npm: `npm i -g @open-gitagent/opengap`. Lalu buat agent baru dengan `opengap init --template standard` (template: minimal, standard, full, llm-wiki), periksa dengan `opengap validate`, lihat ringkasannya dengan `opengap info`, dan ekspor ke mana saja dengan perintah seperti `opengap export --format system-prompt`. Folder `examples/` di repo berisi agent minimal dua file, agent code review standar, dan agent kepatuhan production lengkap untuk dipelajari, plus contoh nyata yang memindahkan AIQ Deep Researcher dari NVIDIA, yang awalnya dibangun dari file konfigurasi dan kode Python, ke format yang portabel ini.
OpenGAP atau GitAgent? Klarifikasi yang Perlu
Nama-nama di sekitar proyek ini memang membingungkan, jadi ini petanya. Standar ini berawal dengan nama gitagent: dokumen spesifikasi di repositori ini masih berjudul "gitagent Specification v0.1.0". CLI-nya awalnya diterbitkan di npm sebagai `@open-gitagent/gitagent`, lalu berganti nama menjadi `@open-gitagent/gapman`, dan sekarang `@open-gitagent/opengap`. Perintah `gitagent` masih terpasang sebagai alias, jadi `opengap validate` maupun `gitagent validate` sama-sama bekerja.
Secara terpisah, organisasi yang sama (org open-gitagent, dipimpin kontributor dari Lyzr, termasuk pengguna GitHub shreyas-lyzr dan patel-lyzr) juga mengelola open-gitagent/gitagent, framework agent git-native yang berbeda dan aktif dikembangkan dengan 720 stars, yang dibangun di atas ide agent-sebagai-file yang sama. Ia adalah proyek saudara, bukan standarnya itu sendiri, dan README-nya tidak mendefinisikan OpenGAP. Artikel ini membahas standar dan CLI referensinya di repositori opengap, yang juga merupakan repositori yang ditampilkan di video RepoManiac yang tertaut di bawah.
Satu catatan jujur soal aktivitas: repositori opengap dibuat pada 2026-02-24 dan push terakhirnya pada 2026-07-02, di hari yang sama CLI versi 0.5.0 diterbitkan ke npm (GitHub API, diakses 2026-10-22). Standarnya saat ini stabil dan tidak bergerak cepat, sementara repo framework GitAgent saudaranya menerima commit lebih sering.
Cocok untuk Apa (dan Kurang Cocok untuk Apa)
OpenGAP cocok untuk tim yang mengelola agent di lebih dari satu framework, organisasi di industri yang diatur regulasi dan membutuhkan jejak audit serta pemisahan tugas, dan proyek open source yang ingin membagikan definisi agent yang bisa di-fork orang lain. Ia kurang cocok jika agent kamu hanya prompt sekali pakai di dalam satu aplikasi, di mana manifest, duties, dan file workflow menambah struktur melebihi kebutuhan kasusnya. Dan seperti standar muda lainnya, adapter hanya sebaik cakupannya terhadap setiap framework target, jadi uji dulu ekspor untuk stack kamu sebelum berkomitmen.
Pertanyaan yang Sering Diajukan
Apakah OpenGAP sama dengan GitAgent?
Tidak persis. OpenGAP adalah standar terbuka (Git Agent Protocol) beserta CLI referensinya, dikelola di repositori open-gitagent/opengap. Proyek ini berawal dengan nama gitagent, dan perintah `gitagent` bertahan sebagai alias CLI. Repositori terpisah, open-gitagent/gitagent, adalah framework agent yang berbeda dari organisasi yang sama.
Ke framework apa saja agent OpenGAP bisa diekspor?
CLI-nya mencantumkan 16 adapter, termasuk Claude Code, OpenAI Agents SDK, CrewAI, Cursor, Google Gemini CLI, OpenCode, OpenClaw, dan ekspor system-prompt universal yang bekerja dengan LLM apa pun.
Lisensi apa yang dipakai OpenGAP?
MIT. Standar, CLI, dan spesifikasinya sepenuhnya open source di github.com/open-gitagent/opengap (GitHub API, diakses 2026-10-22).
Berapa biaya OpenGAP?
Proyeknya sendiri gratis dan open source. Kamu tetap membayar provider LLM untuk panggilan model yang dilakukan agent kamu, sama seperti framework agent lainnya.
Sumber
Repositori GitHub: open-gitagent/opengap
Spesifikasi: spec/SPECIFICATION.md
GitHub API: data repo
Situs resmi: gitagent.sh
Proyek saudara: open-gitagent/gitagent
---
Tonton repo signal 30 detik yang memunculkan proyek ini, atau jelajahi lebih banyak repo signals untuk ringkasan video cepat tentang proyek open source yang sedang tren.
Baca artikel ini dalam Bahasa Inggris: OpenGAP: Turn Your Git Repo Into a Portable AI Agent.