Lewati ke konten utama

Pengetahuan AI Coding Portabel dengan ARES

Ringkasan proyek ARES — CLI referensi untuk AI Repository Standard yang mengomposisi artefak spesifik provider dari sumber kanonis .ai/.

5 menit baca·Menengah·Konsep·18 Jul 2026
projectdeveloper toolsai coding

Pengetahuan AI Coding Portabel dengan ARES

Apa yang Dibangun​

ARES (AI Repository Standard) adalah CLI Go yang memungkinkan repositori mendefinisikan pengetahuan AI coding yang tahan lama sekali di .ai/, lalu menghasilkan file spesifik provider untuk Cursor, GitHub Copilot, Claude Code, OpenAI Codex, dan Antigravity. Aturan emas: hapus file provider yang dihasilkan, jalankan ars compose, dan semuanya ter-regenerasi dari .ai/.

Masalah​

Tim yang mengadopsi alat AI coding mengakumulasi pengetahuan terfragmentasi: aturan di .cursor/, instruksi di .github/copilot-instructions.md, CLAUDE.md, AGENTS.md — masing-masing drift secara independen. Berganti alat berarti menulis ulang pengetahuan. Tim multi-alat memelihara salinan duplikat dan tidak konsisten.

Ringkasan Arsitektur​

ARES adalah CLI lokal berbasis file — bukan runtime agen, workflow engine, atau web app.

Evolusi dan Milestone​

MilestoneYang dirilis
Spesifikasi ARS v1Format direktori .ai/ didefinisikan di SPEC.md
CLI intiars init, ars validate, ars compose, ars import
Compose multi-providerTarget Cursor, Copilot, Claude, Codex
Refactor skills (PR #7)Format dan validasi .ai/skills/ direstrukturisasi
Dukungan Antigravity (PR #8)Compose dan import untuk provider Antigravity
Binary releasemacOS, Linux, Windows via GitHub Releases

Keputusan Kunci​

KeputusanAlasan
.ai/ sebagai satu sumber kebenaranFile provider dihasilkan, tidak pernah dipelihara manual
Simetri import + composeTim bisa migrasi dari format provider yang ada
CLI lokal sajaTanpa server, tanpa database, tanpa runtime agen
ars validate di CITangkap drift struktural sebelum merge
Pertahankan AGENTS.md yang adaCompose Codex melewati overwrite jika file sudah ada

Format Repositori​

.ai/
  manifest.yaml                 metadata proyek
  instructions/<name>.md         instruksi seluruh repositori
  agents/<name>/AGENT.md         peran agen, tanggung jawab, batasan
  skills/<name>/SKILL.md         pengetahuan reusable
  prompts/<name>.md              template prompt reusable

Pelajaran yang Dipetik​

  1. Artefak yang dihasilkan bersifat disposable — jika Anda mengedit manual .cursor/rules/, perubahan hilang pada compose berikutnya. Edit .ai/ sebagai gantinya.
  2. Import sebelum compose saat migrasi — ars import cursor membawa aturan yang ada ke .ai/ tanpa menulis ulang dari awal.
  3. Validasi di CI — ars validate --json menangkap referensi rusak sebelum mencapai mesin setiap developer.
  4. Paritas provider adalah tujuan — satu pohon pengetahuan, banyak output alat.

Terkait​

Sumber​