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.
- package/.claude/rules/vibes-plug-core.md +5 -0
- package/.cursor/rules/vibes-plug-core.mdc +7 -2
- package/.cursorrules +8 -2
- package/AGENTS.md +23 -2
- package/CHANGELOG.md +114 -0
- package/CLAUDE.md +10 -3
- package/README.md +216 -611
- package/bin/vibes.mjs +1104 -0
- package/package.json +11 -3
- package/plugin.json +4 -3
- package/scripts/check-anti-slop.mjs +53 -0
- package/scripts/install.js +3 -1
- package/scripts/update_skills.js +1 -1
- package/scripts/update_skills.mjs +86 -0
- package/scripts/validate-skills.mjs +111 -0
- package/skills/accessibility-testing-expert/SKILL.md +117 -116
- package/skills/affective-computing-emotion-ai/SKILL.md +83 -0
- package/skills/agentic-coding-workflow-expert/SKILL.md +297 -0
- package/skills/agentic-memory-architect/SKILL.md +52 -0
- package/skills/agentic-micro-economy-architect/SKILL.md +92 -0
- package/skills/ai-llm-integration-expert/SKILL.md +330 -194
- package/skills/ai-media-generation-expert/SKILL.md +173 -172
- package/skills/ai-prompt-engineering-expert/SKILL.md +204 -134
- package/skills/ai-safety-governance-expert/SKILL.md +223 -0
- package/skills/angular-expert/SKILL.md +149 -148
- package/skills/anti-slop/SKILL.md +134 -133
- package/skills/api-design-expert/SKILL.md +4 -3
- package/skills/api-gateway-proxy-expert/SKILL.md +3 -2
- package/skills/app-analyzer-optimizer/SKILL.md +4 -3
- package/skills/apple-ecosystem-expert/SKILL.md +6 -5
- package/skills/astro-framework-expert/SKILL.md +201 -200
- package/skills/async-queue-temporal-expert/SKILL.md +218 -217
- package/skills/authentication-identity-expert/SKILL.md +174 -173
- package/skills/autonomous-red-teamer/SKILL.md +338 -203
- package/skills/autonomous-tdd-debugger/SKILL.md +6 -5
- package/skills/biome-linter-formatter-expert/SKILL.md +90 -89
- package/skills/blockchain-web3-expert/SKILL.md +116 -115
- package/skills/brainstorming/SKILL.md +392 -377
- package/skills/browser-automation-expert/SKILL.md +260 -222
- package/skills/bun-runtime-expert/SKILL.md +5 -4
- package/skills/chatbot-messaging-expert/SKILL.md +115 -114
- package/skills/ci-cd-devops-architect/SKILL.md +3 -2
- package/skills/cloud-hosting-expert/SKILL.md +5 -4
- package/skills/coderabbit/SKILL.md +5 -4
- package/skills/compliance-gdpr-privacy-expert/SKILL.md +3 -2
- package/skills/composable-mach-architect/SKILL.md +338 -0
- package/skills/cron-scheduler-expert/SKILL.md +5 -4
- package/skills/data-pipeline-etl-expert/SKILL.md +3 -2
- package/skills/data-telemetry-expert/SKILL.md +5 -4
- package/skills/data-visualization-expert/SKILL.md +155 -154
- package/skills/database-orm-expert/SKILL.md +166 -165
- package/skills/deep-research-analyst/SKILL.md +182 -136
- package/skills/dependency-upgrade-migrator/SKILL.md +11 -10
- package/skills/design-system-architect/SKILL.md +4 -3
- package/skills/desktop-electron-expert/SKILL.md +129 -128
- package/skills/documentation-site-expert/SKILL.md +60 -59
- package/skills/doku-mcp-server/SKILL.md +5 -4
- package/skills/doku-payment-gateway/SKILL.md +250 -232
- package/skills/domain-driven-design-expert/SKILL.md +3 -2
- package/skills/e2e-testing-expert/SKILL.md +5 -4
- package/skills/ecommerce-expert/SKILL.md +88 -87
- package/skills/email-notification-expert/SKILL.md +5 -4
- package/skills/ephemeral-generative-ui-architect/SKILL.md +88 -0
- package/skills/error-resilience-expert/SKILL.md +14 -13
- package/skills/event-driven-architect/SKILL.md +5 -4
- package/skills/feature-flag-analytics-expert/SKILL.md +3 -2
- package/skills/file-upload-media-expert/SKILL.md +5 -4
- package/skills/firebase-security-expert/SKILL.md +5 -4
- package/skills/form-validation-expert/SKILL.md +7 -6
- package/skills/frontier-ai-models-expert/SKILL.md +116 -0
- package/skills/fullstack-expert/SKILL.md +185 -184
- package/skills/gemini-agent-booster/SKILL.md +248 -172
- package/skills/geospatial-maps-expert/SKILL.md +81 -80
- package/skills/global-a11y-i18n-expert/SKILL.md +5 -4
- package/skills/glsl-shader-expert/SKILL.md +191 -190
- package/skills/go-programming-expert/SKILL.md +5 -4
- package/skills/graph-rag-knowledge-expert/SKILL.md +201 -200
- package/skills/graphql-apollo-expert/SKILL.md +5 -4
- package/skills/headless-cms-expert/SKILL.md +182 -181
- package/skills/hig/SKILL.md +5 -4
- package/skills/js-backend-expert/SKILL.md +219 -218
- package/skills/legacy-code-translator/SKILL.md +6 -5
- package/skills/llm-finops-router/SKILL.md +52 -0
- package/skills/local-slm-edge-ai-expert/SKILL.md +168 -167
- package/skills/logging-error-tracking-expert/SKILL.md +5 -4
- package/skills/mcp-server-architect/SKILL.md +315 -307
- package/skills/micro-frontend-architect/SKILL.md +5 -4
- package/skills/mobile-expo-expert/SKILL.md +5 -4
- package/skills/modern-css-native-expert/SKILL.md +190 -189
- package/skills/monorepo-architect/SKILL.md +5 -4
- package/skills/mpa-orchestrator/SKILL.md +41 -4
- package/skills/multi-agent-orchestration/SKILL.md +388 -254
- package/skills/mvc-expert/SKILL.md +5 -4
- package/skills/n8n-automation-expert/SKILL.md +90 -89
- package/skills/nextjs-app-router-expert/SKILL.md +3 -2
- package/skills/openapi-swagger-codegen-expert/SKILL.md +4 -3
- package/skills/payment-gateway-expert/SKILL.md +131 -128
- package/skills/pdf-document-generation-expert/SKILL.md +92 -91
- package/skills/performance-web-vitals/SKILL.md +5 -4
- package/skills/post-quantum-crypto-migrator/SKILL.md +3 -2
- package/skills/prd-architect/SKILL.md +183 -182
- package/skills/proactive-background-watcher/SKILL.md +5 -4
- package/skills/production-ready-hardener/SKILL.md +10 -9
- package/skills/pwa-offline-first-expert/SKILL.md +227 -226
- package/skills/pydantic-ai-expert/SKILL.md +162 -161
- package/skills/python-programming-expert/SKILL.md +5 -4
- package/skills/rate-limit-abuse-prevention/SKILL.md +5 -4
- package/skills/realtime-collaboration-expert/SKILL.md +3 -2
- package/skills/rich-text-editor-expert/SKILL.md +178 -177
- package/skills/rust-programming-expert/SKILL.md +5 -4
- package/skills/saas-architect/SKILL.md +155 -154
- package/skills/saas-billing/SKILL.md +394 -382
- package/skills/saas-multi-tenant/SKILL.md +7 -6
- package/skills/scalability-clean-code/SKILL.md +5 -4
- package/skills/search-engine-expert/SKILL.md +90 -89
- package/skills/self-healing-cloud-orchestrator/SKILL.md +3 -2
- package/skills/senior-frontend/SKILL.md +14 -9
- package/skills/seo/SKILL.md +4 -4
- package/skills/session-memory-manager/SKILL.md +129 -128
- package/skills/solidjs-expert/SKILL.md +81 -80
- package/skills/spa-orchestrator/SKILL.md +5 -4
- package/skills/sse-websocket-streaming-expert/SKILL.md +3 -2
- package/skills/state-management-expert/SKILL.md +5 -4
- package/skills/supabase-security-expert/SKILL.md +5 -4
- package/skills/svelte-sveltekit-expert/SKILL.md +92 -91
- package/skills/svg-animation-motion-expert/SKILL.md +3 -2
- package/skills/synthetic-data-finetuning-expert/SKILL.md +156 -155
- package/skills/tailwind-expert/SKILL.md +62 -5
- package/skills/tanstack-query-expert/SKILL.md +5 -4
- package/skills/tauri-expert/SKILL.md +5 -4
- package/skills/typescript-expert/SKILL.md +5 -4
- package/skills/ui-ux-pro-max/SKILL.md +7 -6
- package/skills/vector-db-rag-expert/SKILL.md +209 -208
- package/skills/vercel-ai-sdk-expert/SKILL.md +226 -181
- package/skills/voice-ai-realtime-agent/SKILL.md +243 -242
- package/skills/vue-frontend-expert/SKILL.md +5 -4
- package/skills/wasm-edge-computing-expert/SKILL.md +3 -2
- package/skills/web-3d-graphics-expert/SKILL.md +314 -313
- package/skills/web-game-engine-expert/SKILL.md +330 -329
- package/skills/web-scraper/SKILL.md +158 -157
- package/skills/website-design-cloner/SKILL.md +5 -4
- package/skills/webxr-ar-vr-expert/SKILL.md +163 -162
- package/skills/wordpress-headless-expert/SKILL.md +145 -144
- package/skills/zero-tech-debt-auditor/SKILL.md +115 -0
- package/skills/zero-to-prod-orchestrator/SKILL.md +281 -229
- package/skills/zero-trust-secret-vault/SKILL.md +3 -2
- package/BLUEPRINT.md +0 -319
- package/skills/bootstrap-to-modern/SKILL.md +0 -94
- package/skills/multiple-entry-points/SKILL.md +0 -91
- package/skills/secure-fuzz-testing/SKILL.md +0 -207
- 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
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
- **`
|
|
19
|
-
- **`
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
|
38
|
-
|
|
|
39
|
-
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
{invoice.
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
<Text
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
}
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
-
|
|
91
|
-
-
|
|
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 `
|
|
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 `
|
|
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
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
- **Phase
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
- **Phase
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
**
|
|
44
|
-
**
|
|
45
|
-
**
|
|
46
|
-
**
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
**
|
|
55
|
-
**
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
- **
|
|
66
|
-
- **
|
|
67
|
-
- **
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
| `
|
|
128
|
-
| `
|
|
129
|
-
| `
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
**
|
|
136
|
-
**
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
- **Fase
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
- **Fase
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
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.
|