project-context, skill agar agen menyimpan konteks proyek berbasis file

Saat membuat dan mengoperasikan proyek dengan agen,
sering kali muncul keinginan untuk terus menyimpan konteks pada tingkat proyek.
Dengan begitu, pada sesi berikutnya pun keadaan saat ini bisa dibaca dengan token yang lebih sedikit
dan pekerjaan lebih mudah dilanjutkan.

Setelah melewati beberapa proyek, saya terus mencoba mencari cara terbaik untuk menyimpan konteks ini,
dan akhirnya merapikannya ke arah meninggalkan status pekerjaan dan konteks referensi
dalam bentuk yang bisa dilihat bersama oleh manusia dan agen di dalam folder docs.
Agen mencatat sendiri hal-hal penting selama bekerja,
dan hal-hal yang berulang kali dibutuhkan bisa disimpan sebagai dokumen referensi untuk digunakan kembali.

Ini bukan pendekatan untuk mendokumentasikan proyek sepenuhnya
atau membangun knowledge base yang sangat besar.
Tujuannya adalah menjaga baseline konteks proyek
sebisa mungkin secara otomatis.

Awalnya saya juga mempertimbangkan struktur yang lebih rumit dan mengalami cukup banyak trial and error,
namun pada akhirnya agen bisa bekerja dengan cukup baik hanya dengan pencarian file,
sehingga bisa dirapikan menjadi struktur ringan berbasis file.

Setelah instalasi, cukup tuliskan di AGENTS.md agar skill ini digunakan,
dan saya juga menyertakan skill migrasi
yang bisa memindahkan konteks yang sudah dirapikan sebelumnya ke struktur project-context.

Silakan dicoba, dan saya akan berterima kasih jika Anda memberi masukan.

Instalasi: npx skills add perhapsspy/project-context

Skill ini adalah lanjutan dari $structure-first yang pernah saya unggah sebelumnya.
Jika dipakai bersama akan lebih baik, dan keduanya dibuat untuk meningkatkan baseline hasil kerja saat menggunakan agen.