Cluedoc: Skill agen untuk menulis dokumentasi yang membantu memahami codebase

Apakah Anda lelah dengan kode yang terus-menerus dihasilkan oleh coding agent? Lalu apakah Anda menyerah untuk memahami perangkat lunak Anda?

Ketika agent menulis kode, memahaminya menjadi hal yang paling penting. Anda tidak mengetik satu baris pun sendiri dan codebase terus berubah; jadi bagaimana Anda tahu apa sebenarnya yang dilakukan sistem, dan apakah perubahan berikutnya aman? Meski agent mengerjakan pekerjaan untuk Anda, untuk mengarahkan agent ke arah yang benar, Anda tetap membutuhkan pemahaman minimal tentang sistem yang sedang Anda bangun.

Karena itu kami membuat Cluedoc. Cluedoc adalah Agent Skill yang membuat coding agent menulis dokumen yang mudah dibaca manusia. Dokumen Cluedoc dibuat untuk dibaca. Dokumen ini mengesampingkan detail teknis dan berfokus pada konsep tingkat tinggi.

Cluedoc melihat sistem sebagai pohon fitur (feature), dan menulis satu dokumen (paper) untuk setiap fitur. Dokumen berada di dalam codebase sebagai Markdown murni dan selalu dijaga tetap mutakhir di dalam loop kerja. Tidak perlu server, dan tidak perlu database.

Landing page yang ditautkan itu sendiri adalah dokumen Cluedoc yang ditulis tentang Cluedoc. Ada juga contoh dokumen yang dibuat untuk Flask, Cobra, dan Commander, jadi silakan lihat.