vibes-plug 2.14.1 → 3.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/.claude/rules/vibes-plug-core.md +5 -0
  2. package/.cursor/rules/vibes-plug-core.mdc +7 -2
  3. package/.cursorrules +8 -2
  4. package/AGENTS.md +23 -2
  5. package/CHANGELOG.md +114 -0
  6. package/CLAUDE.md +10 -3
  7. package/README.md +216 -611
  8. package/bin/vibes.mjs +1104 -0
  9. package/package.json +11 -3
  10. package/plugin.json +4 -3
  11. package/scripts/check-anti-slop.mjs +53 -0
  12. package/scripts/install.js +3 -1
  13. package/scripts/update_skills.js +1 -1
  14. package/scripts/update_skills.mjs +86 -0
  15. package/scripts/validate-skills.mjs +111 -0
  16. package/skills/accessibility-testing-expert/SKILL.md +117 -116
  17. package/skills/affective-computing-emotion-ai/SKILL.md +83 -0
  18. package/skills/agentic-coding-workflow-expert/SKILL.md +297 -0
  19. package/skills/agentic-memory-architect/SKILL.md +52 -0
  20. package/skills/agentic-micro-economy-architect/SKILL.md +92 -0
  21. package/skills/ai-llm-integration-expert/SKILL.md +330 -194
  22. package/skills/ai-media-generation-expert/SKILL.md +173 -172
  23. package/skills/ai-prompt-engineering-expert/SKILL.md +204 -134
  24. package/skills/ai-safety-governance-expert/SKILL.md +223 -0
  25. package/skills/angular-expert/SKILL.md +149 -148
  26. package/skills/anti-slop/SKILL.md +134 -133
  27. package/skills/api-design-expert/SKILL.md +4 -3
  28. package/skills/api-gateway-proxy-expert/SKILL.md +3 -2
  29. package/skills/app-analyzer-optimizer/SKILL.md +4 -3
  30. package/skills/apple-ecosystem-expert/SKILL.md +6 -5
  31. package/skills/astro-framework-expert/SKILL.md +201 -200
  32. package/skills/async-queue-temporal-expert/SKILL.md +218 -217
  33. package/skills/authentication-identity-expert/SKILL.md +174 -173
  34. package/skills/autonomous-red-teamer/SKILL.md +338 -203
  35. package/skills/autonomous-tdd-debugger/SKILL.md +6 -5
  36. package/skills/biome-linter-formatter-expert/SKILL.md +90 -89
  37. package/skills/blockchain-web3-expert/SKILL.md +116 -115
  38. package/skills/brainstorming/SKILL.md +392 -377
  39. package/skills/browser-automation-expert/SKILL.md +260 -222
  40. package/skills/bun-runtime-expert/SKILL.md +5 -4
  41. package/skills/chatbot-messaging-expert/SKILL.md +115 -114
  42. package/skills/ci-cd-devops-architect/SKILL.md +3 -2
  43. package/skills/cloud-hosting-expert/SKILL.md +5 -4
  44. package/skills/coderabbit/SKILL.md +5 -4
  45. package/skills/compliance-gdpr-privacy-expert/SKILL.md +3 -2
  46. package/skills/composable-mach-architect/SKILL.md +338 -0
  47. package/skills/cron-scheduler-expert/SKILL.md +5 -4
  48. package/skills/data-pipeline-etl-expert/SKILL.md +3 -2
  49. package/skills/data-telemetry-expert/SKILL.md +5 -4
  50. package/skills/data-visualization-expert/SKILL.md +155 -154
  51. package/skills/database-orm-expert/SKILL.md +166 -165
  52. package/skills/deep-research-analyst/SKILL.md +182 -136
  53. package/skills/dependency-upgrade-migrator/SKILL.md +11 -10
  54. package/skills/design-system-architect/SKILL.md +4 -3
  55. package/skills/desktop-electron-expert/SKILL.md +129 -128
  56. package/skills/documentation-site-expert/SKILL.md +60 -59
  57. package/skills/doku-mcp-server/SKILL.md +5 -4
  58. package/skills/doku-payment-gateway/SKILL.md +250 -232
  59. package/skills/domain-driven-design-expert/SKILL.md +3 -2
  60. package/skills/e2e-testing-expert/SKILL.md +5 -4
  61. package/skills/ecommerce-expert/SKILL.md +88 -87
  62. package/skills/email-notification-expert/SKILL.md +5 -4
  63. package/skills/ephemeral-generative-ui-architect/SKILL.md +88 -0
  64. package/skills/error-resilience-expert/SKILL.md +14 -13
  65. package/skills/event-driven-architect/SKILL.md +5 -4
  66. package/skills/feature-flag-analytics-expert/SKILL.md +3 -2
  67. package/skills/file-upload-media-expert/SKILL.md +5 -4
  68. package/skills/firebase-security-expert/SKILL.md +5 -4
  69. package/skills/form-validation-expert/SKILL.md +7 -6
  70. package/skills/frontier-ai-models-expert/SKILL.md +116 -0
  71. package/skills/fullstack-expert/SKILL.md +185 -184
  72. package/skills/gemini-agent-booster/SKILL.md +248 -172
  73. package/skills/geospatial-maps-expert/SKILL.md +81 -80
  74. package/skills/global-a11y-i18n-expert/SKILL.md +5 -4
  75. package/skills/glsl-shader-expert/SKILL.md +191 -190
  76. package/skills/go-programming-expert/SKILL.md +5 -4
  77. package/skills/graph-rag-knowledge-expert/SKILL.md +201 -200
  78. package/skills/graphql-apollo-expert/SKILL.md +5 -4
  79. package/skills/headless-cms-expert/SKILL.md +182 -181
  80. package/skills/hig/SKILL.md +5 -4
  81. package/skills/js-backend-expert/SKILL.md +219 -218
  82. package/skills/legacy-code-translator/SKILL.md +6 -5
  83. package/skills/llm-finops-router/SKILL.md +52 -0
  84. package/skills/local-slm-edge-ai-expert/SKILL.md +168 -167
  85. package/skills/logging-error-tracking-expert/SKILL.md +5 -4
  86. package/skills/mcp-server-architect/SKILL.md +315 -307
  87. package/skills/micro-frontend-architect/SKILL.md +5 -4
  88. package/skills/mobile-expo-expert/SKILL.md +5 -4
  89. package/skills/modern-css-native-expert/SKILL.md +190 -189
  90. package/skills/monorepo-architect/SKILL.md +5 -4
  91. package/skills/mpa-orchestrator/SKILL.md +41 -4
  92. package/skills/multi-agent-orchestration/SKILL.md +388 -254
  93. package/skills/mvc-expert/SKILL.md +5 -4
  94. package/skills/n8n-automation-expert/SKILL.md +90 -89
  95. package/skills/nextjs-app-router-expert/SKILL.md +3 -2
  96. package/skills/openapi-swagger-codegen-expert/SKILL.md +4 -3
  97. package/skills/payment-gateway-expert/SKILL.md +131 -128
  98. package/skills/pdf-document-generation-expert/SKILL.md +92 -91
  99. package/skills/performance-web-vitals/SKILL.md +5 -4
  100. package/skills/post-quantum-crypto-migrator/SKILL.md +3 -2
  101. package/skills/prd-architect/SKILL.md +183 -182
  102. package/skills/proactive-background-watcher/SKILL.md +5 -4
  103. package/skills/production-ready-hardener/SKILL.md +10 -9
  104. package/skills/pwa-offline-first-expert/SKILL.md +227 -226
  105. package/skills/pydantic-ai-expert/SKILL.md +162 -161
  106. package/skills/python-programming-expert/SKILL.md +5 -4
  107. package/skills/rate-limit-abuse-prevention/SKILL.md +5 -4
  108. package/skills/realtime-collaboration-expert/SKILL.md +3 -2
  109. package/skills/rich-text-editor-expert/SKILL.md +178 -177
  110. package/skills/rust-programming-expert/SKILL.md +5 -4
  111. package/skills/saas-architect/SKILL.md +155 -154
  112. package/skills/saas-billing/SKILL.md +394 -382
  113. package/skills/saas-multi-tenant/SKILL.md +7 -6
  114. package/skills/scalability-clean-code/SKILL.md +5 -4
  115. package/skills/search-engine-expert/SKILL.md +90 -89
  116. package/skills/self-healing-cloud-orchestrator/SKILL.md +3 -2
  117. package/skills/senior-frontend/SKILL.md +14 -9
  118. package/skills/seo/SKILL.md +4 -4
  119. package/skills/session-memory-manager/SKILL.md +129 -128
  120. package/skills/solidjs-expert/SKILL.md +81 -80
  121. package/skills/spa-orchestrator/SKILL.md +5 -4
  122. package/skills/sse-websocket-streaming-expert/SKILL.md +3 -2
  123. package/skills/state-management-expert/SKILL.md +5 -4
  124. package/skills/supabase-security-expert/SKILL.md +5 -4
  125. package/skills/svelte-sveltekit-expert/SKILL.md +92 -91
  126. package/skills/svg-animation-motion-expert/SKILL.md +3 -2
  127. package/skills/synthetic-data-finetuning-expert/SKILL.md +156 -155
  128. package/skills/tailwind-expert/SKILL.md +62 -5
  129. package/skills/tanstack-query-expert/SKILL.md +5 -4
  130. package/skills/tauri-expert/SKILL.md +5 -4
  131. package/skills/typescript-expert/SKILL.md +5 -4
  132. package/skills/ui-ux-pro-max/SKILL.md +7 -6
  133. package/skills/vector-db-rag-expert/SKILL.md +209 -208
  134. package/skills/vercel-ai-sdk-expert/SKILL.md +226 -181
  135. package/skills/voice-ai-realtime-agent/SKILL.md +243 -242
  136. package/skills/vue-frontend-expert/SKILL.md +5 -4
  137. package/skills/wasm-edge-computing-expert/SKILL.md +3 -2
  138. package/skills/web-3d-graphics-expert/SKILL.md +314 -313
  139. package/skills/web-game-engine-expert/SKILL.md +330 -329
  140. package/skills/web-scraper/SKILL.md +158 -157
  141. package/skills/website-design-cloner/SKILL.md +5 -4
  142. package/skills/webxr-ar-vr-expert/SKILL.md +163 -162
  143. package/skills/wordpress-headless-expert/SKILL.md +145 -144
  144. package/skills/zero-tech-debt-auditor/SKILL.md +115 -0
  145. package/skills/zero-to-prod-orchestrator/SKILL.md +281 -229
  146. package/skills/zero-trust-secret-vault/SKILL.md +3 -2
  147. package/BLUEPRINT.md +0 -319
  148. package/skills/bootstrap-to-modern/SKILL.md +0 -94
  149. package/skills/multiple-entry-points/SKILL.md +0 -91
  150. package/skills/secure-fuzz-testing/SKILL.md +0 -207
  151. package/skills/visual-qa-vision-agent/SKILL.md +0 -71
@@ -1,136 +1,182 @@
1
- ---
2
- name: deep-research-analyst
3
- description: "Expert guide for autonomous deep research, iterative web search, citation verification, evidence graph synthesis, and hallucination mitigation / Panduan ahli riset mendalam otonom, pencarian web iteratif, verifikasi sitasi, dan mitigasi halusinasi."
4
- author: vibes-plug-swarm
5
- ---
6
-
7
- # Deep Research Analyst (2026 Autonomous Research 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`, `prd-architect`, `web-scraper`, `browser-automation-expert`, `project-context-mapper`, and `multi-agent-orchestration` to form an evidence-backed intelligence swarm.
18
-
19
- ### Description
20
- Production guide for architecting and executing autonomous **Deep Research** pipelines. Unlike simple one-shot retrieval (RAG), Deep Research operates as a goal-directed autonomous loop: decomposing queries into multi-perspective sub-questions, crawling and scraping academic/technical sources, scoring source credibility, cross-verifying facts across multiple independent citations, constructing an evidence graph, and synthesizing comprehensive, citation-grounded intelligence briefs.
21
-
22
- **Swarm Synergy:** Within the **Fan-Out / Fan-In Research Swarm**, this skill acts as the Lead Intelligence Subagent. It is deployed in Phase 1 (Discovery & PRD) to gather ground truth, audit competitor architectures, and resolve high-risk technical unknowns before code is written.
23
-
24
- ### Trigger Conditions
25
- - Requiring deep, multi-source investigation before architectural decision-making.
26
- - Benchmarking libraries, database engines, or cloud architectures with empirical data.
27
- - Building autonomous research agents, competitive intelligence scrapers, or literature synthesis tools.
28
- - Eliminating LLM hallucinations in high-stakes technical or business documentation.
29
- - Synthesizing complex multi-page web information into structured, cited intelligence reports.
30
-
31
- ### Deep Research Operational Workflow
32
-
33
- ```
34
- 1. QUERY DECOMPOSITION & HYPOTHESIS FORMULATION
35
- [User Objective] ──► [Query Expander] ──┬──► Sub-query A (Technical Specs)
36
- ├──► Sub-query B (Benchmarks & Limitations)
37
- └──► Sub-query C (Community Issues & Regressions)
38
-
39
- 2. RECURSIVE SOURCE DISCOVERY & CRAWLING
40
- [Sub-queries] ──► [Crawl4AI / Firecrawl / SerpAPI] ──► Raw Markdown / HTML Sources
41
-
42
- 3. SOURCE CREDIBILITY & FACT TRIANGULATION
43
- Raw Documents ──► [Evidence Evaluator] ──► Triangulate Facts (>= 2 Independent Sources)
44
- ──► Discard Low-Trust / SEO-Spam Content
45
-
46
- 4. EVIDENCE GRAPH SYNTHESIS & REPORTING
47
- Verified Facts ──► [Synthesizer Node] ──► Structured Report with Clickable Markdown Citations
48
- ```
49
-
50
- ### Core Implementation Guidelines
51
-
52
- #### 1. Recursive Query Decomposer (Python / TypeScript)
53
- Break high-level user requests into diverse search vectors targeting technical documentation, GitHub issues, and benchmarks:
54
- ```typescript
55
- import { generateObject } from 'ai';
56
- import { z } from 'zod';
57
-
58
- interface ResearchPlan {
59
- coreObjective: string;
60
- subQueries: Array<{
61
- query: string;
62
- focus: 'architecture' | 'benchmarks' | 'security' | 'pitfalls';
63
- expectedSourceType: 'docs' | 'github_repo' | 'benchmark_paper';
64
- }>;
65
- }
66
-
67
- export async function decomposeResearchQuery(userPrompt: string): Promise<ResearchPlan> {
68
- const { object } = await generateObject({
69
- model: customModel('gemini-3.8-flash'),
70
- schema: z.object({
71
- coreObjective: z.string(),
72
- subQueries: z.array(z.object({
73
- query: z.string().describe('Precise keyword search query with technical operators'),
74
- focus: z.enum(['architecture', 'benchmarks', 'security', 'pitfalls']),
75
- expectedSourceType: z.enum(['docs', 'github_repo', 'benchmark_paper']),
76
- })).min(3).max(6),
77
- }),
78
- prompt: `Analyze the following research objective and decompose it into 4-6 targeted, non-overlapping search vectors: "${userPrompt}"`,
79
- });
80
-
81
- return object;
82
- }
83
- ```
84
-
85
- #### 2. Source Credibility & Fact Triangulation Protocol
86
- Never accept a claim from a single unverified blog post. Require citation triangulation:
87
- - **Tier 1 (Highest Confidence):** Official documentation, source code repositories, peer-reviewed benchmarks, RFCs.
88
- - **Tier 2 (Medium Confidence):** Production engineering blogs (Uber, Netflix, Cloudflare), maintainer posts.
89
- - **Tier 3 (Verify Required):** Forum discussions, social threads, unverified community tutorials.
90
- - **Rule of Triangulation:** Any non-trivial technical claim must be confirmed by at least two independent sources or verified against raw benchmark code.
91
-
92
- #### 3. Structured Evidence Graph Output
93
- Every research brief produced by this skill must adhere to the following markdown template:
94
- ```markdown
95
- # [Topic] — Deep Research & Evidence Dossier
96
-
97
- ## Executive Summary
98
- - Concise 3-5 bullet takeaway synthesis.
99
-
100
- ## Evidence Matrix
101
- | Technical Claim | Verified Status | Confidence (0-100%) | Primary Source | Corroborating Source |
102
- |---|---|---|---|---|
103
- | Claim Description | Confirmed / Disputed | 95% | [Source A](url) | [Source B](url) |
104
-
105
- ## Trade-off Analysis & Key Risks
106
- - Concrete architectural trade-offs, cold-start latencies, memory footprint, or pricing cliff.
107
-
108
- ## Recommended Architectural Decision
109
- - Prescriptive guidance for implementation swarms with justification.
110
- ```
111
-
112
- ---
113
-
114
- <a name="bahasa-indonesia"></a>
115
- ## Bahasa Indonesia
116
-
117
- ### Integrasi Orkestrasi
118
- Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `prd-architect`, `web-scraper`, `browser-automation-expert`, `project-context-mapper`, dan `multi-agent-orchestration` untuk membentuk swarm intelijen berbasis bukti empiris.
119
-
120
- ### Deskripsi
121
- Panduan produksi untuk merancang dan mengeksekusi pipeline **Riset Mendalam Otonom (Deep Research)**. Berbeda dari retrieval sederhana (RAG satu langkah), Deep Research beroperasi sebagai siklus otonom terarah: memecah pertanyaan menjadi sub-vektor dari berbagai sudut pandang, merayapi dan mengekstrak sumber teknis/akademis, menilai kredibilitas sumber, memvalidasi silang fakta (*fact triangulation*) di minimal 2 sumber independen, membangun graf bukti, dan menyusun laporan intelijen komprehensif berlandaskan sitasi yang valid.
122
-
123
- **Sinergi Swarm:** Dalam topologi **Fan-Out / Fan-In Research Swarm**, skill ini berperan sebagai Sub-agen Analis Utama. Diterapkan pada Fase 1 (Discovery & PRD) untuk mengumpulkan fakta objektif, mengaudit arsitektur kompetitor, dan mengeliminasi ketidakpastian teknis berisiko tinggi sebelum penulisan kode dimulai.
124
-
125
- ### Kondisi Pemicu
126
- - Membutuhkan penyelidikan multi-sumber yang mendalam sebelum membuat keputusan arsitektur.
127
- - Melakukan benchmark komparatif library, database engine, atau infrastruktur cloud berbasis data empiris.
128
- - Membangun agen riset otonom, alat pemantau kompetitor, atau sintesis literatur otomatis.
129
- - Mengeliminasi halusinasi LLM pada dokumen teknis atau strategi bisnis berisiko tinggi.
130
- - Merangkum informasi web yang rumit dan tersebar menjadi dokumen ringkasan terstruktur dengan sitasi klik langsung.
131
-
132
- ### Protokol Triangulasi Fakta & Skor Keyakinan
133
- 1. **Tier 1 (Otoritatif):** Dokumentasi resmi, repositori kode sumber terbuka, RFC/spesifikasi teknis, laporan audit resmi.
134
- 2. **Tier 2 (Dapat Diandalkan):** Blog teknik produksi resmi (Netflix, Cloudflare, Uber), analisis tim pengembang inti.
135
- 3. **Tier 3 (Perlu Verifikasi Lanjutan):** Thread diskusi komunitas, tutorial umum.
136
- 4. **Aturan Triangulasi:** Setiap klaim teknis penting wajib diverifikasi silang oleh sekurang-kurangnya 2 sumber independen sebelum dimasukkan ke dalam blueprint arsitektur.
1
+ ---
2
+ name: deep-research-analyst
3
+ description: "Expert guide for autonomous deep research, iterative web search, citation verification, evidence graph synthesis, and hallucination mitigation / Panduan ahli riset mendalam otonom, pencarian web iteratif, verifikasi sitasi, dan mitigasi halusinasi."
4
+ author: vibes-plug-swarm
5
+ version: "3.0.0"
6
+ ---
7
+
8
+ # Deep Research Analyst (2026 Autonomous Research Edition)
9
+
10
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
11
+
12
+ ---
13
+
14
+ <a name="english"></a>
15
+ ## English
16
+
17
+ ### Orchestration & Integration
18
+ Connects and orchestrates with relevant domain skills like `brainstorming`, `prd-architect`, `web-scraper`, `browser-automation-expert`, `session-memory-manager`, and `multi-agent-orchestration` to form an evidence-backed intelligence swarm.
19
+
20
+ ### Description
21
+ Production guide for architecting and executing autonomous **Deep Research** pipelines. Unlike simple one-shot retrieval (RAG), Deep Research operates as a goal-directed autonomous loop: decomposing queries into multi-perspective sub-questions, crawling and scraping academic/technical sources, scoring source credibility, cross-verifying facts across multiple independent citations, constructing an evidence graph, and synthesizing comprehensive, citation-grounded intelligence briefs.
22
+
23
+ **Swarm Synergy:** Within the **Fan-Out / Fan-In Research Swarm**, this skill acts as the Lead Intelligence Subagent. It is deployed in Phase 1 (Discovery & PRD) to gather ground truth, audit competitor architectures, and resolve high-risk technical unknowns before code is written.
24
+
25
+ ### Trigger Conditions
26
+ - Requiring deep, multi-source investigation before architectural decision-making.
27
+ - Benchmarking libraries, database engines, or cloud architectures with empirical data.
28
+ - Building autonomous research agents, competitive intelligence scrapers, or literature synthesis tools.
29
+ - Eliminating LLM hallucinations in high-stakes technical or business documentation.
30
+ - Synthesizing complex multi-page web information into structured, cited intelligence reports.
31
+
32
+ ### Deep Research Operational Workflow
33
+
34
+ ```
35
+ 1. QUERY DECOMPOSITION & HYPOTHESIS FORMULATION
36
+ [User Objective] ──► [Query Expander] ──┬──► Sub-query A (Technical Specs)
37
+ ├──► Sub-query B (Benchmarks & Limitations)
38
+ └──► Sub-query C (Community Issues & Regressions)
39
+
40
+ 2. RECURSIVE SOURCE DISCOVERY & CRAWLING
41
+ [Sub-queries] ──► [Crawl4AI / Firecrawl / SerpAPI] ──► Raw Markdown / HTML Sources
42
+
43
+ 3. SOURCE CREDIBILITY & FACT TRIANGULATION
44
+ Raw Documents ──► [Evidence Evaluator] ──► Triangulate Facts (>= 2 Independent Sources)
45
+ ──► Discard Low-Trust / SEO-Spam Content
46
+
47
+ 4. EVIDENCE GRAPH SYNTHESIS & REPORTING
48
+ Verified Facts ──► [Synthesizer Node] ──► Structured Report with Clickable Markdown Citations
49
+ ```
50
+
51
+ ### Core Implementation Guidelines
52
+
53
+ #### 1. Recursive Query Decomposer (Python / TypeScript)
54
+ Break high-level user requests into diverse search vectors targeting technical documentation, GitHub issues, and benchmarks:
55
+ ```typescript
56
+ import { generateObject } from 'ai';
57
+ import { z } from 'zod';
58
+
59
+ interface ResearchPlan {
60
+ coreObjective: string;
61
+ subQueries: Array<{
62
+ query: string;
63
+ focus: 'architecture' | 'benchmarks' | 'security' | 'pitfalls';
64
+ expectedSourceType: 'docs' | 'github_repo' | 'benchmark_paper';
65
+ }>;
66
+ }
67
+
68
+ export async function decomposeResearchQuery(userPrompt: string): Promise<ResearchPlan> {
69
+ const { object } = await generateObject({
70
+ model: customModel('gemini-3.8-flash'),
71
+ schema: z.object({
72
+ coreObjective: z.string(),
73
+ subQueries: z.array(z.object({
74
+ query: z.string().describe('Precise keyword search query with technical operators'),
75
+ focus: z.enum(['architecture', 'benchmarks', 'security', 'pitfalls']),
76
+ expectedSourceType: z.enum(['docs', 'github_repo', 'benchmark_paper']),
77
+ })).min(3).max(6),
78
+ }),
79
+ prompt: `Analyze the following research objective and decompose it into 4-6 targeted, non-overlapping search vectors: "${userPrompt}"`,
80
+ });
81
+
82
+ return object;
83
+ }
84
+ ```
85
+
86
+ #### 2. Python Implementation: Autonomous Extraction
87
+ ```python
88
+ from crawl4ai import AsyncWebCrawler, CrawlerRunConfig, CacheMode
89
+ from pydantic import BaseModel, Field
90
+ from pydantic_ai import Agent
91
+
92
+ class ResearchFinding(BaseModel):
93
+ claim: str = Field(description="Technical claim extracted")
94
+ confidence: float = Field(ge=0, le=1, description="Confidence score")
95
+ source_url: str = Field(description="Source URL")
96
+ corroborating_sources: list[str] = Field(default_factory=list)
97
+
98
+ research_agent = Agent(
99
+ 'google:gemini-3.8-flash',
100
+ result_type=list[ResearchFinding],
101
+ system_prompt="Extract and verify technical claims with confidence scores."
102
+ )
103
+
104
+ async def deep_research(query: str) -> list[ResearchFinding]:
105
+ config = CrawlerRunConfig(cache_mode=CacheMode.BYPASS)
106
+ async with AsyncWebCrawler() as crawler:
107
+ result = await crawler.arun(url=f"https://search-url/{query}", config=config)
108
+ findings = await research_agent.run(result.markdown)
109
+ return findings.data
110
+ ```
111
+
112
+ #### 3. Vector Store Caching for Intermediate Results
113
+ Caching intermediate research results in vector stores prevents redundant crawling and accelerates knowledge retrieval:
114
+ - **Storage:** Use `pgvector` or local `FAISS` for caching crawled page embeddings.
115
+ - **Deduplication:** Deduplicate sources via cosine similarity before processing.
116
+ - **Invalidation:** Implement TTL-based cache invalidation for time-sensitive research (e.g., fast-moving API docs).
117
+ - **Example Flow:**
118
+ ```python
119
+ # Store page chunks in vector store
120
+ vector_store.add_texts(chunks, metadata=[{"url": url, "timestamp": now}])
121
+ # Retrieve similar past findings
122
+ cached = vector_store.similarity_search(query, k=3, filter={"ttl_valid": True})
123
+ ```
124
+
125
+ #### 4. Episodic Research Memory
126
+ Maintain research memory across sessions to build continuous intelligence:
127
+ - **Storage:** Store research dossiers as episodic memories in `session-memory-manager`.
128
+ - **Knowledge Graphs:** Build cumulative knowledge graphs from multiple research sessions, linking related concepts over time.
129
+ - **Cross-referencing:** Cross-reference past findings with new queries to compound understanding without starting from scratch.
130
+
131
+ #### 5. Source Credibility & Fact Triangulation Protocol
132
+ Never accept a claim from a single unverified blog post. Require citation triangulation:
133
+ - **Tier 1 (Highest Confidence):** Official documentation, source code repositories, peer-reviewed benchmarks, RFCs.
134
+ - **Tier 2 (Medium Confidence):** Production engineering blogs (Uber, Netflix, Cloudflare), maintainer posts.
135
+ - **Tier 3 (Verify Required):** Forum discussions, social threads, unverified community tutorials.
136
+ - **Rule of Triangulation:** Any non-trivial technical claim must be confirmed by at least two independent sources or verified against raw benchmark code.
137
+
138
+ #### 6. Structured Evidence Graph Output
139
+ Every research brief produced by this skill must adhere to the following markdown template:
140
+ ```markdown
141
+ # [Topic] — Deep Research & Evidence Dossier
142
+
143
+ ## Executive Summary
144
+ - Concise 3-5 bullet takeaway synthesis.
145
+
146
+ ## Evidence Matrix
147
+ | Technical Claim | Verified Status | Confidence (0-100%) | Primary Source | Corroborating Source |
148
+ |---|---|---|---|---|
149
+ | Claim Description | Confirmed / Disputed | 95% | [Source A](url) | [Source B](url) |
150
+
151
+ ## Trade-off Analysis & Key Risks
152
+ - Concrete architectural trade-offs, cold-start latencies, memory footprint, or pricing cliff.
153
+
154
+ ## Recommended Architectural Decision
155
+ - Prescriptive guidance for implementation swarms with justification.
156
+ ```
157
+
158
+ ---
159
+
160
+ <a name="bahasa-indonesia"></a>
161
+ ## Bahasa Indonesia
162
+
163
+ ### Integrasi Orkestrasi
164
+ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `prd-architect`, `web-scraper`, `browser-automation-expert`, `session-memory-manager`, dan `multi-agent-orchestration` untuk membentuk swarm intelijen berbasis bukti empiris.
165
+
166
+ ### Deskripsi
167
+ Panduan produksi untuk merancang dan mengeksekusi pipeline **Riset Mendalam Otonom (Deep Research)**. Berbeda dari retrieval sederhana (RAG satu langkah), Deep Research beroperasi sebagai siklus otonom terarah: memecah pertanyaan menjadi sub-vektor dari berbagai sudut pandang, merayapi dan mengekstrak sumber teknis/akademis, menilai kredibilitas sumber, memvalidasi silang fakta (*fact triangulation*) di minimal 2 sumber independen, membangun graf bukti, dan menyusun laporan intelijen komprehensif berlandaskan sitasi yang valid.
168
+
169
+ **Sinergi Swarm:** Dalam topologi **Fan-Out / Fan-In Research Swarm**, skill ini berperan sebagai Sub-agen Analis Utama. Diterapkan pada Fase 1 (Discovery & PRD) untuk mengumpulkan fakta objektif, mengaudit arsitektur kompetitor, dan mengeliminasi ketidakpastian teknis berisiko tinggi sebelum penulisan kode dimulai.
170
+
171
+ ### Kondisi Pemicu
172
+ - Membutuhkan penyelidikan multi-sumber yang mendalam sebelum membuat keputusan arsitektur.
173
+ - Melakukan benchmark komparatif library, database engine, atau infrastruktur cloud berbasis data empiris.
174
+ - Membangun agen riset otonom, alat pemantau kompetitor, atau sintesis literatur otomatis.
175
+ - Mengeliminasi halusinasi LLM pada dokumen teknis atau strategi bisnis berisiko tinggi.
176
+ - Merangkum informasi web yang rumit dan tersebar menjadi dokumen ringkasan terstruktur dengan sitasi klik langsung.
177
+
178
+ ### Protokol Triangulasi Fakta & Skor Keyakinan
179
+ 1. **Tier 1 (Otoritatif):** Dokumentasi resmi, repositori kode sumber terbuka, RFC/spesifikasi teknis, laporan audit resmi.
180
+ 2. **Tier 2 (Dapat Diandalkan):** Blog teknik produksi resmi (Netflix, Cloudflare, Uber), analisis tim pengembang inti.
181
+ 3. **Tier 3 (Perlu Verifikasi Lanjutan):** Thread diskusi komunitas, tutorial umum.
182
+ 4. **Aturan Triangulasi:** Setiap klaim teknis penting wajib diverifikasi silang oleh sekurang-kurangnya 2 sumber independen sebelum dimasukkan ke dalam blueprint arsitektur.
@@ -1,7 +1,8 @@
1
1
  ---
2
2
  name: dependency-upgrade-migrator
3
3
  description: "Expert guide for dependency upgrades, breaking change migrations, codemod automation, and package audit remediation / Panduan ahli untuk upgrade dependensi, migrasi breaking change, otomasi codemod, dan remediasi audit paket."
4
- author: "Roedy Rustam"
4
+ author: "Roedy Rustam"
5
+ version: "3.0.0"
5
6
  ---
6
7
 
7
8
  # Dependency Upgrade Migrator (2026 Edition)
@@ -14,10 +15,10 @@ author: "Roedy Rustam"
14
15
  ## English
15
16
 
16
17
  ### Orchestration & Integration
17
- Connects and orchestrates with relevant domain skills like `brainstorming`, `zero-to-prod-orchestrator`, and `project-context-mapper` to ensure cohesive execution.
18
+ Connects and orchestrates with relevant domain skills like `brainstorming`, `zero-to-prod-orchestrator`, and `session-memory-manager` to ensure cohesive execution.
18
19
 
19
20
  ### Description
20
- Production-grade guide for safely upgrading dependencies, migrating through breaking changes, and maintaining healthy dependency trees. Covers **automated upgrade tooling** (`npm-check-updates`, `taze`, Renovate Bot), **major framework migration guides** (React 18→19, Next.js 14→15, Tailwind v3→v4), **codemod automation** (jscodeshift, ts-morph), **vulnerability remediation** (`npm audit`, `pnpm audit`), **lockfile hygiene**, **monorepo alignment** (pnpm catalogs), and **breaking change detection workflows**.
21
+ Production-grade guide for safely upgrading dependencies, migrating through breaking changes, and maintaining healthy dependency trees. Covers **automated upgrade tooling** (`npm-check-updates`, `taze`, Renovate Bot), **major framework migration guides** (React 19→19, Next.js 15→15, Tailwind v3→v4), **codemod automation** (jscodeshift, ts-morph), **vulnerability remediation** (`npm audit`, `pnpm audit`), **lockfile hygiene**, **monorepo alignment** (pnpm catalogs), and **breaking change detection workflows**.
21
22
 
22
23
  ### Trigger Conditions
23
24
  Activate this skill when:
@@ -109,11 +110,11 @@ npx ncu --target minor # Only show minor updates
109
110
 
110
111
  ### 4. Major Framework Migration Guides
111
112
 
112
- #### React 18 → 19
113
+ #### React 19 → 19
113
114
  ```typescript
114
115
  // Key breaking changes:
115
116
  // 1. forwardRef no longer needed (ref is a regular prop)
116
- // ❌ Before (React 18)
117
+ // ❌ Before (React 19)
117
118
  const Input = forwardRef<HTMLInputElement, Props>((props, ref) => (
118
119
  <input ref={ref} {...props} />
119
120
  ));
@@ -132,7 +133,7 @@ function Input({ ref, ...props }: Props & { ref?: React.Ref<HTMLInputElement> })
132
133
  // ✅ New: const theme = use(ThemeContext);
133
134
  ```
134
135
 
135
- #### Next.js 14 → 15
136
+ #### Next.js 15 → 15
136
137
  ```typescript
137
138
  // Key changes:
138
139
  // 1. params/searchParams are now async in page/layout/route
@@ -148,7 +149,7 @@ function Input({ ref, ...props }: Props & { ref?: React.Ref<HTMLInputElement> })
148
149
  // Add: export const dynamic = 'force-static' if you want caching
149
150
  ```
150
151
 
151
- #### Tailwind CSS v3 → v4
152
+ #### Tailwind CSS v4 → v4
152
153
  ```css
153
154
  /* Key changes: */
154
155
  /* 1. Configuration moves from JS to CSS */
@@ -279,10 +280,10 @@ catalog:
279
280
  ## Bahasa Indonesia
280
281
 
281
282
  ### Integrasi Orkestrasi
282
- Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
283
+ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `session-memory-manager` untuk memastikan eksekusi yang kohesif.
283
284
 
284
285
  ### Deskripsi
285
- Panduan tingkat produksi untuk upgrade dependensi yang aman, migrasi melalui breaking change, dan pemeliharaan dependency tree yang sehat. Mencakup **tooling upgrade otomatis** (`taze`, Renovate Bot), **panduan migrasi framework utama** (React 18→19, Next.js 14→15, Tailwind v3→v4), **otomasi codemod** (jscodeshift, ts-morph), **remediasi kerentanan** (`pnpm audit`), **kebersihan lockfile**, dan **penyelarasan dependensi monorepo** (pnpm catalogs).
286
+ Panduan tingkat produksi untuk upgrade dependensi yang aman, migrasi melalui breaking change, dan pemeliharaan dependency tree yang sehat. Mencakup **tooling upgrade otomatis** (`taze`, Renovate Bot), **panduan migrasi framework utama** (React 19→19, Next.js 15→15, Tailwind v3→v4), **otomasi codemod** (jscodeshift, ts-morph), **remediasi kerentanan** (`pnpm audit`), **kebersihan lockfile**, dan **penyelarasan dependensi monorepo** (pnpm catalogs).
286
287
 
287
288
  ### Kondisi Pemicu
288
289
  Aktifkan skill ini ketika:
@@ -298,4 +299,4 @@ Aktifkan skill ini ketika:
298
299
  - `vibe-code-gardener` — Pembersihan pasca-upgrade, penghapusan dead code
299
300
  - `production-ready-hardener` — Fase audit keamanan
300
301
  - `ci-cd-devops-architect` — Integrasi Renovate Bot CI/CD
301
- - `e2e-testing-expert` — Pengujian regresi setelah upgrade mayor
302
+ - `e2e-testing-expert` — Pengujian regresi setelah upgrade mayor
@@ -1,7 +1,8 @@
1
1
  ---
2
2
  name: design-system-architect
3
3
  description: "Expert guide for designing, building, and maintaining scalable UI design systems with design tokens, headless primitives, Material Design 3 (M3), Tailwind v4 @theme, and WCAG 2.2 accessibility."
4
- author: "Roedy Rustam"
4
+ author: "Roedy Rustam"
5
+ version: "3.0.0"
5
6
  ---
6
7
 
7
8
  # Design System Architect (2026 Edition — shadcn/ui Registry)
@@ -256,7 +257,7 @@ import { Dialog, Button, Select } from '@base-ui-components/react';
256
257
  ## Bahasa Indonesia
257
258
 
258
259
  ### Integrasi Orkestrasi
259
- Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
260
+ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `session-memory-manager` untuk memastikan eksekusi yang kohesif.
260
261
 
261
262
  ### Deskripsi
262
263
  Panduan ahli untuk membangun dan memelihara design system UI yang skalabel. Mencakup design token dengan OKLCH dan `@theme` Tailwind v4, primitif komponen headless (Radix UI, **Base UI 1.x**), **registry shadcn/ui** untuk distribusi library komponen, CVA untuk varian type-safe, dan kepatuhan aksesibilitas WCAG 2.2.
@@ -306,4 +307,4 @@ Base UI (dari tim MUI) adalah alternatif Radix UI untuk 2026 dengan dukungan nat
306
307
 
307
308
 
308
309
  ## Orchestration & Integration
309
- - Integrates with frontend orchestrators, Tailwind v4, Base UI, and shadcn/ui.
310
+ - Integrates with frontend orchestrators, Tailwind v4, Base UI, and shadcn/ui.