custom-project-skill

name	custom_project_skill
description	Mandatory context skill. Read this automatically at the beginning of any task related to [Your Project Keywords] to understand the core formulas and boundaries.

Custom Project Skill

Deskripsi Proyek

Referensikan file gemini.md untuk identitas mahasiswa, judul skripsi, dan institusi.

---

Each time a new AI session begins, the MANDATORY first step is to follow the Hybrid Context Protocol:

1. Read supportFiles/PROMPT_TEMPLATE.md for the session start sequence.
2. Load supportFiles/handoff.md to understand the latest project state and prose drafts.
3. Cross-reference papers/index.md and supportFiles/ANTI_HALLUCINATION.md for valid technical citations.

Failure to load these files will result in context drift and potential hallucinations.

---

⚠️ Mandatory Integrity & Onboarding Check

Setiap kali sesi dimulai, AI WAJIB melakukan pengecekan integritas berikut sebelum melakukan tugas teknis apa pun:

1. Placeholder Check: Periksa apakah gemini.md masih mengandung [Nama Anda], atau scripts/sync_word.ps1 masih mengandung [PASTE_...].
2. Infrastructure Check: Baca supportFiles/ACTION_PLAN.md. Periksa apakah semua item di "Phase 0: Infrastructure" (termasuk poin 0.5 dan 0.6) sudah terceklis [x].
3. Citation Guard: Sebelum menulis draf bab, AI WAJIB memverifikasi apakah referensi yang akan digunakan sudah terdaftar di supportFiles/ANTI_HALLUCINATION.md.

Protokol Pemblokiran:

• Jika poin 1 atau 2 belum terpenuhi secara nyata (cek isi filenya!), AI DILARANG melakukan penulisan draf akademik atau eksperimen tingkat lanjut.
• AI harus segera menginterupsi dengan sapaan: "Mohon maaf, saya mendeteksi konfigurasi jalur OneDrive atau daftar referensi utama (Phase 0) belum siap. Mari kita tuntaskan konfigurasi di sync_word.ps1 dan ANTI_HALLUCINATION.md terlebih dahulu."

Otomasi Onboarding: Jika AI mendeteksi file .docx atau .pdf baru di folder example/, AI WAJIB menawarkan untuk menjalankan scripts/extract_docx.py atau scripts/extract_pdfs.py untuk mempelajari gaya bahasa user.

---

🗺️ Smart Auto-Routing System (WAJIB DIIKUTI)

Ketika user TIDAK menyebut nama file tujuan secara eksplisit, AI wajib menggunakan tabel routing di bawah ini untuk menentukan ke mana konten harus ditulis atau disimpan. Jangan pernah hanya mencetak ke chat tanpa menawarkan untuk menyimpan ke file yang tepat.

Intent-to-File Routing Table

Jika user meminta/terdeteksi...	Intent / Sifat Konten	Tulis ke file ini	Aksi setelah menulis
Menjelaskan Teori/Ide	Konseptual, Definisi, "Bagaimana cara kerja X?"	intelligence/konsep/	Buat file .md & link ke [[_INDEX_KONSEP]]
Mengekstrak Paper	Literatur, "Apa kata paper A?", Metrik	intelligence/ringkasan_paper/	Buat file .md & link ke [[_INDEX_PAPER]]
Mendefinisikan Istilah	Glosarium, "X maksudnya adalah...", Singkatan	intelligence/glosarium.md	Update tabel Glosarium & Link di catatan lain
Menemukan Alur/Rumus	Teknikal, "Gunakan rumus Y", "Alur risetnya Z"	intelligence/metodologi/	Buat file .md & link ke [[_INDEX_METODE]]
Mencari Info Bersama	Riset web, "Tolong cari X", Snippet eksternal	intelligence/catatan_web/	Simpan sebagai "Web Clipping" di folder web
Eksternal Deep Research	"pakai notebooklm", "riset mendalam ke google"	.agents/workflows/use-notebooklm.md	Panggil workflow /use-notebooklm
Merubah Strategi	Keputusan, "Ganti ke metode B", "Ubah dataset"	supportFiles/decisions_log.md	Catat tanggal & alasan perubahan

🧠 Proactive Knowledge Detection (SANGAT PENTING)

Asisten tidak boleh pasif menunggu keyword. Asisten WAJIB menawarkan diri untuk menulis ke Wiki jika mendeteksi kondisi berikut:

1. "New Knowledge Nugget": Jika ada penjelasan teknis atau konseptual yang panjang di chat yang belum ada di Wiki.
   • Prompt: "Penjelasan mengenai [Konsep X] tadi cukup mendalam. Izinkan saya merapikannya ke dalam [[intelligence/konsep/Konsep_X]] agar terdokumentasi di Obsidian Anda?"
2. "Methodological Nuance": Jika user menjelaskan detail konfigurasi eksperimen atau alasan di balik pemilihan variabel tertentu.
   • Prompt: "Logika pemilihan [Metode Y] yang Anda jelaskan sangat krusial. Saya akan mencatatnya di [[metodologi/_INDEX_METODE]] sebagai referensi Bab 3 nanti."
3. "Context Shift": Jika user mulai membahas topik baru yang berpotensi menjadi Bab atau Sub-bab baru.
   • Prompt: "Sepertinya kita mulai masuk ke ranah [Topik Baru]. Apakah Anda ingin saya membuatkan folder khusus untuk topik ini di Wiki?"
4. "Literature Gap": Jika asisten kehabisan referensi lokal saat drafting.
   • Prompt: "Saya kekurangan literatur terkini soal ini. Anda ingin mencoba /use-notebooklm? Saya bisa buatkan prompt pencariannya sekarang."

🛠️ Obsidian Vault Maintenance (WAJIB DIIKUTI)

Asisten wajib mengikuti kaidah Obsidian agar Wiki ini fungsional dan interaktif:

1. Gunakan Wikilinks: Gunakan format [[Nama File]] untuk semua link internal antar catatan di folder intelligence/.
2. YAML Frontmatter: Setiap file baru di folder intelligence/ wajib memiliki header YAML:

   ---
   title: [Judul]
   tags: [tag1, tag2]
   last_updated: [YYYY-MM-DD]
   ---
   

3. Indexing Otomatis: Setiap kali membuat catatan baru di salah satu sub-folder intelligence/, asisten WAJIB menambahkan link ke catatan tersebut di file _INDEX.md yang relevan.
4. Bahasa Indonesia: Khusus di dalam folder intelligence/, seluruh konten penjelasan wajib menggunakan Bahasa Indonesia yang formal namun mudah dipahami.

Aturan Routing

1. Sebelum menulis, konfirmasi dengan cepat: "Saya akan menyimpan ini ke [nama file]. Lanjut?"
2. Jika file belum ada, buat file baru sesuai tabel di atas — jangan tulis di chat saja.
3. MANDATORY SYNC: Setiap kali menulis draf akademik (Bab 1-5), asisten WAJIB menyimpan salinan draf/poin tersebut ke supportFiles/handoff.md di bawah section ## Current Text Drafts. Ini krusial agar memori aktif tetap terjaga antar sesi.
4. Setelah menulis konten bab apapun, selalu update supportFiles/handoff.md bagian status bab.
5. TIDAK BOLEH hanya mencetak draf di chat. Jika user tidak menolak, langsung simpan ke kedua lokasi (Fail Bab + Handoff).
6. Jika trigger ambigu (tidak ada di tabel), tanyakan user: "Apakah output ini ingin disimpan ke file tertentu, atau cukup di chat saja?"

---

Alur Penelitian (Research Workflow)

graph TD
    A["[Tahap 1: Persiapan]"] --> B["[Tahap 2: Pengumpulan Data]"]
    B --> C["[Tahap 3: Analisis/Eksperimen]"]
    C --> D["[Tahap 4: Hasil & Pembahasan]"]

Komponen	Detail
Algoritma / Model Utama	Lihat gemini.md
Dataset baseline	Lihat gemini.md
Metode / Pendekatan	Lihat gemini.md
Framework	Lihat gemini.md
Hardware target	Lihat gemini.md

---

Core Research Logic

Feature	Mandatory Specification
Research Focus	[IDENTITY:research_focus]
Primary Methodology	[IDENTITY:primary_methodology]

---

Aturan & Batasan Penting (Wajib Dipatuhi)

⚠️ Constraints Utama

• ❌ TIDAK menggunakan metode di luar scope: [Cakupan Batasan].
• ❌ TIDAK menggunakan framework lain selain yang disepakati.

📝 Hybrid Language & Writing Standards

• Language Protocol:
  • English (🇬🇧): All AI-facing instructions, technical definitions, and thesis prose drafts.
  • Indonesian (🇮🇩): Summary logs, user-facing guides, and general communication.
• Prose Standards (MANDATORY):
  • Typography: Strictly NO em-dash (—). Use LaTeX for math.
  • Paragraph Structure: Follow the pattern [Topic Sentence ➔ Support ➔ Transition/Synthesis ➔ [Citation]].
  • No Bullet Points: Prose drafts must be in flowing paragraphs, NOT bullet lists.
  • Focus: Focus on findings/methodology, not authors (e.g., "AI is used [1]" instead of "According to Smith [1]").
  • Tone: Formal academic tone. Dilarang menggunakan "I", "we", or "our".
  • Anti-AI Signature: Avoid overused AI transitions like "Furthermore", "In conclusion", "Moreover".
  • Citations: Strictly use [Name_Year] format during drafting (e.g., [Smith_2023]). This ensures consistency with Mendeley/Zotero and avoids numbering shift issues. Use [CITATION NEEDED] if a source is missing.
  • Styling: Use italic only for foreign non-English terms (e.g., et al.).
• Quality Control (Self-Audit):
  • AI wajib melakukan pengecekan mandiri menggunakan logika scripts/prose_auditor.py sebelum menyerahkan draf akhir bab kepada user.
  • Pastikan tidak ada karakter terlarang (—) dan semua sitasi sudah terdaftar di ANTI_HALLUCINATION.md.

---

Referensi Paper Utama

Paper	Kontribusi ke Proyek
[Paper 1]	[Kontribusi]
[Paper 2]	[Kontribusi]

---

Terminologi yang Benar

❌ Jangan Tulis	✅ Tulis Ini	Alasan
"[Kata Salah]"	"[Kata Benar]"	[Alasan koreksi]

---

Pengelolaan Support Files

Update Wajib Setelah Setiap Sesi

Setelah menyelesaikan pekerjaan signifikan, AI wajib memperbarui:

1. handoff.md — update status stage, pending actions, last session summary
2. decisions_log.md — tambahkan keputusan baru yang dibuat dalam sesi ini

Template Update handoff.md

## Last Session Summary (YYYY-MM-DD)

- [Apa yang dikerjakan]
- [Hasil yang dicapai]
- [File yang dibuat/dimodifikasi]

✨ Academic Document Standards (MANDATORY)

Setiap kali melakukan ekspor ke format Word (.docx), asisten WAJIB menggunakan file template berikut sebagai basis (Seed Document) untuk menjaga konsistensi penomoran BAB dan Sub-bab:

• Template Path: .agents/resources/academic_template.docx
• Aturan Pemetaan Gaya:
  • BAB / Judul Bab ➔ Gunakan gaya Heading 1 (Format otomatis: BAB I, BAB II, dst).
  • Sub-bab (Level 1) ➔ Gunakan gaya Heading 2 (Format otomatis: 1.1, 1.2, dst).
  • Sub-bab (Level 2) ➔ Gunakan gaya Heading 3 (Format otomatis: 1.1.1, dst).
  • Isi Draf ➔ Gunakan gaya Normal.
  • Tabel ➔ Gunakan gaya tabel Table Grid.

---

🛠️ Script Helper & Utilities (WAJIB TAHU)

Berikut adalah daftar skrip alat bantu yang sudah tertanam di scripts/. AI wajib menawarkan atau langsung mengeksekusi skrip ini menggunakan run_command jika konteks percakapan sesuai:

Nama Skrip	Kapan AI harus menggunakannya?	Perintah Terminasi (Gunakan rtc atau python)
scripts/extract_pdfs.py	Saat user punya file .pdf baru di folder papers/ dan meminta AI membacanya. Skrip ini akan mengubahnya menjadi teks di supportFiles/extracted_pdfs/ agar AI bisa membacanya tanpa modul tambahan.	python scripts/extract_pdfs.py
docx skill	Skill otomatis (built-in) untuk membaca, mengedit, dan memanipulasi file Word .docx secara profesional.	Otomatis aktif saat membahas file .docx
scripts/docx_surgery.py	Jika user/AI ingin melakukan "bedah" XML pada file Word (unpack/pack) untuk memperbaiki format yang rusak.	python scripts/docx_surgery.py
scripts/extract_docx.py	Jika user meminta secara spesifik untuk mengekstrak dokumen Word ke dalam format Markdown (.md).	python scripts/extract_docx.py [file.docx] [file.md]
scripts/sync_word.ps1	Jika user melaporkan "Saya baru menulis di Word OneDrive saya, tolong sinkronkan." Skrip ini akan menyedot draf Word cloud ke repositori lokal secara otomatis.	powershell scripts/sync_word.ps1
scripts/convert_citations.py	Jika user ingin merapikan draf handoff.md yang menggunakan sitasi "[1]" menjadi format "[Author_Year]" menggunakan kamus JSON. Format wajib sebelum dipublish!	python scripts/convert_citations.py
scripts/prose_auditor.py	Digunakan untuk audit kualitas bahasa akademik dan integritas sitasi sebelum draf dipindah ke Word.	python scripts/prose_auditor.py

🐍 Venv Awareness Protocol (Seamless Execution)

Untuk menjalankan skrip Python di atas, asisten wajib menggunakan executable Python dari virtual environment yang sudah dicatat:

1. Check Config: Selalu baca file supportFiles/.venv_config.txt untuk mendapatkan path absolut ke python.exe.
2. Execution: Gunakan path tersebut secara eksplisit saat menjalankan perintah melalui run_command (misalnya: & "C:\Users\[User_Name]\thesis_venv\Scripts\python.exe" scripts/prose_auditor.py).
3. Fallback: Jika file config tidak ada, asisten harus meminta user menjalankan .\scripts\setup_env.ps1 terlebih dahulu.

---

Kontak & Konteks

• Lihat gemini.md untuk detail identitas mahasiswa, hardware, dan bahasa komunikasi.