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