Standar Artikel cerita.basim.id: Enak Dibaca Manusia, Jelas untuk Agent

Dokumen ini sengaja ditulis dengan dua lapisan: enak dibaca manusia, tetapi juga cukup terstruktur agar agent AI bisa mengambil konteks, aturan, dan langkah kerja tanpa menebak-nebak.

Awalnya cerita.basim.id bisa dipakai seperti tempat menyimpan tulisan. Tapi setelah workflow Basim mulai banyak dibantu agent — dari Telegram topic, ringkasan WhatsApp, draft konten, sampai publish artikel — kebutuhannya berubah. Artikel tidak cukup hanya “bagus dibaca”. Artikel juga harus cukup rapi supaya agent bisa memahami konteks, mengambil keputusan, dan melanjutkan pekerjaan tanpa Basim harus menjelaskan ulang dari nol.

Karena itu, standar artikel di cerita.basim.id perlu berada di tengah: tetap punya rasa cerita, tapi punya struktur operasional yang jelas.

Ringkasan cepat

cerita.basim.id bisa dipakai sebagai “rumah pengetahuan” untuk menyimpan cerita, tutorial, eksperimen, dan catatan pengembangan. Agar berguna untuk manusia dan agent, setiap artikel sebaiknya punya struktur yang konsisten: tujuan, konteks, langkah, keputusan teknis, batasan, dan next action.

Metadata artikel

• Tipe: tutorial / playbook
• Audience: manusia, agent AI, dan pengembang cerita.basim.id
• Status: versi awal yang sudah direvisi
• Fungsi: standar membuat artikel yang bisa dibaca manusia dan agent
• Digunakan untuk: drafting, publishing, revisi artikel, dokumentasi pengembangan, dan onboarding agent baru
• Prinsip utama: tulis untuk manusia terlebih dahulu, lalu beri struktur agar agent tidak perlu menebak

Target dokumen ini:

• Membantu manusia memahami cara menulis dan membaca catatan pengembangan.
• Membantu agent mengambil instruksi yang jelas dari artikel.
• Menjadi acuan awal untuk pengembangan berikutnya: fitur, workflow, editorial, dan integrasi AI.

Prinsip utama

Kalau cerita.basim.id hanya berisi tulisan bebas, manusia mungkin masih bisa memahami maksudnya. Tapi agent sering butuh struktur yang lebih eksplisit. Karena itu, setiap artikel penting sebaiknya menjawab lima pertanyaan:

1. Ini tentang apa?
2. Untuk siapa?
3. Apa langkah yang sudah dilakukan?
4. Apa keputusan atau aturan yang harus diikuti berikutnya?
5. Apa risiko, batasan, atau hal yang belum pasti?

Dengan format seperti ini, artikel tidak hanya menjadi konten publik, tetapi juga bisa menjadi memori operasional yang bisa dibaca ulang oleh agent.

Format artikel yang ramah manusia dan agent

Gunakan pola berikut untuk artikel tutorial, dokumentasi, atau catatan pengembangan.

1. Judul yang jelas

Judul jangan terlalu puitis kalau tujuannya dokumentasi. Judul yang baik menjelaskan isi dan manfaatnya.

Contoh:

• Baik: “Cara Membuat Artikel cerita.basim.id yang Bisa Dibaca Agent dan Manusia”
• Kurang jelas: “Catatan Hari Ini”

2. Ringkasan cepat

Bagian ringkasan membantu manusia memutuskan apakah artikel ini relevan. Untuk agent, bagian ini menjadi konteks awal sebelum membaca detail.

Isi ringkasan sebaiknya mencakup:

• masalah yang dibahas,
• hasil yang diharapkan,
• siapa pembacanya,
• status: ide, eksperimen, tutorial, atau keputusan final.

3. Konteks

Konteks menjelaskan latar belakang. Ini penting karena agent tidak selalu tahu sejarah percakapan sebelumnya.

Contoh konteks:

Artikel ini dibuat karena cerita.basim.id ingin berkembang dari sekadar tempat publikasi menjadi knowledge base ringan untuk manusia dan agent AI.

4. Langkah praktis

Untuk tutorial, tulis langkah berurutan. Jangan hanya menulis “setup API”, tapi jelaskan urutan aksi dan hasil yang diharapkan.

Contoh:

1. Tentukan topik artikel.
2. Buat slug yang stabil dan mudah dibaca.
3. Tulis markdown sebagai sumber utama.
4. Publish ke API admin.
5. Verifikasi URL publik.
6. Catat next action di akhir artikel.

5. Keputusan teknis

Kalau ada keputusan teknis, tulis secara eksplisit. Ini membantu agent tidak mengulang debat lama.

Contoh:

• Artikel disimpan dalam format markdown.
• Slug harus stabil dan tidak berubah-ubah.
• Artikel publik diverifikasi lewat URL yang benar.
• Secret atau token tidak boleh masuk ke artikel.

6. Batasan dan risiko

Bagian ini penting agar manusia dan agent tidak terlalu percaya diri.

Contoh risiko:

• Struktur artikel belum konsisten kalau tidak ada template.
• Agent bisa salah memahami artikel yang terlalu naratif tanpa poin aksi.
• API publish harus tetap dilindungi token.
• Perlu verifikasi publik setelah publish, bukan hanya percaya respons API.

7. Next action

Akhiri artikel dengan langkah berikutnya. Agent bisa memakai bagian ini sebagai daftar kerja lanjutan.

Contoh:

• Buat template artikel default.
• Tambahkan kategori seperti tutorial, eksperimen, strategi, dan changelog.
• Tambahkan halaman index untuk artikel penting.
• Buat standar metadata untuk agent.

Template artikel yang direkomendasikan

Berikut template sederhana yang bisa dipakai ulang. Contoh di bawah ini adalah template, bukan struktur aktual artikel ini. Jika agent melakukan parsing heading, treat bagian ini sebagai contoh format saja.

[JUDUL ARTIKEL]

[RINGKASAN CEPAT]

Satu sampai tiga paragraf tentang isi artikel, target pembaca, dan hasil yang diharapkan.

[KONTEKS]

Kenapa artikel ini dibuat? Apa latar belakangnya?

[TUJUAN]

- Tujuan 1
- Tujuan 2
- Tujuan 3

[LANGKAH]

1. Langkah pertama
2. Langkah kedua
3. Langkah ketiga

[KEPUTUSAN PENTING]

- Keputusan A
- Keputusan B

[CATATAN UNTUK AGENT]

- Gunakan informasi ini untuk ...
- Jangan lakukan ...
- Kalau ragu, verifikasi ...

[RISIKO DAN BATASAN]

- Risiko 1
- Risiko 2

[NEXT ACTION]

- [ ] Aksi berikutnya
- [ ] Aksi berikutnya

Metadata yang ramah agent

Selain isi artikel, metadata juga penting. Minimal gunakan:

• slug: alamat stabil artikel.
• title: judul manusiawi.
• description: ringkasan pendek.
• tags: kategori atau konteks.
• status: draft atau published.
• author: penulis atau pemilik konteks.
• source: asal artikel, misalnya admin-api.

Untuk artikel yang akan sering dibaca agent, tambahkan bagian “Catatan untuk agent”. Isinya harus jelas dan tidak ambigu.

Contoh:

## Catatan untuk agent

- Treat this article as public-facing documentation, not private memory.
- Jangan pernah menampilkan token, secret, credential, atau data internal di artikel.
- Kalau diminta update artikel dengan slug yang sama, gunakan endpoint update, bukan membuat duplikat.
- Setelah publish, verifikasi halaman publik sebelum menyatakan selesai.

Tips editorial untuk Basim

Agar artikel tetap terasa manusiawi, jangan membuat semua tulisan seperti dokumentasi kaku. Gunakan gaya cerita, tetapi tetap beri struktur.

Pola yang cocok:

1. Mulai dari kejadian nyata atau masalah.
2. Jelaskan kenapa ini penting.
3. Turunkan menjadi langkah praktis.
4. Tambahkan pelajaran atau insight.
5. Akhiri dengan next action.

Contoh pembuka:

Awalnya cerita.basim.id hanya dipakai untuk menyimpan catatan. Tapi semakin sering agent dipakai untuk membantu kerja, muncul kebutuhan baru: artikel harus bisa dibaca manusia dan juga dipahami agent.

Contoh yang lebih terasa “Basim”:

Dari luar, cerita.basim.id terlihat seperti website artikel biasa. Tapi buat workflow Basim, web ini bisa jadi ruang kerja kedua: tempat agent membaca konteks, manusia membaca cerita, dan keputusan lama tidak hilang di chat. Jadi setiap artikel perlu ditulis seperti catatan publik yang tetap punya instruksi kerja.

Dengan cara ini, artikel tetap punya rasa cerita, tapi tidak kehilangan fungsi sebagai dokumentasi.

Tips teknis untuk next pengembangan

1. Buat template bawaan di CMS

CMS sebaiknya punya tombol atau pilihan template, misalnya:

• Tutorial
• Catatan eksperimen
• Changelog
• Strategi bisnis
• Dokumentasi agent

Setiap template bisa otomatis membuat heading standar: Ringkasan, Konteks, Langkah, Risiko, Next action.

2. Tambahkan field agent_notes

Saat ini catatan agent bisa ditulis di body markdown. Ke depan, bisa dibuat field khusus seperti agent_notes agar agent lebih mudah mengambil instruksi operasional tanpa mengganggu pembaca manusia.

Contoh isi:

{
  "agent_notes": [
    "verify public URL after publishing",
    "do not expose secrets",
    "prefer updating existing slug over creating duplicates"
  ]
}

3. Tambahkan tipe konten

Supaya artikel tidak campur aduk, tambahkan tipe konten:

• story: cerita/refleksi,
• tutorial: panduan langkah,
• reference: dokumentasi teknis,
• changelog: catatan perubahan,
• playbook: prosedur kerja agent/manusia.

4. Tambahkan halaman index untuk agent

Buat satu halaman index seperti /agent-index atau artikel khusus “Index untuk Agent”. Isinya daftar artikel penting beserta fungsi masing-masing.

Contoh:

• Tutorial publish artikel: untuk membuat/update artikel.
• Standar editorial: untuk menjaga gaya tulisan.
• Roadmap pengembangan: untuk memahami prioritas.
• API notes: untuk integrasi teknis tanpa membocorkan secret.

5. Tambahkan checklist verifikasi

Setiap publish atau update artikel harus punya checklist:

• Apakah slug benar?
• Apakah status sudah published?
• Apakah URL publik bisa dibuka?
• Apakah artikel tidak mengandung token atau data private?
• Apakah bagian next action jelas?

Checklist sederhana seperti ini mengurangi risiko agent menyatakan “selesai” padahal halaman publik belum benar-benar terbit.

Link internal yang disarankan

Agar cerita.basim.id berkembang sebagai knowledge base, artikel tidak boleh berdiri sendiri. Setiap artikel penting sebaiknya punya link ke konteks terkait.

Untuk artikel ini, link internal yang relevan:

• Pembelajaran Hermes × Basim — catatan pengalaman operasional memakai Hermes bersama Basim.
• Index agent cerita.basim.id — belum dibuat; direkomendasikan menjadi artikel/index khusus untuk daftar dokumen penting.
• Roadmap pengembangan cerita.basim.id — bisa dibuat sebagai artikel terpisah jika arah produk mulai lebih jelas.

Roadmap ringan cerita.basim.id

Berikut urutan pengembangan yang paling masuk akal.

Tahap 1: Standarisasi konten

• Buat template artikel.
• Rapikan tag.
• Tentukan tipe konten.
• Biasakan selalu ada ringkasan dan next action.

Tahap 2: Membuat artikel lebih mudah ditemukan

• Tambahkan halaman index.
• Tambahkan pencarian.
• Tambahkan filter berdasarkan tag dan tipe konten.
• Buat artikel “start here” untuk pembaca baru.

Tahap 3: Agent-readability

• Tambahkan metadata yang konsisten.
• Tambahkan bagian catatan agent.
• Buat index khusus untuk agent.
• Buat aturan bahwa agent wajib verifikasi URL publik setelah publish.

Tahap 4: Workflow publishing

• Buat alur draft → review → publish.
• Simpan riwayat revisi.
• Tambahkan preview sebelum publish.
• Tambahkan proteksi agar slug penting tidak tertimpa sembarangan.

Tahap 5: Integrasi lebih lanjut

• Integrasi dengan Telegram topic untuk intake ide artikel.
• Integrasi dengan WhatsApp/Telegram summary.
• Integrasi dengan agent yang bisa membaca artikel sebagai knowledge base.
• Integrasi dengan analytics untuk melihat artikel mana yang paling berguna.

Contoh artikel pendek yang ideal

Contoh di bawah ini adalah contoh struktur, bukan heading aktual artikel ini.

[JUDUL]
Cara Memverifikasi Artikel Setelah Publish

[RINGKASAN CEPAT]
Artikel ini menjelaskan cara memastikan artikel yang baru dipublish benar-benar bisa dibuka oleh pembaca publik.

[KONTEKS]
Respons API sukses belum tentu berarti halaman publik sudah bisa dibaca. Karena itu, perlu verifikasi URL publik.

[LANGKAH]
1. Publish artikel lewat API admin.
2. Ambil slug dari respons.
3. Buka URL publik.
4. Pastikan status HTTP 200.
5. Pastikan isi artikel mengandung frasa unik dari versi terbaru.

[CATATAN UNTUK AGENT]
- Jangan menyatakan publish berhasil sebelum URL publik terverifikasi.
- Jika route dari API berbeda dengan route publik yang valid, laporkan route yang benar-benar berhasil.

[NEXT ACTION]
- Jadikan checklist ini bagian dari workflow publish semua artikel.

Catatan operasional untuk agent

Jika agent membaca artikel ini saat diminta membuat, mengaudit, atau memperbarui artikel di cerita.basim.id, gunakan aturan berikut:

1. Gunakan struktur dasar: Ringkasan, Konteks, Tujuan, Langkah, Keputusan, Risiko, dan Next action.
2. Tulis untuk manusia terlebih dahulu, lalu rapikan agar agent bisa mengambil instruksi kerja.
3. Jangan memasukkan token admin, credential, secret, isi chat private, atau data internal yang tidak diminta untuk publik.
4. Jika artikel adalah update, pertahankan slug lama kecuali Basim meminta slug baru.
5. Setelah publish atau update, verifikasi halaman publik dengan status HTTP 200 dan cek frasa unik dari isi terbaru.
6. Jika artikel berisi prosedur kerja, tambahkan bagian “Catatan operasional untuk agent”.
7. Jika ada bagian yang belum pasti, tulis sebagai asumsi atau pertanyaan terbuka, bukan fakta final.

Artikel ini bersifat publik dan boleh dibaca manusia maupun agent. Prioritaskan struktur yang konsisten dibanding tulisan yang terlalu bebas jika artikel akan dipakai sebagai rujukan operasional.

Kesimpulan

Next pengembangan cerita.basim.id sebaiknya tidak hanya mengejar fitur baru, tetapi juga memperbaiki cara pengetahuan disimpan. Kalau artikel ditulis dengan struktur yang jelas, manusia bisa membaca dengan nyaman dan agent bisa bekerja dengan lebih akurat.

Kuncinya sederhana: setiap cerita harus punya konteks, langkah, keputusan, risiko, dan next action. Dari situ, cerita.basim.id bisa berkembang menjadi tempat yang bukan hanya menyimpan tulisan, tetapi juga membantu kerja sehari-hari.