| Istilah | Arti |
|---|---|
| OpenWiki | CLI open source untuk membuat dan merawat dokumentasi repo yang ditujukan untuk dibaca agent AI, bukan manusia. |
| CLI | Command line interface, yaitu aplikasi yang dijalankan lewat perintah teks, dan OpenWiki termasuk jenis ini. |
| repo | Repositori kode tempat proyek dan riwayat perubahannya disimpan, dan dokumentasinya dibuat otomatis oleh OpenWiki. |
| docs | Dokumentasi berupa tulisan penjelas tentang kode, yang dalam talk ini dirancang agar mudah diambil potongannya oleh agent. |
| agents | Program AI yang bekerja sendiri membaca dan menulis kode, dan talk ini menyebut agent kini menulis sebagian besar kode. |
| change log | Berkas log.md yang mencatat apa saja yang berubah pada wiki di setiap pembaruan, sehingga mudah ditinjau manusia. |
| git history | Riwayat perubahan kode di Git, yang juga dibaca OpenWiki agar memahami bagaimana proyek berkembang dari waktu ke waktu. |
| wiki | Kumpulan berkas markdown yang saling terhubung dengan struktur tertentu, yang dibuat OpenWiki dari kode sebuah repo. |
| diagrams | Gambar alur seperti diagram sekuens, state, atau flowchart yang ditambahkan agar manusia lebih mudah memahami dokumen. |
| GitHub action | Otomatisasi di GitHub yang dijalankan terjadwal setiap hari untuk memperbarui wiki dan membuka pull request. |
| npm | Package manager untuk JavaScript yang dipakai untuk memasang OpenWiki dengan satu perintah npm install. |
| commit messages | Pesan yang ditulis developer saat menyimpan perubahan di Git, yang dibaca OpenWiki untuk memahami alasan perubahan kode. |
Talk dari kanal LangChain ini memperkenalkan OpenWiki, sebuah CLI open source yang membuat dan merawat dokumentasi repo khusus untuk dibaca agent AI, bukan manusia. Pembicara menjelaskan alasannya: tahun lalu tema besarnya adalah OpenClaw, dan tahun ini menurut CEO mereka, Harrison, tema berikutnya adalah general purpose memory. Tim memulai dari dokumentasi kode karena area ini cukup terdefinisi untuk dikerjakan lebih dulu. Ada tiga tesis utama: dokumentasi harus ditulis untuk agent, pemasangannya harus sangat mudah lewat satu perintah CLI dan npm, dan wiki harus memperbarui diri secara otomatis tanpa kerja tambahan dari developer. Pembicara juga menjelaskan bahwa agent biasanya mengambil potongan dokumen, sehingga setiap konsep harus mandiri, heading harus presisi, dan isinya harus muat dalam context window.
Isi wiki berupa berkas markdown dengan quickstart.md sebagai titik awal, folder yang dibuat sesuai kebutuhan agent, index di setiap folder, dan log.md sebagai change log. Setiap berkas diberi front matter OKF, format terbuka dari Google, yang berisi type, title, description, resource, tags, dan timestamp, sehingga memudahkan filter dan tautan antar dokumen. Perintah init menjalankan wizard untuk API key, model, dan instruksi, lalu menulis GitHub Action harian serta menambahkan konteks ke AGENTS.md atau CLAUDE.md. Perintah update hanya berjalan jika ada commit baru, lalu membaca riwayat Git termasuk commit message dan membuka pull request. Dalam uji awal pada 20 tugas DeepSWE, jumlah tugas berhasil naik dari sekitar 7 atau 8 menjadi 9 atau 10, sementara konsumsi token turun cukup signifikan. Masukan pengguna juga membuat tim menambahkan diagram agar manusia lebih mudah membaca dokumen. Rencana berikutnya adalah prompting yang lebih baik dan tool pencarian khusus untuk wiki.
Kata kunci
- OpenWiki
- CLI
- change log
- git history
- Mengenal OpenWiki, CLI untuk membuat dan merawat dokumentasi repo yang ditulis khusus agar dikonsumsi agen AI.
- Memahami prinsipnya: setiap konsep berdiri sendiri karena agen mengambil potongan, serta memakai git history dan commit messages untuk melacak perubahan lewat change log.
- Melihat bahwa manusia ternyata ikut membaca wiki ini, lalu memasangnya lewat npm di repo sendiri.
Tulis catatan pribadimu untuk video ini. Catatan tersimpan di akunmu dan bisa dibuka dari perangkat mana pun.