vibes-plug 2.5.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 (187) hide show
  1. package/.claude/rules/vibes-plug-core.md +32 -0
  2. package/.cursor/rules/vibes-plug-core.mdc +51 -0
  3. package/.cursorrules +42 -0
  4. package/AGENTS.md +37 -7
  5. package/BLUEPRINT.md +319 -217
  6. package/CHANGELOG.md +170 -1
  7. package/CLAUDE.md +70 -0
  8. package/LICENSE +1 -1
  9. package/README.md +611 -415
  10. package/index.js +19 -0
  11. package/package.json +44 -8
  12. package/plugin.json +24 -7
  13. package/scripts/check-anti-slop.js +53 -0
  14. package/scripts/generate_swarm_gif.py +295 -0
  15. package/scripts/install.js +201 -0
  16. package/skills/accessibility-testing-expert/SKILL.md +116 -0
  17. package/skills/ai-llm-integration-expert/SKILL.md +192 -178
  18. package/skills/ai-media-generation-expert/SKILL.md +172 -0
  19. package/skills/ai-prompt-engineering-expert/SKILL.md +134 -0
  20. package/skills/angular-expert/SKILL.md +148 -0
  21. package/skills/anti-slop/SKILL.md +133 -0
  22. package/skills/api-design-expert/SKILL.md +6 -3
  23. package/skills/api-gateway-proxy-expert/SKILL.md +81 -0
  24. package/skills/app-analyzer-optimizer/SKILL.md +6 -3
  25. package/skills/apple-ecosystem-expert/SKILL.md +144 -141
  26. package/skills/astro-framework-expert/SKILL.md +200 -0
  27. package/skills/async-queue-temporal-expert/SKILL.md +189 -26
  28. package/skills/authentication-identity-expert/SKILL.md +78 -181
  29. package/skills/autonomous-red-teamer/SKILL.md +172 -28
  30. package/skills/autonomous-tdd-debugger/SKILL.md +70 -64
  31. package/skills/biome-linter-formatter-expert/SKILL.md +89 -0
  32. package/skills/blockchain-web3-expert/SKILL.md +115 -0
  33. package/skills/bootstrap-to-modern/SKILL.md +9 -6
  34. package/skills/brainstorming/SKILL.md +60 -52
  35. package/skills/browser-automation-expert/SKILL.md +197 -21
  36. package/skills/bun-runtime-expert/SKILL.md +7 -1
  37. package/skills/chatbot-messaging-expert/SKILL.md +114 -0
  38. package/skills/ci-cd-devops-architect/SKILL.md +45 -36
  39. package/skills/cloud-hosting-expert/SKILL.md +7 -1
  40. package/skills/coderabbit/SKILL.md +7 -1
  41. package/skills/compliance-gdpr-privacy-expert/SKILL.md +85 -0
  42. package/skills/cron-scheduler-expert/SKILL.md +303 -297
  43. package/skills/data-pipeline-etl-expert/SKILL.md +84 -0
  44. package/skills/data-telemetry-expert/SKILL.md +7 -1
  45. package/skills/data-visualization-expert/SKILL.md +154 -0
  46. package/skills/database-orm-expert/SKILL.md +165 -294
  47. package/skills/deep-research-analyst/SKILL.md +136 -0
  48. package/skills/dependency-upgrade-migrator/SKILL.md +300 -294
  49. package/skills/design-system-architect/SKILL.md +309 -260
  50. package/skills/desktop-electron-expert/SKILL.md +128 -0
  51. package/skills/documentation-site-expert/SKILL.md +59 -0
  52. package/skills/doku-mcp-server/SKILL.md +7 -1
  53. package/skills/doku-payment-gateway/SKILL.md +7 -1
  54. package/skills/domain-driven-design-expert/SKILL.md +82 -0
  55. package/skills/e2e-testing-expert/SKILL.md +7 -1
  56. package/skills/ecommerce-expert/SKILL.md +87 -0
  57. package/skills/email-notification-expert/SKILL.md +393 -360
  58. package/skills/error-resilience-expert/SKILL.md +506 -479
  59. package/skills/event-driven-architect/SKILL.md +7 -1
  60. package/skills/feature-flag-analytics-expert/SKILL.md +65 -45
  61. package/skills/file-upload-media-expert/SKILL.md +436 -430
  62. package/skills/firebase-security-expert/SKILL.md +7 -1
  63. package/skills/form-validation-expert/SKILL.md +406 -400
  64. package/skills/fullstack-expert/SKILL.md +184 -202
  65. package/skills/gemini-agent-booster/SKILL.md +173 -135
  66. package/skills/geospatial-maps-expert/SKILL.md +80 -0
  67. package/skills/global-a11y-i18n-expert/SKILL.md +7 -1
  68. package/skills/glsl-shader-expert/SKILL.md +158 -69
  69. package/skills/go-programming-expert/SKILL.md +21 -15
  70. package/skills/graph-rag-knowledge-expert/SKILL.md +200 -0
  71. package/skills/graphql-apollo-expert/SKILL.md +113 -107
  72. package/skills/headless-cms-expert/SKILL.md +181 -0
  73. package/skills/hig/SKILL.md +7 -1
  74. package/skills/js-backend-expert/SKILL.md +218 -216
  75. package/skills/legacy-code-translator/SKILL.md +70 -64
  76. package/skills/local-slm-edge-ai-expert/SKILL.md +167 -0
  77. package/skills/logging-error-tracking-expert/SKILL.md +343 -337
  78. package/skills/mcp-server-architect/SKILL.md +308 -194
  79. package/skills/micro-frontend-architect/SKILL.md +111 -105
  80. package/skills/mobile-expo-expert/SKILL.md +8 -2
  81. package/skills/modern-css-native-expert/SKILL.md +189 -0
  82. package/skills/monorepo-architect/SKILL.md +7 -1
  83. package/skills/mpa-orchestrator/SKILL.md +20 -1
  84. package/skills/multi-agent-orchestration/SKILL.md +254 -234
  85. package/skills/multiple-entry-points/SKILL.md +37 -1
  86. package/skills/mvc-expert/SKILL.md +7 -1
  87. package/skills/n8n-automation-expert/SKILL.md +89 -0
  88. package/skills/nextjs-app-router-expert/SKILL.md +148 -0
  89. package/skills/openapi-swagger-codegen-expert/SKILL.md +67 -0
  90. package/skills/payment-gateway-expert/SKILL.md +85 -1
  91. package/skills/pdf-document-generation-expert/SKILL.md +91 -0
  92. package/skills/performance-web-vitals/SKILL.md +7 -1
  93. package/skills/post-quantum-crypto-migrator/SKILL.md +57 -57
  94. package/skills/prd-architect/SKILL.md +182 -201
  95. package/skills/proactive-background-watcher/SKILL.md +67 -61
  96. package/skills/production-ready-hardener/SKILL.md +459 -456
  97. package/skills/pwa-offline-first-expert/SKILL.md +226 -0
  98. package/skills/pydantic-ai-expert/SKILL.md +161 -0
  99. package/skills/python-programming-expert/SKILL.md +407 -401
  100. package/skills/rate-limit-abuse-prevention/SKILL.md +376 -370
  101. package/skills/realtime-collaboration-expert/SKILL.md +55 -1
  102. package/skills/rich-text-editor-expert/SKILL.md +177 -0
  103. package/skills/rust-programming-expert/SKILL.md +7 -1
  104. package/skills/saas-architect/SKILL.md +154 -0
  105. package/skills/saas-billing/SKILL.md +7 -1
  106. package/skills/saas-multi-tenant/SKILL.md +7 -1
  107. package/skills/scalability-clean-code/SKILL.md +7 -1
  108. package/skills/search-engine-expert/SKILL.md +89 -0
  109. package/skills/secure-fuzz-testing/SKILL.md +7 -1
  110. package/skills/self-healing-cloud-orchestrator/SKILL.md +57 -57
  111. package/skills/senior-frontend/SKILL.md +139 -161
  112. package/skills/senior-frontend/scripts/frontend_scaffolder.py +1 -1
  113. package/skills/seo/SKILL.md +41 -17
  114. package/skills/session-memory-manager/SKILL.md +128 -0
  115. package/skills/solidjs-expert/SKILL.md +80 -0
  116. package/skills/spa-orchestrator/SKILL.md +20 -1
  117. package/skills/sse-websocket-streaming-expert/SKILL.md +93 -0
  118. package/skills/state-management-expert/SKILL.md +7 -1
  119. package/skills/supabase-security-expert/SKILL.md +7 -1
  120. package/skills/svelte-sveltekit-expert/SKILL.md +91 -0
  121. package/skills/svg-animation-motion-expert/SKILL.md +115 -0
  122. package/skills/synthetic-data-finetuning-expert/SKILL.md +155 -0
  123. package/skills/tailwind-expert/SKILL.md +88 -136
  124. package/skills/tanstack-query-expert/SKILL.md +7 -1
  125. package/skills/tauri-expert/SKILL.md +7 -1
  126. package/skills/typescript-expert/SKILL.md +12 -6
  127. package/skills/ui-ux-pro-max/SKILL.md +25 -3
  128. package/skills/vector-db-rag-expert/SKILL.md +175 -19
  129. package/skills/vercel-ai-sdk-expert/SKILL.md +181 -0
  130. package/skills/visual-qa-vision-agent/SKILL.md +70 -64
  131. package/skills/voice-ai-realtime-agent/SKILL.md +242 -0
  132. package/skills/vue-frontend-expert/SKILL.md +131 -125
  133. package/skills/wasm-edge-computing-expert/SKILL.md +97 -0
  134. package/skills/web-3d-graphics-expert/SKILL.md +262 -80
  135. package/skills/web-game-engine-expert/SKILL.md +281 -48
  136. package/skills/web-scraper/SKILL.md +157 -207
  137. package/skills/website-design-cloner/SKILL.md +179 -173
  138. package/skills/webxr-ar-vr-expert/SKILL.md +108 -63
  139. package/skills/wordpress-headless-expert/SKILL.md +144 -0
  140. package/skills/zero-to-prod-orchestrator/SKILL.md +65 -38
  141. package/skills/zero-trust-secret-vault/SKILL.md +87 -39
  142. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -20
  143. package/.github/workflows/publish.yml +0 -20
  144. package/CONTRIBUTING.md +0 -199
  145. package/SECURITY.md +0 -21
  146. package/banner.png +0 -0
  147. package/skills/ai-cost-token-optimizer/SKILL.md +0 -52
  148. package/skills/asisten_ramah/SKILL.md +0 -41
  149. package/skills/auto-doc-updater/SKILL.md +0 -214
  150. package/skills/autonomous-chaos-monkey/SKILL.md +0 -63
  151. package/skills/autonomous-swarm-director/SKILL.md +0 -69
  152. package/skills/edge-serverless-db-expert/SKILL.md +0 -43
  153. package/skills/hyper-context-synthesizer/SKILL.md +0 -55
  154. package/skills/llm-cost-arbitrage-router/SKILL.md +0 -59
  155. package/skills/mcp-client-orchestrator/SKILL.md +0 -70
  156. package/skills/mobile-push-notification-expert/SKILL.md +0 -51
  157. package/skills/monday-design-aesthetic/SKILL.md +0 -67
  158. package/skills/project-context-mapper/SKILL.md +0 -79
  159. package/skills/saas-mvp-launcher/SKILL.md +0 -241
  160. package/skills/saas-transformer/SKILL.md +0 -489
  161. package/skills/saas-transformer/references/billing_integration_guide.md +0 -401
  162. package/skills/self-evolving-memory-graph/SKILL.md +0 -75
  163. package/skills/senior-fullstack/SKILL.md +0 -167
  164. package/skills/senior-fullstack/references/architecture_patterns.md +0 -160
  165. package/skills/senior-fullstack/references/development_workflows.md +0 -222
  166. package/skills/senior-fullstack/references/tech_stack_guide.md +0 -190
  167. package/skills/senior-fullstack/scripts/code_quality_analyzer.py +0 -114
  168. package/skills/senior-fullstack/scripts/fullstack_scaffolder.py +0 -114
  169. package/skills/senior-fullstack/scripts/project_scaffolder.py +0 -114
  170. package/skills/seo-aeo-landing-page-writer/SKILL.md +0 -97
  171. package/skills/seo-geo/SKILL.md +0 -188
  172. package/skills/session-context-loader/SKILL.md +0 -77
  173. package/skills/session-handoff-resume/SKILL.md +0 -158
  174. package/skills/skill_baru/SKILL.md +0 -172
  175. package/skills/supabase-migration/SKILL.md +0 -45
  176. package/skills/token-saver/SKILL.md +0 -119
  177. package/skills/ui-components-expert/SKILL.md +0 -280
  178. package/skills/ui-ux-pro-max/scripts/__pycache__/core.cpython-310.pyc +0 -0
  179. package/skills/ui-ux-pro-max/scripts/__pycache__/core.cpython-312.pyc +0 -0
  180. package/skills/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-310.pyc +0 -0
  181. package/skills/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-312.pyc +0 -0
  182. package/skills/ui_ux_expert/SKILL.md +0 -125
  183. package/skills/vibe-code-gardener/SKILL.md +0 -181
  184. package/vibes-swarm-demo.gif +0 -0
  185. /package/skills/{saas-transformer → saas-architect}/references/feature_gating_patterns.md +0 -0
  186. /package/skills/{saas-transformer → saas-architect}/references/saas_transformation_checklist.md +0 -0
  187. /package/skills/{saas-transformer → saas-architect}/scripts/saas_transformation_scanner.py +0 -0
@@ -1,201 +1,182 @@
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.
1
+ ---
2
+ name: prd-architect
3
+ description: "Updated to cover both pre-code PRD/ERD/Docs generation AND post-code continuous documentation updates / Diperbarui untuk mencakup pembuatan PRD/ERD/Docs pra-kode DAN pembaruan dokumentasi kontinu pasca-kode."
4
+ author: "Roedy Rustam"
5
+ ---
6
+
7
+ # PRD Architect & Documentation Lifecycle (2026 Edition)
8
+
9
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
+
11
+ ---
12
+
13
+ <a name="english"></a>
14
+ ## English
15
+
16
+ ### Orchestration & Integration
17
+ Connects with `brainstorming`, `zero-to-prod-orchestrator`, `session-memory-manager` to ensure cohesive execution and documentation updates.
18
+
19
+ ### Description
20
+ A mandatory lifecycle guardrail covering two distinct phases:
21
+ - **Phase 1 (Pre-Code):** Enforces creating a comprehensive Product Requirements Document (PRD), ERD, and general Documentation before generating code. Introduces PRD-as-Code — machine-readable and version-controlled.
22
+ - **Phase 2 (Post-Code / Maintenance):** Automatically maintains project documentation after every successful build or feature implementation, updating `CHANGELOG.md`, `BLUEPRINT.md`, `PROGRESS.md`, and Architecture Decision Records (ADRs).
23
+
24
+ ### Trigger Conditions
25
+ - **Phase 1:** User requests building a new app/SaaS/feature from scratch; no existing PRD/blueprint; unclear scope.
26
+ - **Phase 2:** A feature, bug fix, or refactor is successfully implemented; user asks to "update docs" or "save progress"; a significant architectural decision is made; milestone completion.
27
+
28
+ ### Phase 1: Pre-Code Requirements & Enforcement
29
+ **Why PRD Before Code:** Prevents scope creep, aligns AI output, enables traceability, reduces rework, version-controlled.
30
+
31
+ #### Enforcement Protocol
32
+ 1. **Detect**: When user requests a new project build.
33
+ 2. **Pause**: Do NOT generate any code.
34
+ 3. **Generate Assets**: Automatically create `PRD.md`, `ERD.md`, `DOKUMENTASI.md`, and `ROADMAP.md` (or `PROGRESS.md`).
35
+ 4. **Review**: Present to user for approval/edits.
36
+ 5. **Confirm**: Proceed to code generation ONLY after approval.
37
+ 6. **Reference**: Cite these documents in all subsequent decisions.
38
+
39
+ #### PRD-as-Code Template (12 Sections)
40
+ ```markdown
41
+ # Product Requirements Document (PRD)
42
+ **Project**: [Project Name]
43
+ **Version**: 1.0.0
44
+ **Status**: Draft | In Review | Approved
45
+ **Created**: YYYY-MM-DD
46
+ **Last Updated**: YYYY-MM-DD
47
+
48
+ ---
49
+ ## 1. Executive Summary
50
+ [2-3 sentences: What is this product? Who is it for? What problem does it solve?]
51
+
52
+ ## 2. Problem Statement
53
+ **Problem**: [Clear description]
54
+ **Target Users**: [Specific segments]
55
+ **Current Pain Points**: [List]
56
+
57
+ ## 3. Goals & Success Metrics
58
+ | Goal | Metric | Target |
59
+ |---|---|---|
60
+ | [Goal] | [Metric] | [Target] |
61
+
62
+ ## 4. User Personas
63
+ ### Persona 1: [Name]
64
+ - **Role**: [Job title]
65
+ - **Goals**: [What they want to achieve]
66
+ - **Frustrations**: [What currently doesn't work]
67
+ - **Key Behaviors**: [How they'll use this product]
68
+
69
+ ## 5. Feature Requirements
70
+ ### MVP Features (Must Have — v1.0)
71
+ - [ ] **[Feature Name]**: [Description. Acceptance criteria: ...]
72
+ ### Phase 2 Features (Should Have — v1.x)
73
+ - [ ] **[Feature Name]**: [Description]
74
+ ### Future Features (Nice to Have — v2.0+)
75
+ - [ ] **[Feature Name]**: [Description]
76
+
77
+ ## 6. Technical Architecture
78
+ ### Stack Decision
79
+ | Layer | Technology | Rationale |
80
+ |---|---|---|
81
+ | [Layer] | [Technology] | [Reason] |
82
+ ### Architecture Decisions (ADRs)
83
+ - **ADR-001**: [Decision title] — [Decision made and why]
84
+ ### Multi-Entry Points (if SaaS)
85
+ | Entry Point | Domain | Purpose |
86
+ |---|---|---|
87
+ | [Entry] | [Domain] | [Purpose] |
88
+
89
+ ## 7. Data Model (High-Level)
90
+ users ──belongs_to──> workspaces (via workspace_members)
91
+ workspaces ──has_many──> projects
92
+
93
+ ## 8. User Flows
94
+ ### Primary Flow: [Name]
95
+ 1. User [action 1]
96
+ 2. System [response 1]
97
+
98
+ ## 9. Non-Functional Requirements
99
+ | Requirement | Target |
100
+ |---|---|
101
+ | Performance | LCP < 2.5s, INP < 200ms |
102
+
103
+ ## 10. Out of Scope
104
+ - [Explicitly excluded item]
105
+
106
+ ## 11. Open Questions
107
+ - [ ] [Question that needs decision]
108
+
109
+ ## 12. Approval & Sign-off
110
+ | Stakeholder | Role | Status |
111
+ |---|---|---|
112
+ | [Name] | [Role] | [Status] |
113
+ ```
114
+
115
+ ### Phase 2: Post-Code Maintenance & Update Protocol
116
+
117
+ After every successful feature implementation:
118
+ 1. **CHANGELOG.md**: Add entry under `[Unreleased]` (Keep-a-Changelog standard: Added/Changed/Fixed/Removed/Security).
119
+ 2. **BLUEPRINT.md**: Update only if architecture, schema, stack, or entry points changed.
120
+ 3. **PROGRESS.md**: Mark completed tasks `[x]`, update next steps.
121
+ 4. **ADR**: Create a new ADR (`docs/adr/ADR-NNN-title.md`) if a significant architectural decision was made and update index (`docs/adr/README.md`).
122
+
123
+ #### Files Maintained Frequency Matrix
124
+ | File | Purpose | Update Frequency |
125
+ |---|---|---|
126
+ | `CHANGELOG.md` | User-facing list of changes | Every PR / feature |
127
+ | `BLUEPRINT.md` | Technical architecture overview | Major structural changes |
128
+ | `PROGRESS.md` | Development roadmap and status | Each work session |
129
+ | `docs/adr/` | Architecture Decision Records | Each key decision |
130
+
131
+ #### ADR Template
132
+ ```markdown
133
+ # ADR-001: [Title]
134
+ **Status**: Accepted | Rejected | Proposed | Deprecated
135
+ **Date**: YYYY-MM-DD
136
+ **Deciders**: [Team/Individual]
137
+ ## Context
138
+ [What motivated this decision?]
139
+ ## Decision
140
+ [What is being decided?]
141
+ ## Rationale
142
+ [Why this choice?]
143
+ ## Consequences
144
+ **Positive:** / **Negative:**
145
+ ## Superseded By
146
+ [ADR-XXX] (if applicable)
147
+ ```
148
+
149
+ ### 🎨 Automatic Visual Assets Generation Mandate (CRITICAL)
150
+ **MANDATORY**: When building a new application, use `generate_image` to create a custom logo. Use it as:
151
+ 1. The primary application logo (header/navbar).
152
+ 2. The website favicon (`favicon.ico`).
153
+ 3. The Open Graph (OG) image for SEO (`og:image`).
154
+
155
+ ---
156
+
157
+ <a name="bahasa-indonesia"></a>
158
+ ## Bahasa Indonesia
159
+
160
+ ### Integrasi Orkestrasi
161
+ Terhubung dengan `brainstorming`, `zero-to-prod-orchestrator`, `session-memory-manager`.
162
+
163
+ ### Deskripsi
164
+ Guardrail siklus hidup wajib:
165
+ - **Fase 1 (Pra-Kode):** Memaksa pembuatan PRD, ERD, dan Dokumentasi sebelum kode dibuat.
166
+ - **Fase 2 (Pasca-Kode):** Memelihara dokumentasi setelah setiap fitur sukses: `CHANGELOG.md`, `BLUEPRINT.md`, `PROGRESS.md`, dan ADR.
167
+
168
+ ### Kondisi Pemicu
169
+ - **Fase 1:** Proyek baru dari awal; tidak ada PRD; ruang lingkup tidak jelas.
170
+ - **Fase 2:** Fitur berhasil; pengguna meminta "perbarui docs"; keputusan arsitektur signifikan.
171
+
172
+ ### Fase 1: Protokol Penegakan
173
+ 1. Deteksi permintaan proyek baru → 2. Jeda (JANGAN kode) → 3. Buat `PRD.md`, `ERD.md`, `DOKUMENTASI.md`, `ROADMAP.md` → 4. Tinjau & setujui → 5. Baru mulai kode → 6. Referensi selalu.
174
+
175
+ ### Fase 2: Pemeliharaan Pasca-Kode
176
+ 1. **CHANGELOG.md**: Tambahkan ke `[Unreleased]` (Added/Changed/Fixed/Removed/Security).
177
+ 2. **BLUEPRINT.md**: Perbarui jika struktur berubah.
178
+ 3. **PROGRESS.md**: Tandai `[x]`, perbarui langkah selanjutnya.
179
+ 4. **ADR**: Buat `docs/adr/ADR-NNN-title.md` untuk keputusan besar.
180
+
181
+ ### 🎨 Mandat Aset Visual Otomatis (KRITIS)
182
+ **WAJIB**: Gunakan `generate_image` untuk membuat logo kustom sebagai logo, favicon, dan OG image.
@@ -1,62 +1,68 @@
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."
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
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.
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
+ ### 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
+ 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.
21
+
22
+ ### Trigger Conditions
23
+ Activate this skill when:
24
+ - The user says "let me know when the deployment finishes."
25
+ - The user asks to "monitor the server for errors."
26
+ - The user wants a daily summary of new GitHub issues.
27
+
28
+ ### Core Concepts
29
+
30
+ #### 1. The Sentinel Loop
31
+ 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.
32
+ 2. **Sleep:** End your turn. The system will automatically wake you up when the timer/cron fires.
33
+ 3. **Execute:** When woken up by the timer prompt, execute your checks (e.g., read a log file, curl an API).
34
+ 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.
35
+
36
+ #### 2. Agent Constraints
37
+ - **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.
38
+ - **Always provide a clear Prompt in the schedule tool:** e.g., "Timer fired: Check Vercel deployment status now."
39
+
40
+ ---
41
+
42
+ ### Integration with Other Skills (MANDATORY)
43
+ - `cron-scheduler-expert` — Provides the code-level knowledge for building app-level crons, while this skill is for the *agent's own* native scheduling.
44
+ - `ci-cd-devops-architect` — Useful when the agent needs to watch GitHub Actions or Vercel pipelines.
45
+
46
+ ### Referenced By Orchestrators (MANDATORY)
47
+ - `brainstorming` — Add to "Discovery & Audit".
48
+ - `zero-to-prod-orchestrator` — Phase 7 (Deployment & Monitoring).
49
+
50
+ ---
51
+
52
+ <a name="bahasa-indonesia"></a>
53
+ ## Bahasa Indonesia
54
+
55
+ ### Integrasi Orkestrasi
56
+ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
57
+
58
+ ### Deskripsi
59
+ 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.
60
+
61
+ ### Kondisi Pemicu
62
+ - Saat pengguna berkata "tolong kabari saya kalau *build*-nya sudah selesai."
63
+ - Saat pengguna meminta Anda mengawasi log error produksi.
64
+
65
+ ### Panduan Singkat
66
+ - **Gunakan Tool `schedule`:** Anda bisa mengatur waktu tunggu (`DurationSeconds`) atau jadwal rutin (`CronExpression`).
67
+ - **Tidur & Bangun Otomatis:** Setelah mengatur jadwal, hentikan pemanggilan tool. Sistem akan membangunkan Anda secara otomatis saat waktunya tiba.
68
+ - **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.