Cara Kerja Sistem

Alur Halaman Learner

1. Browser meminta route seperti /knowledge/rekayasa-perangkat-lunak/pertemuan-1.
2. Next.js mencocokkan route catch-all pada app/(mdx)/[root]/[[...slug]]/page.tsx.
3. lib/source.ts mengambil halaman dari koleksi MDX Fumadocs.
4. Layout memilih tree navigasi berdasarkan root content dan menampilkan sidebar.
5. MDX dirender menjadi halaman dengan komponen yang terdaftar di mdx-components.tsx.

Alur Navigasi

Navbar homepage berada di app/(home)/layout.tsx. Course Menu membaca data learning path dari app/(home)/_data/, sedangkan Docs mengarah langsung ke /docs. Setelah masuk ke root MDX, sidebar dikendalikan oleh meta.json milik root tersebut.

Alur Agent Context

Root agent menentukan governance dan placement. Router menentukan artifact. Layer akademik mengatur sumber, output, dan audit. Course agent menambahkan konteks lokal seperti urutan pertemuan dan gaya RPL. Layer yang lebih rendah boleh memperjelas, tetapi tidak boleh mengubah routing repository atau aturan akademik yang lebih tinggi.

Sumber Dan Evidence

• PDF akademik wajib dikonversi dengan Docling sebelum digunakan untuk ekstraksi atau drafting.
• Satu PDF menghasilkan satu file Markdown di folder docling/ yang berdampingan dengan sumbernya.
• PDF asli tetap menjadi referensi otoritatif; Markdown Docling adalah bentuk kerja yang mudah dibaca agent.
• Pencarian paper atau bibliography wajib dimulai dari paper-search-mcp, lalu metadata dan klaim divalidasi melalui DOI, publisher, atau full text.
• LOG.md mencatat perubahan dan distribusi sumber, bukan aturan agent atau progres umum.

Validasi Sebelum Selesai

1. Pastikan file MDX berada di root yang benar.
2. Pastikan semua internal link mengarah ke route yang ada.
3. Jalankan pnpm exec fumadocs-mdx atau pnpm run types:check setelah perubahan content.
4. Jalankan pnpm run agents:check setelah perubahan agent.
5. Untuk artifact akademik, jalankan blocking audit dan jangan menghapus status Draft sebelum sumber serta output memenuhi aturan.