vibes-plug 2.11.0 → 2.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/.cursor/rules/vibes-plug-core.mdc +3 -3
  2. package/.cursorrules +3 -3
  3. package/AGENTS.md +4 -4
  4. package/BLUEPRINT.md +16 -6
  5. package/CHANGELOG.md +37 -0
  6. package/CLAUDE.md +8 -8
  7. package/README.md +85 -115
  8. package/index.js +1 -1
  9. package/package.json +2 -2
  10. package/plugin.json +2 -2
  11. package/scripts/check-anti-slop.js +53 -0
  12. package/scripts/generate_swarm_gif.py +2 -2
  13. package/skills/ai-llm-integration-expert/SKILL.md +22 -15
  14. package/skills/ai-prompt-engineering-expert/SKILL.md +133 -83
  15. package/skills/anti-slop/SKILL.md +133 -0
  16. package/skills/async-queue-temporal-expert/SKILL.md +135 -158
  17. package/skills/authentication-identity-expert/SKILL.md +172 -278
  18. package/skills/brainstorming/SKILL.md +26 -26
  19. package/skills/database-orm-expert/SKILL.md +164 -303
  20. package/skills/deep-research-analyst/SKILL.md +136 -0
  21. package/skills/design-system-architect/SKILL.md +31 -1
  22. package/skills/email-notification-expert/SKILL.md +31 -4
  23. package/skills/error-resilience-expert/SKILL.md +21 -0
  24. package/skills/fullstack-expert/SKILL.md +183 -260
  25. package/skills/glsl-shader-expert/SKILL.md +190 -107
  26. package/skills/graph-rag-knowledge-expert/SKILL.md +42 -1
  27. package/skills/mcp-server-architect/SKILL.md +15 -1
  28. package/skills/prd-architect/SKILL.md +181 -206
  29. package/skills/production-ready-hardener/SKILL.md +16 -19
  30. package/skills/pwa-offline-first-expert/SKILL.md +42 -1
  31. package/skills/pydantic-ai-expert/SKILL.md +161 -0
  32. package/skills/saas-architect/SKILL.md +154 -0
  33. package/skills/senior-frontend/SKILL.md +9 -11
  34. package/skills/senior-frontend/scripts/frontend_scaffolder.py +1 -1
  35. package/skills/session-memory-manager/SKILL.md +128 -0
  36. package/skills/synthetic-data-finetuning-expert/SKILL.md +155 -0
  37. package/skills/ui-ux-pro-max/SKILL.md +4 -2
  38. package/skills/vercel-ai-sdk-expert/SKILL.md +181 -0
  39. package/skills/voice-ai-realtime-agent/SKILL.md +41 -1
  40. package/skills/web-3d-graphics-expert/SKILL.md +313 -137
  41. package/skills/web-game-engine-expert/SKILL.md +329 -102
  42. package/skills/webxr-ar-vr-expert/SKILL.md +162 -123
  43. package/skills/zero-to-prod-orchestrator/SKILL.md +26 -24
  44. package/skills/ai-cost-token-optimizer/SKILL.md +0 -82
  45. package/skills/ai-evals-benchmark-expert/SKILL.md +0 -188
  46. package/skills/asisten-ramah/SKILL.md +0 -47
  47. package/skills/auto-doc-updater/SKILL.md +0 -220
  48. package/skills/autonomous-chaos-monkey/SKILL.md +0 -63
  49. package/skills/background-jobs-queue-expert/SKILL.md +0 -235
  50. package/skills/database-migration-versioning-expert/SKILL.md +0 -90
  51. package/skills/edge-serverless-db-expert/SKILL.md +0 -99
  52. package/skills/mcp-client-orchestrator/SKILL.md +0 -76
  53. package/skills/mobile-push-notification-expert/SKILL.md +0 -71
  54. package/skills/monday-design-aesthetic/SKILL.md +0 -73
  55. package/skills/project-context-mapper/SKILL.md +0 -85
  56. package/skills/saas-mvp-launcher/SKILL.md +0 -260
  57. package/skills/saas-transformer/SKILL.md +0 -500
  58. package/skills/saas-transformer/references/billing_integration_guide.md +0 -401
  59. package/skills/self-evolving-memory-graph/SKILL.md +0 -91
  60. package/skills/session-context-loader/SKILL.md +0 -83
  61. package/skills/session-handoff-resume/SKILL.md +0 -164
  62. package/skills/skill-baru/SKILL.md +0 -178
  63. package/skills/supabase-migration/SKILL.md +0 -91
  64. package/skills/token-saver/SKILL.md +0 -119
  65. package/skills/ui-components-expert/SKILL.md +0 -166
  66. package/skills/vibe-code-gardener/SKILL.md +0 -181
  67. /package/skills/{saas-transformer → saas-architect}/references/feature_gating_patterns.md +0 -0
  68. /package/skills/{saas-transformer → saas-architect}/references/saas_transformation_checklist.md +0 -0
  69. /package/skills/{saas-transformer → saas-architect}/scripts/saas_transformation_scanner.py +0 -0
@@ -1,207 +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."
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
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
- ### 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
- 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.
21
-
22
- ### Trigger Conditions
23
- - A user requests building a new application, SaaS, or major feature from scratch.
24
- - There is no existing PRD, BLUEPRINT.md, or product specification.
25
- - The project scope is unclear or ambiguous.
26
- - The user says "build me...", "create a...", "I want to make..." for a new project.
27
-
28
- ### Why PRD Before Code
29
- 1. **Prevents scope creep**: Defines boundaries before any line of code is written.
30
- 2. **Aligns AI output**: AI agents generate significantly better code when given a structured spec.
31
- 3. **Enables traceability**: Each implemented feature can be traced back to a PRD requirement.
32
- 4. **Reduces rework**: Catches architectural decisions early (DB choice, auth flow, integrations).
33
- 5. **Version-controlled spec**: PRD lives in the repo — changes are tracked and reviewable.
34
-
35
- ### PRD-as-Code Template
36
-
37
- ```markdown
38
- # Product Requirements Document (PRD)
39
- **Project**: [Project Name]
40
- **Version**: 1.0.0
41
- **Status**: Draft | In Review | Approved
42
- **Created**: YYYY-MM-DD
43
- **Last Updated**: YYYY-MM-DD
44
-
45
- ---
46
-
47
- ## 1. Executive Summary
48
- [2-3 sentences: What is this product? Who is it for? What problem does it solve?]
49
-
50
- ## 2. Problem Statement
51
- **Problem**: [Clear description of the problem being solved]
52
- **Target Users**: [Specific user segments]
53
- **Current Pain Points**:
54
- - Pain point 1
55
- - Pain point 2
56
-
57
- ## 3. Goals & Success Metrics
58
- | Goal | Metric | Target |
59
- |---|---|---|
60
- | Reduce churn | Monthly churn rate | < 5% |
61
- | Improve activation | D7 retention | > 40% |
62
-
63
- ## 4. User Personas
64
- ### Persona 1: [Name]
65
- - **Role**: [Job title / context]
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
-
72
- ### MVP Features (Must Have — v1.0)
73
- - [ ] **[Feature Name]**: [Description. Acceptance criteria: ...]
74
- - [ ] **Authentication**: Email/password + Google OAuth. PKCE flow. Session-based.
75
- - [ ] **Dashboard**: Overview of [key metrics]. Real-time updates via SSE.
76
-
77
- ### Phase 2 Features (Should Have — v1.x)
78
- - [ ] **[Feature Name]**: [Description]
79
-
80
- ### Future Features (Nice to Have — v2.0+)
81
- - [ ] **[Feature Name]**: [Description]
82
-
83
- ## 6. Technical Architecture
84
-
85
- ### Stack Decision
86
- | Layer | Technology | Rationale |
87
- |---|---|---|
88
- | Frontend | Next.js 15 + React 19 | SSR, App Router, RSC |
89
- | Backend | Hono + Bun | Type-safe RPC, edge-ready |
90
- | Database | PostgreSQL + Drizzle ORM | ACID, RLS multi-tenant |
91
- | Auth | Supabase Auth v3 | PKCE, OAuth, MFA |
92
- | Payments | Stripe / Polar.sh | [Reason for choice] |
93
- | Deployment | Vercel + Railway | [Reason for choice] |
94
-
95
- ### Architecture Decisions (ADRs)
96
- - **ADR-001**: [Decision title] — [Decision made and why]
97
- - **ADR-002**: Multi-tenancy via RLS — Shared schema with Supabase RLS for isolation
98
-
99
- ### Multi-Entry Points (if SaaS)
100
- | Entry Point | Domain | Purpose |
101
- |---|---|---|
102
- | Landing Page | `myapp.com` | Marketing, conversion |
103
- | SaaS App | `app.myapp.com` | Core product |
104
- | Super Admin | `admin.myapp.com` | Cross-tenant management |
105
- | API | `api.myapp.com` | Backend (internal + public) |
106
-
107
- ## 7. Data Model (High-Level)
108
- ```
109
- users ──belongs_to──> workspaces (via workspace_members)
110
- workspaces ──has_many──> projects
111
- projects ──has_many──> tasks
112
- ```
113
-
114
- ## 8. User Flows
115
- ### Primary Flow: [Name]
116
- 1. User [action 1]
117
- 2. System [response 1]
118
- 3. User [action 2]
119
- 4. System [response 2] → Success state
120
-
121
- ## 9. Non-Functional Requirements
122
- | Requirement | Target |
123
- |---|---|
124
- | Performance | LCP < 2.5s, INP < 200ms |
125
- | Availability | 99.9% uptime |
126
- | Security | SOC 2 Type II compliant |
127
- | Scalability | Support 10K concurrent users |
128
-
129
- ## 10. Out of Scope
130
- - [Explicitly excluded feature or integration]
131
- - [Another explicitly excluded item]
132
-
133
- ## 11. Open Questions
134
- - [ ] [Question that needs a decision before development]
135
- - [ ] Should we support SSO (SAML) in v1 or defer to v2?
136
-
137
- ## 12. Approval & Sign-off
138
- | Stakeholder | Role | Status |
139
- |---|---|---|
140
- | [Name] | Product | ✅ Approved |
141
- | [Name] | Engineering | ⏳ Pending |
142
- ```
143
-
144
- ### Enforcement Protocol
145
- 1. **Detect**: When user requests a new project build.
146
- 2. **Pause**: Do NOT generate any code.
147
- 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.
148
- 4. **Review**: Present to user for approval/edits.
149
- 5. **Confirm**: Once the PRD, ERD, Documentation, and Roadmap are approved, proceed to `zero-to-prod-orchestrator` Phase 1.
150
- 6. **Reference**: Cite the PRD, ERD, Documentation, and Roadmap in all subsequent code generation decisions.
151
-
152
- ---
153
-
154
- <a name="bahasa-indonesia"></a>
155
- ## Bahasa Indonesia
156
-
157
- ### Integrasi Orkestrasi
158
- Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
159
-
160
- ### Deskripsi
161
- 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.
162
-
163
- ### Kondisi Pemicu
164
- - Pengguna meminta membangun aplikasi, SaaS, atau fitur besar baru dari awal.
165
- - Tidak ada PRD, BLUEPRINT.md, atau spesifikasi produk yang ada.
166
- - Ruang lingkup proyek tidak jelas atau ambigu.
167
- - Pengguna berkata "buatkan saya...", "buat sebuah...", "saya ingin membuat..." untuk proyek baru.
168
-
169
- ### Mengapa PRD Sebelum Kode
170
- 1. **Mencegah scope creep**: Mendefinisikan batas sebelum satu baris kode pun ditulis.
171
- 2. **Menyelaraskan output AI**: Agen AI menghasilkan kode yang jauh lebih baik saat diberi spesifikasi terstruktur.
172
- 3. **Memungkinkan keterlacakan**: Setiap fitur yang diimplementasikan dapat ditelusuri kembali ke persyaratan PRD.
173
- 4. **Mengurangi pengerjaan ulang**: Menangkap keputusan arsitektur lebih awal (pilihan DB, alur auth, integrasi).
174
- 5. **Spesifikasi dengan kontrol versi**: PRD hidup di repo — perubahan dilacak dan dapat ditinjau.
175
-
176
- ### Template PRD-as-Code
177
- Template PRD mencakup 12 bagian:
178
- 1. **Ringkasan Eksekutif**: Apa produk ini, untuk siapa, masalah apa yang diselesaikan.
179
- 2. **Pernyataan Masalah**: Deskripsi masalah yang jelas dengan persona pengguna target.
180
- 3. **Tujuan & Metrik Keberhasilan**: Target terukur yang terkait dengan tujuan bisnis.
181
- 4. **Persona Pengguna**: Peran, tujuan, frustrasi, dan perilaku kunci.
182
- 5. **Persyaratan Fitur**: MVP (Harus Ada), Fase 2 (Sebaiknya Ada), Masa Depan (Bagus Dimiliki).
183
- 6. **Arsitektur Teknis**: Keputusan stack dengan justifikasi, ADR, multi-entry points.
184
- 7. **Model Data**: Hubungan antar entitas tingkat tinggi.
185
- 8. **Alur Pengguna**: Alur langkah-demi-langkah untuk interaksi utama.
186
- 9. **Persyaratan Non-Fungsional**: Performa, ketersediaan, keamanan, skalabilitas.
187
- 10. **Di Luar Ruang Lingkup**: Apa yang secara eksplisit dikecualikan.
188
- 11. **Pertanyaan Terbuka**: Keputusan yang perlu dibuat sebelum pengembangan.
189
- 12. **Persetujuan**: Pemangku kepentingan dan status tanda tangan.
190
-
191
- ### Protokol Penegakan
192
- 1. **Deteksi**: Saat pengguna meminta pembangunan proyek baru.
193
- 2. **Jeda**: JANGAN hasilkan kode apapun.
194
- 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.
195
- 4. **Tinjau**: Sajikan kepada pengguna untuk persetujuan/edit.
196
- 5. **Konfirmasi**: Setelah PRD, ERD, Dokumentasi, dan Roadmap disetujui, lanjut ke `zero-to-prod-orchestrator` Fase 1.
197
- 6. **Referensi**: Kutip PRD, ERD, Dokumentasi, dan Roadmap dalam semua keputusan pembuatan kode selanjutnya.
198
-
199
- ---
200
- ### 🎨 Automatic Visual Assets Generation Mandate (CRITICAL)
201
- **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.
202
- This generated image MUST be explicitly used as:
203
- 1. The primary application logo (e.g., in the header/navbar).
204
- 2. The website favicon (`favicon.ico` or equivalent).
205
- 3. The Open Graph (OG) image for SEO metadata (`og:image`).
206
-
207
- Do not use placeholders for these assets. Generate and integrate them automatically.
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,7 +1,7 @@
1
1
  ---
2
2
  name: production-ready-hardener
3
3
  description: "Ultimate production readiness skill that orchestrates all relevant skills (frontend, backend, security, performance, SEO, testing, DevOps) to harden applications before deployment / Skill kesiapan produksi utama yang mengorkestrasi semua skill relevan (frontend, backend, keamanan, performa, SEO, testing, DevOps) untuk mengeraskan aplikasi sebelum deployment."
4
- author: "Roedy Rustam"
4
+ author: "Roedy Rustam"
5
5
  ---
6
6
 
7
7
  # Production-Ready Hardener
@@ -31,21 +31,20 @@ This skill does NOT replace individual skills — it **coordinates** them into a
31
31
  │ │
32
32
  │ ┌─── PHASE 1: Architecture & Code Quality ───────────────────┐ │
33
33
  │ │ • scalability-clean-code (SOLID, DRY, Clean Architecture) │ │
34
- │ │ • fullstack-expert / senior-fullstack (Design & patterns) │ │
35
- │ │ • app-analyzer-optimizer (Deep codebase & bottleneck audit)│ │
34
+ │ │ • fullstack-expert (Design & polyglot patterns) │ │
35
+ │ │ • app-analyzer-optimizer (Deep codebase & bottleneck audit)│ │
36
36
  │ │ • monorepo-architect (Turborepo & pnpm workspace structure)│ │
37
37
  │ │ • dependency-upgrade-migrator (Codemod & package audits) │ │
38
- │ │ • vibe-code-gardener (Purge AI slop & context drift) │ │
38
+ │ │ • anti-slop (Eliminate conversational & code slop) │ │
39
39
  │ │ • typescript-expert (Strict mode & type-safe patterns) │ │
40
40
  │ └────────────────────────────────────────────────────────────┘ │
41
41
  │ │
42
42
  │ ┌─── PHASE 2: Frontend Hardening ────────────────────────────┐ │
43
43
  │ │ • senior-frontend (React 19, Next.js 15 App Router) │ │
44
- │ │ • design-system-architect (Tokens, Radix, CVA, WCAG 2.2) │ │
44
+ │ │ • design-system-architect (Tokens, Radix, Base UI, WCAG) │ │
45
45
  │ │ • tailwind-expert (CSS-first config, OKLCH, responsive) │ │
46
46
  │ │ • form-validation-expert (React Hook Form, Zod validation)│ │
47
47
  │ │ • state-management-expert (Zustand, Jotai, TanStack Store)│ │
48
- │ │ • ui-components-expert (Input, nav, container primitives) │ │
49
48
  │ │ • ui-ux-pro-max / hig (HIG principles & design system) │ │
50
49
  │ │ • global-a11y-i18n-expert (Web accessibility & i18n) │ │
51
50
  │ │ • mobile-expo-expert / tauri-expert (Mobile & Desktop) │ │
@@ -53,17 +52,15 @@ This skill does NOT replace individual skills — it **coordinates** them into a
53
52
  │ │
54
53
  │ ┌─── PHASE 3: Backend & AI Services ─────────────────────────┐ │
55
54
  │ │ • js-backend-expert (Node 24, Bun 1.2, Fastify, Hono) │ │
56
- │ │ • go-programming-expert (Go 1.24+, microservices, gRPC) │ │
55
+ │ │ • go-programming-expert (Go 1.25+, microservices, gRPC) │ │
57
56
  │ │ • python-programming-expert (Python 3.13+, FastAPI, uv) │ │
58
57
  │ │ • rust-programming-expert (Rust 2024, Axum, async) │ │
59
- │ │ • database-orm-expert (Prisma 6, Drizzle, migrations) │ │
60
- │ │ • edge-serverless-db-expert (Neon, Cloudflare D1, Turso) │ │
58
+ │ │ • database-orm-expert (Prisma 6, Drizzle, Edge DBs, RLS) │ │
61
59
  │ │ • cron-scheduler-expert / async-queue-temporal-expert │ │
62
- │ │ • email-notification-expert (Transactional emails) │ │
60
+ │ │ • email-notification-expert (Email & Push notifications) │ │
63
61
  │ │ • file-upload-media-expert (S3, Presigned URLs, CDN) │ │
64
62
  │ │ • mcp-server-architect (MCP Server Tools & Zod schemas) │ │
65
63
  │ │ • multi-agent-orchestration / ai-llm-integration-expert │ │
66
- │ │ • ai-cost-token-optimizer (Prompt caching & token budget) │ │
67
64
  │ └────────────────────────────────────────────────────────────┘ │
68
65
  │ │
69
66
  │ ┌─── PHASE 4: Security Hardening ────────────────────────────┐ │
@@ -97,8 +94,8 @@ This skill does NOT replace individual skills — it **coordinates** them into a
97
94
  │ │ • ci-cd-devops-architect (GitHub Actions, Docker, IaC) │ │
98
95
  │ │ • cloud-hosting-expert (Vercel, Cloudflare Workers, AWS) │ │
99
96
  │ │ • data-telemetry-expert (OpenTelemetry, PostHog metrics) │ │
100
- │ │ • session-handoff-resume (Save state checkpoint) │ │
101
- │ │ • auto-doc-updater (CHANGELOG & BLUEPRINT automation) │ │
97
+ │ │ • session-memory-manager (State checkpoints & handoff) │ │
98
+ │ │ • prd-architect (ADR records & changelog updates) │ │
102
99
  │ └────────────────────────────────────────────────────────────┘ │
103
100
  │ │
104
101
  └──────────────────────────────────────────────────────────────────┘
@@ -122,7 +119,7 @@ When this skill is triggered, execute the following 7-phase hardening process **
122
119
  - [ ] **TypeScript strict mode** enabled (`strict: true` in tsconfig), no `any` types (`typescript-expert`)
123
120
  - [ ] **Input validation** on all API boundaries (Zod, Pydantic, or equivalent)
124
121
  - [ ] **No hardcoded values** — all config via environment variables or config files
125
- - [ ] **Dead code & AI slop eliminated** — unneeded boilerplate cleaned via `vibe-code-gardener`
122
+ - [ ] **Dead code & AI slop eliminated** — unneeded boilerplate cleaned via `vibe-code-gardener` and `anti-slop`
126
123
  - [ ] **Dependency audit** — all packages up-to-date, no known CVEs (`dependency-upgrade-migrator`, `npm audit`)
127
124
 
128
125
  ---
@@ -323,13 +320,13 @@ Skill ini TIDAK menggantikan skill individual — ia **mengoordinasikan** mereka
323
320
 
324
321
  | Fase | Skill yang Digunakan | Fokus Utama |
325
322
  |------|---------------------|-------------|
326
- | 1. Arsitektur & Kualitas Kode | `scalability-clean-code`, `fullstack-expert`, `senior-fullstack`, `app-analyzer-optimizer`, `monorepo-architect`, `dependency-upgrade-migrator`, `vibe-code-gardener`, `typescript-expert` | SOLID, DRY, Clean Architecture, RFC 9457 errors, pembersihan AI slop, strict TS |
327
- | 2. Pengerasan Frontend | `senior-frontend`, `design-system-architect`, `tailwind-expert`, `form-validation-expert`, `state-management-expert`, `ui-components-expert`, `ui-ux-pro-max`, `hig`, `tanstack-query-expert`, `global-a11y-i18n-expert` | React 19, Error Boundaries, validasi Zod + RHF, a11y, state management, UI primitives |
328
- | 3. Pengerasan Backend | `js-backend-expert`, `go-programming-expert`, `python-programming-expert`, `rust-programming-expert`, `database-orm-expert`, `edge-serverless-db-expert`, `cron-scheduler-expert`, `async-queue-temporal-expert`, `email-notification-expert`, `file-upload-media-expert`, `mcp-server-architect`, `multi-agent-orchestration`, `ai-cost-token-optimizer` | Database migration, ORM, connection pooling, durable background jobs, transactional email, MCP tools, token budget |
323
+ | 1. Arsitektur & Kualitas Kode | `scalability-clean-code`, `fullstack-expert`, `app-analyzer-optimizer`, `monorepo-architect`, `dependency-upgrade-migrator`, `anti-slop`, `typescript-expert` | SOLID, DRY, Clean Architecture, RFC 9457 errors, pembersihan AI slop, strict TS |
324
+ | 2. Pengerasan Frontend | `senior-frontend`, `design-system-architect`, `tailwind-expert`, `form-validation-expert`, `state-management-expert`, `ui-ux-pro-max`, `hig`, `tanstack-query-expert`, `global-a11y-i18n-expert` | React 19, Error Boundaries, validasi Zod + RHF, a11y, state management, UI primitives |
325
+ | 3. Pengerasan Backend | `js-backend-expert`, `go-programming-expert`, `python-programming-expert`, `rust-programming-expert`, `database-orm-expert`, `cron-scheduler-expert`, `async-queue-temporal-expert`, `email-notification-expert`, `file-upload-media-expert`, `mcp-server-architect`, `multi-agent-orchestration`, `ai-llm-integration-expert` | Database migration, ORM, connection pooling, durable background jobs, transactional email, MCP tools, FinOps |
329
326
  | 4. Pengerasan Keamanan | `supabase-security-expert`, `firebase-security-expert`, `authentication-identity-expert`, `zero-trust-secret-vault`, `rate-limit-abuse-prevention`, `secure-fuzz-testing`, `fullstack-expert` | RLS, RBAC, OAuth2, Turnstile bot protection, Upstash rate limit, secret vault, fuzzing, XSS/CSRF |
330
327
  | 5. Testing & QA | `e2e-testing-expert`, `browser-automation-expert`, `coderabbit`, `secure-fuzz-testing`, `error-resilience-expert`, `logging-error-tracking-expert` | E2E (Playwright), visual testing, Unit (Vitest), circuit breaker, Sentry & Pino logging |
331
328
  | 6. Performa & SEO | `seo`, `seo-geo`, `seo-aeo-landing-page-writer`, `performance-web-vitals`, `app-analyzer-optimizer` | Core Web Vitals (LCP, INP, CLS), bundle, CDN, sitemap, llms.txt & AEO |
332
- | 7. DevOps & Observability | `ci-cd-devops-architect`, `cloud-hosting-expert`, `data-telemetry-expert`, `session-handoff-resume`, `auto-doc-updater` | Docker, CI/CD pipeline, OpenTelemetry, PostHog, Vercel/Cloudflare, state checkpoint & CHANGELOG |
329
+ | 7. DevOps & Observability | `ci-cd-devops-architect`, `cloud-hosting-expert`, `data-telemetry-expert`, `session-memory-manager`, `prd-architect` | Docker, CI/CD pipeline, OpenTelemetry, PostHog, Vercel/Cloudflare, state checkpoint & CHANGELOG |
333
330
 
334
331
  ### Protokol Eksekusi
335
332
 
@@ -346,7 +343,7 @@ Ketika skill ini dipicu, jalankan **7 fase pengerasan berurutan**. Setiap fase m
346
343
  - [ ] TypeScript strict mode aktif (`strict: true`), tanpa tipe `any` (`typescript-expert`)
347
344
  - [ ] Validasi input di semua batas API (Zod, Pydantic)
348
345
  - [ ] Tidak ada hardcoded value — semua konfigurasi via environment variable
349
- - [ ] Dead code & AI slop dieliminasi via `vibe-code-gardener`
346
+ - [ ] Dead code & AI slop dieliminasi via `anti-slop`
350
347
  - [ ] Audit dependensi — semua paket up-to-date, tanpa CVE (`dependency-upgrade-migrator`)
351
348
 
352
349
  #### FASE 2: Pengerasan Frontend
@@ -6,9 +6,21 @@ author: "Roedy Rustam"
6
6
 
7
7
  # PWA & Offline-First Expert (2026 Edition)
8
8
 
9
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
+
11
+ ---
12
+
13
+ <a name="english"></a>
14
+ ## English
15
+
16
+ ### Description
9
17
  Expert guide for building enterprise-grade **Local-First** and **Progressive Web Applications (PWA)**. Eliminates loading spinners by reading and writing to local databases (OPFS SQLite, RxDB, IndexedDB) first, replicating seamlessly in the background with zero conflict (CRDTs, ElectricSQL, PowerSync), and packaging to native stores via PWABuilder.
10
18
 
11
- *Panduan ahli untuk membangun aplikasi web Local-First dan PWA kelas enterprise. Menghilangkan loading spinner dengan membaca dan menulis langsung ke database lokal, sinkronisasi otomatis di latar belakang tanpa bentrok data, dan packaging ke app store.*
19
+ ### Trigger Conditions
20
+ - Applications requiring full offline functionality (field operations, mobile dashboards, transit apps).
21
+ - User experience demands 0ms local read/write latency without loading spinners.
22
+ - Multi-device sync architecture with automatic conflict resolution.
23
+ - Packaging web apps for distribution on Google Play Store, iOS Safari PWA, or Microsoft Store.
12
24
 
13
25
  ---
14
26
 
@@ -183,3 +195,32 @@ To distribute your web application on **Google Play Store** (TWA - Trusted Web A
183
195
  - **`state-management-expert`**: For connecting RxDB / local stores with Zustand or TanStack Store.
184
196
  - **`database-orm-expert`**: For designing compatible backend schemas with ElectricSQL / Postgres.
185
197
  - **`mobile-push-notification-expert`**: For Web Push Notification subscription handling.
198
+
199
+ ---
200
+
201
+ <a name="bahasa-indonesia"></a>
202
+ ## Bahasa Indonesia
203
+
204
+ ### Deskripsi
205
+ Panduan ahli untuk membangun aplikasi web **Local-First** dan **Progressive Web Applications (PWA)** kelas enterprise. Menghilangkan ketergantungan loading spinner dengan membaca dan menulis langsung ke database lokal (OPFS SQLite, RxDB, IndexedDB) terlebih dahulu, sinkronisasi otomatis di latar belakang tanpa bentrok data (CRDTs, ElectricSQL, PowerSync), dan packaging ke toko aplikasi native melalui PWABuilder.
206
+
207
+ ### Kondisi Pemicu
208
+ - Aplikasi yang memerlukan fungsionalitas offline penuh (pekerjaan lapangan, dashboard mobile, aplikasi transit).
209
+ - Tuntutan pengalaman pengguna dengan latensi baca/tulis lokal 0ms tanpa loading spinner.
210
+ - Arsitektur sinkronisasi multi-perangkat dengan resolusi konflik data otomatis.
211
+ - Kebutuhan rilis aplikasi web ke Google Play Store, iOS Safari PWA, atau Microsoft Store.
212
+
213
+ ### Ringkasan Prinsip Local-First & PWA
214
+ 1. **0ms Latensi Lokal**: Komponen membaca dan menulis ke IndexedDB / OPFS lokal secara instan.
215
+ 2. **Sinkronisasi Reaktif Latar Belakang**: Replikasi data berjalan di background worker; mutasi offline dicatat dalam antrean IndexedDB dan di-flush saat jaringan online.
216
+ 3. **Pola Service Worker**: Stale-While-Revalidate untuk asset statis dan rute shell utama menggunakan Service Worker v3.
217
+ 4. **Distribusi Native**: Menggunakan PWABuilder CLI untuk menghasilkan APK Android TWA dan paket MSIX Windows.
218
+
219
+ ---
220
+
221
+ ## Integrasi Orkestrasi
222
+
223
+ - **`senior-frontend`**: Integrasi UI indikator status offline dan hook mutasi optimistik.
224
+ - **`state-management-expert`**: Menghubungkan RxDB / local storage ke Zustand atau TanStack Store.
225
+ - **`database-orm-expert`**: Perancangan skema backend PostgreSQL yang kompatibel dengan replikasi CRDT / ElectricSQL.
226
+ - **`mobile-push-notification-expert`**: Penanganan registrasi dan subscription Web Push Notification.