Masalah klasik: masuk ke repo asing

Sejak AI masuk ke workflow harian, kantor saya mulai mendorong engineer untuk nggak terpaku pada satu role saja — backend engineer ikut pegang frontend, begitu juga sebaliknya.

Tapi ada satu kendala klasik yang selalu berulang: gimana caranya setup repo yang belum pernah kamu sentuh sama sekali? Apalagi kalau repo legacy dengan dependensi tricky, di mana cara menjalankannya cuma tersimpan di kepala segelintir orang.

Bagian onboarding ini biasanya paling boros waktu, karena ujung-ujungnya harus keliling nanya:

• "Ini pakai Node versi berapa ya?"
• "Service dependensinya butuh apa aja?"
• "Kalau pas jalan muncul error A, solusinya gimana?"

Jadikan skill, bukan sekadar dokumentasi pasif

Dari situ muncul ide: kenapa nggak sekalian bikin skill khusus per repo? Bukan dokumentasi setup biasa yang cuma dibaca manusia, melainkan instruksi terstruktur yang dirancang untuk dieksekusi langsung oleh AI agent. User tinggal instruksikan:

"Tolong setup repo <X> di port <X>"

Alurnya kira-kira begini:

1. Ekstrak pengetahuan dari engineer yang paling paham repo tersebut
2. Susun langkah setup-nya secara berurutan
3. Tambahkan instruksi kondisional untuk skenario umum
4. Pisahkan panduan troubleshooting ke file tersendiri
5. Minta agent membantu memformat instruksi tersebut menjadi skill standar

Format strukturnya

<repo-name>/
├── docs/
│   └── troubleshooting.md
├── SKILL.md
└── AGENTS.md

AGENTS.md — entrypoint utama yang dibaca pertama kali oleh agent.SKILL.md — langkah setup bertahap, lengkap dengan percabangan IF-ELSE untuk kondisi tertentu.docs/troubleshooting.md — daftar error umum, akar masalah, dan solusinya.

Apakah beneran jalan?

Dalam praktiknya, agent berhasil memanfaatkan skill ini buat men-setup repo dari nol sampai running di local machine. Yang menarik: model yang lebih ringan pun bisa mengeksekusi instruksi dengan lancar, asalkan panduan di skill-nya cukup presisi.

Kita juga bisa mengarahkan agent untuk pakai tool seperti "user-select question", sehingga ia memberikan opsi pilihan ke manusia ketimbang asal tebak. Contohnya saat instalasi:

1. localhost saja (localhost:3000)
2. sekalian setup local proxy domain (example.domain.local)

Ini bikin proses instalasi tetap fleksibel sesuai kebutuhan developer. Apakah ini sudah jadi industry best practice? Mungkin belum. Tapi sebagai eksperimen, hasilnya terbukti efektif.

Win terbesarnya: konteks setup yang tadinya cuma ada di kepala orang per orang sekarang jadi instruksi yang reusable. Engineer lain tinggal minta agent buat jalankan setup, review langkahnya, approve command yang butuh izin — lalu bisa langsung fokus ke task utamanya.

Di era di mana engineer dituntut makin fleksibel lintas role, pendekatan ini bikin proses adaptasi ke codebase baru jadi jauh lebih mulus tanpa buang-buang waktu.