vibes-plug 2.11.0 → 2.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/.cursor/rules/vibes-plug-core.mdc +3 -3
  2. package/.cursorrules +3 -3
  3. package/AGENTS.md +4 -4
  4. package/BLUEPRINT.md +16 -6
  5. package/CHANGELOG.md +37 -0
  6. package/CLAUDE.md +8 -8
  7. package/README.md +85 -115
  8. package/index.js +1 -1
  9. package/package.json +2 -2
  10. package/plugin.json +2 -2
  11. package/scripts/check-anti-slop.js +53 -0
  12. package/scripts/generate_swarm_gif.py +2 -2
  13. package/skills/ai-llm-integration-expert/SKILL.md +22 -15
  14. package/skills/ai-prompt-engineering-expert/SKILL.md +133 -83
  15. package/skills/anti-slop/SKILL.md +133 -0
  16. package/skills/async-queue-temporal-expert/SKILL.md +135 -158
  17. package/skills/authentication-identity-expert/SKILL.md +172 -278
  18. package/skills/brainstorming/SKILL.md +26 -26
  19. package/skills/database-orm-expert/SKILL.md +164 -303
  20. package/skills/deep-research-analyst/SKILL.md +136 -0
  21. package/skills/design-system-architect/SKILL.md +31 -1
  22. package/skills/email-notification-expert/SKILL.md +31 -4
  23. package/skills/error-resilience-expert/SKILL.md +21 -0
  24. package/skills/fullstack-expert/SKILL.md +183 -260
  25. package/skills/glsl-shader-expert/SKILL.md +190 -107
  26. package/skills/graph-rag-knowledge-expert/SKILL.md +42 -1
  27. package/skills/mcp-server-architect/SKILL.md +15 -1
  28. package/skills/prd-architect/SKILL.md +181 -206
  29. package/skills/production-ready-hardener/SKILL.md +16 -19
  30. package/skills/pwa-offline-first-expert/SKILL.md +42 -1
  31. package/skills/pydantic-ai-expert/SKILL.md +161 -0
  32. package/skills/saas-architect/SKILL.md +154 -0
  33. package/skills/senior-frontend/SKILL.md +9 -11
  34. package/skills/senior-frontend/scripts/frontend_scaffolder.py +1 -1
  35. package/skills/session-memory-manager/SKILL.md +128 -0
  36. package/skills/synthetic-data-finetuning-expert/SKILL.md +155 -0
  37. package/skills/ui-ux-pro-max/SKILL.md +4 -2
  38. package/skills/vercel-ai-sdk-expert/SKILL.md +181 -0
  39. package/skills/voice-ai-realtime-agent/SKILL.md +41 -1
  40. package/skills/web-3d-graphics-expert/SKILL.md +313 -137
  41. package/skills/web-game-engine-expert/SKILL.md +329 -102
  42. package/skills/webxr-ar-vr-expert/SKILL.md +162 -123
  43. package/skills/zero-to-prod-orchestrator/SKILL.md +26 -24
  44. package/skills/ai-cost-token-optimizer/SKILL.md +0 -82
  45. package/skills/ai-evals-benchmark-expert/SKILL.md +0 -188
  46. package/skills/asisten-ramah/SKILL.md +0 -47
  47. package/skills/auto-doc-updater/SKILL.md +0 -220
  48. package/skills/autonomous-chaos-monkey/SKILL.md +0 -63
  49. package/skills/background-jobs-queue-expert/SKILL.md +0 -235
  50. package/skills/database-migration-versioning-expert/SKILL.md +0 -90
  51. package/skills/edge-serverless-db-expert/SKILL.md +0 -99
  52. package/skills/mcp-client-orchestrator/SKILL.md +0 -76
  53. package/skills/mobile-push-notification-expert/SKILL.md +0 -71
  54. package/skills/monday-design-aesthetic/SKILL.md +0 -73
  55. package/skills/project-context-mapper/SKILL.md +0 -85
  56. package/skills/saas-mvp-launcher/SKILL.md +0 -260
  57. package/skills/saas-transformer/SKILL.md +0 -500
  58. package/skills/saas-transformer/references/billing_integration_guide.md +0 -401
  59. package/skills/self-evolving-memory-graph/SKILL.md +0 -91
  60. package/skills/session-context-loader/SKILL.md +0 -83
  61. package/skills/session-handoff-resume/SKILL.md +0 -164
  62. package/skills/skill-baru/SKILL.md +0 -178
  63. package/skills/supabase-migration/SKILL.md +0 -91
  64. package/skills/token-saver/SKILL.md +0 -119
  65. package/skills/ui-components-expert/SKILL.md +0 -166
  66. package/skills/vibe-code-gardener/SKILL.md +0 -181
  67. /package/skills/{saas-transformer → saas-architect}/references/feature_gating_patterns.md +0 -0
  68. /package/skills/{saas-transformer → saas-architect}/references/saas_transformation_checklist.md +0 -0
  69. /package/skills/{saas-transformer → saas-architect}/scripts/saas_transformation_scanner.py +0 -0
@@ -1,123 +1,162 @@
1
- ---
2
- name: webxr-ar-vr-expert
3
- description: "Expert guide for WebXR (Web-based Virtual and Augmented Reality) development using Babylon.js and Three.js. Covers device compatibility, immersive sessions, controllers, and hit-testing."
4
- author: "Roedy Rustam"
5
- ---
6
-
7
- # WebXR AR/VR Expert
8
-
9
- [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
-
11
- ---
12
-
13
- <a name="english"></a>
14
- ## English
15
-
16
- ### Orchestration & Integration
17
- Connects and orchestrates with relevant domain skills like `brainstorming`, `zero-to-prod-orchestrator`, and `project-context-mapper` to ensure cohesive execution.
18
-
19
- ### Description
20
- Production-grade guidance for building immersive **Augmented Reality (AR)** and **Virtual Reality (VR)** experiences in the browser using the **WebXR Device API**. Focuses on implementation via **Babylon.js** (which has industry-leading WebXR support) and **Three.js** / React Three Fiber.
21
-
22
- ### Trigger Conditions
23
- Activate this skill when the user is:
24
- - Building AR/VR experiences for Oculus/Meta Quest, Apple Vision Pro, or mobile AR devices.
25
- - Setting up an `immersive-vr` or `immersive-ar` WebXR session.
26
- - Implementing controller tracking, hand tracking, or teleportation in 3D space.
27
- - Using AR Hit-Testing to place digital objects on physical surfaces (floors/tables).
28
-
29
- ### Core Concepts
30
-
31
- #### 1. Babylon.js WebXR Setup
32
- Babylon.js provides the most robust default WebXR experience.
33
- ```typescript
34
- import { Scene, FreeCamera, Vector3, Engine } from '@babylonjs/core';
35
-
36
- async function setupXR(scene: Scene) {
37
- // Initialize default WebXR experience
38
- // This automatically adds the "Enter VR/AR" button, teleportation, and controller models
39
- const xr = await scene.createDefaultXRExperienceAsync({
40
- uiOptions: {
41
- sessionMode: 'immersive-vr', // or 'immersive-ar'
42
- },
43
- optionalFeatures: true
44
- });
45
-
46
- // Example: Listen for controller input
47
- xr.input.onControllerAddedObservable.add((controller) => {
48
- controller.onMotionControllerInitObservable.add((motionController) => {
49
- // Handle button presses
50
- });
51
- });
52
- }
53
- ```
54
-
55
- #### 2. Three.js / React Three Fiber Setup
56
- In R3F, use `@react-three/xr`.
57
- ```tsx
58
- import { Canvas } from '@react-three/fiber';
59
- import { XR, createXRStore } from '@react-three/xr';
60
-
61
- const store = createXRStore();
62
-
63
- export default function App() {
64
- return (
65
- <>
66
- <button onClick={() => store.enterVR()}>Enter VR</button>
67
- <Canvas>
68
- <XR store={store}>
69
- <mesh>
70
- <boxGeometry />
71
- <meshBasicMaterial color="red" />
72
- </mesh>
73
- </XR>
74
- </Canvas>
75
- </>
76
- );
77
- }
78
- ```
79
-
80
- #### 3. AR Hit-Testing
81
- In AR mode, "Hit-Testing" allows you to detect real-world surfaces.
82
- - Ensure `immersive-ar` is used.
83
- - Request the `hit-test` feature when initializing the session.
84
- - Use the hit-test results (a matrix/position) to place a reticle or object.
85
-
86
- ### Best Practices
87
- - **Performance is Critical:** VR requires a consistent 72 to 90 FPS (or 120 FPS on Apple Vision Pro). Dropped frames cause motion sickness.
88
- - **Polycount:** Keep polygon counts and draw calls low.
89
- - **UI in XR:** Standard HTML UI will not work in immersive mode. You must use 3D UI (e.g., Babylon's GUI 3D system or Three.js spatial HTML layers if supported).
90
-
91
- ---
92
-
93
- ### Integration with Other Skills (MANDATORY)
94
- This skill works best when combined with:
95
- - `web-3d-graphics-expert` — For building the 3D scene that XR will visualize.
96
- - `apple-ecosystem-expert` — For optimizing WebXR compatibility with iOS (Safari) and visionOS.
97
- - `web-game-engine-expert` — For adding physics to VR interactions (e.g., throwing objects).
98
-
99
- ### Referenced By Orchestrators (MANDATORY)
100
- - `brainstorming` — Add to "3D & Graphics" or "Spatial Computing".
101
- - `zero-to-prod-orchestrator` — Phase 5 (Frontend / XR Implementation).
102
-
103
- ---
104
-
105
- <a name="bahasa-indonesia"></a>
106
- ## Bahasa Indonesia
107
-
108
- ### Integrasi Orkestrasi
109
- Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
110
-
111
- ### Deskripsi
112
- Panduan ahli untuk pengembangan *Virtual Reality* (VR) dan *Augmented Reality* (AR) di web menggunakan **WebXR API**. Difokuskan pada implementasi menggunakan **Babylon.js** dan **Three.js** untuk ekosistem *Spatial Computing*.
113
-
114
- ### Kondisi Pemicu
115
- - Mengembangkan aplikasi VR/AR untuk Meta Quest, Apple Vision Pro, atau Mobile AR.
116
- - Mengimplementasikan pelacakan pengontrol (controller), pelacakan tangan (hand tracking), atau teleportasi.
117
- - Menggunakan AR Hit-Testing untuk meletakkan objek 3D di permukaan dunia nyata.
118
-
119
- ### Panduan Singkat
120
- - **Performa Mutlak:** Jaga FPS tetap stabil di angka 72-90 FPS. *Frame drop* pada VR menyebabkan rasa mual (motion sickness) pada pengguna. Batasi jumlah poligon dan *draw calls*.
121
- - **Babylon.js sebagai Prioritas:** Untuk proyek XR berskala besar, prioritaskan Babylon.js karena dukungan bawaannya untuk interaksi VR, fisika, dan UI 3D jauh lebih matang dibanding library lain.
122
- - **UI Spasial:** Ingat bahwa elemen HTML biasa tidak muncul di dalam sesi `immersive-vr` atau `immersive-ar`. Anda harus membuat UI berupa objek 3D (seperti panel yang melayang di udara).
123
- - **Hit-Testing:** Untuk AR, gunakan fitur *Hit-Test* yang disediakan WebXR API untuk mengenali lantai atau meja sebagai tempat menaruh objek.
1
+ ---
2
+ name: webxr-ar-vr-expert
3
+ description: "Expert guide for WebXR spatial computing, Web-based Virtual Reality (VR), Mixed Reality (MR), and Augmented Reality (AR) using Babylon.js and Three.js. Covers Apple Vision Pro, Meta Quest 3, hand tracking, and hit-testing / Panduan ahli WebXR spatial computing (VR/AR/MR)."
4
+ author: "vibes-plug-swarm"
5
+ ---
6
+
7
+ # WebXR Spatial Computing Expert (VR, AR & MR)
8
+
9
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
+
11
+ ---
12
+
13
+ <a name="english"></a>
14
+ ## English
15
+
16
+ ### Orchestration & Integration
17
+ Connects and orchestrates with relevant domain skills:
18
+ - `web-3d-graphics-expert` — WebGPU/WebGL 3D scene rendering, lighting, and model optimization.
19
+ - `web-game-engine-expert` — Spatial physics, grabbing interactions, and fixed-timestep motion.
20
+ - `apple-ecosystem-expert` — Apple Vision Pro visionOS Safari WebXR features and spatial guidelines.
21
+ - `glsl-shader-expert` — Passthrough blending and spatial holographic shaders.
22
+ - `performance-web-vitals` — Maintaining rock-solid 72/90/120 FPS to prevent simulator sickness.
23
+
24
+ ### Description
25
+ Production-grade guidance for architecting immersive **Virtual Reality (VR)**, **Mixed Reality (MR)**, and **Augmented Reality (AR)** in the browser via the **WebXR Device API**. Covers modern head-mounted displays (**Meta Quest 3/3S**, **Apple Vision Pro**) and mobile AR, focusing on Babylon.js and Three.js with `@react-three/xr`.
26
+
27
+ ### Trigger Conditions
28
+ Activate this skill when the user is:
29
+ - Developing spatial computing web applications or immersive web experiences.
30
+ - Setting up WebXR sessions (`immersive-vr`, `immersive-ar`).
31
+ - Implementing Hand Tracking (joint poses, pinch gestures) or spatial controller interactions.
32
+ - Adding Mixed Reality passthrough or depth sensing.
33
+ - Implementing AR Hit-Testing to snap 3D models onto real-world planes (floors, walls, tabletops).
34
+ - Optimizing XR framerates (fixed foveated rendering) to eliminate motion sickness.
35
+
36
+ ---
37
+
38
+ ### Key Capabilities & Headset Targets (2026)
39
+
40
+ | Target Platform | Session Mode | Key Features |
41
+ | :--- | :--- | :--- |
42
+ | **Meta Quest 3 / 3S** | `immersive-vr`, `immersive-ar` | Full-color stereo passthrough, high-precision hand tracking, fixed foveation levels 0-3. |
43
+ | **Apple Vision Pro (visionOS)** | `immersive-vr`, `immersive-ar` | Eye-gaze + pinch interaction, 90/120Hz display refresh, strict privacy hand tracking. |
44
+ | **Mobile AR (Android / iOS WebKit)** | `immersive-ar` | Surface hit-testing, ambient light estimation, instant plane detection. |
45
+
46
+ ---
47
+
48
+ ### 1. Babylon.js WebXR Setup (Gold Standard)
49
+
50
+ Babylon.js provides the most comprehensive out-of-the-box WebXR implementation with integrated teleportation, controller profiles, and physics:
51
+
52
+ ```typescript
53
+ import { Scene, WebXRExperienceHelper, WebXRFeatureName } from '@babylonjs/core';
54
+
55
+ export async function initBabylonXR(scene: Scene) {
56
+ const xr = await scene.createDefaultXRExperienceAsync({
57
+ uiOptions: {
58
+ sessionMode: 'immersive-ar', // Fallback to 'immersive-vr' if AR is unsupported
59
+ referenceSpaceType: 'local-floor'
60
+ },
61
+ optionalFeatures: ['hit-test', 'hand-tracking', 'anchors', 'plane-detection']
62
+ });
63
+
64
+ // Enable Fixed Foveated Rendering to reclaim 20-30% GPU performance on Quest
65
+ const foveation = xr.baseExperience.featuresManager.enableFeature(
66
+ WebXRFeatureName.FOVEATION,
67
+ 'latest',
68
+ { foveationLevel: 2 }
69
+ );
70
+
71
+ // Listen for Hand Tracking
72
+ const handTracking = xr.baseExperience.featuresManager.enableFeature(
73
+ WebXRFeatureName.HAND_TRACKING,
74
+ 'latest',
75
+ { xrInput: xr.input }
76
+ );
77
+
78
+ return xr;
79
+ }
80
+ ```
81
+
82
+ ---
83
+
84
+ ### 2. React Three Fiber Setup (`@react-three/xr`)
85
+
86
+ ```tsx
87
+ import { Canvas } from '@react-three/fiber';
88
+ import { XR, createXRStore, Hands, Controllers } from '@react-three/xr';
89
+
90
+ const store = createXRStore({
91
+ foveation: 1,
92
+ handTracking: true
93
+ });
94
+
95
+ export function SpatialApp() {
96
+ return (
97
+ <>
98
+ <button className="xr-btn" onClick={() => store.enterAR()}>
99
+ Enter Mixed Reality
100
+ </button>
101
+ <Canvas>
102
+ <XR store={store}>
103
+ <ambientLight intensity={0.8} />
104
+ <directionalLight position={[5, 10, 5]} />
105
+ <Controllers />
106
+ <Hands />
107
+ {/* Spatial 3D Objects */}
108
+ <mesh position={[0, 1.2, -1]}>
109
+ <boxGeometry args={[0.3, 0.3, 0.3]} />
110
+ <meshStandardMaterial color="royalblue" />
111
+ </mesh>
112
+ </XR>
113
+ </Canvas>
114
+ </>
115
+ );
116
+ }
117
+ ```
118
+
119
+ ---
120
+
121
+ ### Best Practices for Spatial Performance
122
+ 1. **Rock-Solid Framerates:** VR requires stable 72, 90, or 120 FPS. Any frame drop causes instant vestibular nausea.
123
+ 2. **Fixed Foveated Rendering (FFR):** Reduces fragment shader resolution in the user's peripheral vision, freeing substantial GPU overhead.
124
+ 3. **No 2D DOM Overlays in VR:** Standard HTML elements cannot render inside an immersive session. Render spatial 3D UI panels using world-space 3D meshes or canvas textures.
125
+
126
+ ---
127
+
128
+ <a name="bahasa-indonesia"></a>
129
+ ## Bahasa Indonesia
130
+
131
+ ### Integrasi Orkestrasi
132
+ Terhubung dan mengorkestrasi skill domain yang relevan:
133
+ - `web-3d-graphics-expert` — Rendering scene 3D WebGPU/WebGL, pencahayaan, dan optimasi model.
134
+ - `web-game-engine-expert` — Fisika spasial, interaksi menggenggam objek, dan pergerakan fixed-timestep.
135
+ - `apple-ecosystem-expert` — Fitur WebXR Safari di Apple Vision Pro visionOS dan pedoman spasial.
136
+ - `glsl-shader-expert` — Shader hologram dan blending passthrough AR.
137
+ - `performance-web-vitals` — Menjaga kestabilan 72/90/120 FPS demi mencegah *motion sickness*.
138
+
139
+ ### Deskripsi
140
+ Panduan produksi untuk membangun aplikasi spasial imersif **Virtual Reality (VR)**, **Mixed Reality (MR)**, dan **Augmented Reality (AR)** di browser melalui **WebXR Device API**. Mencakup headset modern (**Meta Quest 3/3S**, **Apple Vision Pro**) serta perangkat mobile AR.
141
+
142
+ ### Kondisi Pemicu
143
+ Aktifkan skill ini ketika pengguna:
144
+ - Mengembangkan aplikasi web *Spatial Computing* (VR/AR/MR).
145
+ - Menginisialisasi sesi WebXR (`immersive-vr`, `immersive-ar`).
146
+ - Mengimplementasikan *Hand Tracking* (pelacakan sendi tangan, gerakan cubit/pinch) atau kontroler spasial.
147
+ - Mengaktifkan *Passthrough* warna Mixed Reality.
148
+ - Menggunakan AR *Hit-Testing* untuk menempatkan objek 3D di lantai atau meja fisik.
149
+ - Mengoptimalkan performa VR dengan *Fixed Foveated Rendering* (FFR).
150
+
151
+ ---
152
+
153
+ ### Panduan Inti Pengembangan Spasial
154
+
155
+ 1. **Stabilitas Frame Rate Mutlak**:
156
+ - Targetkan 72–90 FPS tanpa toleransi *stutter*. Pada kacamata VR, keterlambatan frame (*latency hitch*) langsung memicu rasa mual (*motion sickness*).
157
+ 2. **Fixed Foveated Rendering (FFR)**:
158
+ - Aktifkan fitur foveation pada Meta Quest untuk menurunkan resolusi tepi lensa (periferi mata), menghemat 20-30% daya GPU.
159
+ 3. **Antarmuka 3D Spasial (Bukan HTML DOM)**:
160
+ - Elemen HTML standar tidak dapat ditampilkan di dalam sesi imersif. Buat UI berupa panel 3D melayang (*world-space meshes*).
161
+ 4. **Hit-Testing untuk AR**:
162
+ - Manfaatkan *Hit-Test API* bawaan WebXR untuk mendeteksi bidang nyata permukaan meja atau lantai secara instan sebelum meletakkan objek 3D.
@@ -14,7 +14,7 @@ author: "Roedy Rustam"
14
14
  ## English
15
15
 
16
16
  ### Orchestration & Integration
17
- Connects and orchestrates with relevant domain skills like `brainstorming`, `zero-to-prod-orchestrator`, and `project-context-mapper` to ensure cohesive execution.
17
+ Connects and orchestrates with relevant domain skills like `brainstorming`, `zero-to-prod-orchestrator`, and `session-memory-manager` to ensure cohesive execution.
18
18
 
19
19
  ### Overview
20
20
  The **Zero to Production Orchestrator** is the ultimate master skill designed to orchestrate the entire `vibes-plug` ecosystem as a highly interconnected **engineering swarm**. By acting as the central conductor, it ensures that no sub-skill is executed in isolation. It guides fullstack developers through the complete software engineering lifecycle — from concept discovery to AI integration, multi-platform backend architecture, design systems, automated testing, GEO/AEO optimization, and production deployment.
@@ -26,10 +26,10 @@ The **Zero to Production Orchestrator** is the ultimate master skill designed to
26
26
 
27
27
  ### Core Principles & Hard Gates
28
28
  1. **Never Skip Phases**: Each phase must be completed and validated before advancing to the next.
29
- 2. **Continuous Auto-Documentation**: Invoke `auto-doc-updater` to log changes in `CHANGELOG.md` and `BLUEPRINT.md` after every major milestone.
29
+ 2. **Continuous Auto-Documentation**: Invoke `prd-architect` to log changes in `CHANGELOG.md` and `BLUEPRINT.md` after every major milestone.
30
30
  3. **Strict Progress Tracking**: Maintain a `PROGRESS.md` checklist in the repository root.
31
- 4. **State Preservation & Context**: Utilize `session-handoff-resume` when pausing work, and `session-context-loader` on every new session to preserve full context.
32
- 5. **Efficiency**: Keep `token-saver` active during large refactors to maintain a lean, powerful execution loop.
31
+ 4. **State Preservation & Context**: Utilize `session-memory-manager` when pausing work or starting a new session to preserve full context.
32
+ 5. **Efficiency**: Keep `anti-slop` active during large refactors to maintain a lean, powerful, and zero-placeholder execution loop.
33
33
 
34
34
  ---
35
35
 
@@ -45,7 +45,7 @@ Launch/Deploy <--- Security/GEO <--- Testing/QA <--- Frontend/UI
45
45
  ```
46
46
 
47
47
  #### PHASE 1: Discovery & AI PRD Architectural Planning
48
- **Orchestrates:** `prd-architect`, `brainstorming`, `mcp-server-architect`, `session-context-loader`, `dependency-upgrade-migrator`, `app-analyzer-optimizer`, `seo`, `project-context-mapper`, `self-evolving-memory-graph`, `saas-mvp-launcher`, `web-scraper`, `website-design-cloner`, `headless-cms-expert`, `wordpress-headless-expert`, `documentation-site-expert`, `asisten-ramah`, `skill-baru`
48
+ **Orchestrates:** `prd-architect`, `brainstorming`, `deep-research-analyst`, `mcp-server-architect`, `session-memory-manager`, `dependency-upgrade-migrator`, `app-analyzer-optimizer`, `seo`, `saas-architect`, `web-scraper`, `website-design-cloner`, `headless-cms-expert`, `wordpress-headless-expert`, `documentation-site-expert`, `anti-slop`
49
49
  - [ ] Conduct structured dialogue to clarify product intent, target audience, and non-functional goals.
50
50
  - [ ] Automatically draft a comprehensive Product Requirements Document (PRD.md), Entity Relationship Diagram (ERD.md), and Documentation (DOKUMENTASI.md) alongside the Roadmap (ROADMAP.md).
51
51
  - [ ] Plan AI/LLM integration strategy (Vercel AI SDK, MCP Server tools, or Multi-Agent Graph).
@@ -60,14 +60,14 @@ Launch/Deploy <--- Security/GEO <--- Testing/QA <--- Frontend/UI
60
60
  - [ ] Setup initial CI/CD pipeline template (GitHub Actions, Docker).
61
61
 
62
62
  #### PHASE 3: Database & Multi-Tenant Core Architecture
63
- **Orchestrates:** `fullstack-expert`, `database-migration-versioning-expert`, `database-orm-expert`, `domain-driven-design-expert`, `saas-multi-tenant`, `supabase-migration`, `supabase-security-expert`, `edge-serverless-db-expert`, `data-pipeline-etl-expert`, `search-engine-expert`, `geospatial-maps-expert`, `graph-rag-knowledge-expert`
63
+ **Orchestrates:** `fullstack-expert`, `database-orm-expert`, `domain-driven-design-expert`, `saas-multi-tenant`, `supabase-security-expert`, `data-pipeline-etl-expert`, `search-engine-expert`, `geospatial-maps-expert`, `graph-rag-knowledge-expert`
64
64
  - [ ] Design normalized relational schemas, document models, and geospatial PostGIS structures.
65
65
  - [ ] Configure ORM layer (Drizzle ORM / Prisma 6 / SQLx / sqlc) and full-text search indexing (Typesense/Meilisearch).
66
66
  - [ ] Implement Row-Level Security (RLS) policies and tenant isolation.
67
67
  - [ ] Apply initial database migrations and connection poolers (PgBouncer/Supavisor/Neon).
68
68
 
69
69
  #### PHASE 4: Backend APIs, Microservices & AI Agents
70
- **Orchestrates:** `js-backend-expert`, `go-programming-expert`, `graphql-apollo-expert`, `openapi-swagger-codegen-expert`, `ai-llm-integration-expert`, `ai-prompt-engineering-expert`, `ai-media-generation-expert`, `multi-agent-orchestration`, `mcp-server-architect`, `authentication-identity-expert`, `email-notification-expert`, `cron-scheduler-expert`, `rate-limit-abuse-prevention`, `file-upload-media-expert`, `async-queue-temporal-expert`, `background-jobs-queue-expert`, `doku-mcp-server`, `event-driven-architect`, `gemini-agent-booster`, `mobile-push-notification-expert`, `realtime-collaboration-expert`, `api-gateway-proxy-expert`, `wasm-edge-computing-expert`, `sse-websocket-streaming-expert`, `n8n-automation-expert`, `chatbot-messaging-expert`, `pdf-document-generation-expert`, `ecommerce-expert`, `blockchain-web3-expert`, `local-slm-edge-ai-expert`, `voice-ai-realtime-agent`, `graph-rag-knowledge-expert`
70
+ **Orchestrates:** `js-backend-expert`, `go-programming-expert`, `pydantic-ai-expert`, `vercel-ai-sdk-expert`, `synthetic-data-finetuning-expert`, `graphql-apollo-expert`, `openapi-swagger-codegen-expert`, `ai-llm-integration-expert`, `ai-prompt-engineering-expert`, `ai-media-generation-expert`, `multi-agent-orchestration`, `mcp-server-architect`, `authentication-identity-expert`, `email-notification-expert`, `cron-scheduler-expert`, `rate-limit-abuse-prevention`, `file-upload-media-expert`, `saas-billing`, `payment-gateway-expert`, `vector-db-rag-expert`, `async-queue-temporal-expert`, `doku-mcp-server`, `event-driven-architect`, `gemini-agent-booster`, `realtime-collaboration-expert`, `api-gateway-proxy-expert`, `wasm-edge-computing-expert`, `sse-websocket-streaming-expert`, `n8n-automation-expert`, `chatbot-messaging-expert`, `pdf-document-generation-expert`, `ecommerce-expert`, `blockchain-web3-expert`, `local-slm-edge-ai-expert`, `voice-ai-realtime-agent`, `graph-rag-knowledge-expert`
71
71
  - [ ] Build high-throughput REST / GraphQL / gRPC APIs using Fastify 5, NestJS, Hono, Gin, or Axum.
72
72
  - [ ] Implement authentication (Clerk, Auth.js, Supabase Auth) and RBAC middleware.
73
73
  - [ ] Build MCP Server tools or stateful LangGraph multi-agent workflows with human-in-the-loop gates.
@@ -77,7 +77,7 @@ Launch/Deploy <--- Security/GEO <--- Testing/QA <--- Frontend/UI
77
77
  - [ ] Implement file upload with presigned URLs (S3/R2) and media processing.
78
78
 
79
79
  #### PHASE 5: Frontend, Design Systems & Mobile Apps
80
- **Orchestrates:** `modern-web-guidance`, `design-system-architect`, `senior-frontend`, `nextjs-app-router-expert`, `vue-frontend-expert`, `astro-framework-expert`, `svelte-sveltekit-expert`, `solidjs-expert`, `angular-expert`, `tailwind-expert`, `tanstack-query-expert`, `spa-orchestrator`, `mobile-expo-expert`, `apple-ecosystem-expert`, `tauri-expert`, `desktop-electron-expert`, `form-validation-expert`, `ui-components-expert`, `svg-animation-motion-expert`, `web-3d-graphics-expert`, `web-game-engine-expert`, `glsl-shader-expert`, `webxr-ar-vr-expert`, `visual-qa-vision-agent`, `hig`, `global-a11y-i18n-expert`, `bootstrap-to-modern`, `monday-design-aesthetic`, `state-management-expert`, `ui-ux-pro-max`, `data-visualization-expert`, `rich-text-editor-expert`, `documentation-site-expert`, `blockchain-web3-expert`, `modern-css-native-expert`, `pwa-offline-first-expert`
80
+ **Orchestrates:** `modern-web-guidance`, `design-system-architect`, `senior-frontend`, `vercel-ai-sdk-expert`, `nextjs-app-router-expert`, `vue-frontend-expert`, `astro-framework-expert`, `svelte-sveltekit-expert`, `solidjs-expert`, `angular-expert`, `tailwind-expert`, `tanstack-query-expert`, `spa-orchestrator`, `mobile-expo-expert`, `apple-ecosystem-expert`, `tauri-expert`, `desktop-electron-expert`, `form-validation-expert`, `svg-animation-motion-expert`, `web-3d-graphics-expert`, `web-game-engine-expert`, `glsl-shader-expert`, `webxr-ar-vr-expert`, `visual-qa-vision-agent`, `hig`, `global-a11y-i18n-expert`, `bootstrap-to-modern`, `state-management-expert`, `ui-ux-pro-max`, `data-visualization-expert`, `rich-text-editor-expert`, `documentation-site-expert`, `blockchain-web3-expert`, `modern-css-native-expert`, `pwa-offline-first-expert`
81
81
  - [ ] **MANDATORY**: Run `modern-web-guidance` FIRST before implementing any frontend HTML/CSS/JS features to ensure compliance with modern Google standards.
82
82
  - [ ] Implement design tokens (OKLCH) and Tailwind CSS v4 `@theme` directive tokens.
83
83
  - [ ] Construct accessible component primitives using Radix UI / Base UI and CVA variants.
@@ -85,28 +85,29 @@ Launch/Deploy <--- Security/GEO <--- Testing/QA <--- Frontend/UI
85
85
  - [ ] Build React 19 / Next.js 15, Vue 3, Astro 5, Svelte 5, SolidJS 2, or Angular 19+ apps with state management and Web3 wallets.
86
86
  - [ ] **MANDATORY**: Automatically scaffold standard pages: About, Profile, Contact, Terms of Reference/Service, and Privacy Policy.
87
87
  - [ ] Implement complex forms with React Hook Form + Zod validation.
88
+ - [ ] If 3D Web or Web Games: architect with WebGPU (`WebGPURenderer`, PlayCanvas, or Babylon.js), KTX2 Basis Universal texture compression, Meshopt geometry, fixed-timestep physics loops, zero-GC object pooling, and 3D spatial audio.
88
89
  - [ ] If SPA architecture — coordinate with `spa-orchestrator` for routing (TanStack Router), state (TanStack Query v5), and decoupled API layer.
89
90
  - [ ] Integrate frontend state management with TanStack Query v5.
90
91
 
91
92
  #### PHASE 6: Automated Testing, Error Resilience & Security Audit
92
- **Orchestrates:** `e2e-testing-expert`, `accessibility-testing-expert`, `secure-fuzz-testing`, `firebase-security-expert`, `error-resilience-expert`, `logging-error-tracking-expert`, `vibe-code-gardener`, `coderabbit`, `autonomous-tdd-debugger`, `browser-automation-expert`, `zero-trust-secret-vault`, `autonomous-red-teamer`, `post-quantum-crypto-migrator`, `compliance-gdpr-privacy-expert`, `ai-evals-benchmark-expert`
93
+ **Orchestrates:** `e2e-testing-expert`, `accessibility-testing-expert`, `secure-fuzz-testing`, `firebase-security-expert`, `error-resilience-expert`, `logging-error-tracking-expert`, `anti-slop`, `coderabbit`, `autonomous-tdd-debugger`, `browser-automation-expert`, `zero-trust-secret-vault`, `autonomous-red-teamer`, `post-quantum-crypto-migrator`, `compliance-gdpr-privacy-expert`
93
94
  - [ ] Write unit and integration tests with Vitest and pytest.
94
95
  - [ ] Write resilient E2E browser tests with Playwright and automated WCAG 2.2 accessibility tests with `@axe-core/playwright` and Pa11y.
95
96
  - [ ] Execute security fuzz testing (Atheris / cargo-fuzz / native Go fuzzing).
96
97
  - [ ] Implement Error Boundaries, retry patterns, circuit breakers, and graceful degradation.
97
98
  - [ ] Set up structured logging (Pino) and error tracking (Sentry) with source map uploads.
98
99
  - [ ] Audit CORS, CSP headers, rate-limiting, and input sanitization.
99
- - [ ] Run code quality audit to purge AI slop and architectural decay.
100
+ - [ ] Run code quality audit to purge AI slop and architectural decay with anti-slop.
100
101
 
101
102
  #### PHASE 7: DevOps, Deployment & Proactive Monitoring
102
- **Orchestrates:** `ci-cd-devops-architect`, `cloud-hosting-expert`, `performance-web-vitals`, `logging-error-tracking-expert`, `production-ready-hardener`, `proactive-background-watcher`, `ai-cost-token-optimizer`, `data-telemetry-expert`, `feature-flag-analytics-expert`, `autonomous-chaos-monkey`, `self-healing-cloud-orchestrator`
103
+ **Orchestrates:** `ci-cd-devops-architect`, `cloud-hosting-expert`, `performance-web-vitals`, `logging-error-tracking-expert`, `production-ready-hardener`, `proactive-background-watcher`, `data-telemetry-expert`, `feature-flag-analytics-expert`, `error-resilience-expert`, `self-healing-cloud-orchestrator`
103
104
  - [ ] Perform pre-launch audit across Core Web Vitals (LCP, INP, CLS) and bundle sizes.
104
105
  - [ ] Configure production monitoring, alerting rules, and on-call notifications.
105
106
  - [ ] Optimize Generative Engine Optimization (GEO) for AI Overviews, Perplexity, ChatGPT Search, and deploy `/llms.txt`.
106
107
  - [ ] Generate structured Schema.org JSON-LD markup and AEO conversion landing pages.
107
108
 
108
109
  #### PHASE 8: Launch, Deployment & Handover
109
- **Orchestrates:** `cloud-hosting-expert`, `saas-billing`, `saas-transformer`, `auto-doc-updater`, `ci-cd-devops-architect`, `doku-payment-gateway`
110
+ **Orchestrates:** `cloud-hosting-expert`, `saas-billing`, `saas-architect`, `prd-architect`, `ci-cd-devops-architect`, `doku-payment-gateway`, `payment-gateway-expert`
110
111
  - [ ] Deploy backend and edge services to Vercel, Cloudflare, AWS, or Railway.
111
112
  - [ ] For SaaS applications: deploy Super Admin dashboard on a **separate subdomain** (e.g., `admin.yourdomain.com`) with strict role-based access (`isSuperAdmin` flag).
112
113
  - [ ] Configure Stripe / Polar.sh / LemonSqueezy billing and webhooks.
@@ -119,7 +120,7 @@ Launch/Deploy <--- Security/GEO <--- Testing/QA <--- Frontend/UI
119
120
  ## Bahasa Indonesia
120
121
 
121
122
  ### Integrasi Orkestrasi
122
- Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
123
+ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `session-memory-manager` untuk memastikan eksekusi yang kohesif.
123
124
 
124
125
  ### Ringkasan
125
126
  **Zero to Production Orchestrator** adalah skill master utama yang dirancang untuk mengorkestrasi seluruh ekosistem `vibes-plug` sebagai sebuah **engineering swarm** yang saling terhubung erat. Dengan bertindak sebagai konduktor pusat, skill ini memastikan tidak ada sub-skill yang dieksekusi secara terisolasi. Skill ini memandu pengembang *fullstack* melalui seluruh siklus hidup rekayasa perangkat lunak — mulai dari tahap ide awal hingga integrasi AI, arsitektur backend multi-platform, design system, pengujian otomatis, optimasi GEO/AEO, dan deployment produksi.
@@ -131,17 +132,17 @@ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`,
131
132
 
132
133
  ### Prinsip Inti & Gerbang Ketat
133
134
  1. **Jangan Pernah Melewati Fase**: Setiap fase harus diselesaikan dan divalidasi sebelum beralih ke fase berikutnya.
134
- 2. **Otomatisasi Dokumentasi**: Panggil `auto-doc-updater` untuk memperbarui `CHANGELOG.md` dan `BLUEPRINT.md` setelah setiap milestone utama.
135
+ 2. **Otomatisasi Dokumentasi**: Panggil `prd-architect` untuk memperbarui `CHANGELOG.md` dan `BLUEPRINT.md` setelah setiap milestone utama.
135
136
  3. **Pelacakan Progres**: Pelihara daftar periksa `PROGRESS.md` di root repositori.
136
- 4. **Preservasi State & Konteks**: Gunakan `session-handoff-resume` saat menjeda pekerjaan, dan `session-context-loader` di awal setiap sesi baru untuk menjaga konteks penuh.
137
- 5. **Efisiensi**: Aktifkan `token-saver` selama refactoring besar-besaran untuk mempertahankan *loop* eksekusi yang ringkas dan *powerful*.
137
+ 4. **Preservasi State & Konteks**: Gunakan `session-memory-manager` saat menjeda pekerjaan atau memulai sesi baru untuk menjaga konteks penuh.
138
+ 5. **Efisiensi**: Aktifkan `anti-slop` selama refactoring besar-besaran untuk mempertahankan *loop* eksekusi yang ringkas, powerful, dan bebas dari placeholder.
138
139
 
139
140
  ---
140
141
 
141
142
  ### Master Pipeline Fullstack 8-Fase
142
143
 
143
144
  #### FASE 1: Discovery & Perencanaan Arsitektur PRD AI
144
- **Mengorkestrasi:** `prd-architect`, `brainstorming`, `mcp-server-architect`, `session-context-loader`, `dependency-upgrade-migrator`, `app-analyzer-optimizer`, `seo`, `project-context-mapper`, `self-evolving-memory-graph`, `saas-mvp-launcher`, `web-scraper`, `website-design-cloner`, `headless-cms-expert`, `wordpress-headless-expert`, `documentation-site-expert`, `asisten-ramah`, `skill-baru`
145
+ **Mengorkestrasi:** `prd-architect`, `brainstorming`, `deep-research-analyst`, `mcp-server-architect`, `session-memory-manager`, `dependency-upgrade-migrator`, `app-analyzer-optimizer`, `seo`, `saas-architect`, `web-scraper`, `website-design-cloner`, `headless-cms-expert`, `wordpress-headless-expert`, `documentation-site-expert`, `anti-slop`
145
146
  - [ ] Dialog terstruktur untuk memperjelas tujuan produk, audiens target, dan persyaratan non-fungsional.
146
147
  - [ ] Secara otomatis menyusun Product Requirements Document (PRD.md), Entity Relationship Diagram (ERD.md), dan Dokumentasi (DOKUMENTASI.md) yang komprehensif beserta Roadmap (ROADMAP.md).
147
148
  - [ ] Merencanakan integrasi AI/LLM (Vercel AI SDK, alat MCP Server, atau Graf Multi-Agen).
@@ -156,14 +157,14 @@ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`,
156
157
  - [ ] Menyiapkan template pipeline CI/CD awal (GitHub Actions, Docker).
157
158
 
158
159
  #### FASE 3: Database & Arsitektur Multi-Tenant
159
- **Mengorkestrasi:** `fullstack-expert`, `database-migration-versioning-expert`, `database-orm-expert`, `domain-driven-design-expert`, `saas-multi-tenant`, `supabase-migration`, `supabase-security-expert`, `edge-serverless-db-expert`, `data-pipeline-etl-expert`, `search-engine-expert`, `geospatial-maps-expert`, `graph-rag-knowledge-expert`
160
+ **Mengorkestrasi:** `fullstack-expert`, `database-orm-expert`, `domain-driven-design-expert`, `saas-multi-tenant`, `supabase-security-expert`, `data-pipeline-etl-expert`, `search-engine-expert`, `geospatial-maps-expert`, `graph-rag-knowledge-expert`
160
161
  - [ ] Merancang skema relasional ter-normalisasi, pemodelan dokumen, dan struktur geospasial PostGIS.
161
162
  - [ ] Konfigurasi lapisan ORM (Drizzle ORM / Prisma 6 / SQLx / sqlc) dan indexing mesin pencari (Typesense/Meilisearch).
162
163
  - [ ] Mengimplementasikan kebijakan Row-Level Security (RLS) dan isolasi tenant.
163
164
  - [ ] Menerapkan migrasi database awal dan connection poolers (PgBouncer/Supavisor/Neon).
164
165
 
165
166
  #### FASE 4: Backend API, Microservices & Agen AI
166
- **Mengorkestrasi:** `js-backend-expert`, `go-programming-expert`, `graphql-apollo-expert`, `openapi-swagger-codegen-expert`, `ai-llm-integration-expert`, `ai-prompt-engineering-expert`, `ai-media-generation-expert`, `multi-agent-orchestration`, `mcp-server-architect`, `authentication-identity-expert`, `email-notification-expert`, `cron-scheduler-expert`, `rate-limit-abuse-prevention`, `file-upload-media-expert`, `saas-billing`, `payment-gateway-expert`, `vector-db-rag-expert`, `mcp-client-orchestrator`, `async-queue-temporal-expert`, `background-jobs-queue-expert`, `doku-mcp-server`, `event-driven-architect`, `gemini-agent-booster`, `mobile-push-notification-expert`, `realtime-collaboration-expert`, `api-gateway-proxy-expert`, `wasm-edge-computing-expert`, `sse-websocket-streaming-expert`, `n8n-automation-expert`, `chatbot-messaging-expert`, `pdf-document-generation-expert`, `ecommerce-expert`, `blockchain-web3-expert`, `local-slm-edge-ai-expert`, `voice-ai-realtime-agent`, `graph-rag-knowledge-expert`
167
+ **Mengorkestrasi:** `js-backend-expert`, `go-programming-expert`, `pydantic-ai-expert`, `vercel-ai-sdk-expert`, `synthetic-data-finetuning-expert`, `graphql-apollo-expert`, `openapi-swagger-codegen-expert`, `ai-llm-integration-expert`, `ai-prompt-engineering-expert`, `ai-media-generation-expert`, `multi-agent-orchestration`, `mcp-server-architect`, `authentication-identity-expert`, `email-notification-expert`, `cron-scheduler-expert`, `rate-limit-abuse-prevention`, `file-upload-media-expert`, `saas-billing`, `payment-gateway-expert`, `vector-db-rag-expert`, `async-queue-temporal-expert`, `doku-mcp-server`, `event-driven-architect`, `gemini-agent-booster`, `realtime-collaboration-expert`, `api-gateway-proxy-expert`, `wasm-edge-computing-expert`, `sse-websocket-streaming-expert`, `n8n-automation-expert`, `chatbot-messaging-expert`, `pdf-document-generation-expert`, `ecommerce-expert`, `blockchain-web3-expert`, `local-slm-edge-ai-expert`, `voice-ai-realtime-agent`, `graph-rag-knowledge-expert`
167
168
  - [ ] Bangun API REST / GraphQL / gRPC *high-throughput* menggunakan Fastify 5, NestJS, Hono, Gin, atau Axum.
168
169
  - [ ] Mengimplementasikan autentikasi (Clerk, Auth.js, Supabase Auth) dan middleware RBAC.
169
170
  - [ ] Membangun alat MCP Server atau alur kerja multi-agen LangGraph berbasis state dengan gerbang *human-in-the-loop*.
@@ -173,7 +174,7 @@ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`,
173
174
  - [ ] Mengimplementasikan upload file dengan presigned URL (S3/R2) dan pemrosesan media.
174
175
 
175
176
  #### FASE 5: Frontend, Design System & Mobile App
176
- **Mengorkestrasi:** `modern-web-guidance`, `design-system-architect`, `senior-frontend`, `nextjs-app-router-expert`, `vue-frontend-expert`, `astro-framework-expert`, `svelte-sveltekit-expert`, `solidjs-expert`, `angular-expert`, `tailwind-expert`, `tanstack-query-expert`, `spa-orchestrator`, `mobile-expo-expert`, `apple-ecosystem-expert`, `tauri-expert`, `desktop-electron-expert`, `form-validation-expert`, `ui-components-expert`, `svg-animation-motion-expert`, `web-3d-graphics-expert`, `web-game-engine-expert`, `glsl-shader-expert`, `webxr-ar-vr-expert`, `visual-qa-vision-agent`, `hig`, `global-a11y-i18n-expert`, `bootstrap-to-modern`, `monday-design-aesthetic`, `state-management-expert`, `ui-ux-pro-max`, `data-visualization-expert`, `rich-text-editor-expert`, `documentation-site-expert`, `blockchain-web3-expert`, `modern-css-native-expert`, `pwa-offline-first-expert`
177
+ **Mengorkestrasi:** `modern-web-guidance`, `design-system-architect`, `senior-frontend`, `vercel-ai-sdk-expert`, `nextjs-app-router-expert`, `vue-frontend-expert`, `astro-framework-expert`, `svelte-sveltekit-expert`, `solidjs-expert`, `angular-expert`, `tailwind-expert`, `tanstack-query-expert`, `spa-orchestrator`, `mobile-expo-expert`, `apple-ecosystem-expert`, `tauri-expert`, `desktop-electron-expert`, `form-validation-expert`, `svg-animation-motion-expert`, `web-3d-graphics-expert`, `web-game-engine-expert`, `glsl-shader-expert`, `webxr-ar-vr-expert`, `visual-qa-vision-agent`, `hig`, `global-a11y-i18n-expert`, `bootstrap-to-modern`, `state-management-expert`, `ui-ux-pro-max`, `data-visualization-expert`, `rich-text-editor-expert`, `documentation-site-expert`, `blockchain-web3-expert`, `modern-css-native-expert`, `pwa-offline-first-expert`
177
178
  - [ ] **MANDATORY**: Jalankan `modern-web-guidance` PERTAMA KALI sebelum mengimplementasikan fitur frontend HTML/CSS/JS untuk memastikan kepatuhan dengan standar modern Google.
178
179
  - [ ] Implementasikan token desain (OKLCH) dan konfigurasi tema Tailwind CSS v4.
179
180
  - [ ] Bangun komponen primitif aksesibel menggunakan Radix UI / Base UI dan CVA.
@@ -181,28 +182,29 @@ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`,
181
182
  - [ ] Buat halaman React 19 / Next.js 15, Vue 3, Astro 5, Svelte 5, SolidJS 2, atau Angular 19+ dengan wallet Web3.
182
183
  - [ ] **MANDATORY**: Otomatis buat halaman standar: About, Profile, Contact, Terms of Reference/Service, dan Privacy Policy.
183
184
  - [ ] Mengimplementasikan formulir kompleks dengan React Hook Form + validasi Zod.
185
+ - [ ] Jika Web 3D atau Web Game: arsitekturkan dengan WebGPU (`WebGPURenderer`, PlayCanvas, atau Babylon.js), kompresi tekstur KTX2 Basis Universal, geometri Meshopt, loop fisika fixed-timestep, zero-GC object pooling, dan audio spasial 3D.
184
186
  - [ ] Jika arsitektur SPA — koordinasikan dengan `spa-orchestrator` untuk routing (TanStack Router), state (TanStack Query v5), dan API layer terpisah.
185
187
  - [ ] Mengintegrasikan manajemen state frontend dengan TanStack Query v5.
186
188
 
187
189
  #### FASE 6: Pengujian Otomatis, Ketahanan Error & Audit Keamanan
188
- **Mengorkestrasi:** `e2e-testing-expert`, `accessibility-testing-expert`, `secure-fuzz-testing`, `firebase-security-expert`, `error-resilience-expert`, `logging-error-tracking-expert`, `vibe-code-gardener`, `coderabbit`, `autonomous-tdd-debugger`, `browser-automation-expert`, `zero-trust-secret-vault`, `autonomous-red-teamer`, `post-quantum-crypto-migrator`, `compliance-gdpr-privacy-expert`, `ai-evals-benchmark-expert`
190
+ **Mengorkestrasi:** `e2e-testing-expert`, `accessibility-testing-expert`, `secure-fuzz-testing`, `firebase-security-expert`, `error-resilience-expert`, `logging-error-tracking-expert`, `anti-slop`, `coderabbit`, `autonomous-tdd-debugger`, `browser-automation-expert`, `zero-trust-secret-vault`, `autonomous-red-teamer`, `post-quantum-crypto-migrator`, `compliance-gdpr-privacy-expert`
189
191
  - [ ] Menulis unit test dan integration test dengan Vitest dan pytest.
190
192
  - [ ] Menulis pengujian browser E2E Playwright dan pengujian aksesibilitas WCAG 2.2 otomatis (`@axe-core/playwright` dan Pa11y).
191
193
  - [ ] Menjalankan pengujian fuzzing keamanan (Atheris / cargo-fuzz / native Go fuzzing).
192
194
  - [ ] Mengimplementasikan Error Boundary, pola retry, circuit breaker, dan degradasi anggun.
193
195
  - [ ] Menyiapkan logging terstruktur (Pino) dan pelacakan error (Sentry) dengan upload source map.
194
196
  - [ ] Mengaudit CORS, CSP headers, rate-limiting, dan sanitasi input.
195
- - [ ] Menjalankan audit kualitas kode untuk membersihkan AI slop dan pembusukan arsitektur.
197
+ - [ ] Menjalankan audit kualitas kode untuk membersihkan AI slop dan pembusukan arsitektur dengan anti-slop.
196
198
 
197
199
  #### FASE 7: Hardening Pra-Peluncuran, Monitoring & DevOps Sentinel
198
- **Mengorkestrasi:** `production-ready-hardener`, `app-analyzer-optimizer`, `seo`, `logging-error-tracking-expert`, `proactive-background-watcher`, `ai-cost-token-optimizer`, `data-telemetry-expert`, `feature-flag-analytics-expert`, `autonomous-chaos-monkey`, `self-healing-cloud-orchestrator`
200
+ **Mengorkestrasi:** `ci-cd-devops-architect`, `cloud-hosting-expert`, `performance-web-vitals`, `logging-error-tracking-expert`, `production-ready-hardener`, `proactive-background-watcher`, `data-telemetry-expert`, `feature-flag-analytics-expert`, `error-resilience-expert`, `self-healing-cloud-orchestrator`
199
201
  - [ ] Audit pra-peluncuran pada Core Web Vitals (LCP, INP, CLS) dan ukuran bundle.
200
202
  - [ ] Mengonfigurasi monitoring produksi, aturan alerting, dan notifikasi on-call.
201
203
  - [ ] Mengoptimalkan GEO untuk AI Overviews, Perplexity, ChatGPT Search, dan merilis `/llms.txt`.
202
204
  - [ ] Membuat markup terstruktur Schema.org JSON-LD dan landing page konversi AEO.
203
205
 
204
206
  #### FASE 8: Peluncuran, Deployment & Serah Terima
205
- **Mengorkestrasi:** `cloud-hosting-expert`, `saas-billing`, `saas-transformer`, `auto-doc-updater`, `ci-cd-devops-architect`, `doku-payment-gateway`
207
+ **Mengorkestrasi:** `cloud-hosting-expert`, `saas-billing`, `saas-architect`, `prd-architect`, `ci-cd-devops-architect`, `doku-payment-gateway`, `payment-gateway-expert`
206
208
  - [ ] Deploy backend dan edge services ke Vercel, Cloudflare, AWS, atau Railway.
207
209
  - [ ] Untuk aplikasi SaaS: deploy dashboard Super Admin pada **subdomain terpisah** (misal: `admin.domain.com`) dengan kontrol akses berbasis role (`isSuperAdmin`).
208
210
  - [ ] Konfigurasi billing Stripe / Polar.sh / LemonSqueezy dan webhooks.
@@ -1,82 +0,0 @@
1
- ---
2
- name: ai-cost-token-optimizer
3
- description: "Expert guide for LLM API cost optimization, Prompt Caching, model routing (Flash/Pro/Opus), semantic caching, and token budgeting / Panduan ahli optimasi biaya API LLM, Prompt Caching, model routing, dan semantic caching."
4
- author: "Roedy Rustam"
5
- ---
6
-
7
- # AI Cost & Token Optimizer
8
-
9
- [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
-
11
- ---
12
-
13
- <a name="english"></a>
14
- ## English
15
-
16
- ### Purpose & Overview
17
- Production-grade guidelines for FinOps in AI engineering — prompt caching (Anthropic Prompt Caching, Gemini Context Caching), dynamic model routing (routing lightweight queries to Flash/Haiku and complex reasoning to Pro/Opus), semantic caching with Redis/GPTCache, and real-time token expenditure tracking.
18
-
19
- ### Key Capabilities
20
- - **Prompt & Context Caching**: Storing static system prompts, long-context documents, and schemas in cache to reduce token costs by up to 90%.
21
- - **Model Router**: Heuristic and classifier-based routing between ultra-fast Flash models and high-reasoning Pro models.
22
- - **Semantic Caching**: Hashing query vector embeddings to serve cached responses for semantically identical user queries.
23
-
24
- ```typescript
25
- // Model Routing Strategy Example
26
- export function selectOptimalModel(promptLength: number, taskType: 'classification' | 'reasoning' | 'summary') {
27
- if (taskType === 'classification' || promptLength < 500) {
28
- return 'gemini-3.5-flash'; // High speed, ultra low cost
29
- }
30
- return 'gemini-3.1-pro'; // Complex reasoning
31
- }
32
- ```
33
-
34
- ### Implementation Checklist
35
- - [ ] Enable Context Caching for static system prompts or documents larger than 32k tokens.
36
- - [ ] Implement a router heuristic: use `gemini-3.5-flash` for simple parsing and `gemini-3.1-pro` for deep reasoning.
37
- - [ ] Set up semantic caching (e.g., Redis + Vector Search) for frequently asked identical queries.
38
- - [ ] Monitor token usage and set hard budgeting limits per user/tenant to prevent abuse.
39
-
40
- ### Operating Protocol
41
- 1. **Model Fallback & Routing**: Sets up an abstraction layer (like LiteLLM or Vercel AI SDK Core) to support multiple providers.
42
- 2. **Complexity Scoring**: Implements heuristics (prompt length, required JSON schema, keyword analysis) to route to the cheapest capable model.
43
- 3. **Semantic Caching Integration**: Implements a Vector DB or Redis caching layer. Before routing to an LLM, it embeddings the user prompt and checks if a semantically similar query was answered recently.
44
- 4. **Token Budgeting**: Sets hard limits and alerts for daily API consumption per tenant/user.
45
-
46
- ---
47
-
48
- <a name="bahasa-indonesia"></a>
49
- ## Bahasa Indonesia
50
-
51
- ### Deskripsi
52
- Panduan tingkat produksi untuk FinOps dalam rekayasa AI — prompt caching (Anthropic Prompt Caching & Gemini Context Caching), routing model dinamis (mengarahkan tugas ringan ke Flash/Haiku dan tugas penalaran ke Pro/Opus), semantic caching dengan Redis, dan pelacakan anggaran token real-time.
53
-
54
- ### Fitur Utama
55
- - **Prompt & Context Caching**: Menyimpan prompt sistem dan dokumen konteks panjang di cache untuk menghemat hingga 90% biaya token.
56
- - **Model Router**: Routing otomatis berdasarkan heuristik antara model ultra-cepat Flash dan model penalaran Pro.
57
- - **Semantic Caching**: Memanfaatkan embedding vector query untuk menyajikan respon cache pada pertanyaan pengguna yang serupa secara semantik.
58
-
59
- ### Checklist Implementasi
60
- - [ ] Aktifkan Context Caching untuk prompt sistem statis atau dokumen yang lebih besar dari 32k token.
61
- - [ ] Terapkan heuristik router: gunakan `gemini-3.5-flash` untuk parsing sederhana dan `gemini-3.1-pro` untuk penalaran mendalam.
62
- - [ ] Siapkan semantic caching (misal: Redis + Vector Search) untuk pertanyaan identik yang sering diajukan.
63
- - [ ] Pantau penggunaan token dan tetapkan batas anggaran yang ketat per pengguna/tenant untuk mencegah penyalahgunaan.
64
-
65
- ### Protokol Operasi
66
- 1. **Routing & Fallback Model**: Menyiapkan lapisan abstraksi (seperti LiteLLM atau Vercel AI SDK Core) untuk mendukung berbagai penyedia model.
67
- 2. **Penilaian Kompleksitas**: Mengimplementasikan heuristik (panjang prompt, kebutuhan skema JSON, analisis kata kunci) untuk mengarahkan prompt ke model termurah yang mampu menyelesaikannya.
68
- 3. **Integrasi Semantic Caching**: Mengimplementasikan lapisan *cache* Vector DB atau Redis. Sebelum mengirim ke LLM, prompt pengguna diubah menjadi vektor (*embedding*) untuk mengecek apakah pertanyaan serupa pernah dijawab baru-baru ini.
69
- 4. **Penganggaran Token**: Menetapkan batas maksimal dan notifikasi untuk konsumsi API harian per pengguna/tenant.
70
-
71
-
72
- ## Orchestration & Integration
73
- - Integrates with `ai-llm-integration-expert`, `token-saver`, and `zero-to-prod-orchestrator`.
74
- - Connects to `edge-serverless-db-expert` (Upstash/Redis) for fast semantic caching.
75
- - Collaborates with `vector-db-rag-expert` for similarity scoring during cache retrieval.
76
- - Feeds billing metrics into `saas-billing` for usage-based AI pricing models.
77
-
78
- ## Integrasi Orkestrasi
79
- - Terintegrasi dengan `ai-llm-integration-expert`, `token-saver`, dan `zero-to-prod-orchestrator`.
80
- - Terhubung dengan `edge-serverless-db-expert` (Upstash/Redis) untuk *semantic caching* secepat kilat.
81
- - Berkolaborasi dengan `vector-db-rag-expert` untuk perhitungan kemiripan saat pencarian *cache*.
82
- - Memasok metrik penagihan ke `saas-billing` untuk model bisnis AI berbasis penggunaan (*usage-based pricing*).