# 🤖 PANDUAN LENGKAP LATIHAN AGENTIC AI & GOOGLE ANTIGRAVITY (BLUEPRINT SK SEKSYEN 9)
## Bagaimana Mengajar Automasi Fail Komputer & Excel Kepada Guru dan Pentadbir Sekolah

---

## 🎯 1. OBJEKTIF & ANJAKAN PARADIGMA
Dalam latihan tahap asas, guru diajar menggunakan AI web (ChatGPT / Gemini) yang sekadar memaparkan teks pada skrin. Guru masih perlu menyalin teks tersebut ke dalam Excel, membetulkan garisan jadual yang lari, dan memasukkan semula formula.

**Modul Google Antigravity (Agentic AI)** membawa guru ke tahap seterusnya:
> *"AI yang tidak lagi sekadar menjawab soalan, tetapi bertindak sebagai Ejen Pembantu yang menggerakkan sistem fail di dalam komputer guru untuk menyelesaikan tugas hakiki sekolah."*

---

## 🏗️ 2. ALIRAN KERJA 5-LANGKAH (BLUEPRINT SEBENAR SK SEKSYEN 9)

```mermaid
graph TD
    A["1. Arahan Mentah Guru Besar (Teks WhatsApp / Minit Mesyuarat)"] --> B["2. Templat Excel Rasmi Agihan Tugas (.xlsx)"]
    B --> C["3. Ejen Google Antigravity Jalankan Automasi Tempatan di PC"]
    C --> D["4. Auto-populate Sel Kurikulum, HEM, Koko & Kira Formula SUMIF"]
    D --> E["5. Muat Naik ke Google Sheets & Hubungkan ke Dashboard Visual Canva (JSON Sync)"]
```

---

## 📂 3. SENARAI BAHAN DEMO DALAM FOLDER INI

Folder ini telah dilengkapi dengan bahan ujian lengkap untuk peserta bengkel:
1. `demo_data_guru_raw.txt`: Mengandungi teks nota mesyuarat tidak berstruktur daripada Guru Besar.
2. `PROMPT_ARAHAN_GOOGLE_ANTIGRAVITY.txt`: Teks arahan rasmi siap salin (copy-paste) untuk dimasukkan ke dalam Google Antigravity / Ejen AI.
3. `templat_agihan_tugas_KOSONG.xlsx`: Templat rasmi sekolah yang kosong (header sahaja), sedia untuk diisi oleh ejen AI.
4. `Simulator_Antigravity_Excel.html`: **Aplikasi Web Simulator Interaktif** (Klik dua kali untuk buka di pelayar Chrome/Edge) — membolehkan cikgu mencuba prompt, melihat simulasi pemprosesan ejen, dan memuat turun fail Excel tanpa perlu memasang sebarang perisian!
5. `skrip_automasi_agihan_tugas.py`: Enjin automasi Python tulen yang mensimulasikan tindakan Ejen Antigravity membaca teks dan menulis ke sel Excel.
6. `agihan_tugas_guru_SELESAI.xlsx`: Contoh fail Excel hasil akhir lengkap dengan formula dinamik `=D5+F5+H5` dan warna korporat sekolah.

---

## 🎤 4. TIGA (3) CARA MENJALANKAN DEMO INI

### KAEDAH 1: Menggunakan Simulator Web Interaktif (Paling Disyorkan untuk Cikgu)
1. Buka fail `Simulator_Antigravity_Excel.html` dalam Google Chrome atau Microsoft Edge.
2. Paparkan teks mentah Guru Besar di ruangan kiri.
3. Klik butang **"Salin Prompt"** di ruangan tengah.
4. Klik **"⚡ Jalankan Ejen Antigravity"**.
5. Tunjukkan kepada peserta bagaimana konsol ejen membaca teks mentah, mengisi templat kosong, dan mengira formula secara langsung.
6. Klik butang **"Muat Turun Fail Excel Rasmi (.xlsx)"** untuk membuktikan fail Excel sebenar telah siap dijana!

### KAEDAH 2: Menggunakan Ejen AI Sebenar (Google Antigravity / Cursor / Claude Code)
1. Buka persekitaran Google Antigravity di komputer anda.
2. Buka fail `PROMPT_ARAHAN_GOOGLE_ANTIGRAVITY.txt`, salin prompt yang disediakan.
3. Tampal ke dalam ruangan arahan ejen.
4. Ejen Antigravity akan mengakses `demo_data_guru_raw.txt`, mengisi `templat_agihan_tugas_KOSONG.xlsx`, dan menghasilkan `agihan_tugas_guru_SELESAI.xlsx` secara mandiri.

### KAEDAH 3: Melalui Terminal Python (Untuk Trainer Teknikal / ICT)
1. Buka PowerShell atau Command Prompt dalam folder ini.
2. Jalankan arahan: `python skrip_automasi_agihan_tugas.py`
3. Fail `agihan_tugas_guru_SELESAI.xlsx` akan terhasil dalam masa 2 saat.

---

## 🎤 5. SKRIP PENYAMPAIAN TRAINER SEMASA LIVE DEMO

### Bahagian 1: Tunjukkan 'Sakitnya' Cara Manual (3 Minit)
> *"Cikgu-cikgu, bayangkan hari ini Guru Besar hantar teks WhatsApp panjang berjela mengandungi 40 lantikan jawatankuasa sekolah. Tugas Penolong Kanan atau kerani adalah buka fail Excel, cari nama setiap cikgu, taip jawatan satu persatu, dan kira berapa mata beban tugas mereka. Kalau ada 60 orang cikgu, kerja ini ambil masa 2 hari dan sangat mudah berlaku kesilapan manusia!"*

### Bahagian 2: Tunjukkan Tindakan Ejen Antigravity (5 Minit)
> *"Sekarang perhatikan skrin laptop saya. Saya tidak sentuh tetikus atau taip apa-apa dalam Excel. Saya hanya beri arahan kepada Google Antigravity menggunakan prompt yang telah disediakan: 'Tolong baca teks pelantikan Guru Besar, masukkan ke dalam templat Excel kosong sekolah, dan pastikan formula pengiraan beban tugas kekal aktif'."*

*(Trainer tunjukkan simulasi atau jalankan ejen)*

> *"Dalam masa 3 saat sahaja! Mari kita buka fail Excel yang baru dijana ini bersama-sama."*

### Bahagian 3: Bedah Hasil Kerja Ejen dalam Excel (5 Minit)
1. **Formula Tidak Rosak**: Klik pada lajur **Jumlah Mata Beban** (Lajur I). Tunjukkan kepada guru bahawa ia mengandungi formula dinamik `=D5+F5+H5`, bukannya nombor mati!
2. **Logik Perniagaan Sekolah**: Tunjukkan lajur **Status Beban** (Lajur J) yang menggunakan formula `=IF(I5>8, "BEBAN TINGGI", "SEIMBANG")`. Jika ada cikgu yang memegang terlalu banyak jawatan, sistem automatik memberi amaran warna merah/kuning!
3. **Format & Garisan Kemas**: Garisan sempadan (*thin border*), tajuk sekolah, dan saiz lajur telah dilaraskan sempurna mengikut standard cetakan KPM.

### Bahagian 4: Langkah Seterusnya - Live Dashboard Canva (Integrasi Lanjutan)
1. Muat naik fail Excel ke **Google Drive / Google Sheets**.
2. Salin pautan Google Sheet tersebut.
3. Buka **Canva** -> Pilih **Apps** -> Cari **Google Sheets / JSON Sync**.
4. Tukarkan pautan helaian menjadi **Dashboard Visual Carta Agihan Tugas Guru** yang boleh dipaparkan di bilik guru atau mesyuarat pengurusan sekolah!

---

## ❓ 5. SOALAN LAZIM (FAQ) PENTADBIR SEKOLAH

1. **Adakah data murid & guru selamat daripada kebocoran internet?**
   - **Jawapan**: Ya, kerana Google Antigravity beroperasi secara tempatan (*local environment*) di dalam komputer. Fail tidak dimuat naik ke pelayan awam yang tidak selamat.
2. **Bolehkah Antigravity menukar format fail lain seperti PDF ke Excel?**
   - **Jawapan**: Boleh! Antigravity mampu mengekstrak senarai murid daripada fail PDF jadual peperiksaan atau surat PPD dan menyusunnya ke dalam lajur Excel dengan tepat.
3. **Perlukah semua guru menjadi pakar koding untuk menggunakan ini?**
   - **Jawapan**: Tidak. Dalam fasa implementasi sekolah, pentadbir atau Guru Penyelaras Bestari (ICT) hanya perlu menyediakan satu arahan ejen, dan guru-guru lain hanya perlu meletakkan fail ke dalam folder yang ditetapkan.