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,89 +1,90 @@
1
- ---
2
- name: biome-linter-formatter-expert
3
- description: "Expert guide for Biome (Rust-based linter + formatter), ESLint/Prettier migration, and code quality tooling / Panduan ahli Biome (linter + formatter berbasis Rust), migrasi dari ESLint/Prettier, dan tooling kualitas kode."
4
- author: "Roedy Rustam"
5
- ---
6
-
7
- # Biome Linter & Formatter Expert (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
- - **`monorepo-architect`**: Biome configuration in monorepo workspaces.
18
- - **`ci-cd-devops-architect`**: Biome in CI/CD pipelines.
19
- - **`scalability-clean-code`**: Code quality standards enforcement.
20
- - **`typescript-expert`**: TypeScript-specific lint rules.
21
-
22
- ### Description
23
- Expert guide for Biome v2, the Rust-based unified linter and formatter replacing ESLint + Prettier. Covers migration from ESLint/Prettier, custom rule configuration, CI integration, monorepo setup, and editor integration. Includes performance comparison and best practices for 2026 JavaScript/TypeScript projects.
24
-
25
- ### Trigger Conditions
26
- - Setting up code linting and formatting for new projects.
27
- - Migrating from ESLint + Prettier to Biome.
28
- - Configuring Biome in monorepo or CI/CD pipelines.
29
- - Resolving linting or formatting configuration issues.
30
-
31
- ---
32
-
33
- ### Why Biome over ESLint + Prettier?
34
-
35
- | Aspect | Biome v2 | ESLint 9 + Prettier 3 |
36
- |--------|----------|----------------------|
37
- | Speed | 10-100x faster (Rust) | Baseline (Node.js) |
38
- | Config Files | 1 (`biome.json`) | 2-3 files |
39
- | Formatter + Linter | ✅ Unified | Separate tools |
40
- | Import Sorting | ✅ Built-in | Plugin required |
41
- | CSS/JSON Support | ✅ Built-in | Plugin required |
42
-
43
- ```bash
44
- # Install and init
45
- npm install --save-dev @biomejs/biome
46
- npx biome init
47
-
48
- # Migrate from ESLint/Prettier
49
- npx biome migrate eslint --write
50
- npx biome migrate prettier --write
51
- ```
52
-
53
- ```json
54
- // biome.json
55
- {
56
- "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
57
- "organizeImports": { "enabled": true },
58
- "linter": {
59
- "enabled": true,
60
- "rules": {
61
- "recommended": true,
62
- "complexity": { "noExcessiveCognitiveComplexity": "warn" },
63
- "suspicious": { "noExplicitAny": "error" }
64
- }
65
- },
66
- "formatter": {
67
- "enabled": true,
68
- "indentStyle": "space",
69
- "indentWidth": 2,
70
- "lineWidth": 100
71
- }
72
- }
73
- ```
74
-
75
- ## Orchestration & Integration
76
- - `monorepo-architect`, `ci-cd-devops-architect`, `scalability-clean-code`
77
-
78
- ---
79
-
80
- <a name="bahasa-indonesia"></a>
81
- ## Bahasa Indonesia
82
-
83
- ### Deskripsi
84
- Panduan ahli Biome v2, linter dan formatter berbasis Rust yang menggantikan ESLint + Prettier. Mencakup migrasi, konfigurasi rule, integrasi CI, dan setup monorepo.
85
-
86
- ### Kondisi Pemicu
87
- - Menyiapkan linting dan formatting kode untuk proyek baru.
88
- - Migrasi dari ESLint + Prettier ke Biome.
89
- - Mengkonfigurasi Biome di monorepo atau pipeline CI/CD.
1
+ ---
2
+ name: biome-linter-formatter-expert
3
+ description: "Expert guide for Biome (Rust-based linter + formatter), ESLint/Prettier migration, and code quality tooling / Panduan ahli Biome (linter + formatter berbasis Rust), migrasi dari ESLint/Prettier, dan tooling kualitas kode."
4
+ author: "Roedy Rustam"
5
+ version: "3.0.0"
6
+ ---
7
+
8
+ # Biome Linter & Formatter Expert (2026 Edition)
9
+
10
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
11
+
12
+ ---
13
+
14
+ <a name="english"></a>
15
+ ## English
16
+
17
+ ### Orchestration & Integration
18
+ - **`monorepo-architect`**: Biome configuration in monorepo workspaces.
19
+ - **`ci-cd-devops-architect`**: Biome in CI/CD pipelines.
20
+ - **`scalability-clean-code`**: Code quality standards enforcement.
21
+ - **`typescript-expert`**: TypeScript-specific lint rules.
22
+
23
+ ### Description
24
+ Expert guide for Biome v2, the Rust-based unified linter and formatter replacing ESLint + Prettier. Covers migration from ESLint/Prettier, custom rule configuration, CI integration, monorepo setup, and editor integration. Includes performance comparison and best practices for 2026 JavaScript/TypeScript projects.
25
+
26
+ ### Trigger Conditions
27
+ - Setting up code linting and formatting for new projects.
28
+ - Migrating from ESLint + Prettier to Biome.
29
+ - Configuring Biome in monorepo or CI/CD pipelines.
30
+ - Resolving linting or formatting configuration issues.
31
+
32
+ ---
33
+
34
+ ### Why Biome over ESLint + Prettier?
35
+
36
+ | Aspect | Biome v2 | ESLint 9 + Prettier 3 |
37
+ |--------|----------|----------------------|
38
+ | Speed | 10-100x faster (Rust) | Baseline (Node.js) |
39
+ | Config Files | 1 (`biome.json`) | 2-3 files |
40
+ | Formatter + Linter | ✅ Unified | Separate tools |
41
+ | Import Sorting | ✅ Built-in | Plugin required |
42
+ | CSS/JSON Support | ✅ Built-in | Plugin required |
43
+
44
+ ```bash
45
+ # Install and init
46
+ npm install --save-dev @biomejs/biome
47
+ npx biome init
48
+
49
+ # Migrate from ESLint/Prettier
50
+ npx biome migrate eslint --write
51
+ npx biome migrate prettier --write
52
+ ```
53
+
54
+ ```json
55
+ // biome.json
56
+ {
57
+ "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
58
+ "organizeImports": { "enabled": true },
59
+ "linter": {
60
+ "enabled": true,
61
+ "rules": {
62
+ "recommended": true,
63
+ "complexity": { "noExcessiveCognitiveComplexity": "warn" },
64
+ "suspicious": { "noExplicitAny": "error" }
65
+ }
66
+ },
67
+ "formatter": {
68
+ "enabled": true,
69
+ "indentStyle": "space",
70
+ "indentWidth": 2,
71
+ "lineWidth": 100
72
+ }
73
+ }
74
+ ```
75
+
76
+ ## Orchestration & Integration
77
+ - `monorepo-architect`, `ci-cd-devops-architect`, `scalability-clean-code`
78
+
79
+ ---
80
+
81
+ <a name="bahasa-indonesia"></a>
82
+ ## Bahasa Indonesia
83
+
84
+ ### Deskripsi
85
+ Panduan ahli Biome v2, linter dan formatter berbasis Rust yang menggantikan ESLint + Prettier. Mencakup migrasi, konfigurasi rule, integrasi CI, dan setup monorepo.
86
+
87
+ ### Kondisi Pemicu
88
+ - Menyiapkan linting dan formatting kode untuk proyek baru.
89
+ - Migrasi dari ESLint + Prettier ke Biome.
90
+ - Mengkonfigurasi Biome di monorepo atau pipeline CI/CD.
@@ -1,115 +1,116 @@
1
- ---
2
- name: blockchain-web3-expert
3
- description: "Expert guide for Web3 and blockchain dApp integration — viem, wagmi v2, ethers.js v6, RainbowKit, smart contract interactions, and EVM wallet state / Panduan ahli integrasi Web3 dan blockchain."
4
- author: "Roedy Rustam"
5
- ---
6
-
7
- # Blockchain & Web3 Expert (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
- - **`senior-frontend`**: React and Next.js frontend state for Web3 wallets.
18
- - **`authentication-identity-expert`**: Sign-In with Ethereum (SIWE / ERC-4361).
19
- - **`error-resilience-expert`**: Handling RPC node timeouts, network switches, and user transaction rejections.
20
- - **`post-quantum-crypto-migrator`**: Future-proofing cryptographic signatures and hash functions.
21
-
22
- ### Description
23
- Production-ready guide for building decentralized applications (dApps) on EVM-compatible blockchains. Covers typed smart contract interactions with **viem** and **wagmi v2**, wallet connectivity with **RainbowKit / AppKit**, gas estimation, transaction lifecycle management, ERC-20 / ERC-721 / ERC-1155 standards, and decentralized storage (IPFS/Arweave).
24
-
25
- ### Trigger Conditions
26
- - Integrating crypto wallet connections (MetaMask, Coinbase Wallet, WalletConnect).
27
- - Reading from and writing to Ethereum / Polygon / Arbitrum / Base smart contracts.
28
- - Implementing Sign-In With Ethereum (SIWE) authentication.
29
- - Minting, transferring, or querying ERC-20 tokens or NFTs.
30
-
31
- ---
32
-
33
- ### Core Architecture & Modern Patterns
34
-
35
- #### 1. Wallet Connection & Config (`wagmi.config.ts`)
36
- ```typescript
37
- import { http, createConfig } from 'wagmi';
38
- import { mainnet, base, arbitrum } from 'wagmi/chains';
39
- import { injected, walletConnect } from 'wagmi/connectors';
40
-
41
- export const config = createConfig({
42
- chains: [mainnet, base, arbitrum],
43
- connectors: [
44
- injected(),
45
- walletConnect({ projectId: process.env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID! }),
46
- ],
47
- transports: {
48
- [mainnet.id]: http(),
49
- [base.id]: http(),
50
- [arbitrum.id]: http(),
51
- },
52
- });
53
- ```
54
-
55
- #### 2. Contract Interaction Hook (Wagmi v2 + Viem)
56
- ```tsx
57
- import { useAccount, useReadContract, useWriteContract, useWaitForTransactionReceipt } from 'wagmi';
58
- import { parseAbi } from 'viem';
59
-
60
- const ERC20_ABI = parseAbi([
61
- 'function balanceOf(address owner) view returns (uint256)',
62
- 'function transfer(address to, uint256 amount) returns (bool)',
63
- ]);
64
-
65
- export function TokenTransferCard({ tokenAddress }: { tokenAddress: `0x${string}` }) {
66
- const { address, isConnected } = useAccount();
67
- const { data: balance, refetch } = useReadContract({
68
- address: tokenAddress,
69
- abi: ERC20_ABI,
70
- functionName: 'balanceOf',
71
- args: address ? [address] : undefined,
72
- });
73
-
74
- const { data: hash, writeContract, isPending } = useWriteContract();
75
- const { isLoading: isConfirming, isSuccess } = useWaitForTransactionReceipt({ hash });
76
-
77
- const handleSend = (recipient: `0x${string}`, amount: bigint) => {
78
- writeContract({
79
- address: tokenAddress,
80
- abi: ERC20_ABI,
81
- functionName: 'transfer',
82
- args: [recipient, amount],
83
- });
84
- };
85
-
86
- if (!isConnected) return <p>Please connect your wallet.</p>;
87
-
88
- return (
89
- <div>
90
- <p>Balance: {balance?.toString()}</p>
91
- {isPending && <p>Waiting for signature...</p>}
92
- {isConfirming && <p>Confirming transaction on-chain...</p>}
93
- {isSuccess && <p>Transfer completed successfully!</p>}
94
- </div>
95
- );
96
- }
97
- ```
98
-
99
- ---
100
-
101
- <a name="bahasa-indonesia"></a>
102
- ## Bahasa Indonesia
103
-
104
- ### Integrasi Orkestrasi
105
- - **`senior-frontend`**: Integrasi komponen React dan Next.js untuk antarmuka dApp.
106
- - **`authentication-identity-expert`**: Autentikasi Sign-In with Ethereum (SIWE).
107
- - **`error-resilience-expert`**: Penanganan kegagalan RPC dan penolakan transaksi oleh pengguna.
108
-
109
- ### Deskripsi
110
- Panduan produksi untuk membangun aplikasi terdesentralisasi (dApp) di jaringan EVM. Mencakup koneksi dompet Web3 via viem, wagmi v2, RainbowKit, interaksi smart contract type-safe, estimasi gas, dan standar token ERC-20/721.
111
-
112
- ### Kondisi Pemicu
113
- - Mengintegrasikan koneksi dompet Web3 ke aplikasi web.
114
- - Berinteraksi dengan smart contract di jaringan Ethereum, Base, Arbitrum, atau Polygon.
115
- - Menerapkan login dengan dompet kripto (SIWE).
1
+ ---
2
+ name: blockchain-web3-expert
3
+ description: "Expert guide for Web3 and blockchain dApp integration — viem, wagmi v2, ethers.js v6, RainbowKit, smart contract interactions, and EVM wallet state / Panduan ahli integrasi Web3 dan blockchain."
4
+ author: "Roedy Rustam"
5
+ version: "3.0.0"
6
+ ---
7
+
8
+ # Blockchain & Web3 Expert (2026 Edition)
9
+
10
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
11
+
12
+ ---
13
+
14
+ <a name="english"></a>
15
+ ## English
16
+
17
+ ### Orchestration & Integration
18
+ - **`senior-frontend`**: React and Next.js frontend state for Web3 wallets.
19
+ - **`authentication-identity-expert`**: Sign-In with Ethereum (SIWE / ERC-4361).
20
+ - **`error-resilience-expert`**: Handling RPC node timeouts, network switches, and user transaction rejections.
21
+ - **`post-quantum-crypto-migrator`**: Future-proofing cryptographic signatures and hash functions.
22
+
23
+ ### Description
24
+ Production-ready guide for building decentralized applications (dApps) on EVM-compatible blockchains. Covers typed smart contract interactions with **viem** and **wagmi v2**, wallet connectivity with **RainbowKit / AppKit**, gas estimation, transaction lifecycle management, ERC-20 / ERC-721 / ERC-1155 standards, and decentralized storage (IPFS/Arweave).
25
+
26
+ ### Trigger Conditions
27
+ - Integrating crypto wallet connections (MetaMask, Coinbase Wallet, WalletConnect).
28
+ - Reading from and writing to Ethereum / Polygon / Arbitrum / Base smart contracts.
29
+ - Implementing Sign-In With Ethereum (SIWE) authentication.
30
+ - Minting, transferring, or querying ERC-20 tokens or NFTs.
31
+
32
+ ---
33
+
34
+ ### Core Architecture & Modern Patterns
35
+
36
+ #### 1. Wallet Connection & Config (`wagmi.config.ts`)
37
+ ```typescript
38
+ import { http, createConfig } from 'wagmi';
39
+ import { mainnet, base, arbitrum } from 'wagmi/chains';
40
+ import { injected, walletConnect } from 'wagmi/connectors';
41
+
42
+ export const config = createConfig({
43
+ chains: [mainnet, base, arbitrum],
44
+ connectors: [
45
+ injected(),
46
+ walletConnect({ projectId: process.env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID! }),
47
+ ],
48
+ transports: {
49
+ [mainnet.id]: http(),
50
+ [base.id]: http(),
51
+ [arbitrum.id]: http(),
52
+ },
53
+ });
54
+ ```
55
+
56
+ #### 2. Contract Interaction Hook (Wagmi v2 + Viem)
57
+ ```tsx
58
+ import { useAccount, useReadContract, useWriteContract, useWaitForTransactionReceipt } from 'wagmi';
59
+ import { parseAbi } from 'viem';
60
+
61
+ const ERC20_ABI = parseAbi([
62
+ 'function balanceOf(address owner) view returns (uint256)',
63
+ 'function transfer(address to, uint256 amount) returns (bool)',
64
+ ]);
65
+
66
+ export function TokenTransferCard({ tokenAddress }: { tokenAddress: `0x${string}` }) {
67
+ const { address, isConnected } = useAccount();
68
+ const { data: balance, refetch } = useReadContract({
69
+ address: tokenAddress,
70
+ abi: ERC20_ABI,
71
+ functionName: 'balanceOf',
72
+ args: address ? [address] : undefined,
73
+ });
74
+
75
+ const { data: hash, writeContract, isPending } = useWriteContract();
76
+ const { isLoading: isConfirming, isSuccess } = useWaitForTransactionReceipt({ hash });
77
+
78
+ const handleSend = (recipient: `0x${string}`, amount: bigint) => {
79
+ writeContract({
80
+ address: tokenAddress,
81
+ abi: ERC20_ABI,
82
+ functionName: 'transfer',
83
+ args: [recipient, amount],
84
+ });
85
+ };
86
+
87
+ if (!isConnected) return <p>Please connect your wallet.</p>;
88
+
89
+ return (
90
+ <div>
91
+ <p>Balance: {balance?.toString()}</p>
92
+ {isPending && <p>Waiting for signature...</p>}
93
+ {isConfirming && <p>Confirming transaction on-chain...</p>}
94
+ {isSuccess && <p>Transfer completed successfully!</p>}
95
+ </div>
96
+ );
97
+ }
98
+ ```
99
+
100
+ ---
101
+
102
+ <a name="bahasa-indonesia"></a>
103
+ ## Bahasa Indonesia
104
+
105
+ ### Integrasi Orkestrasi
106
+ - **`senior-frontend`**: Integrasi komponen React dan Next.js untuk antarmuka dApp.
107
+ - **`authentication-identity-expert`**: Autentikasi Sign-In with Ethereum (SIWE).
108
+ - **`error-resilience-expert`**: Penanganan kegagalan RPC dan penolakan transaksi oleh pengguna.
109
+
110
+ ### Deskripsi
111
+ Panduan produksi untuk membangun aplikasi terdesentralisasi (dApp) di jaringan EVM. Mencakup koneksi dompet Web3 via viem, wagmi v2, RainbowKit, interaksi smart contract type-safe, estimasi gas, dan standar token ERC-20/721.
112
+
113
+ ### Kondisi Pemicu
114
+ - Mengintegrasikan koneksi dompet Web3 ke aplikasi web.
115
+ - Berinteraksi dengan smart contract di jaringan Ethereum, Base, Arbitrum, atau Polygon.
116
+ - Menerapkan login dengan dompet kripto (SIWE).