Ikhtisar Custom Agents & Workspace Customization
Triton CBT App dilengkapi dengan sistem Workspace Customization bawaan dari platform pengembang IDE AI (Antigravity/Gemini dan Claude Code). Fitur ini memungkinkan pengembang menulis instruksi kerja, batasan desain, serta kriteria keamanan kustom yang akan dibaca secara otomatis oleh AI sebelum menulis kode.
Dengan cara ini, Anda tidak perlu melatih ulang kecerdasan buatan atau menyalin panduan teknis yang sama secara terus-menerus setiap kali membuka ruang obrolan (chat room) yang baru. Konfigurasi dideklarasikan secara tertulis di dalam repositori dan langsung dimuat sebagai memori kerja AI.
📂 Struktur Folder Kustomisasi Proyek
Semua agen khusus didefinisikan secara rapi di dalam proyek Anda:
tritonapp/
└── .agents/ <-- Folder root kustomisasi
└── skills/ <-- Direktori agen khusus
├── triton-runner/
│ └── SKILL.md <-- Pemicu & petunjuk
├── triton-db-manager/
│ └── SKILL.md
└── ... (agen lainnya)
🧠 Bagaimana AI Mendeteksi Agen Anda?
- Setiap kali Anda membuka chat room baru, IDE memindai folder
.agents/skills/. - Pencocokan dilakukan berdasarkan nama dan deskripsi YAML Frontmatter di bagian atas berkas
SKILL.md. - Jika maksud perintah Anda cocok dengan deskripsi agen, AI akan memanggil fungsi
view_fileuntuk membaca seluruh petunjuk sebelum melakukan eksekusi kode.
Katalog 6 Agen Kustom (Skills) Proyek
Berikut adalah daftar lengkap agen kustom yang telah dikonfigurasi untuk menangani tugas pengembangan Triton CBT App:
Agen Pelaksana Tugas TRN
Secara otomatis membaca berkas spesifikasi di task/task-trn-XX.md, memodifikasi kode sesuai kebutuhan tugas, dan mengeksekusi kompilasi ulang dashboard progres tugas.
Agen Sinkronisasi & Migrasi Database
Memastikan perubahan database didistribusikan secara seragam di db_sd, db_smp, dan db_sma. Menjalankan make db-init serta make seed pasca perubahan skema, dan mencatat riwayat perubahan.
Agen Konsistensi UI/UX & Kontras
Menjaga visual gradien warna tiap jenjang siswa (SD merah, SMP navy, SMA slate), memaksakan penggunaan font Inter, melarang emoji sistem untuk ikon, serta memastikan teks memiliki rasio kontras tinggi.
Agen Keamanan & Anti-Curang CBT
Mengaudit dan menjaga kestabilan kode di halaman ujian agar listener pendeteksi keluar fullscreen, blur jendela peramban, blokir klik kanan, dan clipboard block (copy-paste) tidak terhapus secara tidak sengaja.
Agen Rute API & Firewall Gateway
Mengamankan integrasi rute gateway microservices pada api-gateway, memastikan path rewrite rute jenjang tepat, dan menguji filter hak akses (firewall role siswa).
Agen Penguji Kelayakan Kode (Test & Health)
Menjalankan kompilasi TypeScript untuk seluruh kode (make build), menguji kelayakan respons server (make health), memindai berkas log kesalahan, dan melakukan probing routing endpoints.
Panduan Memicu Agen Kustom
Untuk memicu agen agar memuat file skill yang diinginkan, gunakan perintah berbahasa Inggris agar proses pencocokan intensi (intent matching) berjalan optimal. Di bawah ini adalah templat perintah siap pakai:
Menjalankan Eksekusi Task TRN
Please run task-trn-31 using the triton_task_runner skill.
Efek: AI akan membuka berkas spesifikasi tugas task-trn-31.md, menuliskan perubahan kode, dan memicu pembangunan ulang dashboard di akhir proses.
Menyinkronkan Database & Skema
Use the triton_db_manager skill to sync our database.
Efek: AI memindai perubahan berkas skema database, menjalankan inisialisasi tabel, mengupdate data seed, dan mencatat ringkasan ke migrasi log.
Memverifikasi Kelayakan Kode
Please trigger the triton_code_verifier to test if everything is healthy.
Efek: AI mengompilasi TypeScript, mengecek kesehatan port layanan lokal, dan memverifikasi ketiadaan log error pada repositori.
Alur Sinkronisasi Kolaboratif Database Pengembang
Untuk mencegah kondisi database pengembang tidak sinkron (out-of-sync) akibat perubahan skema lokal yang lupa di-seed ulang oleh rekan tim lain saat melakukan git pull, kita menggunakan alur log terpusat:
Skema Alur Kolaborasi & Git Pull
Agen AI mengupdate skema, menjalankan make db-init lokal, dan menuliskan catatan perubahan skema di berkas docs/db-migrations-log.md.
Rekan tim melakukan git pull. Agen AI milik rekan Anda mendeteksi modifikasi pada berkas log atau berkas skema SQL.
Agen teman Anda menawarkan secara proaktif untuk mengeksekusi sinkronisasi database lokal rekan Anda agar data ter-update.
Membuat Agen Kustom (Skills) Baru
Jika di masa mendatang Anda ingin menambahkan keahlian baru untuk proyek (misalnya agen kustom integrasi Supabase, agen optimasi SEO, dll), ikuti langkah-langkah di bawah ini:
1. Buat Direktori Skill
Di dalam root repositori, buat folder baru di dalam folder .agents/skills/:
mkdir -p .agents/skills/triton-supabase-agent
2. Buat Berkas SKILL.md
Buat file SKILL.md di dalam folder baru tersebut dengan menyisipkan YAML Frontmatter di baris teratas:
---
name: "triton_supabase_helper"
description: "Handles Supabase connection pool adjustments and local pg_cron scheduler syncer"
---
# Supabase Sync Agent Instructions
Write the step-by-step instructions for the AI agent in English here...
3. Validasi Keaktifan
Segera setelah berkas dibuat, buka obrolan (chat) baru. Agen AI secara otomatis akan mendeteksi agen tersebut dan memuat instruksinya ke dalam memori kerja sistem saat dipicu.