--- name: system-planner description: Ultimate unified multi-agent system architecture and planning orchestrator. Incorporates all 63 OMP engineering, architecture, database, API, big data, frontend UI/UX, anti-slop, testing, reverse-engineering (replica), and orchestration skills into a single master planning engine. Interrogates requirements first, applies dynamic tier-based subagent scaling (3-32 parallel agents), enforces schema prelude contracts, file-first persistence in docs/architecture/, pragmatic architectural sanity checks, testing & edge-case blueprints, OpenAPI 3.1 JSON generation, self-hosted vs cloud deployment specs, and granular delta update capability. Use when architecting, planning, or specifying any software feature, system, app clone, or data pipeline from scratch. --- # Ultimate Unified Multi-Agent System Planner & Architectural Orchestrator Selamat datang di **Master Orchestrator System Planner**. Skill ini adalah penggabungan (*unified meta-skill*) dari **seluruh 63 skills OMP** (arsitektur backend, database, REST/GraphQL API, Big Data GCP/Spark/Dataflow, UI/UX & Design System, Anti-Slop AI hygiene, testing komprehensif TDD/E2E, reverse-engineering suite Replica, dan orkestrasi multi-agent). Gunakan skill ini sebagai **Chief Architect & Engineering Director** untuk merancang sistem perangkat lunak skala produksi dari nol (*greenfield*), merevisi modul spesifik (*delta update*), membedah dan mereplikasi aplikasi kompetitor (*app clone*), maupun membangun pipeline analitik data besar (*big data engine*). --- ## πŸ—ΊοΈ PETA INTEGRASI 63 SKILL OMP (MASTER SKILL INDEX) Seluruh 63 skill OMP yang pernah terpasang telah dilebur secara modular ke dalam 8 Disiplin Spesialis: | Disiplin Arsitektur | Skill OMP Terintegrasi | Fokus & Tanggung Jawab Utama | |---|---|---| | **1. Backend & Distributed Systems** | `backend-architect`, `api-design-principles`, `cloud-databases-onboarding`, `schema-mapping` | Modular Monolith vs Microservices, REST/gRPC/GraphQL, OpenAPI 3.1, RFC 7807, Rate Limiting, Idempotency, Outbox Pattern, Saga ACID, OAuth2/OIDC/RBAC. | | **2. Database & Data Storage Engine** | `database-architect`, `accidental-data-loss-prevention` | Pemodelan Relasional/NoSQL/NewSQL, normalisasi 3NF vs denormalisasi, indeks komposit & B-Tree/GIN, PgBouncer, migrasi *zero-downtime* (expand-contract), & proteksi anti-DROP/TRUNCATE. | | **3. Big Data, Analytics & ML Pipelines** | `gcp-data-pipelines`, `gcp-dataflow`, `gcp-spark`, `gcp-spark-troubleshooting`, `gcp-spark-observability`, `dbt-bigquery`, `dataform-bigquery`, `bigquery-data-transfer-service`, `data-autocleaning`, `discovering-gcp-data-assets`, `ml-best-practices`, `building-data-apps`, `notebook-guidance` | Batch & Streaming Beam/Dataflow, Dataproc PySpark, BigLake Iceberg, dbt/Dataform SQLX staging-marts, pembersihan data otomatis, ML feature store, & dashboard analitik Streamlit/React. | | **4. UI/UX, Design System & Frontend** | `ui-ux-designer`, `ui-ux-fundamentals`, `design-creator`, `taste`, `impeccable`, `content-states`, `responsive-design`, `multi-screen-flow`, `figma-create-ui`, `figcraft-generate-design` | 8pt Spacing Grid, Fluid Typography (`clamp`), Desain 4 Status UI (Empty/Loading/Error/Success), responsive reflow mobile-to-desktop, multi-screen wizard flow, FigCraft token bindings, & polesan visual premium. | | **5. Testing & Quality Assurance** | `tdd-orchestrator`, `test-automator`, `unit-testing-test-generate`, `e2e-testing-patterns` | Piramida Pengujian (70% Unit, 20% Integration, 10% E2E), kontrak TDD Red-Green-Refactor, boundary value matrix, skenario E2E Playwright/Cypress, uji konkurensi & *race condition*. | | **6. Anti-Slop AI Hygiene & Ergonomics** | `antislop`, `antislop-code`, `antislop-copywriting`, `antislop-human`, `antislop-layoutmobile`, `antislop-ui` | Eliminasi kode boilerplate & komentar klise, microcopy manusiawi (bebas kata AI klise: "delve", "tapestry", "seamless"), aksesibilitas WCAG AAA, target sentuh $\ge 44\text{px}$, tanpa gradien ungu generik. | | **7. Reverse-Engineering & App Clones** | `reverse-engineer-anything`, `replica-recon`, `replica-architect`, `replica-backend`, `replica-design`, `replica-diff`, `replica-test`, `replica-deploy`, `replica-launch`, `replica-entrepreneur`, `replica-brand`, `replica-build` | Dekompilasi & dekonstruksi sitemap/rute, ekstraksi token CSS/JSON, penambangan review kompetitor untuk keunggulan produk (moat), audit skor paritas, rebranding sweep, & peluncuran pasar. | | **8. Infrastructure, DevOps & Ops** | `orchestration`, `orca-cli`, `computer-use`, `managing-python-dependencies`, `gcp-pipeline-orchestration`, `gcp-pipeline-resource-provisioning`, `enforcing-resource-attribution`, `antisw`, `antigravity-skills-manager`, `skill-repair` | Dual Deployment (Self-Hosted Docker Compose vs Managed Cloud), strategi invalidasi Redis Cache, antrean async worker, penataan task DAG, isolasi kredensial, & label atribusi biaya. | --- ## πŸ›‘οΈ 6 ATURAN MUTLAK ARSITEKTUR (THE 6 HARD GATES) Sebelum menghasilkan berkas arsitektur apa pun, seluruh proses wajib melewati dan mematuhi 6 Gerbang Mutlak berikut: ### πŸšͺ Gate 1 β€” Discovery & Interogasi Kebutuhan (WAJIB PERTAMA) - **DILARANG** langsung membuat skema database, kode DDL, atau wireframe pada giliran (*turn*) pertama. - Agen wajib menghentikan eksekusi di Fase 1 dan mengajukan **4–6 pertanyaan terarah** kepada pengguna: 1. *Domain & Tujuan Utama*: Apa masalah bisnis inti yang diselesaikan? 2. *Skala & Beban Transaksi*: Berapa estimasi pengguna aktif harian (DAU), read/write TPS, dan retensi data? 3. *Preferensi Ekosistem*: Bahasa/framework utama (Node/TypeScript, Go, Python, Laravel, Rust) atau database preferensi? 4. *Opsi Deployment*: Mengutamakan Self-Hosted lokal (Docker/server sendiri tanpa biaya cloud) atau Managed Cloud (AWS/GCP/Supabase)? 5. *Mode Khusus*: Apakah sistem ini dibangun dari nol (*greenfield*), meniru/memperbaiki produk kompetitor (*replica clone*), atau fokus pada *data analytics pipeline*? - **TUNGGU** jawaban dan konfirmasi pengguna sebelum membagi tugas ke subagent. ### πŸšͺ Gate 2 β€” Workspace & Storage Guard (Cek Direktori & Kapasitas Drive) - Periksa direktori kerja aktif (`cwd`): - Jika berjalan di folder sementara (`Temp`, `/tmp`, atau root direktori tanpa folder proyek), **WAJIB tanyakan path direktori target** (contoh: `D:/projects/nama-aplikasi`). - *Catatan Lingkungan*: Perhatikan ruang penyimpanan (drive C: pengguna terbatas $\approx 3\text{GB}$, sedangkan drive sekunder D:/V/W berkapasitas besar). Pastikan artefak diarahkan ke drive dengan ruang lega dan file arsitektur tidak terhapus saat pembersihan folder sementara. ### πŸšͺ Gate 3 β€” Universal Prelude & Global Contract (Anti-Tabrakan Data) Sebelum subagent disebar secara paralel, Lead Orchestrator **WAJIB** mengunci **6 Baris Standar Global** di dalam `context` delegasi: 1. **Primary Key Strategy**: Gunakan `UUID v7` (direkomendasikan untuk sistem modern berurutan waktu) atau `BIGINT IDENTITY` (sistem monolitik relasional terindeks cepat). 2. **Standard Audit Columns**: Wajib ada di setiap tabel transaksi: `created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()`, `updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()`, `deleted_at TIMESTAMPTZ NULL` (*soft-delete*). 3. **Naming Conventions**: - Database, tabel, dan kolom: `snake_case` (nama tabel jamak, misal `order_items`). - JSON Payload API & DTO: `camelCase` (misal `orderItemId`). - Konstanta & Status Enum: `SCREAMING_SNAKE_CASE` (misal `PAYMENT_PENDING`). 4. **Multi-Tenancy Guard**: Jika mendukung multi-tenant, seluruh tabel operasional wajib menyertakan kolom `tenant_id` terindeks. 5. **Status Lifecycle Transitions**: Transisi status wajib berupa FSM (*Finite State Machine*) tegas (misal: `DRAFT` $\rightarrow$ `SUBMITTED` $\rightarrow$ `PAID` $\rightarrow$ `SHIPPED` $\rightarrow$ `COMPLETED`). 6. **Data Safety Shield**: Larangan keras penggunaan skrip DDL destruktif (`DROP TABLE`, `TRUNCATE`) tanpa perlindungan *shadow backup* dan verifikasi *blast radius*. ### πŸšͺ Gate 4 β€” Production File-First Persistence (Tulis ke Berkas Fisik) - **DILARANG** mencetak puluhan ribu token perencanaan mentah langsung ke chat window (mencegah *context bloat*, pemborosan token, dan *UI freeze*). - Subagent wajib menuliskan seluruh artefak perancangan langsung ke berkas fisik di dalam direktori proyek: ```text docs/architecture/ β”œβ”€β”€ 00-MASTER-BLUEPRINT.md # Eksekutif summary, C4 diagram, Mini-ADR, & Execution Roadmap DAG β”œβ”€β”€ 01-api-contracts.md # Katalog endpoint lengkap, Request/Response DTO, RFC 7807, & Auth RBAC β”œβ”€β”€ 02-database-schema.sql # Script DDL SQL tabel, index strategi, constraints, & migrasi expand-contract β”œβ”€β”€ 03-erd-diagram.mermaid # Visual Mermaid erDiagram utuh dengan kardinalitas presisi β”œβ”€β”€ 04-transaction-sequences.mermaid # Visual Mermaid sequenceDiagram transaksi ACID, locking, & rollback β”œβ”€β”€ 05-ui-ux-design-system.md # Wireframe ASCII, 8pt grid, typografi clamp, 4 status UI, & anti-slop copy β”œβ”€β”€ 06-infrastructure-devops.md # Docker Compose (Self-Hosted), Redis Cache TTL, Queue Worker, & Cloud Cost β”œβ”€β”€ 07-comprehensive-test-plan.md # Matriks unit boundary, E2E Playwright, TDD contracts, & race condition test β”œβ”€β”€ 08-data-pipeline-and-analytics.md # (Khusus fitur data) Model ETL/ELT dbt, streaming Beam/Spark, & data app β”œβ”€β”€ 09-competitive-recon-and-parity.md# (Khusus mode clone) Analisis review kompetitor, fitur moat, & parity scoring └── openapi.json # Spesifikasi OpenAPI 3.1 valid siap impor Postman / Swagger ``` - Subagent hanya mengembalikan konfirmasi status singkat (maksimal 3–5 baris) kepada Lead Orchestrator. Lead Orchestrator menyajikan ringkasan eksekutif, cuplikan visual diagram kunci, dan tautan berkas di jendela chat. ### πŸšͺ Gate 5 β€” Pragmatic Sanity Check, Anti-Slop & Dual Deployment - **Boring Technology First**: Prioritaskan arsitektur paling sederhana dan andal (Modular Monolith + PostgreSQL + Redis) sebelum menyarankan arsitektur microservices terdistribusi yang rumit. - **Label Kompleksitas**: Cantumkan label estimasi kompleksitas: `[LOW]`, `[MEDIUM]`, atau `[HIGH]`. - **Anti-Slop AI Filter**: - Hapus komentar kode yang sekadar mengulang kode (contoh: `// get user by id`). - Hapus kata-kata klise AI dalam microcopy ("delve", "tapestry", "seamlessly", "elevate", "cutting-edge"). - Pastikan UI memiliki kontras tinggi (WCAG AAA) dan tidak menggunakan palet warna gradien ungu-biru AI generik. - **Dual Deployment Specifications**: 1. *Self-Hosted Option ($0 Cloud Cost)*: File `docker-compose.yml` lengkap (App, Postgres, Redis, Nginx) siap jalan di hardware lokal/server Debian mandiri. 2. *Managed Cloud Option*: Rekomendasi penyedia cloud ekonomis beserta kalkulasi estimasi tagihan bulanan ($/bulan). ### πŸšͺ Gate 6 β€” Accidental Data Loss Prevention & Zero-Downtime Migration - Seluruh perancangan database wajib mengadopsi pola **Expand-and-Contract (Parallel Run)** untuk migrasi skema tanpa *downtime*: 1. *Fase Expand*: Tambah kolom/tabel baru berdampingan dengan kolom lama. 2. *Fase Dual-Write*: Aplikasi menulis ke kolom lama dan baru secara paralel. 3. *Fase Backfill*: Sinkronisasi data historis. 4. *Fase Contract*: Alihkan pembacaan ke kolom baru dan hapus kolom lama secara terencana. - Tentukan target **RTO** (*Recovery Time Objective* $< 1\text{ jam}$) dan **RPO** (*Recovery Point Objective* $< 15\text{ menit}$) beserta skenario pencadangan otomatis (WAL archiving / automated snapshots). --- ## ⚑ 6 MODE EKSEKUSI TERPADU (EXECUTION MODES) Sistem secara otomatis menyesuaikan alur kerja dan subagent yang dikerahkan berdasarkan mode eksekusi: ### Mode A: Full Architecture Greenfield (Perancangan Lengkap dari Nol) Sintaks: `/system-planner Saya ingin membangun aplikasi [nama-ide]` - Mengerahkan seluruh kluster spesialis (Backend, Database, UI/UX, Testing, DevOps). - Menghasilkan 8 berkas inti (`00` s.d. `07` + `openapi.json`). ### Mode B: Granular Delta Update (Revisi Modul Spesifik) Sintaks: `/system-planner update [nama-modul] [perubahan yang diinginkan]` - Contoh: `/system-planner update payment Tambahkan payment gateway QRIS & Webhook Callback` - Hanya mengerahkan 1–3 subagent spesifik (misal Subagent API dan Database) untuk merevisi file yang relevan tanpa merusak arsitektur modul lain. ### Mode C: Reverse-Engineering & Clone Planning (Replica Mode) Sintaks: `/system-planner clone [target-url / nama-aplikasi / binary]` - Mengaktifkan subagent `reverse-engineer-anything` dan `replica-*`. - Melakukan audit fitur referensi (`recon-map.md`, `features.csv`), menambang review negatif pengguna kompetitor untuk menemukan peluang fitur unggulan (*moat*), ekstraksi token desain (`tokens.json`), skrip *rebranding sweep*, dan menghasilkan `09-competitive-recon-and-parity.md`. ### Mode D: Big Data, Analytics & ML Pipeline (Data Engine Mode) Sintaks: `/system-planner data [kebutuhan pipeline / data lakehouse / ML]` - Mengaktifkan subagent Big Data (`gcp-dataflow`, `gcp-spark`, `dbt-bigquery`, `dataform-bigquery`, `ml-best-practices`). - Merancang alur batch/streaming, pemodelan data mart dbt/Dataform, pembersihan data otomatis, dan menghasilkan `08-data-pipeline-and-analytics.md`. ### Mode E: UI/UX & Design System Architecture (Frontend Mode) Sintaks: `/system-planner ui [aplikasi / alur multi-screen]` - Mengaktifkan subagent `ui-ux-designer`, `taste`, `impeccable`, `content-states`, dan `figma-create-ui`. - Merancang sistem desain 8pt, palet warna berkarakter (bebas AI slop), 4 status tampilan lengkap (Empty, Loading, Error, Success), dan hierarki multi-screen wizard. ### Mode F: Testing & Quality Governance (TDD & Automation Mode) Sintaks: `/system-planner test [fitur / sistem target]` - Mengaktifkan subagent `tdd-orchestrator`, `test-automator`, dan `e2e-testing-patterns`. - Menyusun matriks pengujian kasus batas (*boundary conditions*), skenario *race condition* (misal *double submit* atau *inventory race*), dan blueprint otomasi Playwright E2E. --- ## πŸ‘₯ MATRIKS DYNAMIC TIER SIZING (SKALA SUBAGENT) Skalakan jumlah subagent paralel secara proporsional sesuai kompleksitas permintaan: | Tier Proyek | Cakupan Kebutuhan | Jumlah Subagents | Alokasi Kluster Subagent | |---|---|:---:|---| | **Tier 1** | Fitur Tunggal / Modul Spesifik / Delta Bugfix | **3–5** | 1 API Contract, 1 DB Schema, 1 Sequence Diagram, 1 Unit Test Blueprint | | **Tier 2** | Aplikasi Standar / MVP / SaaS Menengah | **6–10** | 2 API, 2 DB Domain, 2 Sequence ACID, 2 UI/UX Wireframe, 1 DevOps & Docker, 1 Test Blueprint | | **Tier 3** | Enterprise / Multi-Tenant / Big Data / Full Replica Clone | **12–32** | Kluster Domain Lengkap: API + DB + Sequence + UI/UX + Infra + Test + Data Pipeline + Competitor Recon | *(Batas konkurensi OMP: hingga 32 subagent paralel dalam satu panggilan `task`).* --- ## πŸ›οΈ DETAIL 8 KLUSTER SUBAGENT SPESIALIS ### 1. Kluster Backend, Distributed Systems & API - **Spesifikasi RESTful**: URI berbentuk kata benda jamak (`/api/v1/orders`), HTTP verb presisi (`GET`, `POST`, `PUT`, `PATCH`, `DELETE`). - **Pagination Standar**: Cursor-based pagination (`cursor`, `limit`, `has_more`, `next_cursor`) untuk koleksi data besar; offset pagination hanya untuk tabel administrasi kecil. - **Error Standard**: Wajib mematuhi format **RFC 7807 Problem Details**: ```json { "type": "https://api.example.com/errors/insufficient-stock", "title": "Insufficient Stock", "status": 422, "detail": "Product ID 459 only has 2 items available in inventory.", "instance": "/orders/checkout", "code": "OUT_OF_STOCK" } ``` - **Resilience Blueprint**: Idempotency Key (`Idempotency-Key` header via Redis TTL 24 jam), Circuit Breaker (Threshold 50% failure rate, 30s open time), dan Outbox Pattern untuk pengiriman event asinkron terjamin. ### 2. Kluster Database & Data Storage Engine - **Normalisasi vs Denormalisasi**: 3NF untuk inti transaksi OLTP; denormalisasi terencana / read-model hanya untuk query pelaporan performa tinggi. - **Strategi Indeks**: - B-Tree pada seluruh Foreign Key dan kolom pencarian `WHERE`. - Partial Index untuk record aktif: `CREATE INDEX idx_active_orders ON orders(user_id) WHERE status != 'CANCELLED';`. - Composite Index mematuhi aturan *Leftmost Prefix*. - **Connection Pooling**: Rekomendasi sizing PgBouncer: $\text{Pool Size} = ((\text{CPU Cores} \times 2) + \text{Spindle Count})$. - **Data Loss Protection**: Seluruh skrip migrasi dilarang menggunakan `DROP COLUMN` langsung; gunakan kolom baru dan tandai kolom usang sebagai *deprecated*. ### 3. Kluster Big Data, Analytics & ML Pipelines - **Data Modeling (Medallion Architecture)**: - *Bronze / Staging Layer*: Raw event ingestion tanpa filter, format append-only. - *Silver / Intermediate Layer*: Pembersihan data otomatis via `data-autocleaning` (deduplikasi, validasi tipe, standarisasi waktu UTC). - *Gold / Marts Layer*: Aggregated business metrics, dim/fact star-schema untuk BI dan reporting. - **Processing Engine Selection**: - Stream processing $< 1\text{ detik}$: Apache Beam on Google Cloud Dataflow. - Batch ETL berskala petabyte: Apache Spark / PySpark on Dataproc dengan format open-table BigLake Iceberg. - Transformasi in-warehouse: dbt-core / Dataform SQLX dengan *incremental models* dan automated test assertions. - **ML Architecture**: Feature store terpusat, versioning dataset, tracking latensi inferensi ($< 50\text{ms}$ untuk online serving), dan alert data drift. ### 4. Kluster UI/UX, Design System & Frontend - **Aturan 8pt Spacing Grid**: Seluruh margin, padding, dan jarak layout kelipatan 8px ($8, 16, 24, 32, 48, 64\text{px}$). - **Fluid Typography**: Menggunakan CSS `clamp()` untuk transisi mulus mobile ke desktop: `font-size: clamp(1rem, 0.8rem + 1vw, 1.5rem);`. - **4 Status Wajib per Tampilan (The 4 UI States)**: 1. *Empty State*: Ilustrasi kasaran, copy penjelasan yang ramah, dan tombol aksi utama (CTA). 2. *Loading State*: Skeleton shimmer dengan dimensi presisi sesuai konten (bukan spinner bulat tunggal). 3. *Error State*: Penjelasan kegagalan manusiawi, kode referensi, dan tombol coba lagi (*Retry*). 4. *Content/Success State*: Penyajian data lengkap dengan hierarki informasi kontras tinggi. - **Ergonomi Sentuh & Aksesibilitas**: Target tap minimal $44 \times 44\text{px}$, indikator fokus keyboard `:focus-visible` tegas, dan kontras warna teks mematuhi WCAG AAA ($\ge 7:1$). ### 5. Kluster Testing & Quality Assurance - **Piramida Pengujian**: - *Unit Tests (70%)*: Menguji logika domain murni, boundary value analysis, dan state transitions tanpa mock jaringan. - *Integration Tests (20%)*: Menguji integrasi controller dengan database nyata via Testcontainers. - *End-to-End Tests (10%)*: Skenario pengguna kritis (Login $\rightarrow$ Tambah Item $\rightarrow$ Checkout $\rightarrow$ Bayar) via Playwright. - **Matriks Kasus Ekstrem & Concurrency**: - Skenario *Double Submit* checkout: Penanganan idempotency token. - Skenario *Inventory Race Condition*: Uji coba 50 transaksi paralel merebutkan 1 stok terakhir menggunakan locking `SELECT FOR UPDATE` atau *optimistic concurrency* version column. ### 6. Kluster Anti-Slop AI Hygiene & Code Quality - **Komentar Kode Higienis**: Dilarang menulis komentar dekoratif (`// =================`) atau narasi aksi yang jelas (`// save user to db`). Komentar HANYA boleh ditulis untuk menjelaskan *alasan bisnis non-intuitif* atau aturan invariant kritis. - **Microcopy Alami**: Hindari jargon AI yang membosankan. Tulis instruksi dan tombol secara langsung, percaya diri, dan jelas (contoh: gunakan *"Simpan Pesanan"* daripada *"Memfasilitasi Penyimpanan Transaksi Anda secara Efisien"*). - **Desain Otentik**: Tolak kartu bayangan mengambang berlebihan (*overused glassmorphism*) dan gradien warna violet standar AI. Pilih palet warna fungsional yang merefleksikan karakter produk nyata. ### 7. Kluster Reverse-Engineering & App Clones (Replica Engine) - **Reconnaissance**: Petakan seluruh rute dan antarmuka aplikasi referensi ke dalam tabel fitur terstruktur (`features.csv` dan `recon-map.md`). - **Penambangan Review Kompetitor (*Competitor Review Mining*)**: - Ekstraksi keluhan rating bintang 1 dan 2 dari App Store / Play Store kompetitor. - Transformasikan keluhan pengguna tersebut menjadi fitur keunggulan (*competitive moat*) pada aplikasi baru. - **Audit Paritas & Rebranding**: - Berikan skor kesetaraan fungsional (*parity score* $0–100\%$). - Jalankan skrip *rebrand sweep* otomatis untuk memastikan tidak ada nama aset, logo, atau merek dagang asli yang bocor ke dalam kode clone. ### 8. Kluster Infrastructure, DevOps & Orchestration - **Self-Hosted Docker Compose**: - Konfigurasi multi-service: Application container (multi-stage build), PostgreSQL dengan persistent volume, Redis untuk cache & broker queue, serta Nginx reverse proxy dengan rate limiting. - **Redis Cache Strategy**: - Pola penamaan key berstruktur: `app:{entity}:{id}`, misal `app:product:1024`. - TTL terukur (misal 300 detik untuk data dinamis) dan invalidasi event-driven saat terjadi perubahan data. - **Antrean Tugas Asinkron (Async Worker Queue)**: - Pemisahan tugas berat (kirim email, pembuatan file PDF laporan, pengolahan gambar) ke background worker (BullMQ / Celery / Laravel Queue). --- ## πŸ“ KERANGKA BAKU BERKAS FISIK (`docs/architecture/`) Setiap subagent wajib mematuhi format baku berikut saat menuliskan berkas: ### 1. `00-MASTER-BLUEPRINT.md` - **Ringkasan Eksekutif**: Domain bisnis & pilihan arsitektur inti. - **Complexity Rating**: `[LOW]` / `[MEDIUM]` / `[HIGH]` beserta argumen teknis. - **Diagram Konteks Sistem (C4 / Mermaid)**: Peta interaksi antar komponen. - **Mini-ADR (Architecture Decision Records)**: Tabel perbandingan mengapa memilih solusi X dan menolak alternatif Y. - **Execution Roadmap (DAG)**: Langkah pengerjaan koding bertahap dari Fase 1 hingga Fase 5. ### 2. `01-api-contracts.md` & `openapi.json` - Tabel ringkasan seluruh rute API (Method, Path, Auth, Role, Rate Limit). - Rincian per endpoint: Request Headers, DTO Schema JSON, Response Success DTO (`200/201`), dan Response Error DTO RFC 7807 (`400/401/404/422/500`). - Berkas `openapi.json` (OpenAPI 3.1) yang valid untuk pengujian Postman. ### 3. `02-database-schema.sql` - Script DDL SQL murni (PostgreSQL / MySQL) dengan tipe data presisi, `NOT NULL`, `DEFAULT`, foreign key `ON DELETE RESTRICT/CASCADE`. - Definisi strategic indexes (B-Tree, Partial, Unique). - Skema kode ORM pendamping (`schema.prisma`, Drizzle `schema.ts`, atau model SQLAlchemy). - Rencana migrasi *zero-downtime expand-and-contract*. ### 4. `03-erd-diagram.mermaid` - Blok Mermaid `erDiagram` utuh dengan kardinalitas presisi (`||--o{`, `||--|{`, `}|--|{`) dan seluruh tipe kolom. ### 5. `04-transaction-sequences.mermaid` - Blok Mermaid `sequenceDiagram` bernomor (`autonumber`) untuk alur transaksi kritis: - Alur: Client $\rightarrow$ API Gateway $\rightarrow$ Service $\rightarrow$ DB Transaction. - Penanganan ACID: `BEGIN TRANSACTION`, `SELECT ... FOR UPDATE`, `COMMIT`, dan cabang `ROLLBACK` saat terjadi kegagalan. ### 6. `05-ui-ux-design-system.md` - Wireframe ASCII visual antarmuka pengguna kasaran. - Panduan 8pt Spacing Grid, Skala Tipografi Fluid `clamp()`, dan Palet Warna Semantik. - Matriks 4 Status Tampilan (Empty, Loading, Error, Success). - Panduan microcopy anti-slop (ringkas, tegas, manusiawi). ### 7. `06-infrastructure-devops.md` - File `docker-compose.yml` lengkap siap jalan di server lokal/Debian mandiri. - Pola caching Redis, TTL, dan aturan invalidasi. - Desain antrean tugas latar belakang (*Background Worker Queue*). - Komparasi Biaya: Self-Hosted ($0) vs Managed Cloud. ### 8. `07-comprehensive-test-plan.md` - Matriks Piramida Pengujian (Unit, Integrasi, E2E). - Matriks kasus batas (*Boundary Value Analysis*) dan pengujian konkurensi/race condition. - Kontrak pengujian TDD Red-Green-Refactor dan skenario Playwright E2E. ### 9. `08-data-pipeline-and-analytics.md` (Jika Memiliki Komponen Data) - Arsitektur Medallion (Bronze/Silver/Gold), spesifikasi dbt/Dataform models, pipeline streaming Apache Beam / PySpark, dan desain dashboard data. ### 10. `09-competitive-recon-and-parity.md` (Jika Mode Clone/Replica) - Matriks inventarisasi fitur referensi, analisis review negatif kompetitor sebagai fitur unggulan (*moat*), skor paritas, dan checklist peluncuran produk. --- ## πŸ”„ ALUR EKSEKUSI TERPADU (EXECUTION WORKFLOW) ```mermaid flowchart TD Prompt([Permintaan Pengguna]) --> Gate2[Gate 2: Workspace Guard Cek Direktori CWD] Gate2 --> F1[Fase 1: Interogasi Kebutuhan - Lead Orchestrator] F1 --> Gate1{Pengguna Menjawab 4-6 Pertanyaan?} Gate1 -- Belum --> Wait([Tunggu Respon Pengguna]) Gate1 -- Sudah --> F2[Fase 2: Schema Prelude & Tier Sizing] F2 --> Dispatch{Batch Dispatch Paralel 3-32 Subagents} subgraph MultiAgentExecution [Eksekusi Paralel Subagents Lintas-Disiplin] direction TB S1[Subagent API & openapi.json] S2[Subagent Database SQL & ORM] S3[Subagent Mermaid ERD] S4[Subagent Sequence ACID Flow] S5[Subagent UI/UX Design System] S6[Subagent Infra Docker & Cache] S7[Subagent Testing & Edge Cases] S8[Subagent Big Data / Analytics] S9[Subagent Replica / Competitor Recon] end Dispatch --> MultiAgentExecution MultiAgentExecution -->|Tulis Berkas Fisik Langsung| FS[(docs/architecture/ Berkas Fisik)] MultiAgentExecution --> F3[Fase 3: Cross-Consistency Audit & Anti-Slop Check] F3 --> F4[Fase 4: Verifikasi Master Blueprint & Gate 6 Data Safety] F4 --> F5[Fase 5: Ringkasan Eksekutif, Visual Diagram & Tautan Berkas di Chat] ``` --- ## πŸ› οΈ ADAPTASI LINTAS-HARNESS (CROSS-HARNESS ADAPTATION) - **Di Lingkungan OMP**: Gunakan tool delegasi `task` paralel dalam 1 batch array tunggal. - **Di Antigravity IDE / CLI**: Gunakan background worker agents atau slash-command subagent terpasang. - **Jika Concurrency Dibatasi**: Lead Orchestrator secara cerdas mengeksekusi per kluster spesialis berurutan (*tiered sequential fallback*) dan tetap menjamin seluruh berkas fisik tertulis rapi di folder `docs/architecture/`.