vibes-plug 1.0.0 β†’ 2.5.0

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 (123) hide show
  1. package/.github/workflows/publish.yml +20 -0
  2. package/AGENTS.md +66 -0
  3. package/BLUEPRINT.md +152 -60
  4. package/CHANGELOG.md +50 -0
  5. package/README.md +346 -194
  6. package/package.json +25 -25
  7. package/plugin.json +1 -1
  8. package/skills/ai-cost-token-optimizer/SKILL.md +52 -0
  9. package/skills/ai-llm-integration-expert/SKILL.md +180 -162
  10. package/skills/api-design-expert/SKILL.md +314 -310
  11. package/skills/app-analyzer-optimizer/SKILL.md +193 -189
  12. package/skills/apple-ecosystem-expert/SKILL.md +142 -0
  13. package/skills/async-queue-temporal-expert/SKILL.md +54 -0
  14. package/skills/authentication-identity-expert/SKILL.md +251 -20
  15. package/skills/auto-doc-updater/SKILL.md +214 -204
  16. package/skills/autonomous-chaos-monkey/SKILL.md +63 -0
  17. package/skills/autonomous-red-teamer/SKILL.md +59 -0
  18. package/skills/autonomous-swarm-director/SKILL.md +69 -0
  19. package/skills/autonomous-tdd-debugger/SKILL.md +65 -0
  20. package/skills/bootstrap-to-modern/SKILL.md +90 -86
  21. package/skills/brainstorming/SKILL.md +373 -353
  22. package/skills/browser-automation-expert/SKILL.md +46 -0
  23. package/skills/ci-cd-devops-architect/SKILL.md +72 -45
  24. package/skills/cloud-hosting-expert/SKILL.md +244 -244
  25. package/skills/coderabbit/SKILL.md +192 -192
  26. package/skills/cron-scheduler-expert/SKILL.md +298 -0
  27. package/skills/data-telemetry-expert/SKILL.md +213 -213
  28. package/skills/database-orm-expert/SKILL.md +294 -294
  29. package/skills/dependency-upgrade-migrator/SKILL.md +295 -0
  30. package/skills/design-system-architect/SKILL.md +27 -10
  31. package/skills/doku-mcp-server/SKILL.md +251 -0
  32. package/skills/doku-payment-gateway/SKILL.md +227 -0
  33. package/skills/e2e-testing-expert/SKILL.md +315 -315
  34. package/skills/edge-serverless-db-expert/SKILL.md +43 -0
  35. package/skills/email-notification-expert/SKILL.md +362 -0
  36. package/skills/error-resilience-expert/SKILL.md +480 -0
  37. package/skills/event-driven-architect/SKILL.md +81 -81
  38. package/skills/feature-flag-analytics-expert/SKILL.md +46 -0
  39. package/skills/file-upload-media-expert/SKILL.md +431 -0
  40. package/skills/form-validation-expert/SKILL.md +401 -0
  41. package/skills/fullstack-expert/SKILL.md +202 -202
  42. package/skills/fullstack-expert/references/api_design_guide.md +466 -466
  43. package/skills/fullstack-expert/references/multi_language_backend.md +528 -528
  44. package/skills/fullstack-expert/scripts/api_contract_validator.py +253 -253
  45. package/skills/fullstack-expert/scripts/architecture_analyzer.py +326 -326
  46. package/skills/gemini-agent-booster/SKILL.md +135 -135
  47. package/skills/global-a11y-i18n-expert/SKILL.md +81 -81
  48. package/skills/glsl-shader-expert/SKILL.md +101 -0
  49. package/skills/go-programming-expert/SKILL.md +295 -295
  50. package/skills/graphql-apollo-expert/SKILL.md +108 -0
  51. package/skills/hig/SKILL.md +188 -188
  52. package/skills/hyper-context-synthesizer/SKILL.md +55 -0
  53. package/skills/js-backend-expert/SKILL.md +34 -9
  54. package/skills/legacy-code-translator/SKILL.md +65 -0
  55. package/skills/llm-cost-arbitrage-router/SKILL.md +59 -0
  56. package/skills/logging-error-tracking-expert/SKILL.md +338 -0
  57. package/skills/mcp-client-orchestrator/SKILL.md +70 -0
  58. package/skills/mcp-server-architect/SKILL.md +194 -194
  59. package/skills/micro-frontend-architect/SKILL.md +106 -0
  60. package/skills/mobile-expo-expert/SKILL.md +186 -186
  61. package/skills/mobile-push-notification-expert/SKILL.md +51 -0
  62. package/skills/monday-design-aesthetic/SKILL.md +67 -67
  63. package/skills/monorepo-architect/SKILL.md +227 -227
  64. package/skills/mpa-orchestrator/SKILL.md +101 -101
  65. package/skills/multi-agent-orchestration/SKILL.md +234 -234
  66. package/skills/multiple-entry-points/SKILL.md +55 -55
  67. package/skills/mvc-expert/SKILL.md +231 -231
  68. package/skills/payment-gateway-expert/SKILL.md +45 -45
  69. package/skills/performance-web-vitals/SKILL.md +332 -332
  70. package/skills/post-quantum-crypto-migrator/SKILL.md +57 -0
  71. package/skills/prd-architect/SKILL.md +201 -191
  72. package/skills/proactive-background-watcher/SKILL.md +62 -0
  73. package/skills/production-ready-hardener/PRODUCTION_READINESS_REPORT.md +67 -0
  74. package/skills/production-ready-hardener/SKILL.md +173 -186
  75. package/skills/production-ready-hardener/references/production_checklist.md +161 -161
  76. package/skills/production-ready-hardener/scripts/production_readiness_scanner.py +881 -875
  77. package/skills/project-context-mapper/SKILL.md +79 -0
  78. package/skills/python-programming-expert/SKILL.md +263 -132
  79. package/skills/rate-limit-abuse-prevention/SKILL.md +371 -0
  80. package/skills/realtime-collaboration-expert/SKILL.md +45 -45
  81. package/skills/rust-programming-expert/SKILL.md +235 -235
  82. package/skills/saas-billing/SKILL.md +377 -377
  83. package/skills/saas-multi-tenant/SKILL.md +251 -237
  84. package/skills/saas-mvp-launcher/SKILL.md +10 -0
  85. package/skills/saas-transformer/SKILL.md +187 -144
  86. package/skills/saas-transformer/references/billing_integration_guide.md +401 -401
  87. package/skills/saas-transformer/references/feature_gating_patterns.md +137 -137
  88. package/skills/saas-transformer/references/saas_transformation_checklist.md +121 -121
  89. package/skills/saas-transformer/scripts/saas_transformation_scanner.py +39 -29
  90. package/skills/scalability-clean-code/SKILL.md +229 -229
  91. package/skills/self-evolving-memory-graph/SKILL.md +75 -0
  92. package/skills/self-healing-cloud-orchestrator/SKILL.md +57 -0
  93. package/skills/senior-frontend/SKILL.md +161 -161
  94. package/skills/senior-fullstack/SKILL.md +167 -167
  95. package/skills/seo/SKILL.md +235 -225
  96. package/skills/seo-geo/SKILL.md +188 -188
  97. package/skills/session-context-loader/SKILL.md +77 -0
  98. package/skills/session-handoff-resume/SKILL.md +158 -158
  99. package/skills/skill_baru/SKILL.md +172 -147
  100. package/skills/spa-orchestrator/SKILL.md +288 -288
  101. package/skills/state-management-expert/SKILL.md +272 -272
  102. package/skills/supabase-security-expert/SKILL.md +243 -243
  103. package/skills/tailwind-expert/SKILL.md +188 -188
  104. package/skills/tanstack-query-expert/SKILL.md +199 -199
  105. package/skills/token-saver/SKILL.md +119 -111
  106. package/skills/typescript-expert/SKILL.md +324 -279
  107. package/skills/ui-components-expert/SKILL.md +263 -46
  108. package/skills/ui-ux-pro-max/SKILL.md +202 -201
  109. package/skills/ui-ux-pro-max/scripts/__pycache__/core.cpython-310.pyc +0 -0
  110. package/skills/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-310.pyc +0 -0
  111. package/skills/ui_ux_expert/SKILL.md +17 -6
  112. package/skills/vector-db-rag-expert/SKILL.md +52 -0
  113. package/skills/vibe-code-gardener/SKILL.md +181 -173
  114. package/skills/visual-qa-vision-agent/SKILL.md +65 -0
  115. package/skills/vue-frontend-expert/SKILL.md +126 -0
  116. package/skills/web-3d-graphics-expert/SKILL.md +131 -0
  117. package/skills/web-game-engine-expert/SKILL.md +96 -0
  118. package/skills/web-scraper/SKILL.md +207 -205
  119. package/skills/website-design-cloner/SKILL.md +174 -0
  120. package/skills/webxr-ar-vr-expert/SKILL.md +117 -0
  121. package/skills/zero-to-prod-orchestrator/SKILL.md +206 -180
  122. package/skills/zero-trust-secret-vault/SKILL.md +40 -0
  123. package/vibes-swarm-demo.gif +0 -0
@@ -0,0 +1,57 @@
1
+ ---
2
+ name: post-quantum-crypto-migrator
3
+ description: "FinTech future-proofing. Scans and migrates classical encryption to NIST-approved Post-Quantum Cryptography (PQC) / Migrasi ke Kriptografi Pasca-Kuantum (PQC) yang disetujui NIST untuk sistem FinTech."
4
+ author: vibes-plug-swarm
5
+ ---
6
+
7
+ # Post-Quantum Cryptography Migrator
8
+
9
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
+
11
+ ---
12
+
13
+ <a name="english"></a>
14
+ ## English
15
+
16
+ ### Description
17
+ An advanced security architect skill designed to future-proof FinTech, SaaS, and Payment integrations (such as DOKU) against the impending threat of Quantum Computers breaking classical encryption (RSA/ECC). It scans codebases for vulnerable cryptographic algorithms and migrates them to NIST-approved Post-Quantum Cryptography (PQC) algorithms, such as CRYSTALS-Kyber (for Key Encapsulation) and CRYSTALS-Dilithium/SPHINCS+ (for Digital Signatures).
18
+
19
+ ### Trigger Conditions
20
+ - During security audits or Phase 6 (Automated Testing & Security Audit).
21
+ - When upgrading high-security financial payment gateways or generating JWT/Session tokens.
22
+ - Explicit user request to make the application "Quantum-Proof".
23
+
24
+ ### Operating Protocol
25
+ 1. **Cryptographic Discovery**: Audits all usage of `crypto`, `bcrypt`, `RSA`, `ECDSA`, and `HMAC` operations.
26
+ 2. **Hybrid Migration Plan**: Recommends hybrid implementations (combining classical ECC with PQC algorithms like Kyber-512) to comply with modern standards while maintaining backward compatibility.
27
+ 3. **Implementation**: Swaps vulnerable implementations with PQC-ready libraries (e.g., OQS - Open Quantum Safe, or modernized webcrypto wrappers supporting Kyber).
28
+ 4. **Validation**: Ensures the expanded key sizes and signature sizes of PQC algorithms do not break database schemas or HTTP header limits.
29
+
30
+ ## Orchestration & Integration
31
+ - Enforces extreme security standards alongside `authentication-identity-expert`.
32
+ - Hardens `doku-payment-gateway` and `saas-billing` payload encryption to banking-grade PQC standards.
33
+ - Integrates with `database-orm-expert` to update schema lengths (PQC keys are significantly larger than RSA).
34
+
35
+ ---
36
+
37
+ <a name="bahasa-indonesia"></a>
38
+ ## Bahasa Indonesia
39
+
40
+ ### Deskripsi
41
+ Keterampilan arsitek keamanan tingkat lanjut yang dirancang untuk melindungi integrasi FinTech, SaaS, dan Sistem Pembayaran (seperti DOKU) dari ancaman Komputer Kuantum yang kelak mampu membobol enkripsi klasik (RSA/ECC). Agen ini memindai basis kode untuk mencari algoritma kriptografi yang rentan, lalu memigrasikannya ke standar Kriptografi Pasca-Kuantum (PQC) yang disetujui NIST, seperti CRYSTALS-Kyber (untuk *Key Encapsulation*) dan CRYSTALS-Dilithium/SPHINCS+ (untuk Tanda Tangan Digital).
42
+
43
+ ### Kondisi Pemicu
44
+ - Selama audit keamanan atau Fase 6 (Pengujian Otomatis & Audit Keamanan).
45
+ - Saat memperbarui *payment gateway* keuangan berskala tinggi atau membuat token JWT/Sesi.
46
+ - Permintaan eksplisit dari pengguna untuk membuat aplikasi *"Quantum-Proof"* (Tahan-Kuantum).
47
+
48
+ ### Protokol Operasi
49
+ 1. **Penemuan Kriptografi**: Mengaudit seluruh penggunaan operasi `crypto`, `bcrypt`, `RSA`, `ECDSA`, dan `HMAC`.
50
+ 2. **Rencana Migrasi Hibrida**: Merekomendasikan implementasi hibrida (menggabungkan algoritma klasik ECC dengan algoritma PQC seperti Kyber-512) untuk mematuhi standar modern sembari menjaga kompatibilitas ke belakang (*backward compatibility*).
51
+ 3. **Implementasi**: Menukar implementasi yang rentan dengan pustaka yang mendukung PQC (misalnya, OQS - Open Quantum Safe, atau *wrapper webcrypto* modern yang mendukung Kyber).
52
+ 4. **Validasi**: Memastikan ukuran kunci dan ukuran *signature* algoritma PQC yang lebih besar tidak merusak skema database atau melampaui batas header HTTP.
53
+
54
+ ## Integrasi Orkestrasi
55
+ - Menegakkan standar keamanan ekstrem berdampingan dengan `authentication-identity-expert`.
56
+ - Memperkeras enkripsi *payload* `doku-payment-gateway` dan `saas-billing` ke standar PQC kelas perbankan.
57
+ - Terintegrasi dengan `database-orm-expert` untuk memperbarui panjang skema kolom database (karena ukuran kunci PQC jauh lebih besar dari RSA).
@@ -1,191 +1,201 @@
1
- ---
2
- name: prd-architect
3
- description: "Mandatory guardrail skill that enforces creating a comprehensive Product Requirements Document (PRD) before generating code for new projects / Skill khusus untuk memaksa pembuatan Product Requirements Document (PRD) sebelum mulai coding pada setiap proyek baru."
4
- author: "Roedy Rustam"
5
- ---
6
-
7
- # PRD Architect (2026 β€” PRD-as-Code Edition)
8
-
9
- [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
-
11
- ---
12
-
13
- <a name="english"></a>
14
- ## English
15
-
16
- ### Description
17
- Mandatory guardrail that enforces creating a comprehensive Product Requirements Document (PRD) before generating code for any new project. Introduces **PRD-as-Code** β€” a structured Markdown format designed to be machine-readable by AI agents and version-controlled alongside code.
18
-
19
- ### Trigger Conditions
20
- - A user requests building a new application, SaaS, or major feature from scratch.
21
- - There is no existing PRD, BLUEPRINT.md, or product specification.
22
- - The project scope is unclear or ambiguous.
23
- - The user says "build me...", "create a...", "I want to make..." for a new project.
24
-
25
- ### Why PRD Before Code
26
- 1. **Prevents scope creep**: Defines boundaries before any line of code is written.
27
- 2. **Aligns AI output**: AI agents generate significantly better code when given a structured spec.
28
- 3. **Enables traceability**: Each implemented feature can be traced back to a PRD requirement.
29
- 4. **Reduces rework**: Catches architectural decisions early (DB choice, auth flow, integrations).
30
- 5. **Version-controlled spec**: PRD lives in the repo β€” changes are tracked and reviewable.
31
-
32
- ### PRD-as-Code Template
33
-
34
- ```markdown
35
- # Product Requirements Document (PRD)
36
- **Project**: [Project Name]
37
- **Version**: 1.0.0
38
- **Status**: Draft | In Review | Approved
39
- **Created**: YYYY-MM-DD
40
- **Last Updated**: YYYY-MM-DD
41
-
42
- ---
43
-
44
- ## 1. Executive Summary
45
- [2-3 sentences: What is this product? Who is it for? What problem does it solve?]
46
-
47
- ## 2. Problem Statement
48
- **Problem**: [Clear description of the problem being solved]
49
- **Target Users**: [Specific user segments]
50
- **Current Pain Points**:
51
- - Pain point 1
52
- - Pain point 2
53
-
54
- ## 3. Goals & Success Metrics
55
- | Goal | Metric | Target |
56
- |---|---|---|
57
- | Reduce churn | Monthly churn rate | < 5% |
58
- | Improve activation | D7 retention | > 40% |
59
-
60
- ## 4. User Personas
61
- ### Persona 1: [Name]
62
- - **Role**: [Job title / context]
63
- - **Goals**: [What they want to achieve]
64
- - **Frustrations**: [What currently doesn't work]
65
- - **Key Behaviors**: [How they'll use this product]
66
-
67
- ## 5. Feature Requirements
68
-
69
- ### MVP Features (Must Have β€” v1.0)
70
- - [ ] **[Feature Name]**: [Description. Acceptance criteria: ...]
71
- - [ ] **Authentication**: Email/password + Google OAuth. PKCE flow. Session-based.
72
- - [ ] **Dashboard**: Overview of [key metrics]. Real-time updates via SSE.
73
-
74
- ### Phase 2 Features (Should Have β€” v1.x)
75
- - [ ] **[Feature Name]**: [Description]
76
-
77
- ### Future Features (Nice to Have β€” v2.0+)
78
- - [ ] **[Feature Name]**: [Description]
79
-
80
- ## 6. Technical Architecture
81
-
82
- ### Stack Decision
83
- | Layer | Technology | Rationale |
84
- |---|---|---|
85
- | Frontend | Next.js 15 + React 19 | SSR, App Router, RSC |
86
- | Backend | Hono + Bun | Type-safe RPC, edge-ready |
87
- | Database | PostgreSQL + Drizzle ORM | ACID, RLS multi-tenant |
88
- | Auth | Supabase Auth v3 | PKCE, OAuth, MFA |
89
- | Payments | Stripe / Polar.sh | [Reason for choice] |
90
- | Deployment | Vercel + Railway | [Reason for choice] |
91
-
92
- ### Architecture Decisions (ADRs)
93
- - **ADR-001**: [Decision title] β€” [Decision made and why]
94
- - **ADR-002**: Multi-tenancy via RLS β€” Shared schema with Supabase RLS for isolation
95
-
96
- ### Multi-Entry Points (if SaaS)
97
- | Entry Point | Domain | Purpose |
98
- |---|---|---|
99
- | Landing Page | `myapp.com` | Marketing, conversion |
100
- | SaaS App | `app.myapp.com` | Core product |
101
- | Super Admin | `admin.myapp.com` | Cross-tenant management |
102
- | API | `api.myapp.com` | Backend (internal + public) |
103
-
104
- ## 7. Data Model (High-Level)
105
- ```
106
- users ──belongs_to──> workspaces (via workspace_members)
107
- workspaces ──has_many──> projects
108
- projects ──has_many──> tasks
109
- ```
110
-
111
- ## 8. User Flows
112
- ### Primary Flow: [Name]
113
- 1. User [action 1]
114
- 2. System [response 1]
115
- 3. User [action 2]
116
- 4. System [response 2] β†’ Success state
117
-
118
- ## 9. Non-Functional Requirements
119
- | Requirement | Target |
120
- |---|---|
121
- | Performance | LCP < 2.5s, INP < 200ms |
122
- | Availability | 99.9% uptime |
123
- | Security | SOC 2 Type II compliant |
124
- | Scalability | Support 10K concurrent users |
125
-
126
- ## 10. Out of Scope
127
- - [Explicitly excluded feature or integration]
128
- - [Another explicitly excluded item]
129
-
130
- ## 11. Open Questions
131
- - [ ] [Question that needs a decision before development]
132
- - [ ] Should we support SSO (SAML) in v1 or defer to v2?
133
-
134
- ## 12. Approval & Sign-off
135
- | Stakeholder | Role | Status |
136
- |---|---|---|
137
- | [Name] | Product | βœ… Approved |
138
- | [Name] | Engineering | ⏳ Pending |
139
- ```
140
-
141
- ### Enforcement Protocol
142
- 1. **Detect**: When user requests a new project build.
143
- 2. **Pause**: Do NOT generate any code.
144
- 3. **Generate PRD**: Create a pre-filled PRD draft based on the user's description.
145
- 4. **Review**: Present to user for approval/edits.
146
- 5. **Confirm**: Once PRD is approved, proceed to `zero-to-prod-orchestrator` Phase 1.
147
- 6. **Reference**: Cite the PRD in all subsequent code generation decisions.
148
-
149
- ---
150
-
151
- <a name="bahasa-indonesia"></a>
152
- ## Bahasa Indonesia
153
-
154
- ### Deskripsi
155
- Guardrail wajib yang memaksa pembuatan Product Requirements Document (PRD) komprehensif sebelum membuat kode untuk proyek baru apapun. Memperkenalkan **PRD-as-Code** β€” format Markdown terstruktur yang dirancang agar dapat dibaca mesin oleh agen AI dan dikontrol versi bersama kode.
156
-
157
- ### Kondisi Pemicu
158
- - Pengguna meminta membangun aplikasi, SaaS, atau fitur besar baru dari awal.
159
- - Tidak ada PRD, BLUEPRINT.md, atau spesifikasi produk yang ada.
160
- - Ruang lingkup proyek tidak jelas atau ambigu.
161
- - Pengguna berkata "buatkan saya...", "buat sebuah...", "saya ingin membuat..." untuk proyek baru.
162
-
163
- ### Mengapa PRD Sebelum Kode
164
- 1. **Mencegah scope creep**: Mendefinisikan batas sebelum satu baris kode pun ditulis.
165
- 2. **Menyelaraskan output AI**: Agen AI menghasilkan kode yang jauh lebih baik saat diberi spesifikasi terstruktur.
166
- 3. **Memungkinkan keterlacakan**: Setiap fitur yang diimplementasikan dapat ditelusuri kembali ke persyaratan PRD.
167
- 4. **Mengurangi pengerjaan ulang**: Menangkap keputusan arsitektur lebih awal (pilihan DB, alur auth, integrasi).
168
- 5. **Spesifikasi dengan kontrol versi**: PRD hidup di repo β€” perubahan dilacak dan dapat ditinjau.
169
-
170
- ### Template PRD-as-Code
171
- Template PRD mencakup 12 bagian:
172
- 1. **Ringkasan Eksekutif**: Apa produk ini, untuk siapa, masalah apa yang diselesaikan.
173
- 2. **Pernyataan Masalah**: Deskripsi masalah yang jelas dengan persona pengguna target.
174
- 3. **Tujuan & Metrik Keberhasilan**: Target terukur yang terkait dengan tujuan bisnis.
175
- 4. **Persona Pengguna**: Peran, tujuan, frustrasi, dan perilaku kunci.
176
- 5. **Persyaratan Fitur**: MVP (Harus Ada), Fase 2 (Sebaiknya Ada), Masa Depan (Bagus Dimiliki).
177
- 6. **Arsitektur Teknis**: Keputusan stack dengan justifikasi, ADR, multi-entry points.
178
- 7. **Model Data**: Hubungan antar entitas tingkat tinggi.
179
- 8. **Alur Pengguna**: Alur langkah-demi-langkah untuk interaksi utama.
180
- 9. **Persyaratan Non-Fungsional**: Performa, ketersediaan, keamanan, skalabilitas.
181
- 10. **Di Luar Ruang Lingkup**: Apa yang secara eksplisit dikecualikan.
182
- 11. **Pertanyaan Terbuka**: Keputusan yang perlu dibuat sebelum pengembangan.
183
- 12. **Persetujuan**: Pemangku kepentingan dan status tanda tangan.
184
-
185
- ### Protokol Penegakan
186
- 1. **Deteksi**: Saat pengguna meminta pembangunan proyek baru.
187
- 2. **Jeda**: JANGAN hasilkan kode apapun.
188
- 3. **Buat PRD**: Buat draf PRD yang sudah diisi berdasarkan deskripsi pengguna.
189
- 4. **Tinjau**: Sajikan kepada pengguna untuk persetujuan/edit.
190
- 5. **Konfirmasi**: Setelah PRD disetujui, lanjut ke `zero-to-prod-orchestrator` Fase 1.
191
- 6. **Referensi**: Kutip PRD dalam semua keputusan pembuatan kode selanjutnya.
1
+ ---
2
+ name: prd-architect
3
+ description: "Mandatory guardrail skill that enforces creating a comprehensive Product Requirements Document (PRD), ERD, and Documentation before generating code for new projects / Skill khusus untuk memaksa pembuatan Product Requirements Document (PRD), ERD, dan Dokumentasi secara otomatis sebelum mulai coding pada setiap proyek baru."
4
+ author: "Roedy Rustam"
5
+ ---
6
+
7
+ # PRD Architect (2026 β€” PRD-as-Code Edition)
8
+
9
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
+
11
+ ---
12
+
13
+ <a name="english"></a>
14
+ ## English
15
+
16
+ ### Description
17
+ Mandatory guardrail that enforces creating a comprehensive Product Requirements Document (PRD), Entity Relationship Diagram (ERD), and general Documentation before generating code for any new project. Introduces **PRD-as-Code** β€” a structured Markdown format designed to be machine-readable by AI agents and version-controlled alongside code.
18
+
19
+ ### Trigger Conditions
20
+ - A user requests building a new application, SaaS, or major feature from scratch.
21
+ - There is no existing PRD, BLUEPRINT.md, or product specification.
22
+ - The project scope is unclear or ambiguous.
23
+ - The user says "build me...", "create a...", "I want to make..." for a new project.
24
+
25
+ ### Why PRD Before Code
26
+ 1. **Prevents scope creep**: Defines boundaries before any line of code is written.
27
+ 2. **Aligns AI output**: AI agents generate significantly better code when given a structured spec.
28
+ 3. **Enables traceability**: Each implemented feature can be traced back to a PRD requirement.
29
+ 4. **Reduces rework**: Catches architectural decisions early (DB choice, auth flow, integrations).
30
+ 5. **Version-controlled spec**: PRD lives in the repo β€” changes are tracked and reviewable.
31
+
32
+ ### PRD-as-Code Template
33
+
34
+ ```markdown
35
+ # Product Requirements Document (PRD)
36
+ **Project**: [Project Name]
37
+ **Version**: 1.0.0
38
+ **Status**: Draft | In Review | Approved
39
+ **Created**: YYYY-MM-DD
40
+ **Last Updated**: YYYY-MM-DD
41
+
42
+ ---
43
+
44
+ ## 1. Executive Summary
45
+ [2-3 sentences: What is this product? Who is it for? What problem does it solve?]
46
+
47
+ ## 2. Problem Statement
48
+ **Problem**: [Clear description of the problem being solved]
49
+ **Target Users**: [Specific user segments]
50
+ **Current Pain Points**:
51
+ - Pain point 1
52
+ - Pain point 2
53
+
54
+ ## 3. Goals & Success Metrics
55
+ | Goal | Metric | Target |
56
+ |---|---|---|
57
+ | Reduce churn | Monthly churn rate | < 5% |
58
+ | Improve activation | D7 retention | > 40% |
59
+
60
+ ## 4. User Personas
61
+ ### Persona 1: [Name]
62
+ - **Role**: [Job title / context]
63
+ - **Goals**: [What they want to achieve]
64
+ - **Frustrations**: [What currently doesn't work]
65
+ - **Key Behaviors**: [How they'll use this product]
66
+
67
+ ## 5. Feature Requirements
68
+
69
+ ### MVP Features (Must Have β€” v1.0)
70
+ - [ ] **[Feature Name]**: [Description. Acceptance criteria: ...]
71
+ - [ ] **Authentication**: Email/password + Google OAuth. PKCE flow. Session-based.
72
+ - [ ] **Dashboard**: Overview of [key metrics]. Real-time updates via SSE.
73
+
74
+ ### Phase 2 Features (Should Have β€” v1.x)
75
+ - [ ] **[Feature Name]**: [Description]
76
+
77
+ ### Future Features (Nice to Have β€” v2.0+)
78
+ - [ ] **[Feature Name]**: [Description]
79
+
80
+ ## 6. Technical Architecture
81
+
82
+ ### Stack Decision
83
+ | Layer | Technology | Rationale |
84
+ |---|---|---|
85
+ | Frontend | Next.js 15 + React 19 | SSR, App Router, RSC |
86
+ | Backend | Hono + Bun | Type-safe RPC, edge-ready |
87
+ | Database | PostgreSQL + Drizzle ORM | ACID, RLS multi-tenant |
88
+ | Auth | Supabase Auth v3 | PKCE, OAuth, MFA |
89
+ | Payments | Stripe / Polar.sh | [Reason for choice] |
90
+ | Deployment | Vercel + Railway | [Reason for choice] |
91
+
92
+ ### Architecture Decisions (ADRs)
93
+ - **ADR-001**: [Decision title] β€” [Decision made and why]
94
+ - **ADR-002**: Multi-tenancy via RLS β€” Shared schema with Supabase RLS for isolation
95
+
96
+ ### Multi-Entry Points (if SaaS)
97
+ | Entry Point | Domain | Purpose |
98
+ |---|---|---|
99
+ | Landing Page | `myapp.com` | Marketing, conversion |
100
+ | SaaS App | `app.myapp.com` | Core product |
101
+ | Super Admin | `admin.myapp.com` | Cross-tenant management |
102
+ | API | `api.myapp.com` | Backend (internal + public) |
103
+
104
+ ## 7. Data Model (High-Level)
105
+ ```
106
+ users ──belongs_to──> workspaces (via workspace_members)
107
+ workspaces ──has_many──> projects
108
+ projects ──has_many──> tasks
109
+ ```
110
+
111
+ ## 8. User Flows
112
+ ### Primary Flow: [Name]
113
+ 1. User [action 1]
114
+ 2. System [response 1]
115
+ 3. User [action 2]
116
+ 4. System [response 2] β†’ Success state
117
+
118
+ ## 9. Non-Functional Requirements
119
+ | Requirement | Target |
120
+ |---|---|
121
+ | Performance | LCP < 2.5s, INP < 200ms |
122
+ | Availability | 99.9% uptime |
123
+ | Security | SOC 2 Type II compliant |
124
+ | Scalability | Support 10K concurrent users |
125
+
126
+ ## 10. Out of Scope
127
+ - [Explicitly excluded feature or integration]
128
+ - [Another explicitly excluded item]
129
+
130
+ ## 11. Open Questions
131
+ - [ ] [Question that needs a decision before development]
132
+ - [ ] Should we support SSO (SAML) in v1 or defer to v2?
133
+
134
+ ## 12. Approval & Sign-off
135
+ | Stakeholder | Role | Status |
136
+ |---|---|---|
137
+ | [Name] | Product | βœ… Approved |
138
+ | [Name] | Engineering | ⏳ Pending |
139
+ ```
140
+
141
+ ### Enforcement Protocol
142
+ 1. **Detect**: When user requests a new project build.
143
+ 2. **Pause**: Do NOT generate any code.
144
+ 3. **Generate PRD, ERD, Docs & Roadmap**: Automatically create a pre-filled PRD draft (`PRD.md`), an Entity Relationship Diagram (`ERD.md`), general Documentation (`DOKUMENTASI.md`), and a Roadmap document (`ROADMAP.md` or `PROGRESS.md`) based on the user's description.
145
+ 4. **Review**: Present to user for approval/edits.
146
+ 5. **Confirm**: Once the PRD, ERD, Documentation, and Roadmap are approved, proceed to `zero-to-prod-orchestrator` Phase 1.
147
+ 6. **Reference**: Cite the PRD, ERD, Documentation, and Roadmap in all subsequent code generation decisions.
148
+
149
+ ---
150
+
151
+ <a name="bahasa-indonesia"></a>
152
+ ## Bahasa Indonesia
153
+
154
+ ### Deskripsi
155
+ Guardrail wajib yang memaksa pembuatan secara otomatis Product Requirements Document (PRD) komprehensif, Entity Relationship Diagram (ERD), dan Dokumentasi sebelum membuat kode untuk proyek baru apapun. Memperkenalkan **PRD-as-Code** β€” format Markdown terstruktur yang dirancang agar dapat dibaca mesin oleh agen AI dan dikontrol versi bersama kode.
156
+
157
+ ### Kondisi Pemicu
158
+ - Pengguna meminta membangun aplikasi, SaaS, atau fitur besar baru dari awal.
159
+ - Tidak ada PRD, BLUEPRINT.md, atau spesifikasi produk yang ada.
160
+ - Ruang lingkup proyek tidak jelas atau ambigu.
161
+ - Pengguna berkata "buatkan saya...", "buat sebuah...", "saya ingin membuat..." untuk proyek baru.
162
+
163
+ ### Mengapa PRD Sebelum Kode
164
+ 1. **Mencegah scope creep**: Mendefinisikan batas sebelum satu baris kode pun ditulis.
165
+ 2. **Menyelaraskan output AI**: Agen AI menghasilkan kode yang jauh lebih baik saat diberi spesifikasi terstruktur.
166
+ 3. **Memungkinkan keterlacakan**: Setiap fitur yang diimplementasikan dapat ditelusuri kembali ke persyaratan PRD.
167
+ 4. **Mengurangi pengerjaan ulang**: Menangkap keputusan arsitektur lebih awal (pilihan DB, alur auth, integrasi).
168
+ 5. **Spesifikasi dengan kontrol versi**: PRD hidup di repo β€” perubahan dilacak dan dapat ditinjau.
169
+
170
+ ### Template PRD-as-Code
171
+ Template PRD mencakup 12 bagian:
172
+ 1. **Ringkasan Eksekutif**: Apa produk ini, untuk siapa, masalah apa yang diselesaikan.
173
+ 2. **Pernyataan Masalah**: Deskripsi masalah yang jelas dengan persona pengguna target.
174
+ 3. **Tujuan & Metrik Keberhasilan**: Target terukur yang terkait dengan tujuan bisnis.
175
+ 4. **Persona Pengguna**: Peran, tujuan, frustrasi, dan perilaku kunci.
176
+ 5. **Persyaratan Fitur**: MVP (Harus Ada), Fase 2 (Sebaiknya Ada), Masa Depan (Bagus Dimiliki).
177
+ 6. **Arsitektur Teknis**: Keputusan stack dengan justifikasi, ADR, multi-entry points.
178
+ 7. **Model Data**: Hubungan antar entitas tingkat tinggi.
179
+ 8. **Alur Pengguna**: Alur langkah-demi-langkah untuk interaksi utama.
180
+ 9. **Persyaratan Non-Fungsional**: Performa, ketersediaan, keamanan, skalabilitas.
181
+ 10. **Di Luar Ruang Lingkup**: Apa yang secara eksplisit dikecualikan.
182
+ 11. **Pertanyaan Terbuka**: Keputusan yang perlu dibuat sebelum pengembangan.
183
+ 12. **Persetujuan**: Pemangku kepentingan dan status tanda tangan.
184
+
185
+ ### Protokol Penegakan
186
+ 1. **Deteksi**: Saat pengguna meminta pembangunan proyek baru.
187
+ 2. **Jeda**: JANGAN hasilkan kode apapun.
188
+ 3. **Buat PRD, ERD, Dokumentasi & Roadmap**: Secara otomatis buat draf PRD (`PRD.md`), Entity Relationship Diagram (`ERD.md`), Dokumentasi umum (`DOKUMENTASI.md`), dan dokumen Roadmap (`ROADMAP.md` atau `PROGRESS.md`) yang sudah diisi berdasarkan deskripsi pengguna.
189
+ 4. **Tinjau**: Sajikan kepada pengguna untuk persetujuan/edit.
190
+ 5. **Konfirmasi**: Setelah PRD, ERD, Dokumentasi, dan Roadmap disetujui, lanjut ke `zero-to-prod-orchestrator` Fase 1.
191
+ 6. **Referensi**: Kutip PRD, ERD, Dokumentasi, dan Roadmap dalam semua keputusan pembuatan kode selanjutnya.
192
+
193
+ ---
194
+ ### 🎨 Automatic Visual Assets Generation Mandate (CRITICAL)
195
+ **MANDATORY**: Whenever you are building a new application, scaffolding a project, or finalizing the initial UI/UX, you MUST automatically use the `generate_image` tool to create a custom logo that perfectly matches the application's core concept and aesthetic.
196
+ This generated image MUST be explicitly used as:
197
+ 1. The primary application logo (e.g., in the header/navbar).
198
+ 2. The website favicon (`favicon.ico` or equivalent).
199
+ 3. The Open Graph (OG) image for SEO metadata (`og:image`).
200
+
201
+ Do not use placeholders for these assets. Generate and integrate them automatically.
@@ -0,0 +1,62 @@
1
+ ---
2
+ name: proactive-background-watcher
3
+ description: "Grants the AI the ability to act proactively using native cron/timer scheduling. The agent can monitor systems, poll APIs, or watch logs in the background and self-trigger without waiting for user prompts."
4
+ author: "Roedy Rustam"
5
+ ---
6
+
7
+ # Proactive Background Watcher (Sentinel Agent)
8
+
9
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
+
11
+ ---
12
+
13
+ <a name="english"></a>
14
+ ## English
15
+
16
+ ### Description
17
+ Standard LLM chat interfaces (like Claude or ChatGPT) are purely reactiveβ€”they do nothing until the user types a prompt. This skill gives Antigravity the "superpower" of proactivity. By utilizing the native `schedule` tool, the agent can set up background cron jobs or timers to monitor logs, poll APIs, or check CI/CD pipelines. If an anomaly is detected, the agent wakes up autonomously and alerts the user or fixes the issue.
18
+
19
+ ### Trigger Conditions
20
+ Activate this skill when:
21
+ - The user says "let me know when the deployment finishes."
22
+ - The user asks to "monitor the server for errors."
23
+ - The user wants a daily summary of new GitHub issues.
24
+
25
+ ### Core Concepts
26
+
27
+ #### 1. The Sentinel Loop
28
+ 1. **Schedule:** Use the `schedule` tool. Set either a `DurationSeconds` (e.g., check again in 5 minutes) or a `CronExpression` (e.g., run every hour `0 * * * *`). Set `IsDaemon=true` if it's a long-running background watcher.
29
+ 2. **Sleep:** End your turn. The system will automatically wake you up when the timer/cron fires.
30
+ 3. **Execute:** When woken up by the timer prompt, execute your checks (e.g., read a log file, curl an API).
31
+ 4. **Evaluate:** If everything is normal, go back to sleep (or set a new timer). If an anomaly is found, notify the user immediately with an alert.
32
+
33
+ #### 2. Agent Constraints
34
+ - **Do not spam the user.** If a background check passes normally, do not write a message to the user. Only alert the user if action is required or a long-running task finally completes.
35
+ - **Always provide a clear Prompt in the schedule tool:** e.g., "Timer fired: Check Vercel deployment status now."
36
+
37
+ ---
38
+
39
+ ### Integration with Other Skills (MANDATORY)
40
+ - `cron-scheduler-expert` β€” Provides the code-level knowledge for building app-level crons, while this skill is for the *agent's own* native scheduling.
41
+ - `ci-cd-devops-architect` β€” Useful when the agent needs to watch GitHub Actions or Vercel pipelines.
42
+
43
+ ### Referenced By Orchestrators (MANDATORY)
44
+ - `brainstorming` β€” Add to "Discovery & Audit".
45
+ - `zero-to-prod-orchestrator` β€” Phase 7 (Deployment & Monitoring).
46
+
47
+ ---
48
+
49
+ <a name="bahasa-indonesia"></a>
50
+ ## Bahasa Indonesia
51
+
52
+ ### Deskripsi
53
+ LLM biasa (seperti Claude) sepenuhnya reaktifβ€”diam sampai pengguna mengetik. Skill ini memberi Anda "kekuatan super" proaktif (Sentinel). Menggunakan tool `schedule`, Anda dapat menjadwalkan tugas *background* untuk memantau log, mengecek status *deployment*, atau mengawasi API secara berkala. Anda bisa "bangun sendiri" tanpa disuruh jika menemukan error.
54
+
55
+ ### Kondisi Pemicu
56
+ - Saat pengguna berkata "tolong kabari saya kalau *build*-nya sudah selesai."
57
+ - Saat pengguna meminta Anda mengawasi log error produksi.
58
+
59
+ ### Panduan Singkat
60
+ - **Gunakan Tool `schedule`:** Anda bisa mengatur waktu tunggu (`DurationSeconds`) atau jadwal rutin (`CronExpression`).
61
+ - **Tidur & Bangun Otomatis:** Setelah mengatur jadwal, hentikan pemanggilan tool. Sistem akan membangunkan Anda secara otomatis saat waktunya tiba.
62
+ - **Jangan Cerewet (No Spam):** Jika Anda terbangun karena alarm dan mengecek log ternyata tidak ada error, **jangan** beri tahu pengguna. Biarkan pengguna bekerja dengan tenang. Hanya lapor jika ada error atau tugas besar telah selesai.
@@ -0,0 +1,67 @@
1
+ # Production Readiness Report
2
+ **Target:** `C:\Users\roedy\.gemini\config\plugins\vibes-plug\skills\production-ready-hardener`
3
+ **Date Check:** Current Date
4
+ **Overall Score:** `85/100` (`B+`)
5
+ **Status:** ⚠️ NEEDS MINOR FIXES
6
+
7
+ ## Executive Summary
8
+ This report lists potential security vulnerabilities, code architecture errors, test coverage status, and build checks before release. Critical errors must be addressed immediately.
9
+ ## Phase Breakdown
10
+
11
+ | Phase | Score | Critical | Warnings |
12
+ |:---|:---:|:---:|:---:|
13
+ | Architecture & Code Quality | `80/100` | 0 | 4 |
14
+ | Frontend Hardening | `95/100` | 0 | 1 |
15
+ | Backend Hardening | `90/100` | 0 | 2 |
16
+ | Security Hardening | `80/100` | 1 | 0 |
17
+ | Testing & Quality Assurance | `82/100` | 0 | 4 |
18
+ | Performance & SEO | `87/100` | 0 | 4 |
19
+ | DevOps & Deployment | `83/100` | 0 | 4 |
20
+
21
+ ## Detailed Checklist Items
22
+
23
+ ### Architecture & Code Quality
24
+ - **Has organized source directory (src/ or app/)**: ❌ Failed (WARNING)
25
+ - **TypeScript strict mode enabled**: βœ… Passed
26
+ - **package.json exists**: ❌ Failed (WARNING)
27
+ - **No TypeScript `any` types found**: βœ… Passed
28
+ - **.env.example/env.example documents required config variables**: ❌ Failed (WARNING)
29
+ - **Input validation library used (Zod/Joi/Yup)**: ❌ Failed (WARNING)
30
+ - **TypeScript compiles without errors (0 errors)**: βœ… Passed
31
+
32
+ ### Frontend Hardening
33
+ - **Frontend framework detected**: ❌ Failed (WARNING)
34
+
35
+ ### Backend Hardening
36
+ - **Database migrations directory setup**: ❌ Failed (WARNING)
37
+ - **Public routing endpoints ready**: ❌ Failed (WARNING)
38
+
39
+ ### Security Hardening
40
+ - **.env included in .gitignore**: ❌ Failed (CRITICAL)
41
+ - **No hardcoded private API keys/secrets in project files**: βœ… Passed
42
+ - **No vulnerable string-interpolated SQL queries found**: βœ… Passed
43
+ - **No unrestricted CORS wildcard access allowed in source**: βœ… Passed
44
+
45
+ ### Testing & Quality Assurance
46
+ - **Unit test suite configured (Vitest/Jest)**: ❌ Failed (WARNING)
47
+ - **E2E test suite configured (Playwright)**: ❌ Failed (WARNING)
48
+ - **Linter configuration exists (eslint.config.js)**: ❌ Failed (WARNING)
49
+ - **Git hooks config present**: ❌ Failed (WARNING)
50
+
51
+ ### Performance & SEO
52
+ - **Sitemap exists or generated**: ❌ Failed (WARNING)
53
+ - **robots.txt exists in public directory**: ❌ Failed (WARNING)
54
+ - **User speed & web vitals tracking integrated**: ❌ Failed (WARNING)
55
+ - **Progressive Web App (PWA) configuration present**: ❌ Failed (WARNING)
56
+
57
+ ### DevOps & Deployment
58
+ - **GitHub Actions CI/CD workflows setup**: ❌ Failed (WARNING)
59
+ - **Deployment configuration file exists**: ❌ Failed (WARNING)
60
+ - **README.md contains instructions**: ❌ Failed (WARNING)
61
+ - **CHANGELOG.md updated for release**: ❌ Failed (WARNING)
62
+ - **Vite/Compiler build executes successfully (No build_errors.txt)**: βœ… Passed
63
+
64
+ ## πŸš€ Quick Remediation Checklist
65
+ Below are instructions to address the most urgent failures detected:
66
+
67
+ - No immediate high-priority remediation templates needed. Fix individual warnings listed above.