Panduan Pembuat Materi

Pembuat materi tidak perlu menulis struktur project dari nol. Gunakan prompting dengan konteks agent Eduverse agar AI membantu memilih lokasi, format, sumber, dan validasi yang sesuai.

Sebelum Menulis

Baca AGENTS.md sebagai governance root.
Tentukan apakah materi termasuk university atau non-university.
Tentukan artifact: course, topic-series, standalone, atau reference.
Tentukan root content dan route yang akan digunakan.
Siapkan sumber yang dapat dilacak.

Untuk materi university, gunakan profil kurikulum TI dan course agent yang sesuai. Untuk materi non-university seperti library, framework, tool, atau dokumentasi, gunakan KNOWLEDGE_MATERIAL_AGENT tanpa menambahkan metadata akademik yang tidak diminta.

Sumber Materi

Dokumentasi library, framework, atau tool harus mengutamakan dokumentasi resmi.
Pencarian paper wajib menggunakan paper-search-mcp melalui ACADEMIC_SOURCE_AGENT.
Setiap PDF wajib dikonversi menjadi satu file Markdown Docling sebelum diekstraksi atau dipakai untuk drafting.
Simpan sumber asli sebagai referensi otoritatif dan Docling sebagai hasil ekstraksi yang dapat dibaca agent.
Jika evidence belum cukup, tandai materi sebagai Draft dan jelaskan keterbatasannya.

Prompt Yang Disarankan

Buat [jenis artifact] tentang [topik] untuk root [root tujuan].
Ikuti AGENTS.md dan pipeline agent Eduverse.
Gunakan [sumber resmi atau sumber lokal], gunakan paper-search-mcp jika membutuhkan paper,
dan konversi PDF dengan Docling sebelum membaca isinya.
Tulis dalam MDX dengan frontmatter title dan description.
Pastikan route, link internal, contoh, sumber, dan status Draft dapat diaudit.

Untuk materi university, tambahkan nama course, pertemuan, tujuan pembelajaran, dan instruksi agar AI membaca course agent serta profil kurikulum TI. Untuk artikel standalone, jangan menambahkan CPMK, SKS, semester, atau struktur 16 pertemuan tanpa dasar yang diminta.

Struktur Dan Penempatan

Simpan materi learner-facing di content/**. Gunakan pola berikut:

content/<root>/index.mdx
content/<root>/<section>/index.mdx

File index.mdx membuat route; meta.json hanya mengatur judul, urutan, dan navigasi. Jangan membuat link ke route yang belum memiliki file sumber.

Setiap halaman minimal memiliki frontmatter:

---
title: Judul Materi
description: Ringkasan singkat materi.
---

Validasi Sebelum Diterbitkan

Pastikan sumber dan klaim dapat dilacak.
Pastikan struktur sesuai tipe artifact.
Pastikan Coba Kita Pahami memiliki pertanyaan dan jawaban jika bagian tersebut digunakan.
Periksa link internal dan route bersih.
Jalankan pnpm run types:check setelah perubahan content.
Jalankan audit akademik untuk artifact university.
Jalankan pnpm exec fumadocs-mdx setelah perubahan struktur content.

Materi baru belum dianggap selesai hanya karena teks sudah tertulis. Materi harus berada di root yang benar, memiliki sumber yang jelas, lolos validasi, dan dapat ditemukan melalui navigasi.