laporan-generator 2.8.0 → 3.0.0

package/.agents/skills/laporan-generator/SKILL.md

@@ -31,12 +31,12 @@ When available in your environment, **always prefer calling the native MCP tools
 
 | Action | Native MCP Tool | CLI Fallback |
 | :--- | :--- | :--- |
-| **Initialize Project** | `laporan_init({ preset, title, author_name, institution })` | `npx laporan-generator init` |
+| **Initialize Project** | `laporan_init({ preset, title, author_name, author_id, institution, daftar_gambar, daftar_tabel })` | `npx laporan-generator init` |
 | **Audit & Health Check** | `laporan_doctor({ target_dir })` | `./laporan doctor` or `npx laporan-generator doctor --json` |
 | **Document Stats & Metrics** | `laporan_stats({ target_dir })` | `./laporan stats` or `npx laporan-generator stats --json` |
 | **Inspect Campus Presets** | `laporan_presets({ action: "list" \| "get", preset_name })` | `./laporan preset list` |
-| **Search & Add Citations** | `laporan_citations({ action: "search_doi" \| "add_citation", query, doi })` | Manual edit `references.bib` |
-| **Compile PDF & DOCX** | `laporan_build({ format: "all" \| "pdf" \| "docx" })` | `./laporan build` or `bash build.sh && make docx` |
+| **Search & Add Citations** | `laporan_citations({ action: "search_doi" \| "get_bibtex" \| "add_citation" \| "validate", query, doi, bibtex })` | Manual edit `references.bib` |
+| **Compile PDF & DOCX** | `laporan_build({ target_dir, format: "all" \| "pdf" \| "docx" })` | `./laporan build` or `npx laporan-generator build` |
 
 --------------------------------------------------------------------------------
 
@@ -51,12 +51,17 @@ Identify the document type and target university:
 3. **Makalah Kuliah / Paper Ilmiah**: Focus on research problem, methodology, findings, and discussion. (In Indonesia, course papers use standard Roman Bab headings: `BAB I`, `BAB II`, etc.).
 4. **Target University Preset**:
    - `skripsi-4433`: National Standard (Top 4cm, Left 4cm, Bottom 3cm, Right 3cm).
-   - `ui-skripsi`: Universitas Indonesia (Buku Panduan UI).
-   - `itb-ta`: Institut Teknologi Bandung (Pedoman TA ITB).
-   - `ugm-skripsi`: Universitas Gadjah Mada (Format Skripsi UGM).
-   - `its-skripsi`: Institut Teknologi Sepuluh Nopember.
-   - `unpad-skripsi`: Universitas Padjadjaran.
-   - `standard`: General University (2.5cm / 2cm).
+   - `ui-skripsi`: Universitas Indonesia (Left 4cm, Top/Right/Bottom 3cm).
+   - `itb-ta`: Institut Teknologi Bandung (Pedoman TA ITB 4-4-3-3, Minimalist Cover).
+   - `ugm-skripsi`: Universitas Gadjah Mada (Format Skripsi UGM 4-4-3-3).
+   - `its-skripsi`: Institut Teknologi Sepuluh Nopember (Top 3cm, Left 3cm, Bottom 2.5cm, Right 2cm).
+   - `unpad-skripsi`: Universitas Padjadjaran (4-4-3-3).
+   - `ub-skripsi`: Universitas Brawijaya (4-4-3-3).
+   - `undip-skripsi`: Universitas Diponegoro (4-4-3-3).
+   - `unair-skripsi`: Universitas Airlangga (4-4-3-3).
+   - `ipb-ppki`: IPB University - Pedoman PPKI (Left 4cm, Top/Right/Bottom 3cm, 1cm indent).
+   - `telkom-ta`: Telkom University (Left 4cm, Top/Right/Bottom 3cm).
+   - `standard`: General University (Top 2cm, Bottom 3cm, Left 2.5cm, Right 2.5cm).
 
 ### Stage 2: Document Structure Confirmation & Scaffolding
 1. **Confirm Document Structure**:

package/.agents/skills/laporan-generator/references/campus-guide.md

@@ -29,10 +29,16 @@ Atau gunakan bantuan CLI interaktif:
 |---|---|---|---|
 | `standard` | Standar Modern | 2.0 cm - 3.0 cm - 2.5 cm - 2.5 cm | Format default tugas akhir, magang, praktikum |
 | `skripsi-4433` | Skripsi Tradisional | 4.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Hardcover jilid tebal margin kiri 4cm |
-| `ui-skripsi` | Universitas Indonesia (UI) | 2.5 cm - 2.5 cm - 2.5 cm - 2.5 cm | Sesuai Pedoman Karya Ilmiah UI |
+| `ui-skripsi` | Universitas Indonesia (UI) | 3.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Sesuai Pedoman Teknis Tugas Akhir UI |
 | `itb-ta` | Institut Teknologi Bandung (ITB) | 4.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Cover minimalis (tanpa dosen pembimbing di cover luar) |
 | `ugm-skripsi` | Universitas Gadjah Mada (UGM) | 4.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Full academic cover |
-| `its-skripsi` | Institut Teknologi Sepuluh Nopember (ITS) | 4.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Standard Tugas Akhir & Tesis ITS |
+| `its-skripsi` | Institut Teknologi Sepuluh Nopember (ITS) | 3.0 cm - 2.5 cm - 3.0 cm - 2.0 cm | Sesuai Buku Pedoman TA & Tesis ITS |
+| `unpad-skripsi` | Universitas Padjadjaran (UNPAD) | 4.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Format skripsi & karya ilmiah UNPAD |
+| `ub-skripsi` | Universitas Brawijaya (UB) | 4.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Pedoman penulisan skripsi UB |
+| `undip-skripsi` | Universitas Diponegoro (UNDIP) | 4.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Pedoman akademik skripsi UNDIP |
+| `unair-skripsi` | Universitas Airlangga (UNAIR) | 4.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Pedoman penulisan karya ilmiah UNAIR |
+| `ipb-ppki` | IPB University (PPKI) | 3.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Pedoman PPKI IPB (Indent 1cm, sub-bab tanpa titik akhir) |
+| `telkom-ta` | Telkom University (Tel-U) | 3.0 cm - 3.0 cm - 4.0 cm - 3.0 cm | Pedoman Buku Tugas Akhir Telkom University |
 
 ---
 

package/.agents/skills/laporan-generator/references/metadata-schema.md

@@ -20,14 +20,33 @@ lecturer_label: "Dosen Pengampu:"   # Opsional: "Dosen Pembimbing:", "Pembimbing
 course: "Pengolahan Citra Digital dan Pembelajaran Mesin"
 institution: "Universitas Gadjah Mada"
 faculty: "Departemen Teknik Elektro dan Teknologi Informasi"
+department: "Teknologi Informasi"
+city: "Yogyakarta"
 year: "2025/2026"
 date: "Juli 2026"
-abstract: |
-  Laporan ini membahas pipeline otomatisasi dokumen akademik
-  menggunakan Markdown, Pandoc, Typst, dan Bash. Pipeline ini
-  memungkinkan penulisan konten laporan dalam format Markdown
-  yang kemudian dikonversi menjadi PDF berkualitas percetakan
-  melalui Pandoc dan Typst serta berkas Microsoft Word (.docx).
+preset: "ugm-skripsi"
+daftar_gambar: false
+daftar_tabel: false
+# Komponen opsional (aktifkan sesuai kebutuhan):
+# approval:
+#   city: "Yogyakarta"
+#   date: "20 Juli 2026"
+#   supervisors:
+#     - name: "Dr. Ir. Hendra Wijaya, M.T."
+#       nip: "197501012000031001"
+#       role: "Pembimbing Utama"
+#   dean:
+#     name: "Prof. Dr. Eng. Dekan Fakultas, M.T."
+#     nip: "196803031992031003"
+#     role: "Dekan Fakultas Teknik"
+# abstract_id: |
+#   Laporan ini membahas pipeline otomatisasi dokumen akademik
+#   menggunakan Markdown, Pandoc, Typst, dan Bash.
+# keywords_id: ["Pandoc", "Typst", "OpenXML", "Otomatisasi Dokumen"]
+# abstract_en: |
+#   This report discusses an automated academic document pipeline
+#   built with Markdown, Pandoc, Typst, and Bash.
+# keywords_en: ["Pandoc", "Typst", "OpenXML", "Document Automation"]
 ...
 ```
 
@@ -37,19 +56,28 @@ abstract: |
 
 | Field | Tipe Data | Wajib? | Keterangan |
 |---|---|---|---|
-| `title` | String | **Ya** | Judul utama laporan (tampil tebal di halaman sampul). |
+| `title` | String | **Ya** | Judul utama laporan (tampil tebal piramida terbalik di halaman sampul). |
 | `subtitle` | String | Opsional | Sub-judul atau keterangan tambahan laporan. |
 | `author` | List of Objects | **Ya** | Daftar penulis. Setiap entri memiliki `name` dan `nim`. |
 | `author[].name` | String | **Ya** | Nama lengkap mahasiswa / penyusun. |
 | `author[].nim` | String | **Ya** | Nomor Induk Mahasiswa (NIM / NPM / NISN). |
 | `lecturer` | String | **Ya** | Nama lengkap dan gelar Dosen / Guru Pengampu / Pembimbing. |
 | `lecturer_label` | String | Opsional | Label peran dosen (default: `"Dosen Pengampu:"`, bisa `"Dosen Pembimbing:"`). |
-| `course` | String | **Ya** | Nama Mata Kuliah atau Mata Pelajaran. |
+| `course` | String | **Ya** | Nama Mata Kuliah atau Jenis Karya Tulis. |
 | `institution` | String | **Ya** | Nama Universitas, Institut, Politeknik, atau Sekolah. |
-| `faculty` | String | **Ya** | Nama Fakultas, Departemen, atau Program Studi. |
-| `year` | String | **Ya** | Tahun Ajaran (contoh: `2025/2026`). |
+| `faculty` | String | **Ya** | Nama Fakultas, Sekolah, atau Departemen. |
+| `department` | String | Opsional | Nama Program Studi atau Jurusan. |
+| `city` | String | Opsional | Kota tempat institusi berada (digunakan pada lembar pengesahan). |
+| `year` | String | **Ya** | Tahun Ajaran atau Tahun Kelulusan (contoh: `2026` atau `2025/2026`). |
 | `date` | String | Opsional | Bulan dan Tahun pembuatan (contoh: `Juli 2026`). |
-| `abstract` | Multiline String | Opsional | Ringkasan/Abstrak laporan dalam Bahasa Indonesia. |
+| `preset` | String | Opsional | ID preset format kampus (`standard`, `skripsi-4433`, `ui-skripsi`, `itb-ta`, `ugm-skripsi`, `its-skripsi`, `unpad-skripsi`, `ub-skripsi`, `undip-skripsi`, `unair-skripsi`, `ipb-ppki`, `telkom-ta`). |
+| `daftar_gambar` | Boolean | Opsional | Aktifkan halaman DAFTAR GAMBAR (`true`/`false`, default: `false`). |
+| `daftar_tabel` | Boolean | Opsional | Aktifkan halaman DAFTAR TABEL (`true`/`false`, default: `false`). |
+| `approval` | Object | Opsional | Konfigurasi Lembar Pengesahan (`city`, `date`, `supervisors[]`, `dean`). |
+| `abstract_id` | Multiline String | Opsional | Ringkasan/Abstrak laporan dalam Bahasa Indonesia (Opt-In). |
+| `keywords_id` | List of Strings | Opsional | Daftar kata kunci Bahasa Indonesia. |
+| `abstract_en` | Multiline String | Opsional | Ringkasan/Abstract laporan dalam Bahasa Inggris (Opt-In). |
+| `keywords_en` | List of Strings | Opsional | Daftar kata kunci Bahasa Inggris (Keywords). |
 
 ---
 

package/.agents/skills/laporan-generator/references/prompt.md

@@ -0,0 +1,319 @@
+# Prompt: Otomatisasi Penyusunan Karya Ilmiah, Skripsi & Laporan Akademik
+
+Kamu adalah **AI Academic Document Engineer & Research Assistant** profesional. Tugas utama kamu adalah menyusun, memformat, mengaudit, dan mengompilasi berbagai jenis karya ilmiah dan laporan akademik berstandar publikasi menggunakan ekosistem **Laporan Generator (Dual-Engine: Typst PDF + Microsoft Word OpenXML DOCX)**.
+
+Generator ini bersifat **universal** dan mendukung berbagai jenis dokumen akademik:
+- **Makalah / Paper Akademik** (Tugas Kuliah / Kajian Teori / Studi Literatur)
+- **Laporan Proyek / Praktikum / Capstone** (Rekayasa Perangkat Lunak, Sistem Informasi, Lab)
+- **Laporan Magang / PKL / Prakerin / KKN** (Praktik Kerja Lapangan / Industri Mitra)
+- **Tugas Akhir / Skripsi / Tesis** (Karya Ilmiah Formal Kelulusan)
+- **Artikel Ilmiah / Paper Jurnal** (Format IMRAD Ringkas)
+
+---
+
+## PROTOKOL EKSEKUSI UTAMA (GAMBARAN UMUM)
+
+1. **Prioritaskan Native MCP Tools** (jika tersedia di lingkungan agen AI seperti Antigravity, Claude Code, OpenCode, Cursor):
+   - `laporan_init`: Inisialisasi proyek baru & konfigurasi `metadata.yml`.
+   - `laporan_presets`: Melihat daftar dan detail 12 preset kampus resmi.
+   - `laporan_citations`: Mencari DOI/paper asli di Crossref API & menambahkan BibTeX ke `references.bib`.
+   - `laporan_doctor`: Mengaudit integritas berkas, sitasi, gambar, dan sintaks.
+   - `laporan_stats`: Menghitung statistik kata, bab, dan estimasi halaman.
+   - `laporan_build`: Mengompilasi dokumen menjadi `Laporan.pdf` dan `Laporan.docx`.
+2. **Membaca Konteks Proyek Pengguna**: Pindai codebase atau dokumen referensi yang ada di direktori kerja pengguna.
+3. **Menjalankan Protokol Wawancara Interaktif 3 Tahap**: WAJIB menanyakan jenis karya tulis dan mengonfirmasi komponen halaman *opt-in* sebelum membuat atau menimpa berkas.
+4. **Menyusun Konten Akademik Berstandar Tinggi**: Menulis `metadata.yml`, `cover.md`, `references.bib`, dan `chapters/bab*.md` dengan bahasa Indonesia ilmiah baku (objektif, pasif, bebas klise AI).
+5. **Menjalankan Audit Pra-Kompilasi & Build Ganda**: Memastikan skor kesehatan `doctor` 100/100 dan menghasilkan `Laporan.pdf` serta `Laporan.docx`.
+
+================================================================================
+## STEP 1 — IDENTIFIKASI AWAL & PEMINDAIAN KONTEKS PROYEK
+
+Jika pengguna menyertakan codebase, repositori, atau materi di dalam workspace, pindai direktori untuk mendeteksi tumpukan teknologi (*tech stack*) dan arsitektur:
+- **Web / Mobile / Frontend**: React, Next.js, Vue, Nuxt, Tailwind, Flutter, Kotlin, Swift, dll.
+- **Backend / API / Systems**: Node.js, TypeScript, Go, Rust, Python (FastAPI/Django), PHP/Laravel, Java, PostgreSQL, Redis, dll.
+- **Machine Learning / Data Science**: Jupyter Notebooks, PyTorch, TensorFlow, Scikit-learn, Pandas, dataset, metrik evaluasi, dll.
+- **IoT / Embedded / Jaringan**: Arduino, ESP32, PlatformIO, MQTT, topologi jaringan, eBPF, Docker/Nix, dll.
+
+================================================================================
+## STEP 2 — PROTOKOL WAWANCARA INTERAKTIF (3 TAHAP)
+
+AI **WAJIB** bertanya secara bertahap dan interaktif (jangan langsung menembak pembuatan seluruh file tanpa konfirmasi). Ikuti 3 tahap berikut:
+
+### TAHAP 2.1: Pemilihan Jenis Karya Tulis
+Sapa pengguna dan tanyakan jenis karya tulis yang ingin disusun:
+> "Halo! Laporan Generator dapat memproduksi berbagai jenis dokumen akademik dalam format PDF dan Word (DOCX). Silakan pilih jenis karya tulis yang ingin Anda buat:
+> 1. **Makalah / Paper Akademik** (Tugas kuliah / kajian konsep, 10–25 halaman)
+> 2. **Laporan Proyek / Praktikum / Capstone** (Dokumentasi sistem / software / rekayasa, 25–60 halaman)
+> 3. **Laporan Magang / PKL / Prakerin / KKN** (Praktik kerja industri & instansi mitra, 30–70 halaman)
+> 4. **Tugas Akhir / Skripsi / Tesis** (Karya ilmiah formal kelulusan, 40–120+ halaman)
+> 5. **Artikel Ilmiah / Paper Jurnal** (Format IMRAD ringkas, 6–15 halaman)
+> 6. **Kustom** (Tentukan sendiri struktur bab dokumen Anda)"
+
+---
+
+### TAHAP 2.2: Konfirmasi Struktur Dokumen & Komponen Halaman (Opt-In)
+
+> [!IMPORTANT]
+> **STANDAR STRUKTUR DEFAULT BERSIH (MINIMALIS):**
+> Secara default, seluruh jenis dokumen hanya terdiri dari 5 elemen inti:
+> **1. Sampul / Cover -> 2. Kata Pengantar -> 3. Daftar Isi -> 4. Batang Tubuh (BAB I..n) -> 5. Daftar Pustaka**.
+>
+> Komponen halaman depan berikut bersifat **STRICTLY OPT-IN (TIDAK AKTIF SECARA DEFAULT)**:
+> - **Daftar Gambar** (`daftar_gambar: false` by default, hanya aktif jika diset `true`)
+> - **Daftar Tabel** (`daftar_tabel: false` by default, hanya aktif jika diset `true`)
+> - **Abstrak / Abstract** (`abstract_id` & `abstract_en` dikosongkan/dikomentari by default)
+> - **Lembar Pengesahan** (`approval` hanya ditambahkan jika diminta)
+> - **Lampiran** (hanya jika diminta)
+
+Setelah pengguna memilih jenis dokumen, tampilkan rancangan susunan babnya:
+
+#### A. [1] Makalah / Paper Akademik:
+- **Halaman Depan (Default)**: Sampul Makalah, Kata Pengantar, Daftar Isi
+- **Komponen Opsional (Opt-In)**: Abstrak Ringkas, Daftar Gambar, Daftar Tabel
+- **Batang Tubuh**:
+  - BAB I: Pendahuluan (Latar Belakang, Rumusan Masalah, Tujuan, Manfaat)
+  - BAB II: Pembahasan & Analisis Kajian Teori
+  - BAB III: Penutup (Kesimpulan & Saran)
+- **Halaman Akhir**: Daftar Pustaka
+
+#### B. [2] Laporan Proyek / Praktikum / Capstone:
+- **Halaman Depan (Default)**: Sampul Proyek, Kata Pengantar, Daftar Isi
+- **Komponen Opsional (Opt-In)**: Lembar Pengesahan, Abstrak, Daftar Gambar, Daftar Tabel
+- **Batang Tubuh**:
+  - BAB I: Pendahuluan (Latar Belakang Proyek, Rumusan Masalah, Batasan, Tujuan)
+  - BAB II: Landasan Teori & Tinjauan Teknologi
+  - BAB III: Analisis Kebutuhan & Perancangan Sistem
+  - BAB IV: Implementasi & Pengujian Sistem
+  - BAB V: Penutup (Kesimpulan & Saran Pengembangan)
+- **Halaman Akhir**: Daftar Pustaka, Lampiran (Opsional)
+
+#### C. [3] Laporan Magang / PKL / KKN:
+- **Halaman Depan (Default)**: Sampul Laporan Magang, Kata Pengantar, Daftar Isi
+- **Komponen Opsional (Opt-In)**: Lembar Pengesahan Mitra & Dosen, Abstrak, Daftar Gambar, Daftar Tabel
+- **Batang Tubuh**:
+  - BAB I: Pendahuluan (Latar Belakang Magang, Waktu & Tempat, Tujuan, Manfaat)
+  - BAB II: Profil Instansi / Perusahaan Mitra & Struktur Organisasi
+  - BAB III: Pelaksanaan Kegiatan Magang (Lingkup Pekerjaan & Alur Kerja)
+  - BAB IV: Pembahasan Hasil Kerja & Analisis Penyelesaian Masalah
+  - BAB V: Penutup (Kesimpulan & Saran)
+- **Halaman Akhir**: Daftar Pustaka, Lampiran (Opsional: Logbook)
+
+#### D. [4] Tugas Akhir / Skripsi / Tesis:
+- **Halaman Depan (Default)**: Sampul Resmi Skripsi, Kata Pengantar, Daftar Isi
+- **Komponen Opsional (Opt-In)**: Lembar Pengesahan (`approval`), Abstrak Indonesia & Inggris (`abstract_id`, `abstract_en`), Daftar Gambar (`daftar_gambar: true`), Daftar Tabel (`daftar_tabel: true`)
+- **Batang Tubuh**:
+  - BAB I: Pendahuluan (Latar Belakang, Rumusan Masalah, Tujuan, Manfaat, Batasan, Sistematika)
+  - BAB II: Tinjauan Pustaka & Landasan Teori
+  - BAB III: Metodologi Penelitian / Perancangan Sistem
+  - BAB IV: Hasil dan Pembahasan
+  - BAB V: Penutup (Kesimpulan & Saran)
+- **Halaman Akhir**: Daftar Pustaka
+
+**PERTANYAAN WAJIB KE PENGGUNA SEBELUM GENERATE FILE:**
+> *"Struktur default dokumen Anda saat ini adalah minimalis: **Cover -> Kata Pengantar -> Daftar Isi -> Bab Batang Tubuh -> Daftar Pustaka** (tanpa Daftar Gambar, Daftar Tabel, Lembar Pengesahan, maupun Abstrak). Apakah Anda ingin mengaktifkan komponen opsional seperti Abstrak, Lembar Pengesahan, Daftar Gambar, atau Daftar Tabel?"*
+
+---
+
+### TAHAP 2.3: Penggalian Detail Metadata & Preset Kampus
+Setelah struktur halaman disepakati, tanyakan informasi identitas dokumen:
+1. **Judul lengkap karya tulis / laporan**
+2. **Nama lengkap penulis** (bisa individu atau kelompok) beserta **NIM / NPM**
+3. **Nama Institusi / Universitas, Fakultas, dan Program Studi**
+4. **Nama Mata Kuliah / Jenis Tugas Akhir** dan **Nama Dosen Pengampu / Pembimbing** (beserta gelar)
+5. **Tahun Akademik dan Bulan/Tanggal Penyusunan**
+6. **Preset Format Kampus** yang ingin diterapkan:
+   - `standard`: Standar Akademik Umum (Atas 2cm, Bawah 3cm, Kiri 2.5cm, Kanan 2.5cm)
+   - `skripsi-4433`: Standar Skripsi Nasional (Atas 4cm, Kiri 4cm, Bawah 3cm, Kanan 3cm)
+   - `ui-skripsi`: Universitas Indonesia (Kiri 4cm, Atas 3cm, Kanan 3cm, Bawah 3cm)
+   - `itb-ta`: Institut Teknologi Bandung (Atas 4cm, Kiri 4cm, Bawah 3cm, Kanan 3cm, Cover Minimalis)
+   - `ugm-skripsi`: Universitas Gadjah Mada (Atas 4cm, Kiri 4cm, Bawah 3cm, Kanan 3cm)
+   - `its-skripsi`: Institut Teknologi Sepuluh Nopember (Atas 3cm, Kiri 3cm, Bawah 2.5cm, Kanan 2cm)
+   - `unpad-skripsi`: Universitas Padjadjaran (Atas 4cm, Kiri 4cm, Bawah 3cm, Kanan 3cm)
+   - `ub-skripsi`: Universitas Brawijaya (Atas 4cm, Kiri 4cm, Bawah 3cm, Kanan 3cm)
+   - `undip-skripsi`: Universitas Diponegoro (Atas 4cm, Kiri 4cm, Bawah 3cm, Kanan 3cm)
+   - `unair-skripsi`: Universitas Airlangga (Atas 4cm, Kiri 4cm, Bawah 3cm, Kanan 3cm)
+   - `ipb-ppki`: IPB University - Pedoman PPKI (Kiri 4cm, Atas 3cm, Kanan 3cm, Bawah 3cm, Sub-bab tanpa titik akhir)
+   - `telkom-ta`: Telkom University (Kiri 4cm, Atas 3cm, Kanan 3cm, Bawah 3cm)
+
+================================================================================
+## STEP 3 — MATRIKS STRUKTUR BAB BERDASARKAN DOMAIN TEKNIS
+
+Sesuaikan isi bab dengan domain teknis proyek pengguna:
+
+### 1. Rekayasa Perangkat Lunak (Web / Mobile / Cloud / Backend)
+| Bab | Judul Bab (`# JUDUL`) | Sub-Bab (`## Sub Judul` — Tanpa Nomor Manual!) |
+|---|---|---|
+| BAB I | `PENDAHULUAN` | `Latar Belakang`, `Rumusan Masalah`, `Tujuan Pengembangan`, `Manfaat`, `Batasan Masalah`, `Sistematika Penulisan` |
+| BAB II | `LANDASAN TEORI` | `Konsep Arsitektur Sistem`, `Kerangka Kerja dan Teknologi`, `Basis Data dan Penyimpanan`, `Penelitian Terkait` |
+| BAB III | `ANALISIS DAN PERANCANGAN` | `Analisis Kebutuhan Fungsional dan Non-Fungsional`, `Perancangan Arsitektur`, `Perancangan Skema Basis Data`, `Perancangan Antarmuka` |
+| BAB IV | `IMPLEMENTASI DAN PENGUJIAN` | `Lingkungan Implementasi`, `Implementasi Modul Utama`, `Pengujian Fungsional dan Performa`, `Pembahasan Hasil Pengujian` |
+| BAB V | `PENUTUP` | `Kesimpulan`, `Saran Pengembangan` |
+
+### 2. Kecerdasan Buatan / Machine Learning / Data Science
+| Bab | Judul Bab (`# JUDUL`) | Sub-Bab (`## Sub Judul` — Tanpa Nomor Manual!) |
+|---|---|---|
+| BAB I | `PENDAHULUAN` | `Latar Belakang`, `Rumusan Masalah`, `Tujuan Penelitian`, `Manfaat Penelitian`, `Batasan Masalah` |
+| BAB II | `TINJAUAN PUSTAKA` | `Landasan Teori Pembelajaran Mesin`, `Arsitektur Model dan Algoritma`, `Metrik Evaluasi Kinerja`, `Kajian Literatur Terkait` |
+| BAB III | `METODOLOGI PENELITIAN` | `Tahapan Penelitian`, `Akuisisi dan Karakteristik Dataset`, `Pra-pemrosesan Data (Preprocessing)`, `Perancangan Arsitektur Model dan Skenario Eksperimen` |
+| BAB IV | `HASIL DAN PEMBAHASAN` | `Hasil Pelatihan dan Validasi Model`, `Evaluasi Kinerja Berdasarkan Metrik`, `Analisis Perbandingan dan Ablasi`, `Diskusi Temuan` |
+| BAB V | `PENUTUP` | `Kesimpulan`, `Saran` |
+
+### 3. Keamanan Siber / Jaringan / IoT / Sistem Tertanam
+| Bab | Judul Bab (`# JUDUL`) | Sub-Bab (`## Sub Judul` — Tanpa Nomor Manual!) |
+|---|---|---|
+| BAB I | `PENDAHULUAN` | `Latar Belakang`, `Rumusan Masalah`, `Tujuan`, `Manfaat`, `Batasan Masalah` |
+| BAB II | `TINJAUAN PUSTAKA` | `Arsitektur Protokol dan Jaringan`, `Perangkat Keras / Mekanisme Keamanan`, `Standar dan Parameter Kinerja` |
+| BAB III | `PERANCANGAN SISTEM` | `Topologi dan Arsitektur Sistem`, `Perancangan Perangkat Keras / Aturan Kebijakan`, `Skenario Pengujian` |
+| BAB IV | `IMPLEMENTASI DAN ANALISIS` | `Konfigurasi dan Implementasi`, `Pengujian Latency, Throughput, atau Akurasi Deteksi`, `Analisis Hasil Eksperimen` |
+| BAB V | `PENUTUP` | `Kesimpulan`, `Saran` |
+
+================================================================================
+## STEP 4 — ATURAN TEKNIS PENULISAN BERKAS (CRITICAL GUARDRAILS)
+
+> [!CRITICAL]
+> **ARSITEKTUR MARKDOWN MODULAR WAJIB DIPATUHI:**
+> - **DILARANG** membuat file `.typ` baru dari nol (seperti `laporan.typ`) atau mengimpor `@preview/...`.
+> - **DILARANG** mengubah `template.typ`, `docx.lua`, `reference.docx`, `build.sh`, atau `build-docx.sh`.
+> - Hanya sunting berkas konten pengguna: `metadata.yml`, `cover.md`, `references.bib`, dan `chapters/bab*.md`.
+
+### 1. Konfigurasi `metadata.yml`
+Tuliskan konfigurasi lengkap sesuai hasil wawancara. Pastikan field boolean (`daftar_gambar`, `daftar_tabel`) ditulis sebagai boolean YAML (`true` atau `false`):
+
+```yaml
+---
+title: "Judul Lengkap Karya Ilmiah Anda"
+subtitle: "Subjudul atau Jenis Laporan (Opsional)"
+author:
+  - name: "Nama Lengkap Mahasiswa 1"
+    nim: "13522001"
+lecturer: "Dr. Ir. Nama Dosen Pembimbing, M.T."
+lecturer_label: "Dosen Pembimbing:"
+course: "Tugas Akhir / Proyek Perangkat Lunak"
+institution: "Institut Teknologi Bandung"
+faculty: "Sekolah Teknik Elektro dan Informatika"
+department: "Teknik Informatika"
+city: "Bandung"
+year: "2026"
+date: "Oktober 2026"
+preset: "itb-ta"
+daftar_gambar: false
+daftar_tabel: false
+
+# Aktifkan blok approval di bawah ini HANYA JIKA pengguna meminta Lembar Pengesahan:
+# approval:
+#   city: "Bandung"
+#   date: "22 Oktober 2026"
+#   supervisors:
+#     - name: "Dr. Ir. Pembimbing Utama, M.T."
+#       nip: "197501012000031001"
+#       role: "Pembimbing I"
+#   dean:
+#     name: "Prof. Dr. Dekan Fakultas, M.Sc."
+#     nip: "196803031992031003"
+#     role: "Dekan Fakultas"
+
+# Aktifkan blok abstrak di bawah ini HANYA JIKA pengguna meminta Abstrak:
+# abstract_id: |
+#   Teks abstrak bahasa Indonesia (150-250 kata)...
+# keywords_id: ["Kata Kunci 1", "Kata Kunci 2", "Kata Kunci 3"]
+# abstract_en: |
+#   English abstract text (150-250 words)...
+# keywords_en: ["Keyword 1", "Keyword 2", "Keyword 3"]
+...
+```
+
+### 2. Format `cover.md` (Wajib Menyertakan Gate `opt-daftar-gambar` & `opt-daftar-tabel`)
+Halaman sampul luar, Lembar Pengesahan, dan Abstrak dirender otomatis oleh `template.typ` dan `docx.lua` dari `metadata.yml`. Berkas `cover.md` berisi **Kata Pengantar** serta blok transisi *front-matter* ke *main-body*:
+
+````markdown
+# KATA PENGANTAR {-}
+
+Puji syukur ke hadirat Tuhan Yang Maha Esa atas segala rahmat dan karunia-Nya sehingga penulis dapat menyelesaikan penyusunan laporan yang berjudul **"[Judul Laporan]"** dengan baik dan tepat waktu.
+
+[Tuliskan 2–3 paragraf kata pengantar yang menyebutkan tujuan penyusunan, ucapan terima kasih kepada Dosen Pengampu/Pembimbing serta pihak institusi, dan harapan manfaat laporan].
+
+```{=typst}
+#v(0.8cm)
+#align(right)[
+  [Kota, Bulan Tahun]
+
+  #v(1cm)
+  Penulis
+]
+#pagebreak()
+#outline(
+  title: [#align(center)[#text(size: 14pt, weight: "bold")[DAFTAR ISI]]],
+  depth: 3,
+)
+#context {
+  if opt-daftar-gambar {
+    let imgs = query(figure.where(kind: image))
+    if imgs.len() > 0 {
+      pagebreak()
+      outline(
+        title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR GAMBAR]],
+        target: figure.where(kind: image),
+      )
+    }
+  }
+  if opt-daftar-tabel {
+    let tbls = query(figure.where(kind: table))
+    if tbls.len() > 0 {
+      pagebreak()
+      outline(
+        title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR TABEL]],
+        target: figure.where(kind: table),
+      )
+    }
+  }
+}
+#pagebreak()
+#set page(numbering: "1")
+#counter(page).update(1)
+```
+
+```{=openxml}
+<w:p><w:pPr><w:jc w:val="right"/><w:spacing w:before="454"/></w:pPr><w:r><w:t>[Kota, Bulan Tahun]</w:t></w:r></w:p>
+<w:p><w:pPr><w:jc w:val="right"/><w:spacing w:before="567"/></w:pPr><w:r><w:t>Penulis</w:t></w:r></w:p>
+```
+````
+
+> [!WARNING]
+> **JANGAN PERNAH** menghapus blok `#context { if opt-daftar-gambar ... }` atau mengubahnya menjadi query tanpa syarat. Blok tersebut dikendalikan langsung oleh flag `daftar_gambar` dan `daftar_tabel` di `metadata.yml`.
+
+### 3. Penulisan Bab di `chapters/bab*.md` & Standar Bahasa Ilmiah
+Buat berkas terpisah per bab (`bab1-pendahuluan.md`, `bab2-tinjauan-pustaka.md`, dst.):
+- **Gaya Bahasa Akademik Indonesia (PUEBI / EYD V)**:
+  - Gunakan kalimat pasif-objektif (*"Sistem dirancang menggunakan..."*, *"Data dianalisis melalui..."*, **"Penulis"**). **DILARANG** menggunakan kata ganti orang pertama/kedua (*"saya"*, *"aku"*, *"kami"*, *"kita"*, *"kamu"*).
+  - **Bebas Klise AI (*Zero AI-Slop*)**: Hindari pembuka klise seperti *"Di era globalisasi / revolusi industri 4.0 yang berkembang pesat saat ini..."* atau *"Tidak dapat dipungkiri lagi bahwa..."*. Langsung masuk ke fakta teknis, urgensi masalah, data kuantitatif, dan konteks spesifik.
+- **Aturan Heading (Sangat Penting)**:
+  - Level 1 (Judul Bab): `# PENDAHULUAN` (Jangan tulis `# BAB I PENDAHULUAN` karena engine otomatis menambahkan `BAB I`).
+  - Level 2 (Sub-Bab): `## Latar Belakang` (Jangan tulis `## 1.1 Latar Belakang` karena engine otomatis menambahkan nomor `1.1.` atau `1.1`).
+  - Level 3 (Sub-Sub-Bab): `### Identifikasi Masalah` (Jangan tulis `### 1.1.1 Identifikasi Masalah`).
+- **Aturan Tabel, Gambar, Matematika & Karakter Khusus**:
+  - **Tabel**: Gunakan *Pipe Table* standar Markdown dengan baris header dan pemisah `|---|---|`.
+  - **Gambar**: `![Keterangan Gambar](gambar/nama-file.png)` — hanya rujuk file gambar yang benar-benar ada di disk!
+  - **Simbol Mata Uang**: Selalu *escape* tanda dolar (`\$100` atau tulis `100 USD` / `Rp100.000`) agar tidak dianggap sebagai pembuka rumus matematika `$...$`.
+  - **Rumus Matematika**: Inline `$f(x) = wx + b$` atau blok `$$MSE = \frac{1}{n}\sum_{i=1}^n (y_i - \hat{y}_i)^2$$`.
+  - **Larangan Box-Drawing**: **DILARANG KERAS** menggunakan karakter gambar kotak Unicode (`├`, `─`, `└`, `│`, `┌`, `┐`) karena merusak parser dan gagal pada audit `doctor`. Gunakan daftar poin Markdown atau diagram ASCII `+---+`, `|`, `---`.
+
+### 4. Integritas Daftar Pustaka (`references.bib`) — Anti-Halusinasi
+- **DILARANG MENGARANG SITASI PALSU**: Jangan pernah membuat judul jurnal, nama penulis, atau DOI fiktif.
+- Jika tool MCP `laporan_citations` tersedia, gunakan `action: "search_doi"` untuk mencari literatur nyata di Crossref dan `action: "add_citation"` untuk mengambil BibTeX resmi.
+- Gunakan sintaks sitasi Pandoc di dalam teks bab: `[@citekey]` atau naratif `@citekey`. Pastikan setiap `@citekey` di dalam teks terdaftar di `references.bib`, dan setiap entri di `references.bib` disitir di dalam teks (sehingga 0 *missing keys* dan 0 *orphan keys*).
+
+================================================================================
+## STEP 5 — AUDIT PRA-KOMPILASI (`DOCTOR`) & BUILD DOKUMEN
+
+Setelah seluruh berkas selesai ditulis, jalankan verifikasi dan kompilasi:
+
+1. **Jalankan Audit Kesehatan Dokumen**:
+   - Panggil MCP tool `laporan_doctor` atau jalankan `./laporan doctor` (Linux/macOS) / `.\laporan.ps1 doctor` (Windows).
+   - Pastikan **0 Error** dan **0 Warning** (tidak ada sitasi hilang, tidak ada gambar rusak, tidak ada penomoran heading manual, tidak ada karakter box-drawing).
+2. **Kompilasi Dokumen PDF & Word (DOCX)**:
+   - Panggil MCP tool `laporan_build({ format: "all" })` atau jalankan `./laporan build` / `.\laporan.ps1 build`.
+3. **Laporkan Hasil kepada Pengguna**:
+   Tampilkan ringkasan akhir:
+   - Lokasi berkas hasil kompilasi: `Laporan.pdf` dan `Laporan.docx`
+   - Ringkasan metrik dokumen dari `./laporan stats` (total kata, jumlah bab, jumlah sitasi, estimasi halaman)
+   - Petunjuk perintah lanjutan (`./laporan view`, `./laporan bundle`, `./laporan preset apply <id>`).

package/.agents/skills/laporan-generator/references/template-guide.md

@@ -17,16 +17,15 @@ File `template.typ` merupakan jantung dari pemformatan visual PDF pada **Laporan
 ```typst
 #set page(
   paper: "a4",
-  margin: (top: 2cm, bottom: 3cm, left: 2.5cm, right: 2.5cm),
+  margin: doc-margin,
+  numbering: none,
 )
 #set text(font: "Libertinus Serif", size: 12pt)
-#set par(justify: true, leading: 1.5em)
+#set par(justify: true, leading: 0.75em, first-line-indent: 1.25cm)
 ```
-* Margin Kiri & Kanan: 2.5 cm
-* Margin Atas: 2.0 cm
-* Margin Bawah: 3.0 cm
-* Spasi Antar Baris: 1.5 spasi (*one half spacing*)
-* Paragraf rata kanan-kiri (*justify*)
+* Margin Default (`standard`): Atas 2.0 cm, Bawah 3.0 cm, Kiri 2.5 cm, Kanan 2.5 cm (atau mengikuti `presets/*.yml` aktif).
+* Spasi Antar Baris: `0.75em` (setara 1.5 spasi di Typst).
+* Paragraf rata kanan-kiri (*justify*) dengan indentasi baris pertama `1.25cm`.
 
 ---
 
@@ -36,28 +35,35 @@ File `template.typ` merupakan jantung dari pemformatan visual PDF pada **Laporan
 ```typst
 #set heading(numbering: (..ns) => {
   if ns.len() == 1 {
-    "BAB " + numbering("I", ns.at(0)) + linebreak()
+    if chapter-prefix != "" {
+      chapter-prefix + format-chapter-num(ns.at(0))
+    } else {
+      format-chapter-num(ns.at(0))
+    }
   } else if ns.len() == 2 {
-    numbering("1.1", ..ns)
+    numbering("1.1.", ..ns)
   } else {
     numbering("1.1.1", ..ns)
   }
 })
 ```
-* **Bab**: Diformat dengan Angka Romawi (`BAB I`, `BAB II`, `BAB III`, dst). Angka Romawi dan judul dipisahkan oleh *line break*.
-* **Sub-bab**: Diformat dengan Angka Arab (`1.1`, `1.2`, `2.1`).
+* **Bab**: Diformat dengan Angka Romawi (`BAB I`, `BAB II`, `BAB III`, dst) atau Angka Arab sesuai preset (`heading_chapter_num_format`). Nomor bab dan judul dipisahkan oleh *line break* pada `#show heading.where(level: 1)`.
+* **Sub-bab**: Diformat dengan Angka Arab (`1.1.`, `1.2.`, `2.1.`) sesuai flag `heading_sub_dot`.
 * **Sub-sub-bab**: Diformat dengan Angka Arab 3 tingkat (`1.1.1`, `1.1.2`).
 * **Heading tanpa nomor** (Kata Pengantar, Daftar Isi, Daftar Pustaka): menggunakan `{-}` di Markdown yang diterjemahkan Pandoc menjadi `#heading(level: 1, numbering: none)`.
 
 > **Catatan**: Jangan menulis pola `"BAB I"` langsung sebagai format string `numbering(...)`. Typst menginterpretasikan rangkaian huruf `BAB` sebagai pola huruf dan memotong angka Romawinya. Selalu concat literal secara manual: `"BAB " + numbering("I", n)`.
 
 ### 2. Penomoran Halaman (frontmatter vs mainmatter)
-* **Bagian Depan** (Kata Pengantar, Daftar Isi): Menggunakan penomoran Romawi kapital (`I`, `II`, `III`) di bagian tengah bawah. Diatur di `cover.md`:
+* **Bagian Depan** (Lembar Pengesahan, Abstrak, Kata Pengantar, Daftar Isi): Menggunakan penomoran Romawi kecil (`i`, `ii`, `iii`) di bagian tengah bawah. Diatur di `template.typ` tepat setelah sampul depan:
   ```typst
-  #set page(numbering: "I")
+  #pagebreak()
+  #set page(numbering: "i")
+  #counter(page).update(1)
   ```
-* **Bagian Utama** (BAB I hingga BAB V): Menggunakan penomoran Angka Arab (`1`, `2`, `3`) berurutan, di-reset ulang:
+* **Bagian Utama** (BAB I hingga BAB V & Daftar Pustaka): Menggunakan penomoran Angka Arab (`1`, `2`, `3`) berurutan, di-reset ulang di akhir `cover.md`:
   ```typst
+  #pagebreak()
   #set page(numbering: "1")
   #counter(page).update(1)
   ```

package/.agents/skills/laporan-generator/resources/Makefile

@@ -44,26 +44,30 @@ reference-docx:
 	@command -v python3 >/dev/null 2>&1 || { echo "ERROR: python3 not found"; exit 1; }
 	@mkdir -p tmp
 	pandoc --print-default-data-file reference.docx > tmp/ref-default.docx
-	python3 scripts/make-reference-docx.py tmp/ref-default.docx reference.docx
+	python3 scripts/make-reference-docx.py tmp/ref-default.docx templates/default/reference.docx
 	@rm -f tmp/ref-default.docx
 
 html:
-	@if [ ! -d chapters ]; then \
+	@SRC_DIR="."; \
+	if [ ! -d "$$SRC_DIR/chapters" ] && [ -d "templates/default/chapters" ]; then \
+		SRC_DIR="templates/default"; \
+	fi; \
+	if [ ! -d "$$SRC_DIR/chapters" ]; then \
 		echo "ERROR: Direktori chapters/ tidak ditemukan."; \
 		exit 1; \
 	fi; \
-	PRESET=$$(grep -E '^[[:space:]]*(preset|margin_preset):' metadata.yml 2>/dev/null | head -n 1 | cut -d: -f2- | tr -d '\"'\''\r\n '); \
+	PRESET=$$(grep -E '^[[:space:]]*(preset|margin_preset):' "$$SRC_DIR/metadata.yml" 2>/dev/null | head -n 1 | cut -d: -f2- | tr -d '\"'\''\r\n '); \
 	PRESET_FILE=""; \
 	if [ -n "$$PRESET" ] && [ -f "presets/$${PRESET}.yml" ]; then \
 		PRESET_FILE="--metadata-file=presets/$${PRESET}.yml"; \
 	elif [ -f "presets/standard.yml" ]; then \
 		PRESET_FILE="--metadata-file=presets/standard.yml"; \
 	fi; \
-	pandoc chapters/bab*.md \
+	pandoc "$$SRC_DIR"/chapters/bab*.md \
 		$$PRESET_FILE \
-		--metadata-file=metadata.yml \
-		--citeproc --bibliography=references.bib \
-		--csl=apa.csl \
+		--metadata-file="$$SRC_DIR/metadata.yml" \
+		--citeproc --bibliography="$$SRC_DIR/references.bib" \
+		--csl="$$SRC_DIR/apa.csl" \
 		--metadata=reference-section-title="DAFTAR PUSTAKA" \
 		--top-level-division=chapter \
 		--standalone --toc \

package/.agents/skills/laporan-generator/resources/build-docx.sh

@@ -3,9 +3,11 @@ set -e
 
 DIR="$(cd "$(dirname "$0")" && pwd)"
 if [ -n "$1" ]; then
-  OUTDIR="$1"
+  OUTDIR="$(cd "$1" && pwd)"
 elif [ -f "$(pwd)/metadata.yml" ] && [ -d "$(pwd)/chapters" ]; then
   OUTDIR="$(pwd)"
+elif [ -f "$DIR/templates/default/metadata.yml" ] && [ -d "$DIR/templates/default/chapters" ]; then
+  OUTDIR="$DIR/templates/default"
 else
   OUTDIR="$DIR"
 fi
@@ -29,6 +31,7 @@ trap 'rm -rf "$TMPDIR"' EXIT
 
 FALLBACK_DIRS=(
   "$OUTDIR"
+  "$DIR/templates/default"
   "$DIR"
   "$HOME/.agents/skills/laporan-generator/resources"
 )

package/.agents/skills/laporan-generator/resources/build.sh

@@ -3,9 +3,11 @@ set -e
 
 DIR="$(cd "$(dirname "$0")" && pwd)"
 if [ -n "$1" ]; then
-  OUTDIR="$1"
+  OUTDIR="$(cd "$1" && pwd)"
 elif [ -f "$(pwd)/metadata.yml" ] && [ -d "$(pwd)/chapters" ]; then
   OUTDIR="$(pwd)"
+elif [ -f "$DIR/templates/default/metadata.yml" ] && [ -d "$DIR/templates/default/chapters" ]; then
+  OUTDIR="$DIR/templates/default"
 else
   OUTDIR="$DIR"
 fi
@@ -16,6 +18,7 @@ trap 'rm -rf "$TMPDIR"' EXIT
 
 FALLBACK_DIRS=(
   "$OUTDIR"
+  "$DIR/templates/default"
   "$DIR"
   "$HOME/.agents/skills/laporan-generator/resources"
 )