vibes-plug 2.14.1 → 3.9.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 (151) hide show
  1. package/.claude/rules/vibes-plug-core.md +5 -0
  2. package/.cursor/rules/vibes-plug-core.mdc +7 -2
  3. package/.cursorrules +8 -2
  4. package/AGENTS.md +23 -2
  5. package/CHANGELOG.md +114 -0
  6. package/CLAUDE.md +10 -3
  7. package/README.md +216 -611
  8. package/bin/vibes.mjs +1104 -0
  9. package/package.json +11 -3
  10. package/plugin.json +4 -3
  11. package/scripts/check-anti-slop.mjs +53 -0
  12. package/scripts/install.js +3 -1
  13. package/scripts/update_skills.js +1 -1
  14. package/scripts/update_skills.mjs +86 -0
  15. package/scripts/validate-skills.mjs +111 -0
  16. package/skills/accessibility-testing-expert/SKILL.md +117 -116
  17. package/skills/affective-computing-emotion-ai/SKILL.md +83 -0
  18. package/skills/agentic-coding-workflow-expert/SKILL.md +297 -0
  19. package/skills/agentic-memory-architect/SKILL.md +52 -0
  20. package/skills/agentic-micro-economy-architect/SKILL.md +92 -0
  21. package/skills/ai-llm-integration-expert/SKILL.md +330 -194
  22. package/skills/ai-media-generation-expert/SKILL.md +173 -172
  23. package/skills/ai-prompt-engineering-expert/SKILL.md +204 -134
  24. package/skills/ai-safety-governance-expert/SKILL.md +223 -0
  25. package/skills/angular-expert/SKILL.md +149 -148
  26. package/skills/anti-slop/SKILL.md +134 -133
  27. package/skills/api-design-expert/SKILL.md +4 -3
  28. package/skills/api-gateway-proxy-expert/SKILL.md +3 -2
  29. package/skills/app-analyzer-optimizer/SKILL.md +4 -3
  30. package/skills/apple-ecosystem-expert/SKILL.md +6 -5
  31. package/skills/astro-framework-expert/SKILL.md +201 -200
  32. package/skills/async-queue-temporal-expert/SKILL.md +218 -217
  33. package/skills/authentication-identity-expert/SKILL.md +174 -173
  34. package/skills/autonomous-red-teamer/SKILL.md +338 -203
  35. package/skills/autonomous-tdd-debugger/SKILL.md +6 -5
  36. package/skills/biome-linter-formatter-expert/SKILL.md +90 -89
  37. package/skills/blockchain-web3-expert/SKILL.md +116 -115
  38. package/skills/brainstorming/SKILL.md +392 -377
  39. package/skills/browser-automation-expert/SKILL.md +260 -222
  40. package/skills/bun-runtime-expert/SKILL.md +5 -4
  41. package/skills/chatbot-messaging-expert/SKILL.md +115 -114
  42. package/skills/ci-cd-devops-architect/SKILL.md +3 -2
  43. package/skills/cloud-hosting-expert/SKILL.md +5 -4
  44. package/skills/coderabbit/SKILL.md +5 -4
  45. package/skills/compliance-gdpr-privacy-expert/SKILL.md +3 -2
  46. package/skills/composable-mach-architect/SKILL.md +338 -0
  47. package/skills/cron-scheduler-expert/SKILL.md +5 -4
  48. package/skills/data-pipeline-etl-expert/SKILL.md +3 -2
  49. package/skills/data-telemetry-expert/SKILL.md +5 -4
  50. package/skills/data-visualization-expert/SKILL.md +155 -154
  51. package/skills/database-orm-expert/SKILL.md +166 -165
  52. package/skills/deep-research-analyst/SKILL.md +182 -136
  53. package/skills/dependency-upgrade-migrator/SKILL.md +11 -10
  54. package/skills/design-system-architect/SKILL.md +4 -3
  55. package/skills/desktop-electron-expert/SKILL.md +129 -128
  56. package/skills/documentation-site-expert/SKILL.md +60 -59
  57. package/skills/doku-mcp-server/SKILL.md +5 -4
  58. package/skills/doku-payment-gateway/SKILL.md +250 -232
  59. package/skills/domain-driven-design-expert/SKILL.md +3 -2
  60. package/skills/e2e-testing-expert/SKILL.md +5 -4
  61. package/skills/ecommerce-expert/SKILL.md +88 -87
  62. package/skills/email-notification-expert/SKILL.md +5 -4
  63. package/skills/ephemeral-generative-ui-architect/SKILL.md +88 -0
  64. package/skills/error-resilience-expert/SKILL.md +14 -13
  65. package/skills/event-driven-architect/SKILL.md +5 -4
  66. package/skills/feature-flag-analytics-expert/SKILL.md +3 -2
  67. package/skills/file-upload-media-expert/SKILL.md +5 -4
  68. package/skills/firebase-security-expert/SKILL.md +5 -4
  69. package/skills/form-validation-expert/SKILL.md +7 -6
  70. package/skills/frontier-ai-models-expert/SKILL.md +116 -0
  71. package/skills/fullstack-expert/SKILL.md +185 -184
  72. package/skills/gemini-agent-booster/SKILL.md +248 -172
  73. package/skills/geospatial-maps-expert/SKILL.md +81 -80
  74. package/skills/global-a11y-i18n-expert/SKILL.md +5 -4
  75. package/skills/glsl-shader-expert/SKILL.md +191 -190
  76. package/skills/go-programming-expert/SKILL.md +5 -4
  77. package/skills/graph-rag-knowledge-expert/SKILL.md +201 -200
  78. package/skills/graphql-apollo-expert/SKILL.md +5 -4
  79. package/skills/headless-cms-expert/SKILL.md +182 -181
  80. package/skills/hig/SKILL.md +5 -4
  81. package/skills/js-backend-expert/SKILL.md +219 -218
  82. package/skills/legacy-code-translator/SKILL.md +6 -5
  83. package/skills/llm-finops-router/SKILL.md +52 -0
  84. package/skills/local-slm-edge-ai-expert/SKILL.md +168 -167
  85. package/skills/logging-error-tracking-expert/SKILL.md +5 -4
  86. package/skills/mcp-server-architect/SKILL.md +315 -307
  87. package/skills/micro-frontend-architect/SKILL.md +5 -4
  88. package/skills/mobile-expo-expert/SKILL.md +5 -4
  89. package/skills/modern-css-native-expert/SKILL.md +190 -189
  90. package/skills/monorepo-architect/SKILL.md +5 -4
  91. package/skills/mpa-orchestrator/SKILL.md +41 -4
  92. package/skills/multi-agent-orchestration/SKILL.md +388 -254
  93. package/skills/mvc-expert/SKILL.md +5 -4
  94. package/skills/n8n-automation-expert/SKILL.md +90 -89
  95. package/skills/nextjs-app-router-expert/SKILL.md +3 -2
  96. package/skills/openapi-swagger-codegen-expert/SKILL.md +4 -3
  97. package/skills/payment-gateway-expert/SKILL.md +131 -128
  98. package/skills/pdf-document-generation-expert/SKILL.md +92 -91
  99. package/skills/performance-web-vitals/SKILL.md +5 -4
  100. package/skills/post-quantum-crypto-migrator/SKILL.md +3 -2
  101. package/skills/prd-architect/SKILL.md +183 -182
  102. package/skills/proactive-background-watcher/SKILL.md +5 -4
  103. package/skills/production-ready-hardener/SKILL.md +10 -9
  104. package/skills/pwa-offline-first-expert/SKILL.md +227 -226
  105. package/skills/pydantic-ai-expert/SKILL.md +162 -161
  106. package/skills/python-programming-expert/SKILL.md +5 -4
  107. package/skills/rate-limit-abuse-prevention/SKILL.md +5 -4
  108. package/skills/realtime-collaboration-expert/SKILL.md +3 -2
  109. package/skills/rich-text-editor-expert/SKILL.md +178 -177
  110. package/skills/rust-programming-expert/SKILL.md +5 -4
  111. package/skills/saas-architect/SKILL.md +155 -154
  112. package/skills/saas-billing/SKILL.md +394 -382
  113. package/skills/saas-multi-tenant/SKILL.md +7 -6
  114. package/skills/scalability-clean-code/SKILL.md +5 -4
  115. package/skills/search-engine-expert/SKILL.md +90 -89
  116. package/skills/self-healing-cloud-orchestrator/SKILL.md +3 -2
  117. package/skills/senior-frontend/SKILL.md +14 -9
  118. package/skills/seo/SKILL.md +4 -4
  119. package/skills/session-memory-manager/SKILL.md +129 -128
  120. package/skills/solidjs-expert/SKILL.md +81 -80
  121. package/skills/spa-orchestrator/SKILL.md +5 -4
  122. package/skills/sse-websocket-streaming-expert/SKILL.md +3 -2
  123. package/skills/state-management-expert/SKILL.md +5 -4
  124. package/skills/supabase-security-expert/SKILL.md +5 -4
  125. package/skills/svelte-sveltekit-expert/SKILL.md +92 -91
  126. package/skills/svg-animation-motion-expert/SKILL.md +3 -2
  127. package/skills/synthetic-data-finetuning-expert/SKILL.md +156 -155
  128. package/skills/tailwind-expert/SKILL.md +62 -5
  129. package/skills/tanstack-query-expert/SKILL.md +5 -4
  130. package/skills/tauri-expert/SKILL.md +5 -4
  131. package/skills/typescript-expert/SKILL.md +5 -4
  132. package/skills/ui-ux-pro-max/SKILL.md +7 -6
  133. package/skills/vector-db-rag-expert/SKILL.md +209 -208
  134. package/skills/vercel-ai-sdk-expert/SKILL.md +226 -181
  135. package/skills/voice-ai-realtime-agent/SKILL.md +243 -242
  136. package/skills/vue-frontend-expert/SKILL.md +5 -4
  137. package/skills/wasm-edge-computing-expert/SKILL.md +3 -2
  138. package/skills/web-3d-graphics-expert/SKILL.md +314 -313
  139. package/skills/web-game-engine-expert/SKILL.md +330 -329
  140. package/skills/web-scraper/SKILL.md +158 -157
  141. package/skills/website-design-cloner/SKILL.md +5 -4
  142. package/skills/webxr-ar-vr-expert/SKILL.md +163 -162
  143. package/skills/wordpress-headless-expert/SKILL.md +145 -144
  144. package/skills/zero-tech-debt-auditor/SKILL.md +115 -0
  145. package/skills/zero-to-prod-orchestrator/SKILL.md +281 -229
  146. package/skills/zero-trust-secret-vault/SKILL.md +3 -2
  147. package/BLUEPRINT.md +0 -319
  148. package/skills/bootstrap-to-modern/SKILL.md +0 -94
  149. package/skills/multiple-entry-points/SKILL.md +0 -91
  150. package/skills/secure-fuzz-testing/SKILL.md +0 -207
  151. package/skills/visual-qa-vision-agent/SKILL.md +0 -71
@@ -1,91 +1,92 @@
1
- ---
2
- name: pdf-document-generation-expert
3
- description: "Expert guide for PDF generation and document processing (React PDF, Puppeteer, jsPDF, pdf-lib) / Panduan ahli generasi PDF dan pemrosesan dokumen (React PDF, Puppeteer, jsPDF, pdf-lib)."
4
- author: "Roedy Rustam"
5
- ---
6
-
7
- # PDF & Document Generation Expert (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
- - **`email-notification-expert`**: PDF attachments in transactional emails.
18
- - **`saas-billing`**: Invoice and receipt PDF generation.
19
- - **`file-upload-media-expert`**: PDF storage and CDN delivery.
20
-
21
- ### Description
22
- Expert guide for generating PDFs and processing documents in web applications. Covers React PDF (@react-pdf/renderer), Puppeteer HTML-to-PDF, jsPDF, pdf-lib, invoice generation, report templates, digital signatures, and document parsing.
23
-
24
- ### Trigger Conditions
25
- - Generating invoices, receipts, or reports as PDFs.
26
- - Converting HTML pages to downloadable PDFs.
27
- - Building document templates with dynamic data.
28
- - Implementing digital signatures on PDF documents.
29
-
30
- ---
31
-
32
- ### Library Selection
33
-
34
- | Library | Approach | Server/Client | Best For |
35
- |---------|----------|---------------|----------|
36
- | @react-pdf/renderer | React components → PDF | Both | Complex layouts |
37
- | Puppeteer | HTML → PDF (headless Chrome) | Server | Pixel-perfect from HTML |
38
- | jsPDF | Programmatic canvas | Client | Simple client-side PDFs |
39
- | pdf-lib | Low-level PDF manipulation | Both | Modify existing PDFs |
40
-
41
- ```tsx
42
- // React PDF — Invoice generation
43
- import { Document, Page, Text, View, StyleSheet, renderToBuffer } from '@react-pdf/renderer';
44
-
45
- const styles = StyleSheet.create({
46
- page: { padding: 40, fontSize: 12 },
47
- header: { fontSize: 24, marginBottom: 20, color: '#8B5CF6' },
48
- row: { flexDirection: 'row', justifyContent: 'space-between', marginBottom: 8 },
49
- total: { fontSize: 16, fontWeight: 'bold', borderTopWidth: 1, paddingTop: 8, marginTop: 16 },
50
- });
51
-
52
- function InvoicePDF({ invoice }) {
53
- return (
54
- <Document>
55
- <Page size="A4" style={styles.page}>
56
- <Text style={styles.header}>Invoice #{invoice.number}</Text>
57
- {invoice.items.map((item, i) => (
58
- <View key={i} style={styles.row}>
59
- <Text>{item.description}</Text>
60
- <Text>${item.amount.toFixed(2)}</Text>
61
- </View>
62
- ))}
63
- <View style={styles.total}>
64
- <Text>Total: ${invoice.total.toFixed(2)}</Text>
65
- </View>
66
- </Page>
67
- </Document>
68
- );
69
- }
70
-
71
- // Server-side render to buffer
72
- export async function generateInvoicePDF(invoice) {
73
- return await renderToBuffer(<InvoicePDF invoice={invoice} />);
74
- }
75
- ```
76
-
77
- ## Orchestration & Integration
78
- - `email-notification-expert`, `saas-billing`, `file-upload-media-expert`
79
-
80
- ---
81
-
82
- <a name="bahasa-indonesia"></a>
83
- ## Bahasa Indonesia
84
-
85
- ### Deskripsi
86
- Panduan ahli untuk menghasilkan PDF dan memproses dokumen di aplikasi web. Mencakup React PDF, Puppeteer HTML-to-PDF, jsPDF, dan pdf-lib.
87
-
88
- ### Kondisi Pemicu
89
- - Menghasilkan invoice, struk, atau laporan sebagai PDF.
90
- - Mengkonversi halaman HTML ke PDF yang bisa diunduh.
91
- - Membangun template dokumen dengan data dinamis.
1
+ ---
2
+ name: pdf-document-generation-expert
3
+ description: "Expert guide for PDF generation and document processing (React PDF, Puppeteer, jsPDF, pdf-lib) / Panduan ahli generasi PDF dan pemrosesan dokumen (React PDF, Puppeteer, jsPDF, pdf-lib)."
4
+ author: "Roedy Rustam"
5
+ version: "3.0.0"
6
+ ---
7
+
8
+ # PDF & Document Generation Expert (2026 Edition)
9
+
10
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
11
+
12
+ ---
13
+
14
+ <a name="english"></a>
15
+ ## English
16
+
17
+ ### Orchestration & Integration
18
+ - **`email-notification-expert`**: PDF attachments in transactional emails.
19
+ - **`saas-billing`**: Invoice and receipt PDF generation.
20
+ - **`file-upload-media-expert`**: PDF storage and CDN delivery.
21
+
22
+ ### Description
23
+ Expert guide for generating PDFs and processing documents in web applications. Covers React PDF (@react-pdf/renderer), Puppeteer HTML-to-PDF, jsPDF, pdf-lib, invoice generation, report templates, digital signatures, and document parsing.
24
+
25
+ ### Trigger Conditions
26
+ - Generating invoices, receipts, or reports as PDFs.
27
+ - Converting HTML pages to downloadable PDFs.
28
+ - Building document templates with dynamic data.
29
+ - Implementing digital signatures on PDF documents.
30
+
31
+ ---
32
+
33
+ ### Library Selection
34
+
35
+ | Library | Approach | Server/Client | Best For |
36
+ |---------|----------|---------------|----------|
37
+ | @react-pdf/renderer | React components → PDF | Both | Complex layouts |
38
+ | Puppeteer | HTML → PDF (headless Chrome) | Server | Pixel-perfect from HTML |
39
+ | jsPDF | Programmatic canvas | Client | Simple client-side PDFs |
40
+ | pdf-lib | Low-level PDF manipulation | Both | Modify existing PDFs |
41
+
42
+ ```tsx
43
+ // React PDF — Invoice generation
44
+ import { Document, Page, Text, View, StyleSheet, renderToBuffer } from '@react-pdf/renderer';
45
+
46
+ const styles = StyleSheet.create({
47
+ page: { padding: 40, fontSize: 12 },
48
+ header: { fontSize: 24, marginBottom: 20, color: '#8B5CF6' },
49
+ row: { flexDirection: 'row', justifyContent: 'space-between', marginBottom: 8 },
50
+ total: { fontSize: 16, fontWeight: 'bold', borderTopWidth: 1, paddingTop: 8, marginTop: 16 },
51
+ });
52
+
53
+ function InvoicePDF({ invoice }) {
54
+ return (
55
+ <Document>
56
+ <Page size="A4" style={styles.page}>
57
+ <Text style={styles.header}>Invoice #{invoice.number}</Text>
58
+ {invoice.items.map((item, i) => (
59
+ <View key={i} style={styles.row}>
60
+ <Text>{item.description}</Text>
61
+ <Text>${item.amount.toFixed(2)}</Text>
62
+ </View>
63
+ ))}
64
+ <View style={styles.total}>
65
+ <Text>Total: ${invoice.total.toFixed(2)}</Text>
66
+ </View>
67
+ </Page>
68
+ </Document>
69
+ );
70
+ }
71
+
72
+ // Server-side render to buffer
73
+ export async function generateInvoicePDF(invoice) {
74
+ return await renderToBuffer(<InvoicePDF invoice={invoice} />);
75
+ }
76
+ ```
77
+
78
+ ## Orchestration & Integration
79
+ - `email-notification-expert`, `saas-billing`, `file-upload-media-expert`
80
+
81
+ ---
82
+
83
+ <a name="bahasa-indonesia"></a>
84
+ ## Bahasa Indonesia
85
+
86
+ ### Deskripsi
87
+ Panduan ahli untuk menghasilkan PDF dan memproses dokumen di aplikasi web. Mencakup React PDF, Puppeteer HTML-to-PDF, jsPDF, dan pdf-lib.
88
+
89
+ ### Kondisi Pemicu
90
+ - Menghasilkan invoice, struk, atau laporan sebagai PDF.
91
+ - Mengkonversi halaman HTML ke PDF yang bisa diunduh.
92
+ - Membangun template dokumen dengan data dinamis.
@@ -1,7 +1,8 @@
1
1
  ---
2
2
  name: performance-web-vitals
3
3
  description: "Expert guide for Web Performance optimization: Core Web Vitals (LCP, INP, CLS), bundle analysis, image optimization, rendering strategies, and Lighthouse score improvement / Panduan ahli untuk optimasi performa web: Core Web Vitals (LCP, INP, CLS), analisis bundle, optimasi gambar, strategi rendering, dan peningkatan skor Lighthouse."
4
- author: "Roedy Rustam"
4
+ author: "Roedy Rustam"
5
+ version: "3.0.0"
5
6
  ---
6
7
 
7
8
  # Web Performance & Core Web Vitals Expert
@@ -14,7 +15,7 @@ author: "Roedy Rustam"
14
15
  ## English
15
16
 
16
17
  ### 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
+ Connects and orchestrates with relevant domain skills like `brainstorming`, `zero-to-prod-orchestrator`, and `session-memory-manager` to ensure cohesive execution.
18
19
 
19
20
  ### Description
20
21
  Expert guide for measuring, diagnosing, and optimizing web application performance with a focus on **Core Web Vitals** (LCP, INP, CLS), JavaScript bundle optimization, image and font loading strategies, rendering performance, and achieving high Lighthouse scores. Covers Next.js 15, React 19, and modern browser APIs.
@@ -308,7 +309,7 @@ onTTFB(sendToAnalytics);
308
309
  ## Bahasa Indonesia
309
310
 
310
311
  ### Integrasi Orkestrasi
311
- Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
312
+ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `session-memory-manager` untuk memastikan eksekusi yang kohesif.
312
313
 
313
314
  ### Deskripsi
314
315
  Panduan ahli untuk mengukur, mendiagnosis, dan mengoptimalkan performa aplikasi web dengan fokus pada **Core Web Vitals** (LCP, INP, CLS), optimasi JavaScript bundle, strategi loading gambar dan font, performa rendering, dan mencapai skor Lighthouse yang tinggi.
@@ -335,4 +336,4 @@ Panduan ahli untuk mengukur, mendiagnosis, dan mengoptimalkan performa aplikasi
335
336
  - **INP**: Pecah long task dengan `scheduler.yield()`, gunakan `useTransition` React 19, virtualisasi list panjang.
336
337
  - **CLS**: Reservasi ruang untuk gambar dengan `aspect-ratio`, hindari penyisipan konten di atas konten yang sudah ada.
337
338
  - **Bundle**: Analisis bundle, gunakan dynamic import, tree-shaking, dan named imports.
338
- - **Monitoring**: Implementasikan `web-vitals` library untuk melaporkan metrik ke analytics secara real-time.
339
+ - **Monitoring**: Implementasikan `web-vitals` library untuk melaporkan metrik ke analytics secara real-time.
@@ -1,7 +1,8 @@
1
1
  ---
2
2
  name: post-quantum-crypto-migrator
3
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: "Roedy Rustam"
4
+ author: "Roedy Rustam"
5
+ version: "3.0.0"
5
6
  ---
6
7
 
7
8
  # Post-Quantum Cryptography Migrator
@@ -54,4 +55,4 @@ Keterampilan arsitek keamanan tingkat lanjut yang dirancang untuk melindungi int
54
55
  ## Integrasi Orkestrasi
55
56
  - Menegakkan standar keamanan ekstrem berdampingan dengan `authentication-identity-expert`.
56
57
  - 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).
58
+ - Terintegrasi dengan `database-orm-expert` untuk memperbarui panjang skema kolom database (karena ukuran kunci PQC jauh lebih besar dari RSA).
@@ -1,182 +1,183 @@
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
+ ---
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
+ version: "3.0.0"
6
+ ---
7
+
8
+ # PRD Architect & Documentation Lifecycle (2026 Edition)
9
+
10
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
11
+
12
+ ---
13
+
14
+ <a name="english"></a>
15
+ ## English
16
+
17
+ ### Orchestration & Integration
18
+ Connects with `brainstorming`, `zero-to-prod-orchestrator`, `session-memory-manager` to ensure cohesive execution and documentation updates.
19
+
20
+ ### Description
21
+ A mandatory lifecycle guardrail covering two distinct phases:
22
+ - **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.
23
+ - **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).
24
+
25
+ ### Trigger Conditions
26
+ - **Phase 1:** User requests building a new app/SaaS/feature from scratch; no existing PRD/blueprint; unclear scope.
27
+ - **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.
28
+
29
+ ### Phase 1: Pre-Code Requirements & Enforcement
30
+ **Why PRD Before Code:** Prevents scope creep, aligns AI output, enables traceability, reduces rework, version-controlled.
31
+
32
+ #### Enforcement Protocol
33
+ 1. **Detect**: When user requests a new project build.
34
+ 2. **Pause**: Do NOT generate any code.
35
+ 3. **Generate Assets**: Automatically create `PRD.md`, `ERD.md`, `DOKUMENTASI.md`, and `ROADMAP.md` (or `PROGRESS.md`).
36
+ 4. **Review**: Present to user for approval/edits.
37
+ 5. **Confirm**: Proceed to code generation ONLY after approval.
38
+ 6. **Reference**: Cite these documents in all subsequent decisions.
39
+
40
+ #### PRD-as-Code Template (12 Sections)
41
+ ```markdown
42
+ # Product Requirements Document (PRD)
43
+ **Project**: [Project Name]
44
+ **Version**: 1.0.0
45
+ **Status**: Draft | In Review | Approved
46
+ **Created**: YYYY-MM-DD
47
+ **Last Updated**: YYYY-MM-DD
48
+
49
+ ---
50
+ ## 1. Executive Summary
51
+ [2-3 sentences: What is this product? Who is it for? What problem does it solve?]
52
+
53
+ ## 2. Problem Statement
54
+ **Problem**: [Clear description]
55
+ **Target Users**: [Specific segments]
56
+ **Current Pain Points**: [List]
57
+
58
+ ## 3. Goals & Success Metrics
59
+ | Goal | Metric | Target |
60
+ |---|---|---|
61
+ | [Goal] | [Metric] | [Target] |
62
+
63
+ ## 4. User Personas
64
+ ### Persona 1: [Name]
65
+ - **Role**: [Job title]
66
+ - **Goals**: [What they want to achieve]
67
+ - **Frustrations**: [What currently doesn't work]
68
+ - **Key Behaviors**: [How they'll use this product]
69
+
70
+ ## 5. Feature Requirements
71
+ ### MVP Features (Must Have — v1.0)
72
+ - [ ] **[Feature Name]**: [Description. Acceptance criteria: ...]
73
+ ### Phase 2 Features (Should Have — v1.x)
74
+ - [ ] **[Feature Name]**: [Description]
75
+ ### Future Features (Nice to Have — v2.0+)
76
+ - [ ] **[Feature Name]**: [Description]
77
+
78
+ ## 6. Technical Architecture
79
+ ### Stack Decision
80
+ | Layer | Technology | Rationale |
81
+ |---|---|---|
82
+ | [Layer] | [Technology] | [Reason] |
83
+ ### Architecture Decisions (ADRs)
84
+ - **ADR-001**: [Decision title] — [Decision made and why]
85
+ ### Multi-Entry Points (if SaaS)
86
+ | Entry Point | Domain | Purpose |
87
+ |---|---|---|
88
+ | [Entry] | [Domain] | [Purpose] |
89
+
90
+ ## 7. Data Model (High-Level)
91
+ users ──belongs_to──> workspaces (via workspace_members)
92
+ workspaces ──has_many──> projects
93
+
94
+ ## 8. User Flows
95
+ ### Primary Flow: [Name]
96
+ 1. User [action 1]
97
+ 2. System [response 1]
98
+
99
+ ## 9. Non-Functional Requirements
100
+ | Requirement | Target |
101
+ |---|---|
102
+ | Performance | LCP < 2.5s, INP < 200ms |
103
+
104
+ ## 10. Out of Scope
105
+ - [Explicitly excluded item]
106
+
107
+ ## 11. Open Questions
108
+ - [ ] [Question that needs decision]
109
+
110
+ ## 12. Approval & Sign-off
111
+ | Stakeholder | Role | Status |
112
+ |---|---|---|
113
+ | [Name] | [Role] | [Status] |
114
+ ```
115
+
116
+ ### Phase 2: Post-Code Maintenance & Update Protocol
117
+
118
+ After every successful feature implementation:
119
+ 1. **CHANGELOG.md**: Add entry under `[Unreleased]` (Keep-a-Changelog standard: Added/Changed/Fixed/Removed/Security).
120
+ 2. **BLUEPRINT.md**: Update only if architecture, schema, stack, or entry points changed.
121
+ 3. **PROGRESS.md**: Mark completed tasks `[x]`, update next steps.
122
+ 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`).
123
+
124
+ #### Files Maintained Frequency Matrix
125
+ | File | Purpose | Update Frequency |
126
+ |---|---|---|
127
+ | `CHANGELOG.md` | User-facing list of changes | Every PR / feature |
128
+ | `BLUEPRINT.md` | Technical architecture overview | Major structural changes |
129
+ | `PROGRESS.md` | Development roadmap and status | Each work session |
130
+ | `docs/adr/` | Architecture Decision Records | Each key decision |
131
+
132
+ #### ADR Template
133
+ ```markdown
134
+ # ADR-001: [Title]
135
+ **Status**: Accepted | Rejected | Proposed | Deprecated
136
+ **Date**: YYYY-MM-DD
137
+ **Deciders**: [Team/Individual]
138
+ ## Context
139
+ [What motivated this decision?]
140
+ ## Decision
141
+ [What is being decided?]
142
+ ## Rationale
143
+ [Why this choice?]
144
+ ## Consequences
145
+ **Positive:** / **Negative:**
146
+ ## Superseded By
147
+ [ADR-XXX] (if applicable)
148
+ ```
149
+
150
+ ### 🎨 Automatic Visual Assets Generation Mandate (CRITICAL)
151
+ **MANDATORY**: When building a new application, use `generate_image` to create a custom logo. Use it as:
152
+ 1. The primary application logo (header/navbar).
153
+ 2. The website favicon (`favicon.ico`).
154
+ 3. The Open Graph (OG) image for SEO (`og:image`).
155
+
156
+ ---
157
+
158
+ <a name="bahasa-indonesia"></a>
159
+ ## Bahasa Indonesia
160
+
161
+ ### Integrasi Orkestrasi
162
+ Terhubung dengan `brainstorming`, `zero-to-prod-orchestrator`, `session-memory-manager`.
163
+
164
+ ### Deskripsi
165
+ Guardrail siklus hidup wajib:
166
+ - **Fase 1 (Pra-Kode):** Memaksa pembuatan PRD, ERD, dan Dokumentasi sebelum kode dibuat.
167
+ - **Fase 2 (Pasca-Kode):** Memelihara dokumentasi setelah setiap fitur sukses: `CHANGELOG.md`, `BLUEPRINT.md`, `PROGRESS.md`, dan ADR.
168
+
169
+ ### Kondisi Pemicu
170
+ - **Fase 1:** Proyek baru dari awal; tidak ada PRD; ruang lingkup tidak jelas.
171
+ - **Fase 2:** Fitur berhasil; pengguna meminta "perbarui docs"; keputusan arsitektur signifikan.
172
+
173
+ ### Fase 1: Protokol Penegakan
174
+ 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.
175
+
176
+ ### Fase 2: Pemeliharaan Pasca-Kode
177
+ 1. **CHANGELOG.md**: Tambahkan ke `[Unreleased]` (Added/Changed/Fixed/Removed/Security).
178
+ 2. **BLUEPRINT.md**: Perbarui jika struktur berubah.
179
+ 3. **PROGRESS.md**: Tandai `[x]`, perbarui langkah selanjutnya.
180
+ 4. **ADR**: Buat `docs/adr/ADR-NNN-title.md` untuk keputusan besar.
181
+
182
+ ### 🎨 Mandat Aset Visual Otomatis (KRITIS)
183
+ **WAJIB**: Gunakan `generate_image` untuk membuat logo kustom sebagai logo, favicon, dan OG image.