vibes-plug 2.11.0 → 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 +8 -3
- package/.cursorrules +9 -3
- package/AGENTS.md +25 -4
- package/CHANGELOG.md +151 -0
- package/CLAUDE.md +15 -8
- package/README.md +216 -641
- package/bin/vibes.mjs +1104 -0
- package/index.js +1 -1
- package/package.json +11 -3
- package/plugin.json +4 -3
- package/scripts/check-anti-slop.js +53 -0
- package/scripts/check-anti-slop.mjs +53 -0
- package/scripts/generate_swarm_gif.py +2 -2
- 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 -187
- package/skills/ai-media-generation-expert/SKILL.md +173 -172
- package/skills/ai-prompt-engineering-expert/SKILL.md +170 -50
- 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 -0
- 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 -240
- package/skills/authentication-identity-expert/SKILL.md +79 -184
- 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 +102 -240
- package/skills/deep-research-analyst/SKILL.md +182 -0
- package/skills/dependency-upgrade-migrator/SKILL.md +11 -10
- package/skills/design-system-architect/SKILL.md +34 -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 +35 -7
- package/skills/ephemeral-generative-ui-architect/SKILL.md +88 -0
- package/skills/error-resilience-expert/SKILL.md +26 -4
- 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 +68 -144
- 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 +155 -71
- package/skills/go-programming-expert/SKILL.md +5 -4
- package/skills/graph-rag-knowledge-expert/SKILL.md +201 -159
- 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 +316 -294
- 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 +85 -109
- package/skills/proactive-background-watcher/SKILL.md +5 -4
- package/skills/production-ready-hardener/SKILL.md +25 -27
- package/skills/pwa-offline-first-expert/SKILL.md +227 -185
- package/skills/pydantic-ai-expert/SKILL.md +162 -0
- 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 -0
- 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 +21 -18
- package/skills/senior-frontend/scripts/frontend_scaffolder.py +1 -1
- package/skills/seo/SKILL.md +4 -4
- package/skills/session-memory-manager/SKILL.md +129 -0
- 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 -0
- 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 -4
- package/skills/vector-db-rag-expert/SKILL.md +209 -208
- package/skills/vercel-ai-sdk-expert/SKILL.md +226 -0
- package/skills/voice-ai-realtime-agent/SKILL.md +243 -202
- 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 +259 -82
- package/skills/web-game-engine-expert/SKILL.md +278 -50
- 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 +105 -65
- 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 -227
- package/skills/zero-trust-secret-vault/SKILL.md +3 -2
- package/BLUEPRINT.md +0 -309
- package/skills/ai-cost-token-optimizer/SKILL.md +0 -82
- package/skills/ai-evals-benchmark-expert/SKILL.md +0 -188
- package/skills/asisten-ramah/SKILL.md +0 -47
- package/skills/auto-doc-updater/SKILL.md +0 -220
- package/skills/autonomous-chaos-monkey/SKILL.md +0 -63
- package/skills/background-jobs-queue-expert/SKILL.md +0 -235
- package/skills/bootstrap-to-modern/SKILL.md +0 -94
- package/skills/database-migration-versioning-expert/SKILL.md +0 -90
- package/skills/edge-serverless-db-expert/SKILL.md +0 -99
- package/skills/mcp-client-orchestrator/SKILL.md +0 -76
- package/skills/mobile-push-notification-expert/SKILL.md +0 -71
- package/skills/monday-design-aesthetic/SKILL.md +0 -73
- package/skills/multiple-entry-points/SKILL.md +0 -91
- package/skills/project-context-mapper/SKILL.md +0 -85
- package/skills/saas-mvp-launcher/SKILL.md +0 -260
- package/skills/saas-transformer/SKILL.md +0 -500
- package/skills/saas-transformer/references/billing_integration_guide.md +0 -401
- package/skills/secure-fuzz-testing/SKILL.md +0 -207
- package/skills/self-evolving-memory-graph/SKILL.md +0 -91
- package/skills/session-context-loader/SKILL.md +0 -83
- package/skills/session-handoff-resume/SKILL.md +0 -164
- package/skills/skill-baru/SKILL.md +0 -178
- package/skills/supabase-migration/SKILL.md +0 -91
- package/skills/token-saver/SKILL.md +0 -119
- package/skills/ui-components-expert/SKILL.md +0 -166
- package/skills/vibe-code-gardener/SKILL.md +0 -181
- package/skills/visual-qa-vision-agent/SKILL.md +0 -71
- /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,91 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: self-evolving-memory-graph
|
|
3
|
-
description: "Grants the AI long-term episodic memory. The agent autonomously documents the user's coding preferences, past mistakes to avoid, and architectural decisions into a persistent learning graph."
|
|
4
|
-
author: "Roedy Rustam"
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Self-Evolving Memory Graph (Episodic Memory)
|
|
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
|
-
Claude forgets everything once a chat is cleared, and its "Project Knowledge" requires manual human updating. This skill gives Antigravity the "superpower" of continuous, autonomous self-improvement. The agent actively listens for user corrections, stylistic preferences, and hard-learned debugging lessons, writing them into a persistent `LEARNING_GRAPH.md` (or `.agents/LEARNING.md`) file. The agent gets smarter and more aligned with the user over time.
|
|
21
|
-
|
|
22
|
-
### Trigger Conditions
|
|
23
|
-
Activate this skill when:
|
|
24
|
-
- The user corrects your code (e.g., "Don't use `any`, use `unknown`", or "Always use Arrow functions").
|
|
25
|
-
- You just spent a long time fixing a very complex bug.
|
|
26
|
-
- The user says "Remember this for the future."
|
|
27
|
-
|
|
28
|
-
### Core Concepts
|
|
29
|
-
|
|
30
|
-
#### 1. Memory Encoding
|
|
31
|
-
Whenever a hard lesson is learned or a strong user preference is stated, do not just say "I will remember that." You must physically write it down.
|
|
32
|
-
Use the `multi_replace_file_content` or `write_to_file` tool to append the lesson to the memory file.
|
|
33
|
-
|
|
34
|
-
#### 2. Memory Format (`LEARNING_GRAPH.md`)
|
|
35
|
-
```markdown
|
|
36
|
-
# 🧠 Self-Evolving Memory Graph
|
|
37
|
-
|
|
38
|
-
## User Stylistic Preferences
|
|
39
|
-
- [2026-08-12] Always use `Tailwind v4 @theme` variables instead of arbitrary values like `text-[#ff0000]`.
|
|
40
|
-
- [2026-08-12] Prefer functional components with `const` over `function` declarations.
|
|
41
|
-
|
|
42
|
-
## Hard-Learned Lessons (Avoid these mistakes)
|
|
43
|
-
- [2026-08-11] Supabase RLS policies: Never use `auth.uid()` in a `FOR ALL` policy without checking role claims. It caused an infinite recursion bug in `users` table.
|
|
44
|
-
|
|
45
|
-
## Architectural Decisions
|
|
46
|
-
- [2026-08-10] State Management: We exclusively use `Zustand` for global state. Do not suggest Redux.
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
#### 3. Memory Retrieval
|
|
50
|
-
Ensure `session-context-loader` is configured to read this memory file at the start of every new chat session.
|
|
51
|
-
|
|
52
|
-
#### 4. Cross-Project Episodic Memory (Global Context)
|
|
53
|
-
- **Continuous Capture**: For complex architectural decisions or bug fixes that span beyond a single project, extract the root cause and solution into a global knowledge graph (e.g., `~/.gemini/knowledge` or equivalent `<appDataDir>/knowledge` KI system).
|
|
54
|
-
- **Contextual Retrieval**: On new sessions, search the global context directory for similar past issues before diving into complex bugs.
|
|
55
|
-
- **Synthesis & Injection**: Inject the historical context directly into the current execution loop, stating explicitly: *"I remember we solved this architectural issue in Project X using technique Y. Applying the same proven pattern here."*
|
|
56
|
-
|
|
57
|
-
---
|
|
58
|
-
|
|
59
|
-
### Integration with Other Skills (MANDATORY)
|
|
60
|
-
- `session-context-loader` — Essential for loading the `LEARNING_GRAPH.md` when a new session starts.
|
|
61
|
-
- `project-context-mapper` — The context map tracks *where* things are; the memory graph tracks *how* and *why* things are built.
|
|
62
|
-
|
|
63
|
-
### Referenced By Orchestrators (MANDATORY)
|
|
64
|
-
- `brainstorming` — Add to "Discovery & Audit".
|
|
65
|
-
- `zero-to-prod-orchestrator` — Phase 1 (Discovery & Architecture).
|
|
66
|
-
|
|
67
|
-
---
|
|
68
|
-
|
|
69
|
-
<a name="bahasa-indonesia"></a>
|
|
70
|
-
## Bahasa Indonesia
|
|
71
|
-
|
|
72
|
-
### Integrasi Orkestrasi
|
|
73
|
-
Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
|
|
74
|
-
|
|
75
|
-
### Deskripsi
|
|
76
|
-
Claude melupakan segalanya saat sesi chat baru dimulai. Skill ini memberi Anda "kekuatan super" berupa *Ingatan Jangka Panjang* yang berevolusi sendiri. Agen secara aktif mencatat preferensi koding pengguna, pelajaran dari *bug* yang sulit dipecahkan, dan keputusan arsitektur ke dalam file persisten `LEARNING_GRAPH.md`.
|
|
77
|
-
|
|
78
|
-
### Kondisi Pemicu
|
|
79
|
-
- Saat pengguna mengoreksi gaya koding Anda (misal: "Gunakan bahasa Indonesia baku", "Jangan pakai `var`").
|
|
80
|
-
- Setelah Anda berhasil memecahkan *bug* yang menghabiskan waktu lama.
|
|
81
|
-
- Saat pengguna berkata "Ingat ini untuk proyek ke depannya."
|
|
82
|
-
|
|
83
|
-
### Panduan Singkat
|
|
84
|
-
- **Jangan Hanya Berjanji:** Jika pengguna mengoreksi Anda, jangan sekadar menjawab "Baik, saya akan ingat." LLM tidak punya ingatan bawaan antar-sesi. Anda **wajib** menulis koreksi tersebut ke dalam file `LEARNING_GRAPH.md` di folder `.agents/` atau direktori *root*.
|
|
85
|
-
- **Kategorisasi Ingatan:** Pisahkan ingatan menjadi: Preferensi Gaya (*Style*), Pelajaran Berharga (*Lessons Learned*), dan Keputusan Arsitektur (*Decisions*).
|
|
86
|
-
- **Semakin Lama Semakin Pintar:** Dengan membaca file ini di awal setiap percakapan, Anda tidak akan pernah mengulangi kesalahan yang sama dua kali.
|
|
87
|
-
|
|
88
|
-
### Memori Episodik Lintas-Proyek (Konteks Global)
|
|
89
|
-
- **Penangkapan Berkelanjutan**: Untuk bug yang rumit dan pola arsitektur tingkat lanjut, ekstrak solusi ke dalam grafik pengetahuan global (misal: `~/.gemini/knowledge`).
|
|
90
|
-
- **Pencarian Kontekstual**: Sebelum memecahkan masalah kompleks baru, cari direktori konteks global untuk kasus serupa.
|
|
91
|
-
- **Sintesis & Injeksi**: Secara proaktif sebutkan: *"Saya ingat kita menyelesaikan ini di Proyek X dengan cara Y, saya akan menerapkannya di sini."*
|
|
@@ -1,83 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: session-context-loader
|
|
3
|
-
description: "Automatically loads and learns project context (Tech Stack, PRD, Roadmap, Blueprint) at the start of every new conversation session to ensure focused and directed development / Otomatis memuat dan mempelajari konteks proyek (Tech Stack, PRD, Roadmap, Blueprint) di awal setiap sesi percakapan baru untuk memastikan pengembangan yang terarah dan fokus."
|
|
4
|
-
author: "Roedy Rustam"
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Session Context Loader
|
|
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
|
-
This skill ensures that the AI agent is always aligned with the project's core documentation. At the beginning of every new conversation session, it automatically searches for and reads essential project context files (Tech Stack, PRD, Roadmap, Blueprint). This guarantees that development remains focused, directed, and strictly adheres to established requirements and architectural decisions.
|
|
21
|
-
|
|
22
|
-
### Trigger Conditions
|
|
23
|
-
Activate this skill IMMEDIATELY when:
|
|
24
|
-
- It is the very first message of a new conversation session.
|
|
25
|
-
- The user says "start session", "initialize project", or "load context".
|
|
26
|
-
- The AI realizes it lacks the high-level context of the current repository.
|
|
27
|
-
|
|
28
|
-
### Execution Protocol
|
|
29
|
-
|
|
30
|
-
When triggered, you MUST perform the following steps before answering the user's primary request or writing any code:
|
|
31
|
-
|
|
32
|
-
1. **Locate Key Documentation Files:**
|
|
33
|
-
Use your file search tools (`list_dir`, `grep_search`, or `view_file`) to look for the following files in the project root or `.docs/` folder:
|
|
34
|
-
- `PRD.md` (Product Requirements Document)
|
|
35
|
-
- `ROADMAP.md` or `ROADMAP.txt`
|
|
36
|
-
- `BLUEPRINT.md` or `ARCHITECTURE.md`
|
|
37
|
-
- `TECH_STACK.md`, `package.json`, `go.mod`, `Cargo.toml`, or `requirements.txt` (to identify the tech stack)
|
|
38
|
-
|
|
39
|
-
2. **Read and Internalize Context:**
|
|
40
|
-
- Read the contents of the found files.
|
|
41
|
-
- Understand the project's primary goal, current phase in the roadmap, architectural constraints (blueprint), and the specific tech stack being used.
|
|
42
|
-
|
|
43
|
-
3. **Acknowledge and Align:**
|
|
44
|
-
- Briefly acknowledge to the user that the project context has been loaded successfully.
|
|
45
|
-
- State the current Tech Stack and the immediate goal based on the Roadmap/PRD.
|
|
46
|
-
- Proceed with addressing the user's actual request using the newly loaded context.
|
|
47
|
-
|
|
48
|
-
---
|
|
49
|
-
|
|
50
|
-
<a name="bahasa-indonesia"></a>
|
|
51
|
-
## Bahasa Indonesia
|
|
52
|
-
|
|
53
|
-
### Integrasi Orkestrasi
|
|
54
|
-
Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
|
|
55
|
-
|
|
56
|
-
### Deskripsi
|
|
57
|
-
Skill ini memastikan bahwa agen AI selalu selaras dengan dokumentasi inti proyek. Di awal setiap sesi percakapan baru, agen akan secara otomatis mencari dan membaca file konteks proyek esensial (Tech Stack, PRD, Roadmap, Blueprint). Ini menjamin bahwa pengembangan proyek aplikasi tetap lebih terarah, fokus, dan sangat mematuhi persyaratan serta keputusan arsitektur yang telah ditetapkan.
|
|
58
|
-
|
|
59
|
-
### Kondisi Pemicu
|
|
60
|
-
Aktifkan skill ini SEGERA ketika:
|
|
61
|
-
- Ini adalah pesan pertama dari sesi percakapan baru.
|
|
62
|
-
- Pengguna berkata "mulai sesi", "inisialisasi proyek", atau "muat konteks".
|
|
63
|
-
- AI menyadari bahwa ia kekurangan konteks tingkat tinggi dari repositori saat ini.
|
|
64
|
-
|
|
65
|
-
### Protokol Eksekusi
|
|
66
|
-
|
|
67
|
-
Saat dipicu, Anda HARUS melakukan langkah-langkah berikut sebelum menjawab permintaan utama pengguna atau menulis kode apa pun:
|
|
68
|
-
|
|
69
|
-
1. **Temukan File Dokumentasi Kunci:**
|
|
70
|
-
Gunakan alat pencarian file Anda (`list_dir`, `grep_search`, atau `view_file`) untuk mencari file berikut di root proyek atau folder `.docs/`:
|
|
71
|
-
- `PRD.md` (Product Requirements Document)
|
|
72
|
-
- `ROADMAP.md` atau `ROADMAP.txt`
|
|
73
|
-
- `BLUEPRINT.md` atau `ARCHITECTURE.md`
|
|
74
|
-
- `TECH_STACK.md`, `package.json`, `go.mod`, `Cargo.toml`, atau `requirements.txt` (untuk mengidentifikasi tech stack)
|
|
75
|
-
|
|
76
|
-
2. **Baca dan Pahami Konteks:**
|
|
77
|
-
- Baca isi dari file-file yang ditemukan.
|
|
78
|
-
- Pahami tujuan utama proyek, fase saat ini di roadmap, batasan arsitektur (blueprint), dan tech stack spesifik yang digunakan.
|
|
79
|
-
|
|
80
|
-
3. **Konfirmasi dan Selaraskan:**
|
|
81
|
-
- Berikan konfirmasi singkat kepada pengguna bahwa konteks proyek telah berhasil dimuat.
|
|
82
|
-
- Sebutkan Tech Stack saat ini dan tujuan langsung berdasarkan Roadmap/PRD.
|
|
83
|
-
- Lanjutkan dengan menjawab permintaan pengguna yang sebenarnya menggunakan konteks yang baru dimuat.
|
|
@@ -1,164 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: session-handoff-resume
|
|
3
|
-
description: "Skill to save ultra-compact project checkpoints and seamlessly resume work across accounts or new chat sessions with minimum token consumption / Skill untuk menyimpan checkpoint proyek yang super ringkas dan melanjutkan pekerjaan secara efisien saat ganti akun/sesi tanpa boros token."
|
|
4
|
-
author: "Roedy Rustam"
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Session Handoff & Resume (2026 — Cross-Model 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
|
-
Saves ultra-compact project checkpoints and enables seamless work resumption across new chat sessions, different accounts, or different AI models (Gemini, Claude, GPT). Designed for minimum token consumption while preserving full context needed for continuation.
|
|
21
|
-
|
|
22
|
-
### Trigger Conditions
|
|
23
|
-
- Session is running very long and context window is nearly exhausted.
|
|
24
|
-
- User wants to switch to a new chat session or different AI model.
|
|
25
|
-
- User wants to save progress before closing and resume later.
|
|
26
|
-
- User says "save checkpoint", "handoff", "save progress", "resume later".
|
|
27
|
-
|
|
28
|
-
### Checkpoint Format (Ultra-Compact)
|
|
29
|
-
|
|
30
|
-
When creating a checkpoint, output a compact YAML block under 200 tokens:
|
|
31
|
-
|
|
32
|
-
```yaml
|
|
33
|
-
# CHECKPOINT — [Project Name] — [Date]
|
|
34
|
-
project: "[Project Name]"
|
|
35
|
-
goal: "[One-line goal of the current session]"
|
|
36
|
-
status: "[brief status: e.g., '60% — backend API done, frontend in progress']"
|
|
37
|
-
stack: "[e.g., Next.js 15 + Hono + Supabase + Drizzle]"
|
|
38
|
-
last_completed:
|
|
39
|
-
- "[Most recent task completed]"
|
|
40
|
-
- "[Second most recent]"
|
|
41
|
-
next_tasks:
|
|
42
|
-
- "[Immediate next task]"
|
|
43
|
-
- "[Following task]"
|
|
44
|
-
- "[Following task]"
|
|
45
|
-
blockers: "[Any known blockers or pending decisions, or 'none']"
|
|
46
|
-
key_files:
|
|
47
|
-
- "[path/to/critical/file.ts]"
|
|
48
|
-
- "[path/to/another/file.ts]"
|
|
49
|
-
env_needed: "[List of env vars needed, e.g., SUPABASE_URL, STRIPE_KEY]"
|
|
50
|
-
notes: "[Any critical context that doesn't fit above]"
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
### Cross-Model Handoff Protocol (2026)
|
|
54
|
-
|
|
55
|
-
Different AI models interpret context differently. Use this universal handoff prompt:
|
|
56
|
-
|
|
57
|
-
```markdown
|
|
58
|
-
## RESUME CONTEXT — [Project Name]
|
|
59
|
-
|
|
60
|
-
You are resuming work on [Project Name]. Read this context carefully before taking any action.
|
|
61
|
-
|
|
62
|
-
**Goal**: [One-sentence project goal]
|
|
63
|
-
**Current Status**: [What's been done, what's pending]
|
|
64
|
-
**Tech Stack**: [Stack details]
|
|
65
|
-
**Repository**: [path or URL if available]
|
|
66
|
-
|
|
67
|
-
**Completed**:
|
|
68
|
-
- ✅ [Done item 1]
|
|
69
|
-
- ✅ [Done item 2]
|
|
70
|
-
|
|
71
|
-
**Next Tasks** (in priority order):
|
|
72
|
-
1. [ ] [Immediate next task — be specific]
|
|
73
|
-
2. [ ] [Second task]
|
|
74
|
-
3. [ ] [Third task]
|
|
75
|
-
|
|
76
|
-
**Critical Files to Read First**:
|
|
77
|
-
- [file path] — [why it's critical]
|
|
78
|
-
- [file path] — [why it's critical]
|
|
79
|
-
|
|
80
|
-
**Known Constraints**:
|
|
81
|
-
- [Constraint 1, e.g., "Use pnpm, not npm"]
|
|
82
|
-
- [Constraint 2, e.g., "Admin panel must be on admin.domain.com"]
|
|
83
|
-
|
|
84
|
-
**Do NOT**:
|
|
85
|
-
- [Something the previous session explicitly avoided]
|
|
86
|
-
- [Another anti-pattern to avoid]
|
|
87
|
-
|
|
88
|
-
Start by reading the critical files listed above, then confirm you understand the current state before proceeding.
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
### Checkpoint Storage Locations
|
|
92
|
-
|
|
93
|
-
| Destination | Use When |
|
|
94
|
-
|---|---|
|
|
95
|
-
| `CHECKPOINT.md` in project root | Primary — version-controlled |
|
|
96
|
-
| `.agents/CHECKPOINT.md` | Alternative — agents-specific dir |
|
|
97
|
-
| Copied to clipboard | Quick cross-session handoff |
|
|
98
|
-
| Supabase notes table | Cloud-synced across devices |
|
|
99
|
-
|
|
100
|
-
### Resume Protocol (For New Session)
|
|
101
|
-
When the user provides a checkpoint to resume from:
|
|
102
|
-
1. **Read all key files** listed in the checkpoint.
|
|
103
|
-
2. **Verify current state** matches the checkpoint (check git status, recent commits).
|
|
104
|
-
3. **Confirm understanding** — briefly state what you're resuming and what the first task is.
|
|
105
|
-
4. **Proceed immediately** — don't ask unnecessary questions.
|
|
106
|
-
|
|
107
|
-
### Automatic Checkpoint Triggers
|
|
108
|
-
Proactively offer to create a checkpoint when:
|
|
109
|
-
- User has been working for > 30 messages in a session.
|
|
110
|
-
- The context window is > 70% consumed.
|
|
111
|
-
- A major milestone is completed (e.g., "backend API is fully done").
|
|
112
|
-
- The user says "I'll continue later".
|
|
113
|
-
|
|
114
|
-
---
|
|
115
|
-
|
|
116
|
-
<a name="bahasa-indonesia"></a>
|
|
117
|
-
## Bahasa Indonesia
|
|
118
|
-
|
|
119
|
-
### Integrasi Orkestrasi
|
|
120
|
-
Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
|
|
121
|
-
|
|
122
|
-
### Deskripsi
|
|
123
|
-
Menyimpan checkpoint proyek yang ultra-ringkas dan memungkinkan kelanjutan pekerjaan yang mulus di sesi chat baru, akun yang berbeda, atau model AI yang berbeda (Gemini, Claude, GPT). Dirancang untuk konsumsi token minimum sambil mempertahankan konteks penuh yang diperlukan untuk kelanjutan.
|
|
124
|
-
|
|
125
|
-
### Kondisi Pemicu
|
|
126
|
-
- Sesi berjalan sangat lama dan context window hampir habis.
|
|
127
|
-
- Pengguna ingin beralih ke sesi chat baru atau model AI yang berbeda.
|
|
128
|
-
- Pengguna ingin menyimpan progres sebelum menutup dan melanjutkan nanti.
|
|
129
|
-
- Pengguna berkata "simpan checkpoint", "handoff", "simpan progres", "lanjut nanti".
|
|
130
|
-
|
|
131
|
-
### Format Checkpoint (Ultra-Ringkas)
|
|
132
|
-
|
|
133
|
-
Saat membuat checkpoint, keluarkan blok YAML ringkas di bawah 200 token dengan field: `project`, `goal`, `status`, `stack`, `last_completed`, `next_tasks`, `blockers`, `key_files`, `env_needed`, `notes`.
|
|
134
|
-
|
|
135
|
-
### Protokol Handoff Lintas-Model (2026)
|
|
136
|
-
|
|
137
|
-
Model AI yang berbeda menginterpretasikan konteks secara berbeda. Gunakan prompt handoff universal saat berpindah antar model (Gemini → Claude → GPT):
|
|
138
|
-
- Sertakan goal satu kalimat, status saat ini, stack, daftar tugas yang selesai (✅), dan tugas berikutnya yang diprioritaskan.
|
|
139
|
-
- Sertakan file kritis yang harus dibaca terlebih dahulu oleh model baru.
|
|
140
|
-
- Sertakan kendala yang diketahui dan daftar "Jangan Lakukan".
|
|
141
|
-
- Minta model baru untuk mengkonfirmasi pemahaman sebelum melanjutkan.
|
|
142
|
-
|
|
143
|
-
### Lokasi Penyimpanan Checkpoint
|
|
144
|
-
|
|
145
|
-
| Tujuan | Gunakan Saat |
|
|
146
|
-
|---|---|
|
|
147
|
-
| `CHECKPOINT.md` di root proyek | Utama — dikontrol versi |
|
|
148
|
-
| `.agents/CHECKPOINT.md` | Alternatif — direktori agen |
|
|
149
|
-
| Disalin ke clipboard | Handoff lintas sesi cepat |
|
|
150
|
-
| Tabel catatan Supabase | Tersinkronisasi cloud antar perangkat |
|
|
151
|
-
|
|
152
|
-
### Protokol Resume (Untuk Sesi Baru)
|
|
153
|
-
Saat pengguna memberikan checkpoint untuk dilanjutkan:
|
|
154
|
-
1. **Baca semua file kritis** yang tercantum dalam checkpoint.
|
|
155
|
-
2. **Verifikasi status saat ini** cocok dengan checkpoint (periksa git status, commit terbaru).
|
|
156
|
-
3. **Konfirmasi pemahaman** — nyatakan singkat apa yang dilanjutkan dan apa tugas pertama.
|
|
157
|
-
4. **Lanjutkan segera** — jangan ajukan pertanyaan yang tidak perlu.
|
|
158
|
-
|
|
159
|
-
### Pemicu Checkpoint Otomatis
|
|
160
|
-
Tawarkan secara proaktif untuk membuat checkpoint saat:
|
|
161
|
-
- Pengguna telah bekerja lebih dari 30 pesan dalam satu sesi.
|
|
162
|
-
- Context window > 70% terpakai.
|
|
163
|
-
- Milestone besar selesai.
|
|
164
|
-
- Pengguna berkata "saya akan lanjutkan nanti".
|
|
@@ -1,178 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: skill-baru
|
|
3
|
-
description: "Comprehensive template for creating new vibes-plug skills with proper structure, trigger conditions, and bilingual support / Template komprehensif untuk membuat skill vibes-plug baru dengan struktur yang tepat, kondisi pemicu, dan dukungan bilingual."
|
|
4
|
-
author: "Roedy Rustam"
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# [Skill Name] — vibes-plug Skill Template
|
|
8
|
-
|
|
9
|
-
[English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
> **HOW TO USE THIS TEMPLATE**
|
|
14
|
-
> 1. Copy this entire folder (`skill-baru/`) and rename it using kebab-case (e.g., `my-new-skill/`).
|
|
15
|
-
> 2. Replace all placeholder text marked with `[...]` brackets.
|
|
16
|
-
> 3. Update the frontmatter `name` and `description` fields above.
|
|
17
|
-
> 4. Delete this instruction block before publishing.
|
|
18
|
-
> 5. Add your skill to the `brainstorming` orchestration matrix if it belongs to a domain.
|
|
19
|
-
|
|
20
|
-
---
|
|
21
|
-
|
|
22
|
-
<a name="english"></a>
|
|
23
|
-
## English
|
|
24
|
-
|
|
25
|
-
### Orchestration & Integration
|
|
26
|
-
Connects and orchestrates with relevant domain skills like `brainstorming`, `zero-to-prod-orchestrator`, and `project-context-mapper` to ensure cohesive execution.
|
|
27
|
-
|
|
28
|
-
### Description
|
|
29
|
-
[One paragraph describing the purpose and scope of this skill. Be specific about what problems it solves and what technology versions it targets.]
|
|
30
|
-
|
|
31
|
-
Example: *"Expert guide for [Technology/Domain] (v[X.Y]+). Covers [feature A], [feature B], [pattern C], and [best practice D] for production-grade TypeScript/JavaScript applications."*
|
|
32
|
-
|
|
33
|
-
### Trigger Conditions
|
|
34
|
-
Activate this skill when the user is:
|
|
35
|
-
- [Trigger scenario 1 — be specific, e.g., "Writing X with framework Y"]
|
|
36
|
-
- [Trigger scenario 2]
|
|
37
|
-
- [Trigger scenario 3]
|
|
38
|
-
- [Trigger scenario 4]
|
|
39
|
-
|
|
40
|
-
---
|
|
41
|
-
|
|
42
|
-
### Core Concepts
|
|
43
|
-
|
|
44
|
-
#### [Concept 1 — e.g., "Architecture Overview"]
|
|
45
|
-
[Explain the foundational concept. Use tables for comparisons, bullet points for lists, and code blocks for examples.]
|
|
46
|
-
|
|
47
|
-
```typescript
|
|
48
|
-
// [Language] — [What this code demonstrates]
|
|
49
|
-
// Replace this block with a real, runnable code example.
|
|
50
|
-
const example = {
|
|
51
|
-
field: 'value',
|
|
52
|
-
};
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
#### [Concept 2 — e.g., "Selection Guide"]
|
|
56
|
-
|
|
57
|
-
| Criteria | Option A | Option B | Option C |
|
|
58
|
-
|---|---|---|---|
|
|
59
|
-
| [Criterion 1] | [Value] | [Value] | [Value] |
|
|
60
|
-
| [Criterion 2] | [Value] | [Value] | [Value] |
|
|
61
|
-
| **Best For** | [Use case] | [Use case] | [Use case] |
|
|
62
|
-
|
|
63
|
-
**Recommendation:** [State a clear default recommendation with rationale.]
|
|
64
|
-
|
|
65
|
-
---
|
|
66
|
-
|
|
67
|
-
### [Main Topic Section 1 — e.g., "Setup & Configuration"]
|
|
68
|
-
|
|
69
|
-
#### [Sub-topic 1.1]
|
|
70
|
-
```typescript
|
|
71
|
-
// Example: Configuration or setup code
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
#### [Sub-topic 1.2]
|
|
75
|
-
```typescript
|
|
76
|
-
// Example: Core usage pattern
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
81
|
-
### [Main Topic Section 2 — e.g., "Best Practices"]
|
|
82
|
-
|
|
83
|
-
1. **[Practice 1]:** [Explanation]
|
|
84
|
-
2. **[Practice 2]:** [Explanation]
|
|
85
|
-
3. **[Practice 3]:** [Explanation]
|
|
86
|
-
4. **[Practice 4]:** [Explanation]
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
### Common Pitfalls to Avoid
|
|
91
|
-
|
|
92
|
-
| Anti-Pattern | Problem | Correct Approach |
|
|
93
|
-
|---|---|---|
|
|
94
|
-
| [Bad practice 1] | [Why it's bad] | [What to do instead] |
|
|
95
|
-
| [Bad practice 2] | [Why it's bad] | [What to do instead] |
|
|
96
|
-
| [Bad practice 3] | [Why it's bad] | [What to do instead] |
|
|
97
|
-
|
|
98
|
-
---
|
|
99
|
-
|
|
100
|
-
### Integration with Other Skills (MANDATORY)
|
|
101
|
-
|
|
102
|
-
> ⚠️ **Every skill MUST list at least 3 cross-references.** No skill should exist in isolation.
|
|
103
|
-
|
|
104
|
-
This skill works best when combined with:
|
|
105
|
-
- `[skill-name]` — [Why and when to combine]
|
|
106
|
-
- `[skill-name]` — [Why and when to combine]
|
|
107
|
-
- `[skill-name]` — [Why and when to combine]
|
|
108
|
-
|
|
109
|
-
### Referenced By Orchestrators (MANDATORY)
|
|
110
|
-
|
|
111
|
-
> ⚠️ **Update the orchestrator skills below when creating a new domain skill.**
|
|
112
|
-
|
|
113
|
-
This skill should be referenced by the following orchestrators:
|
|
114
|
-
- `brainstorming` — Add to the "[Domain]" row in the Skill Integration & Orchestration Matrix
|
|
115
|
-
- `zero-to-prod-orchestrator` — Add to Phase [N]: [Phase Name]
|
|
116
|
-
- `production-ready-hardener` — Add to Phase [N] if relevant to pre-launch audit
|
|
117
|
-
|
|
118
|
-
---
|
|
119
|
-
|
|
120
|
-
<a name="bahasa-indonesia"></a>
|
|
121
|
-
## Bahasa Indonesia
|
|
122
|
-
|
|
123
|
-
### Integrasi Orkestrasi
|
|
124
|
-
Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
|
|
125
|
-
|
|
126
|
-
### Deskripsi
|
|
127
|
-
[Satu paragraf menjelaskan tujuan dan ruang lingkup skill ini. Spesifik tentang masalah apa yang dipecahkan dan versi teknologi apa yang ditargetkan.]
|
|
128
|
-
|
|
129
|
-
Contoh: *"Panduan ahli untuk [Teknologi/Domain] (v[X.Y]+). Mencakup [fitur A], [fitur B], [pola C], dan [praktik terbaik D] untuk aplikasi TypeScript/JavaScript berkualitas produksi."*
|
|
130
|
-
|
|
131
|
-
### Kondisi Pemicu
|
|
132
|
-
Aktifkan skill ini ketika pengguna sedang:
|
|
133
|
-
- [Skenario pemicu 1 — spesifik, misal: "Menulis X dengan framework Y"]
|
|
134
|
-
- [Skenario pemicu 2]
|
|
135
|
-
- [Skenario pemicu 3]
|
|
136
|
-
- [Skenario pemicu 4]
|
|
137
|
-
|
|
138
|
-
### Panduan Singkat
|
|
139
|
-
|
|
140
|
-
[Ringkasan praktis berisi poin-poin utama yang harus diketahui. Merujuk ke bagian English untuk detail teknis dan contoh kode lengkap.]
|
|
141
|
-
|
|
142
|
-
- **[Prinsip 1]:** [Penjelasan singkat]
|
|
143
|
-
- **[Prinsip 2]:** [Penjelasan singkat]
|
|
144
|
-
- **[Prinsip 3]:** [Penjelasan singkat]
|
|
145
|
-
- **[Prinsip 4]:** [Penjelasan singkat]
|
|
146
|
-
|
|
147
|
-
### Integrasi dengan Skill Lain (WAJIB)
|
|
148
|
-
|
|
149
|
-
> ⚠️ **Setiap skill WAJIB mencantumkan minimal 3 referensi silang.** Tidak ada skill yang boleh berdiri sendiri.
|
|
150
|
-
|
|
151
|
-
Skill ini bekerja paling baik dikombinasikan dengan:
|
|
152
|
-
- `[nama-skill]` — [Mengapa dan kapan dikombinasikan]
|
|
153
|
-
- `[nama-skill]` — [Mengapa dan kapan dikombinasikan]
|
|
154
|
-
- `[nama-skill]` — [Mengapa dan kapan dikombinasikan]
|
|
155
|
-
|
|
156
|
-
### Direferensikan oleh Orchestrator (WAJIB)
|
|
157
|
-
|
|
158
|
-
Skill ini harus direferensikan oleh orchestrator berikut:
|
|
159
|
-
- `brainstorming` — Tambahkan ke baris "[Domain]" di Matriks Orkestrasi
|
|
160
|
-
- `zero-to-prod-orchestrator` — Tambahkan ke Fase [N]
|
|
161
|
-
- `production-ready-hardener` — Tambahkan ke Fase [N] jika relevan
|
|
162
|
-
|
|
163
|
-
---
|
|
164
|
-
|
|
165
|
-
## Checklist Sebelum Mempublikasikan Skill Ini
|
|
166
|
-
|
|
167
|
-
- [ ] Frontmatter `name` dan `description` sudah diisi (bilingual EN/ID).
|
|
168
|
-
- [ ] Semua teks `[...]` placeholder sudah diganti.
|
|
169
|
-
- [ ] Ada minimal 2 contoh kode yang nyata dan dapat dijalankan.
|
|
170
|
-
- [ ] Ada tabel perbandingan atau selection guide jika relevan.
|
|
171
|
-
- [ ] Ada bagian "Common Pitfalls" atau anti-pattern.
|
|
172
|
-
- [ ] **Bagian "Integration with Other Skills" mencantumkan minimal 3 skill.**
|
|
173
|
-
- [ ] **Bagian "Referenced By Orchestrators" sudah diisi.**
|
|
174
|
-
- [ ] Bagian Bahasa Indonesia sudah diterjemahkan dengan benar.
|
|
175
|
-
- [ ] Blok instruksi ini sudah dihapus.
|
|
176
|
-
- [ ] **Skill sudah ditambahkan ke matriks orkestrasi `brainstorming`.**
|
|
177
|
-
- [ ] **Skill sudah ditambahkan ke fase yang relevan di `zero-to-prod-orchestrator`.**
|
|
178
|
-
- [ ] `BLUEPRINT.md` sudah diperbarui dengan deskripsi skill baru.
|
|
@@ -1,91 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: supabase-migration
|
|
3
|
-
description: "A skill to create or apply a Supabase database migration / Kemampuan untuk membuat atau menerapkan migrasi database Supabase."
|
|
4
|
-
author: "Roedy Rustam"
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Supabase Migration Skill
|
|
8
|
-
|
|
9
|
-
[English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
<a name="english"></a>
|
|
14
|
-
## English
|
|
15
|
-
|
|
16
|
-
### Description
|
|
17
|
-
When the user asks to create or apply a database migration for Supabase, follow these instructions:
|
|
18
|
-
|
|
19
|
-
### Instructions
|
|
20
|
-
1. **Check Environment**: Ensure `supabase/migrations` directory exists. Run `list_dir` on it if needed.
|
|
21
|
-
2. **Review Available MCP Commands**: Utilize the Supabase MCP integration.
|
|
22
|
-
- For listing existing migrations, use `mcp_supabase-mcp-server_list_migrations` with `project_id`.
|
|
23
|
-
- Before executing migration queries on the server directly, confirm the SQL is correct.
|
|
24
|
-
3. **Execute Command**:
|
|
25
|
-
- Write the SQL script to a local migration file located in `supabase/migrations/` using `write_to_file`. Use standard timestamps or `supabase migration new` command to get the filename.
|
|
26
|
-
- Run `npx supabase migration up` to test locally or use the remote MCP `apply_migration` if the user wants it applied remotely.
|
|
27
|
-
4. **Final Step**: Confirm with the user that the migration successfully completed.
|
|
28
|
-
|
|
29
|
-
### Implementation Checklist
|
|
30
|
-
- [ ] Generate a new migration file: `npx supabase migration new [name]`
|
|
31
|
-
- [ ] Write raw SQL in the generated migration file (DDL and DML).
|
|
32
|
-
- [ ] Test the migration locally: `npx supabase db reset` or `npx supabase migration up`.
|
|
33
|
-
- [ ] If using RLS, explicitly add policies to the new tables.
|
|
34
|
-
- [ ] Commit the migration file to version control.
|
|
35
|
-
|
|
36
|
-
### Example: Supabase Migration Command Flow
|
|
37
|
-
```bash
|
|
38
|
-
# 1. Create a new migration file
|
|
39
|
-
npx supabase migration new create_users_table
|
|
40
|
-
|
|
41
|
-
# 2. Write SQL to supabase/migrations/<timestamp>_create_users_table.sql
|
|
42
|
-
# 3. Apply to local database
|
|
43
|
-
npx supabase migration up
|
|
44
|
-
|
|
45
|
-
# 4. Apply to remote production database
|
|
46
|
-
npx supabase db push
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
## Orchestration & Integration
|
|
50
|
-
- Integrates with: `supabase-security-expert`, `database-orm-expert`, `ci-cd-devops-architect`.
|
|
51
|
-
|
|
52
|
-
---
|
|
53
|
-
|
|
54
|
-
<a name="bahasa-indonesia"></a>
|
|
55
|
-
## Bahasa Indonesia
|
|
56
|
-
|
|
57
|
-
### Deskripsi
|
|
58
|
-
Ketika pengguna meminta untuk membuat atau menerapkan migrasi database untuk Supabase, ikuti instruksi berikut:
|
|
59
|
-
|
|
60
|
-
### Instruksi
|
|
61
|
-
1. **Periksa Lingkungan**: Pastikan direktori `supabase/migrations` ada. Jalankan `list_dir` jika diperlukan.
|
|
62
|
-
2. **Tinjau Perintah MCP yang Tersedia**: Manfaatkan integrasi Supabase MCP.
|
|
63
|
-
- Untuk mencantumkan migrasi yang ada, gunakan `mcp_supabase-mcp-server_list_migrations` dengan `project_id`.
|
|
64
|
-
- Sebelum menjalankan kueri migrasi di server secara langsung, pastikan kode SQL-nya sudah benar.
|
|
65
|
-
3. **Jalankan Perintah**:
|
|
66
|
-
- Tulis skrip SQL ke file migrasi lokal yang terletak di `supabase/migrations/` menggunakan `write_to_file`. Gunakan timestamp standar atau perintah `supabase migration new` untuk mendapatkan nama file.
|
|
67
|
-
- Jalankan `npx supabase migration up` untuk menguji secara lokal atau gunakan MCP remote `apply_migration` jika pengguna ingin menerapkannya secara remote.
|
|
68
|
-
4. **Langkah Terakhir**: Konfirmasikan dengan pengguna bahwa migrasi telah berhasil diselesaikan.
|
|
69
|
-
|
|
70
|
-
### Checklist Implementasi
|
|
71
|
-
- [ ] Buat file migrasi baru: `npx supabase migration new [nama]`
|
|
72
|
-
- [ ] Tulis SQL mentah di file migrasi yang dihasilkan (DDL dan DML).
|
|
73
|
-
- [ ] Uji migrasi secara lokal: `npx supabase db reset` atau `npx supabase migration up`.
|
|
74
|
-
- [ ] Jika menggunakan RLS, tambahkan kebijakan secara eksplisit ke tabel baru.
|
|
75
|
-
- [ ] Commit file migrasi ke sistem kontrol versi.
|
|
76
|
-
|
|
77
|
-
### Contoh: Alur Perintah Migrasi Supabase
|
|
78
|
-
```bash
|
|
79
|
-
# 1. Buat file migrasi baru
|
|
80
|
-
npx supabase migration new create_users_table
|
|
81
|
-
|
|
82
|
-
# 2. Tulis SQL ke supabase/migrations/<timestamp>_create_users_table.sql
|
|
83
|
-
# 3. Terapkan ke database lokal
|
|
84
|
-
npx supabase migration up
|
|
85
|
-
|
|
86
|
-
# 4. Terapkan ke database remote produksi
|
|
87
|
-
npx supabase db push
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
## Integrasi Orkestrasi
|
|
91
|
-
- Terintegrasi dengan: `supabase-security-expert`, `database-orm-expert`, `ci-cd-devops-architect`.
|