vibes-plug 2.5.0 → 2.14.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/rules/vibes-plug-core.md +32 -0
- package/.cursor/rules/vibes-plug-core.mdc +51 -0
- package/.cursorrules +42 -0
- package/AGENTS.md +37 -7
- package/BLUEPRINT.md +319 -217
- package/CHANGELOG.md +170 -1
- package/CLAUDE.md +70 -0
- package/LICENSE +1 -1
- package/README.md +611 -415
- package/index.js +19 -0
- package/package.json +44 -8
- package/plugin.json +24 -7
- package/scripts/check-anti-slop.js +53 -0
- package/scripts/generate_swarm_gif.py +295 -0
- package/scripts/install.js +201 -0
- package/skills/accessibility-testing-expert/SKILL.md +116 -0
- package/skills/ai-llm-integration-expert/SKILL.md +192 -178
- package/skills/ai-media-generation-expert/SKILL.md +172 -0
- package/skills/ai-prompt-engineering-expert/SKILL.md +134 -0
- package/skills/angular-expert/SKILL.md +148 -0
- package/skills/anti-slop/SKILL.md +133 -0
- package/skills/api-design-expert/SKILL.md +6 -3
- package/skills/api-gateway-proxy-expert/SKILL.md +81 -0
- package/skills/app-analyzer-optimizer/SKILL.md +6 -3
- package/skills/apple-ecosystem-expert/SKILL.md +144 -141
- package/skills/astro-framework-expert/SKILL.md +200 -0
- package/skills/async-queue-temporal-expert/SKILL.md +189 -26
- package/skills/authentication-identity-expert/SKILL.md +78 -181
- package/skills/autonomous-red-teamer/SKILL.md +172 -28
- package/skills/autonomous-tdd-debugger/SKILL.md +70 -64
- package/skills/biome-linter-formatter-expert/SKILL.md +89 -0
- package/skills/blockchain-web3-expert/SKILL.md +115 -0
- package/skills/bootstrap-to-modern/SKILL.md +9 -6
- package/skills/brainstorming/SKILL.md +60 -52
- package/skills/browser-automation-expert/SKILL.md +197 -21
- package/skills/bun-runtime-expert/SKILL.md +7 -1
- package/skills/chatbot-messaging-expert/SKILL.md +114 -0
- package/skills/ci-cd-devops-architect/SKILL.md +45 -36
- package/skills/cloud-hosting-expert/SKILL.md +7 -1
- package/skills/coderabbit/SKILL.md +7 -1
- package/skills/compliance-gdpr-privacy-expert/SKILL.md +85 -0
- package/skills/cron-scheduler-expert/SKILL.md +303 -297
- package/skills/data-pipeline-etl-expert/SKILL.md +84 -0
- package/skills/data-telemetry-expert/SKILL.md +7 -1
- package/skills/data-visualization-expert/SKILL.md +154 -0
- package/skills/database-orm-expert/SKILL.md +165 -294
- package/skills/deep-research-analyst/SKILL.md +136 -0
- package/skills/dependency-upgrade-migrator/SKILL.md +300 -294
- package/skills/design-system-architect/SKILL.md +309 -260
- package/skills/desktop-electron-expert/SKILL.md +128 -0
- package/skills/documentation-site-expert/SKILL.md +59 -0
- package/skills/doku-mcp-server/SKILL.md +7 -1
- package/skills/doku-payment-gateway/SKILL.md +7 -1
- package/skills/domain-driven-design-expert/SKILL.md +82 -0
- package/skills/e2e-testing-expert/SKILL.md +7 -1
- package/skills/ecommerce-expert/SKILL.md +87 -0
- package/skills/email-notification-expert/SKILL.md +393 -360
- package/skills/error-resilience-expert/SKILL.md +506 -479
- package/skills/event-driven-architect/SKILL.md +7 -1
- package/skills/feature-flag-analytics-expert/SKILL.md +65 -45
- package/skills/file-upload-media-expert/SKILL.md +436 -430
- package/skills/firebase-security-expert/SKILL.md +7 -1
- package/skills/form-validation-expert/SKILL.md +406 -400
- package/skills/fullstack-expert/SKILL.md +184 -202
- package/skills/gemini-agent-booster/SKILL.md +173 -135
- package/skills/geospatial-maps-expert/SKILL.md +80 -0
- package/skills/global-a11y-i18n-expert/SKILL.md +7 -1
- package/skills/glsl-shader-expert/SKILL.md +158 -69
- package/skills/go-programming-expert/SKILL.md +21 -15
- package/skills/graph-rag-knowledge-expert/SKILL.md +200 -0
- package/skills/graphql-apollo-expert/SKILL.md +113 -107
- package/skills/headless-cms-expert/SKILL.md +181 -0
- package/skills/hig/SKILL.md +7 -1
- package/skills/js-backend-expert/SKILL.md +218 -216
- package/skills/legacy-code-translator/SKILL.md +70 -64
- package/skills/local-slm-edge-ai-expert/SKILL.md +167 -0
- package/skills/logging-error-tracking-expert/SKILL.md +343 -337
- package/skills/mcp-server-architect/SKILL.md +308 -194
- package/skills/micro-frontend-architect/SKILL.md +111 -105
- package/skills/mobile-expo-expert/SKILL.md +8 -2
- package/skills/modern-css-native-expert/SKILL.md +189 -0
- package/skills/monorepo-architect/SKILL.md +7 -1
- package/skills/mpa-orchestrator/SKILL.md +20 -1
- package/skills/multi-agent-orchestration/SKILL.md +254 -234
- package/skills/multiple-entry-points/SKILL.md +37 -1
- package/skills/mvc-expert/SKILL.md +7 -1
- package/skills/n8n-automation-expert/SKILL.md +89 -0
- package/skills/nextjs-app-router-expert/SKILL.md +148 -0
- package/skills/openapi-swagger-codegen-expert/SKILL.md +67 -0
- package/skills/payment-gateway-expert/SKILL.md +85 -1
- package/skills/pdf-document-generation-expert/SKILL.md +91 -0
- package/skills/performance-web-vitals/SKILL.md +7 -1
- package/skills/post-quantum-crypto-migrator/SKILL.md +57 -57
- package/skills/prd-architect/SKILL.md +182 -201
- package/skills/proactive-background-watcher/SKILL.md +67 -61
- package/skills/production-ready-hardener/SKILL.md +459 -456
- package/skills/pwa-offline-first-expert/SKILL.md +226 -0
- package/skills/pydantic-ai-expert/SKILL.md +161 -0
- package/skills/python-programming-expert/SKILL.md +407 -401
- package/skills/rate-limit-abuse-prevention/SKILL.md +376 -370
- package/skills/realtime-collaboration-expert/SKILL.md +55 -1
- package/skills/rich-text-editor-expert/SKILL.md +177 -0
- package/skills/rust-programming-expert/SKILL.md +7 -1
- package/skills/saas-architect/SKILL.md +154 -0
- package/skills/saas-billing/SKILL.md +7 -1
- package/skills/saas-multi-tenant/SKILL.md +7 -1
- package/skills/scalability-clean-code/SKILL.md +7 -1
- package/skills/search-engine-expert/SKILL.md +89 -0
- package/skills/secure-fuzz-testing/SKILL.md +7 -1
- package/skills/self-healing-cloud-orchestrator/SKILL.md +57 -57
- package/skills/senior-frontend/SKILL.md +139 -161
- package/skills/senior-frontend/scripts/frontend_scaffolder.py +1 -1
- package/skills/seo/SKILL.md +41 -17
- package/skills/session-memory-manager/SKILL.md +128 -0
- package/skills/solidjs-expert/SKILL.md +80 -0
- package/skills/spa-orchestrator/SKILL.md +20 -1
- package/skills/sse-websocket-streaming-expert/SKILL.md +93 -0
- package/skills/state-management-expert/SKILL.md +7 -1
- package/skills/supabase-security-expert/SKILL.md +7 -1
- package/skills/svelte-sveltekit-expert/SKILL.md +91 -0
- package/skills/svg-animation-motion-expert/SKILL.md +115 -0
- package/skills/synthetic-data-finetuning-expert/SKILL.md +155 -0
- package/skills/tailwind-expert/SKILL.md +88 -136
- package/skills/tanstack-query-expert/SKILL.md +7 -1
- package/skills/tauri-expert/SKILL.md +7 -1
- package/skills/typescript-expert/SKILL.md +12 -6
- package/skills/ui-ux-pro-max/SKILL.md +25 -3
- package/skills/vector-db-rag-expert/SKILL.md +175 -19
- package/skills/vercel-ai-sdk-expert/SKILL.md +181 -0
- package/skills/visual-qa-vision-agent/SKILL.md +70 -64
- package/skills/voice-ai-realtime-agent/SKILL.md +242 -0
- package/skills/vue-frontend-expert/SKILL.md +131 -125
- package/skills/wasm-edge-computing-expert/SKILL.md +97 -0
- package/skills/web-3d-graphics-expert/SKILL.md +262 -80
- package/skills/web-game-engine-expert/SKILL.md +281 -48
- package/skills/web-scraper/SKILL.md +157 -207
- package/skills/website-design-cloner/SKILL.md +179 -173
- package/skills/webxr-ar-vr-expert/SKILL.md +108 -63
- package/skills/wordpress-headless-expert/SKILL.md +144 -0
- package/skills/zero-to-prod-orchestrator/SKILL.md +65 -38
- package/skills/zero-trust-secret-vault/SKILL.md +87 -39
- package/.github/ISSUE_TEMPLATE/feature_request.md +0 -20
- package/.github/workflows/publish.yml +0 -20
- package/CONTRIBUTING.md +0 -199
- package/SECURITY.md +0 -21
- package/banner.png +0 -0
- package/skills/ai-cost-token-optimizer/SKILL.md +0 -52
- package/skills/asisten_ramah/SKILL.md +0 -41
- package/skills/auto-doc-updater/SKILL.md +0 -214
- package/skills/autonomous-chaos-monkey/SKILL.md +0 -63
- package/skills/autonomous-swarm-director/SKILL.md +0 -69
- package/skills/edge-serverless-db-expert/SKILL.md +0 -43
- package/skills/hyper-context-synthesizer/SKILL.md +0 -55
- package/skills/llm-cost-arbitrage-router/SKILL.md +0 -59
- package/skills/mcp-client-orchestrator/SKILL.md +0 -70
- package/skills/mobile-push-notification-expert/SKILL.md +0 -51
- package/skills/monday-design-aesthetic/SKILL.md +0 -67
- package/skills/project-context-mapper/SKILL.md +0 -79
- package/skills/saas-mvp-launcher/SKILL.md +0 -241
- package/skills/saas-transformer/SKILL.md +0 -489
- package/skills/saas-transformer/references/billing_integration_guide.md +0 -401
- package/skills/self-evolving-memory-graph/SKILL.md +0 -75
- package/skills/senior-fullstack/SKILL.md +0 -167
- package/skills/senior-fullstack/references/architecture_patterns.md +0 -160
- package/skills/senior-fullstack/references/development_workflows.md +0 -222
- package/skills/senior-fullstack/references/tech_stack_guide.md +0 -190
- package/skills/senior-fullstack/scripts/code_quality_analyzer.py +0 -114
- package/skills/senior-fullstack/scripts/fullstack_scaffolder.py +0 -114
- package/skills/senior-fullstack/scripts/project_scaffolder.py +0 -114
- package/skills/seo-aeo-landing-page-writer/SKILL.md +0 -97
- package/skills/seo-geo/SKILL.md +0 -188
- package/skills/session-context-loader/SKILL.md +0 -77
- package/skills/session-handoff-resume/SKILL.md +0 -158
- package/skills/skill_baru/SKILL.md +0 -172
- package/skills/supabase-migration/SKILL.md +0 -45
- package/skills/token-saver/SKILL.md +0 -119
- package/skills/ui-components-expert/SKILL.md +0 -280
- package/skills/ui-ux-pro-max/scripts/__pycache__/core.cpython-310.pyc +0 -0
- package/skills/ui-ux-pro-max/scripts/__pycache__/core.cpython-312.pyc +0 -0
- package/skills/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-310.pyc +0 -0
- package/skills/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-312.pyc +0 -0
- package/skills/ui_ux_expert/SKILL.md +0 -125
- package/skills/vibe-code-gardener/SKILL.md +0 -181
- package/vibes-swarm-demo.gif +0 -0
- /package/skills/{saas-transformer → saas-architect}/references/feature_gating_patterns.md +0 -0
- /package/skills/{saas-transformer → saas-architect}/references/saas_transformation_checklist.md +0 -0
- /package/skills/{saas-transformer → saas-architect}/scripts/saas_transformation_scanner.py +0 -0
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: synthetic-data-finetuning-expert
|
|
3
|
+
description: "Expert guide for synthetic dataset generation, LLM-as-a-judge filtering, QLoRA fine-tuning (Unsloth), DPO alignment, and GGUF/Ollama export for local SLMs / Panduan ahli generasi data sintetis, fine-tuning QLoRA, DPO, dan ekspor GGUF/Ollama."
|
|
4
|
+
author: vibes-plug-swarm
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Synthetic Data & Fine-Tuning Expert (Custom Domain SLMs)
|
|
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 domain skills like `local-slm-edge-ai-expert`, `ai-prompt-engineering-expert`, `ai-evals-benchmark-expert`, `python-programming-expert`, and `ai-cost-token-optimizer` to build high-performance, cost-effective domain models.
|
|
18
|
+
|
|
19
|
+
### Description
|
|
20
|
+
Production-grade guide for generating synthetic training datasets, curating high-signal instruction pairs, executing Parameter-Efficient Fine-Tuning (QLoRA / LoRA) with **Unsloth** and Hugging Face TRL, performing Direct Preference Optimization (DPO), and quantizing custom Small Language Models (SLMs) to GGUF for edge or on-premise execution.
|
|
21
|
+
|
|
22
|
+
**Swarm Synergy:** Within the **AI Engineering Swarm**, this skill serves as the Model Specialization Lead. When frontier API costs or latency become prohibitive, it trains, aligns, and deploys hyper-efficient domain SLMs (1B–8B parameters) in Phase 4.
|
|
23
|
+
|
|
24
|
+
### Trigger Conditions
|
|
25
|
+
- Generating domain-specific synthetic training data from seed documents, codebases, or APIs.
|
|
26
|
+
- Filtering low-quality or hallucinated synthetic data using LLM-as-a-judge curation pipelines.
|
|
27
|
+
- Fine-tuning open-weights models (Llama 3.3, Qwen 2.5, Mistral) on custom tasks using 4-bit QLoRA.
|
|
28
|
+
- Aligning model outputs using Direct Preference Optimization (DPO) to enforce specific response styles.
|
|
29
|
+
- Quantizing fine-tuned models to GGUF (q4_k_m, q8_0) for zero-latency local inference with Ollama or llama.cpp.
|
|
30
|
+
|
|
31
|
+
### Synthetic Data & Fine-Tuning Lifecycle
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
1. SEED EXTRACTION & SYNTHESIS
|
|
35
|
+
[Raw Docs / Codebase] ──► [Frontier LLM / Distilabel] ──► Raw Instruction Pairs (10k+)
|
|
36
|
+
|
|
37
|
+
2. QUALITY FILTERING (LLM-AS-A-JUDGE)
|
|
38
|
+
Raw Instruction Pairs ──► [Rubric Scorer / De-duplication] ──► Curated Gold Dataset (2k-5k)
|
|
39
|
+
|
|
40
|
+
3. 4-BIT QLORA FINE-TUNING (UNSLOTH)
|
|
41
|
+
Base Model (e.g. Qwen 2.5-Coder) + LoRA Adapters ──► SFT / DPO Training Loop
|
|
42
|
+
|
|
43
|
+
4. QUANTIZATION & LOCAL DEPLOYMENT
|
|
44
|
+
Merged 16-bit Weights ──► [llama.cpp GGUF Export] ──► Local Ollama Service (<50ms latency)
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Core Implementation Guidelines
|
|
48
|
+
|
|
49
|
+
#### 1. Synthetic Instruction Generation & Rejection Sampling
|
|
50
|
+
Use frontier models to generate input-output pairs with strict rejection criteria:
|
|
51
|
+
```python
|
|
52
|
+
from pydantic import BaseModel, Field
|
|
53
|
+
from openai import OpenAI
|
|
54
|
+
import json
|
|
55
|
+
|
|
56
|
+
client = OpenAI()
|
|
57
|
+
|
|
58
|
+
class SyntheticInstructionPair(BaseModel):
|
|
59
|
+
user_instruction: str = Field(description="Realistic developer query")
|
|
60
|
+
input_context: str = Field(description="Code snippet or API contract")
|
|
61
|
+
ground_truth_response: str = Field(description="Flawless, production-grade output")
|
|
62
|
+
quality_score: int = Field(ge=1, le=5, description="Self-evaluated quality score")
|
|
63
|
+
|
|
64
|
+
def generate_synthetic_samples(seed_text: str) -> list[SyntheticInstructionPair]:
|
|
65
|
+
response = client.beta.chat.completions.parse(
|
|
66
|
+
model="gpt-4o-mini",
|
|
67
|
+
messages=[
|
|
68
|
+
{"role": "system", "content": "Generate 5 diverse, hard edge-case instruction pairs based on the seed code."},
|
|
69
|
+
{"role": "user", "content": seed_text}
|
|
70
|
+
],
|
|
71
|
+
response_format=SyntheticInstructionPair,
|
|
72
|
+
)
|
|
73
|
+
# Filter out anything below score 4 (Rejection Sampling)
|
|
74
|
+
return [sample for sample in [response.choices[0].message.parsed] if sample.quality_score >= 4]
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
#### 2. High-Speed 4-Bit QLoRA with Unsloth
|
|
78
|
+
Fine-tune on consumer GPUs (e.g., RTX 3090/4090 or single A10G) with 5x faster throughput:
|
|
79
|
+
```python
|
|
80
|
+
from unsloth import FastLanguageModel
|
|
81
|
+
import torch
|
|
82
|
+
from trl import SFTTrainer
|
|
83
|
+
from transformers import TrainingArguments
|
|
84
|
+
|
|
85
|
+
# 1. Load Model & Tokenizer in 4-bit
|
|
86
|
+
max_seq_length = 2048
|
|
87
|
+
model, tokenizer = FastLanguageModel.from_pretrained(
|
|
88
|
+
model_name="unsloth/Qwen2.5-Coder-7B-Instruct-bnb-4bit",
|
|
89
|
+
max_seq_length=max_seq_length,
|
|
90
|
+
load_in_4bit=True,
|
|
91
|
+
)
|
|
92
|
+
|
|
93
|
+
# 2. Add LoRA Adapters
|
|
94
|
+
model = FastLanguageModel.get_peft_model(
|
|
95
|
+
model,
|
|
96
|
+
r=16,
|
|
97
|
+
target_modules=["q_proj", "k_proj", "v_proj", "o_proj", "gate_proj", "up_proj", "down_proj"],
|
|
98
|
+
lora_alpha=16,
|
|
99
|
+
lora_dropout=0, # Optimized 0 dropout for Unsloth
|
|
100
|
+
bias="none",
|
|
101
|
+
)
|
|
102
|
+
|
|
103
|
+
# 3. Supervised Fine-Tuning (SFT)
|
|
104
|
+
trainer = SFTTrainer(
|
|
105
|
+
model=model,
|
|
106
|
+
tokenizer=tokenizer,
|
|
107
|
+
train_dataset=dataset,
|
|
108
|
+
dataset_text_field="text",
|
|
109
|
+
max_seq_length=max_seq_length,
|
|
110
|
+
args=TrainingArguments(
|
|
111
|
+
per_device_train_batch_size=2,
|
|
112
|
+
gradient_accumulation_steps=4,
|
|
113
|
+
warmup_steps=10,
|
|
114
|
+
max_steps=100,
|
|
115
|
+
learning_rate=2e-4,
|
|
116
|
+
fp16=not torch.cuda.is_bf16_supported(),
|
|
117
|
+
bf16=torch.cuda.is_bf16_supported(),
|
|
118
|
+
logging_steps=1,
|
|
119
|
+
output_dir="outputs",
|
|
120
|
+
),
|
|
121
|
+
)
|
|
122
|
+
trainer.train()
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
#### 3. GGUF Export for Local Ollama Deployment
|
|
126
|
+
Export merged model to 4-bit or 8-bit quantized GGUF format:
|
|
127
|
+
```python
|
|
128
|
+
# Save to 16bit or GGUF directly
|
|
129
|
+
model.save_pretrained_gguf("custom-domain-coder", tokenizer, quantization_method="q4_k_m")
|
|
130
|
+
|
|
131
|
+
# Generate Modelfile for Ollama:
|
|
132
|
+
# FROM ./custom-domain-coder-q4_k_m.gguf
|
|
133
|
+
# PARAMETER temperature 0.2
|
|
134
|
+
# SYSTEM You are an expert domain coder.
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
<a name="bahasa-indonesia"></a>
|
|
140
|
+
## Bahasa Indonesia
|
|
141
|
+
|
|
142
|
+
### Integrasi Orkestrasi
|
|
143
|
+
Terhubung dan mengorkestrasi skill domain yang relevan seperti `local-slm-edge-ai-expert`, `ai-prompt-engineering-expert`, `ai-evals-benchmark-expert`, `python-programming-expert`, dan `ai-cost-token-optimizer` untuk membangun model spesialis domain dengan performa tinggi dan biaya hemat.
|
|
144
|
+
|
|
145
|
+
### Deskripsi
|
|
146
|
+
Panduan produksi untuk menghasilkan dataset pelatihan sintetis, mengurasi pasangan instruksi bernilai tinggi, mengeksekusi Parameter-Efficient Fine-Tuning (QLoRA / LoRA) dengan **Unsloth** dan Hugging Face TRL, menerapkan Direct Preference Optimization (DPO), dan mengkuantisasi Small Language Models (SLM) kustom ke format GGUF untuk inferensi lokal atau on-premise berlatensi ultra-rendah.
|
|
147
|
+
|
|
148
|
+
**Sinergi Swarm:** Di dalam **AI Engineering Swarm**, skill ini memegang peranan sebagai Pemimpin Spesialisasi Model. Ketika biaya API atau latensi model cloud frontier terlalu tinggi, skill ini melatih, menyelaraskan (*align*), dan men-deploy SLM domain yang sangat efisien (1B–8B parameter) pada Fase 4.
|
|
149
|
+
|
|
150
|
+
### Kondisi Pemicu
|
|
151
|
+
- Menghasilkan data pelatihan sintetis spesifik domain dari dokumen panduan, codebase, atau skema API.
|
|
152
|
+
- Menyaring data sintetis berkualitas rendah menggunakan pipeline penilaian otomatis *LLM-as-a-judge*.
|
|
153
|
+
- Melakukan fine-tuning model berbobot terbuka (Llama 3.3, Qwen 2.5, Mistral) dengan QLoRA 4-bit secara hemat memori VRAM.
|
|
154
|
+
- Menyelaraskan respon model dengan Direct Preference Optimization (DPO) agar mematuhi aturan format dan gaya tertentu.
|
|
155
|
+
- Mengkuantisasi model hasil fine-tuning ke format GGUF (q4_k_m, q8_0) untuk inferensi lokal instan di Ollama atau llama.cpp.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: tailwind-expert
|
|
3
|
-
description: "
|
|
4
|
-
author: "Roedy Rustam"
|
|
3
|
+
description: "Expert guide for Tailwind CSS v4, CSS-first configuration, @theme customization, and modern responsive design / Panduan ahli untuk Tailwind CSS v4, konfigurasi CSS-first, kustomisasi @theme, dan desain responsif modern."
|
|
4
|
+
author: "Roedy Rustam"
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Tailwind CSS Expert (v4 Edition)
|
|
@@ -14,134 +14,66 @@ author: "Roedy Rustam"
|
|
|
14
14
|
## English
|
|
15
15
|
|
|
16
16
|
### Description
|
|
17
|
-
|
|
17
|
+
Strict guidelines and best practices for Tailwind CSS v4. Enforces the CSS-first configuration model, `@theme` token definitions, dynamic utilities, and performance optimization via Lightning CSS.
|
|
18
18
|
|
|
19
19
|
### Trigger Conditions
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
- Registering custom plugins with `@plugin` directive.
|
|
20
|
+
- Scaffold or configure a Tailwind CSS v4 project.
|
|
21
|
+
- Migrate a codebase from Tailwind CSS v3 to v4.
|
|
22
|
+
- Implement design tokens via `@theme`.
|
|
23
|
+
- Apply 3D transforms, CSS container queries, or `field-sizing`.
|
|
25
24
|
|
|
26
|
-
|
|
25
|
+
## Orchestration & Integration
|
|
26
|
+
Integrates tightly with the following skills:
|
|
27
|
+
- **`senior-frontend`**: Feeds modern CSS capabilities into Next.js/React component architecture.
|
|
28
|
+
- **`ui-components-expert`**: Provides the styling primitives for Radix/shadcn-style components.
|
|
29
|
+
- **`design-system-architect`**: Establishes the core tokens mapped inside `@theme`.
|
|
27
30
|
|
|
28
|
-
|
|
31
|
+
### Execution Standards
|
|
32
|
+
|
|
33
|
+
#### 1. CSS-First Architecture
|
|
34
|
+
Do NOT create `tailwind.config.js`. Define all configuration inside CSS using the `@theme` directive.
|
|
29
35
|
|
|
30
36
|
```css
|
|
31
37
|
/* app/globals.css */
|
|
32
38
|
@import "tailwindcss";
|
|
33
39
|
|
|
34
|
-
/* Design tokens — replaces tailwind.config.js theme */
|
|
35
40
|
@theme {
|
|
36
|
-
/* Colors
|
|
41
|
+
/* OKLCH Colors for wide-gamut displays */
|
|
37
42
|
--color-brand-50: oklch(97% 0.02 250);
|
|
38
43
|
--color-brand-500: oklch(55% 0.2 250);
|
|
39
|
-
--color-brand-900: oklch(20% 0.1 250);
|
|
40
44
|
|
|
41
45
|
/* Typography */
|
|
42
|
-
--font-sans: "Inter Variable",
|
|
43
|
-
--font-mono: "JetBrains Mono", "Fira Code", ui-monospace;
|
|
44
|
-
|
|
45
|
-
/* Spacing & Sizing */
|
|
46
|
-
--spacing-18: 4.5rem;
|
|
47
|
-
--spacing-112: 28rem;
|
|
46
|
+
--font-sans: "Inter Variable", system-ui, sans-serif;
|
|
48
47
|
|
|
49
|
-
/* Custom
|
|
50
|
-
--animate-slide-in: slide-in 0.3s ease-out;
|
|
51
|
-
--animate-fade-up: fade-up 0.4s ease-out;
|
|
52
|
-
|
|
53
|
-
/* Breakpoints */
|
|
48
|
+
/* Custom breakpoints */
|
|
54
49
|
--breakpoint-3xl: 112rem;
|
|
55
50
|
}
|
|
56
51
|
|
|
57
|
-
/* Register plugins
|
|
52
|
+
/* Register plugins */
|
|
58
53
|
@plugin "@tailwindcss/typography";
|
|
59
|
-
@plugin "@tailwindcss/forms";
|
|
60
|
-
@plugin "./plugins/animations.js";
|
|
61
|
-
|
|
62
|
-
/* Custom keyframes */
|
|
63
|
-
@keyframes slide-in {
|
|
64
|
-
from { transform: translateX(-100%); opacity: 0; }
|
|
65
|
-
to { transform: translateX(0); opacity: 1; }
|
|
66
|
-
}
|
|
67
|
-
@keyframes fade-up {
|
|
68
|
-
from { transform: translateY(16px); opacity: 0; }
|
|
69
|
-
to { transform: translateY(0); opacity: 1; }
|
|
70
|
-
}
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
### New Utilities in Tailwind v4
|
|
74
|
-
|
|
75
|
-
#### 3D Transforms
|
|
76
|
-
```html
|
|
77
|
-
<!-- 3D perspective and rotation -->
|
|
78
|
-
<div class="perspective-1000">
|
|
79
|
-
<div class="rotate-x-12 rotate-y-6 transform-3d hover:rotate-y-0 transition-transform duration-500">
|
|
80
|
-
Card content
|
|
81
|
-
</div>
|
|
82
|
-
</div>
|
|
83
|
-
|
|
84
|
-
<!-- perspective-{value}: sets perspective on parent -->
|
|
85
|
-
<!-- rotate-x-{deg}, rotate-y-{deg}: 3D rotation -->
|
|
86
|
-
<!-- transform-3d: enables 3D transform context -->
|
|
87
|
-
<!-- backface-visible, backface-hidden: card flip effects -->
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
#### Color Mix & Relative Colors
|
|
91
|
-
```html
|
|
92
|
-
<!-- Mix colors at the utility level -->
|
|
93
|
-
<div class="bg-brand-500/50"> <!-- 50% opacity -->
|
|
94
|
-
<div class="text-[color-mix(in_oklch,blue_70%,white)]"> <!-- CSS color-mix -->
|
|
95
|
-
<div class="border-brand-500 hover:border-brand-700">
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
#### Container Queries
|
|
99
|
-
```html
|
|
100
|
-
<!-- Responsive to parent container size, not viewport -->
|
|
101
|
-
<div class="@container">
|
|
102
|
-
<div class="@sm:grid-cols-2 @lg:grid-cols-3 grid grid-cols-1">
|
|
103
|
-
<!-- Adapts to container width, not screen width -->
|
|
104
|
-
</div>
|
|
105
|
-
</div>
|
|
106
|
-
```
|
|
107
|
-
|
|
108
|
-
#### `field-sizing` for Auto-Resizing Textareas
|
|
109
|
-
```html
|
|
110
|
-
<textarea class="field-sizing-content resize-none min-h-20 max-h-64">
|
|
111
|
-
Auto-resizes to fit content — no JavaScript needed!
|
|
112
|
-
</textarea>
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
### Migration from v3 to v4
|
|
116
|
-
|
|
117
|
-
#### Automated Migration Tool
|
|
118
|
-
```bash
|
|
119
|
-
npx @tailwindcss/upgrade
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
#### Key Breaking Changes
|
|
123
|
-
| v3 | v4 Equivalent |
|
|
124
|
-
|---|---|
|
|
125
|
-
| `tailwind.config.js` | `@theme {}` in CSS |
|
|
126
|
-
| `theme.extend.colors` | `--color-*` CSS vars in `@theme` |
|
|
127
|
-
| `plugins: [require('@tailwindcss/typography')]` | `@plugin "@tailwindcss/typography"` |
|
|
128
|
-
| `darkMode: 'class'` | `@variant dark (&:where(.dark, .dark *))` |
|
|
129
|
-
| `screens` in config | `--breakpoint-*` in `@theme` |
|
|
130
|
-
| `content` array | Auto-detected (no config needed) |
|
|
131
|
-
|
|
132
|
-
#### Custom Variants in v4
|
|
133
|
-
```css
|
|
134
|
-
/* Custom variants — replaces addVariant() in plugins */
|
|
135
|
-
@variant hocus (&:hover, &:focus);
|
|
136
|
-
@variant dark (&:where(.dark, .dark *));
|
|
137
|
-
@variant reduced-motion (@media (prefers-reduced-motion: reduce));
|
|
138
54
|
```
|
|
139
55
|
|
|
140
|
-
|
|
141
|
-
-
|
|
142
|
-
-
|
|
143
|
-
-
|
|
144
|
-
-
|
|
56
|
+
#### 2. Advanced Utilities
|
|
57
|
+
Utilize v4-native features instead of custom CSS where possible:
|
|
58
|
+
- **3D Transforms**: Use `perspective-1000`, `rotate-x-12`, `transform-3d`, `backface-hidden`.
|
|
59
|
+
- **Color Mix**: Use inline mixing: `text-[color-mix(in_oklch,blue_70%,white)]`.
|
|
60
|
+
- **Container Queries**: Use `@container` on the parent, `@sm:grid-cols-2` on children.
|
|
61
|
+
- **Auto-sizing**: Use `field-sizing-content` for dynamically sizing textareas.
|
|
62
|
+
|
|
63
|
+
#### 3. Migration (v3 to v4)
|
|
64
|
+
When upgrading older codebases:
|
|
65
|
+
1. Run `npx @tailwindcss/upgrade` automatically.
|
|
66
|
+
2. Manually verify `tailwind.config.js` logic is perfectly translated to `@theme` CSS variables.
|
|
67
|
+
3. Replace deprecated `addVariant` plugin code with `@variant` CSS directives:
|
|
68
|
+
```css
|
|
69
|
+
@variant hocus (&:hover, &:focus);
|
|
70
|
+
@variant dark (&:where(.dark, .dark *));
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
#### 4. Performance Directives
|
|
74
|
+
- **Zero Configuration**: Rely on v4's automatic content detection. Do not manually specify content paths.
|
|
75
|
+
- **Specificity**: Use `@layer utilities` strictly when custom CSS requires Tailwind's specificity tier.
|
|
76
|
+
- **No `@apply` Abuse**: Avoid `@apply` in loops or highly repeated components; use HTML utility classes to leverage Lightning CSS tree-shaking.
|
|
145
77
|
|
|
146
78
|
---
|
|
147
79
|
|
|
@@ -149,40 +81,60 @@ npx @tailwindcss/upgrade
|
|
|
149
81
|
## Bahasa Indonesia
|
|
150
82
|
|
|
151
83
|
### Deskripsi
|
|
152
|
-
Panduan
|
|
84
|
+
Panduan ketat dan praktik terbaik untuk Tailwind CSS v4. Memaksa penggunaan model konfigurasi CSS-first, definisi token `@theme`, utilitas dinamis, dan optimasi performa melalui Lightning CSS.
|
|
153
85
|
|
|
154
86
|
### Kondisi Pemicu
|
|
155
|
-
- Menyiapkan atau mengonfigurasi proyek Tailwind CSS v4
|
|
156
|
-
-
|
|
157
|
-
-
|
|
158
|
-
- Menggunakan
|
|
159
|
-
- Mendaftarkan plugin kustom dengan direktif `@plugin`.
|
|
160
|
-
|
|
161
|
-
### Tailwind v4 — Pergeseran Paradigma CSS-First
|
|
87
|
+
- Menyiapkan atau mengonfigurasi proyek Tailwind CSS v4.
|
|
88
|
+
- Migrasi codebase dari Tailwind CSS v3 ke v4.
|
|
89
|
+
- Implementasi design token via `@theme`.
|
|
90
|
+
- Menggunakan 3D transform, container query, atau `field-sizing`.
|
|
162
91
|
|
|
163
|
-
|
|
92
|
+
## Integrasi Orkestrasi
|
|
93
|
+
Terintegrasi erat dengan skill berikut:
|
|
94
|
+
- **`senior-frontend`**: Menyuplai kapabilitas CSS modern ke dalam arsitektur komponen Next.js/React.
|
|
95
|
+
- **`ui-components-expert`**: Menyediakan primitif styling untuk komponen gaya Radix/shadcn.
|
|
96
|
+
- **`design-system-architect`**: Membangun token utama yang dipetakan di dalam `@theme`.
|
|
164
97
|
|
|
165
|
-
###
|
|
98
|
+
### Standar Eksekusi
|
|
166
99
|
|
|
167
|
-
####
|
|
168
|
-
|
|
100
|
+
#### 1. Arsitektur CSS-First
|
|
101
|
+
JANGAN membuat `tailwind.config.js`. Definisikan semua konfigurasi di dalam CSS menggunakan direktif `@theme`.
|
|
169
102
|
|
|
170
|
-
|
|
171
|
-
|
|
103
|
+
```css
|
|
104
|
+
/* app/globals.css */
|
|
105
|
+
@import "tailwindcss";
|
|
172
106
|
|
|
173
|
-
|
|
174
|
-
|
|
107
|
+
@theme {
|
|
108
|
+
/* Warna OKLCH untuk layar wide-gamut */
|
|
109
|
+
--color-brand-50: oklch(97% 0.02 250);
|
|
110
|
+
--color-brand-500: oklch(55% 0.2 250);
|
|
175
111
|
|
|
176
|
-
|
|
112
|
+
/* Tipografi */
|
|
113
|
+
--font-sans: "Inter Variable", system-ui, sans-serif;
|
|
114
|
+
}
|
|
177
115
|
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
- `darkMode: 'class'` → `@variant dark`
|
|
182
|
-
- Array `content` → Deteksi otomatis (tidak perlu konfigurasi)
|
|
116
|
+
/* Registrasi plugin */
|
|
117
|
+
@plugin "@tailwindcss/typography";
|
|
118
|
+
```
|
|
183
119
|
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
-
|
|
187
|
-
- Gunakan
|
|
188
|
-
-
|
|
120
|
+
#### 2. Utilitas Lanjutan
|
|
121
|
+
Gunakan fitur bawaan v4 alih-alih CSS kustom:
|
|
122
|
+
- **3D Transform**: Gunakan `perspective-1000`, `rotate-x-12`, `transform-3d`, `backface-hidden`.
|
|
123
|
+
- **Color Mix**: Gunakan `text-[color-mix(in_oklch,blue_70%,white)]`.
|
|
124
|
+
- **Container Queries**: Gunakan `@container` pada induk, `@sm:grid-cols-2` pada anak.
|
|
125
|
+
- **Auto-sizing**: Gunakan `field-sizing-content` untuk textarea agar ukurannya otomatis menyesuaikan.
|
|
126
|
+
|
|
127
|
+
#### 3. Migrasi (v3 ke v4)
|
|
128
|
+
Saat memperbarui codebase lama:
|
|
129
|
+
1. Jalankan `npx @tailwindcss/upgrade` secara otomatis.
|
|
130
|
+
2. Verifikasi manual logika `tailwind.config.js` agar diterjemahkan sempurna ke variabel CSS `@theme`.
|
|
131
|
+
3. Ganti plugin `addVariant` lama dengan direktif CSS `@variant`:
|
|
132
|
+
```css
|
|
133
|
+
@variant hocus (&:hover, &:focus);
|
|
134
|
+
@variant dark (&:where(.dark, .dark *));
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
#### 4. Arahan Performa
|
|
138
|
+
- **Konfigurasi Nol**: Andalkan deteksi konten otomatis v4. Jangan tentukan path konten secara manual.
|
|
139
|
+
- **Spesifisitas**: Gunakan `@layer utilities` secara ketat hanya jika CSS kustom memerlukan tingkat spesifisitas Tailwind.
|
|
140
|
+
- **Dilarang Menyalahgunakan `@apply`**: Hindari `@apply` pada loop atau komponen berulang; gunakan kelas utilitas di HTML untuk memaksimalkan tree-shaking Lightning CSS.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: tanstack-query-expert
|
|
3
3
|
description: "Advanced TanStack Query (v5) expert. Covers useSuspenseQuery, infinite scrolling, optimistic mutations, SSR/React Server Components hydration, and advanced cache invalidation / Pakar manajemen state asinkron menggunakan TanStack Query (React Query) v5 dan Next.js App Router (SSR)."
|
|
4
|
-
author: "Roedy Rustam"
|
|
4
|
+
author: "Roedy Rustam"
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# TanStack Query Expert (v5 + TanStack Router/Start Edition)
|
|
@@ -13,6 +13,9 @@ author: "Roedy Rustam"
|
|
|
13
13
|
<a name="english"></a>
|
|
14
14
|
## English
|
|
15
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
|
+
|
|
16
19
|
### Description
|
|
17
20
|
Production-grade TanStack Query (v5) mastery for modern React (v18/19) and Next.js (App Router) applications. Covers declarative data fetching, advanced cache invalidation, optimistic UI updates, Suspense boundaries, SSR hydration, and the new **TanStack Router** + **TanStack Start** ecosystem for full-stack type-safe applications.
|
|
18
21
|
|
|
@@ -151,6 +154,9 @@ export default async function UsersPage() {
|
|
|
151
154
|
<a name="bahasa-indonesia"></a>
|
|
152
155
|
## Bahasa Indonesia
|
|
153
156
|
|
|
157
|
+
### Integrasi Orkestrasi
|
|
158
|
+
Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
|
|
159
|
+
|
|
154
160
|
### Deskripsi
|
|
155
161
|
Penguasaan TanStack Query (v5) tingkat produksi untuk aplikasi React modern (v18/19) dan Next.js (App Router). Mencakup data fetching deklaratif, invalidasi cache lanjutan, optimistic UI, Suspense boundaries, hidrasi SSR, serta ekosistem **TanStack Router** + **TanStack Start** untuk aplikasi full-stack yang type-safe.
|
|
156
162
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: tauri-expert
|
|
3
3
|
description: "Expert skill for Tauri (v2) development, Rust backend, IPC, and security / Panduan ahli untuk pengembangan Tauri v2, Rust backend, IPC, dan keamanan."
|
|
4
|
-
author: "Roedy Rustam"
|
|
4
|
+
author: "Roedy Rustam"
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Tauri Expert
|
|
@@ -13,6 +13,9 @@ author: "Roedy Rustam"
|
|
|
13
13
|
<a name="english"></a>
|
|
14
14
|
## English
|
|
15
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
|
+
|
|
16
19
|
### Description
|
|
17
20
|
This skill provides best practice guidance for building cross-platform desktop and mobile applications using Tauri (specifically Tauri v2). It covers frontend integration with the Rust backend, Inter-Process Communication (IPC), state management, and security.
|
|
18
21
|
|
|
@@ -57,6 +60,9 @@ Active when:
|
|
|
57
60
|
<a name="bahasa-indonesia"></a>
|
|
58
61
|
## Bahasa Indonesia
|
|
59
62
|
|
|
63
|
+
### Integrasi Orkestrasi
|
|
64
|
+
Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
|
|
65
|
+
|
|
60
66
|
### Deskripsi
|
|
61
67
|
Skill ini memberikan panduan praktik terbaik (best practices) untuk membangun aplikasi desktop dan mobile lintas platform menggunakan Tauri (terutama Tauri v2). Skill ini mencakup integrasi frontend dengan backend Rust, Inter-Process Communication (IPC), manajemen state, serta keamanan.
|
|
62
68
|
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: typescript-expert
|
|
3
|
-
description: "Expert guide for TypeScript 5.
|
|
4
|
-
author: "Roedy Rustam"
|
|
3
|
+
description: "Expert guide for TypeScript 5.8+ advanced type system, strict mode, generics, utility types, branded types, inferred type predicates, isolated declarations, and type-safe architectural patterns / Panduan ahli untuk sistem tipe TypeScript 5.8+, mode strict, generics, utility types, branded types, inferred type predicates, isolated declarations, dan pola arsitektur type-safe."
|
|
4
|
+
author: "Roedy Rustam"
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
# TypeScript Expert (TypeScript 5.
|
|
7
|
+
# TypeScript Expert (TypeScript 5.8+ Edition)
|
|
8
8
|
|
|
9
9
|
[English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
|
|
10
10
|
|
|
@@ -13,8 +13,11 @@ author: "Roedy Rustam"
|
|
|
13
13
|
<a name="english"></a>
|
|
14
14
|
## English
|
|
15
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
|
+
|
|
16
19
|
### Description
|
|
17
|
-
Expert-level TypeScript development covering the advanced type system, strict mode enforcement, generic programming, utility types, branded types, and type-safe patterns for production applications. Targets **TypeScript 5.
|
|
20
|
+
Expert-level TypeScript development covering the advanced type system, strict mode enforcement, generic programming, utility types, branded types, and type-safe patterns for production applications. Targets **TypeScript 5.8+** features including inferred type predicates, isolated declarations, `NoInfer`, `using` declarations, variadic tuple improvements, and `const` type parameters.
|
|
18
21
|
|
|
19
22
|
### Trigger Conditions
|
|
20
23
|
- Writing TypeScript with advanced generic constraints.
|
|
@@ -66,7 +69,7 @@ const b = identity({ x: 10 }); // type: { readonly x: 10 }
|
|
|
66
69
|
|
|
67
70
|
---
|
|
68
71
|
|
|
69
|
-
### TypeScript 5.5
|
|
72
|
+
### TypeScript 5.5 - 5.8 — New Features
|
|
70
73
|
|
|
71
74
|
#### Inferred Type Predicates (TS 5.5)
|
|
72
75
|
```typescript
|
|
@@ -299,8 +302,11 @@ config.port.toFixed(2); // Works! Literal type preserved.
|
|
|
299
302
|
<a name="bahasa-indonesia"></a>
|
|
300
303
|
## Bahasa Indonesia
|
|
301
304
|
|
|
305
|
+
### Integrasi Orkestrasi
|
|
306
|
+
Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
|
|
307
|
+
|
|
302
308
|
### Deskripsi
|
|
303
|
-
Panduan TypeScript level ahli mencakup sistem tipe tingkat lanjut, penerapan strict mode, pemrograman generik, utility types, branded types, dan pola type-safe untuk aplikasi produksi. Menargetkan fitur **TypeScript 5.
|
|
309
|
+
Panduan TypeScript level ahli mencakup sistem tipe tingkat lanjut, penerapan strict mode, pemrograman generik, utility types, branded types, dan pola type-safe untuk aplikasi produksi. Menargetkan fitur **TypeScript 5.8+** termasuk inferred type predicates, isolated declarations, `NoInfer`, deklarasi `using`, peningkatan variadic tuple, dan parameter tipe `const`.
|
|
304
310
|
|
|
305
311
|
### Kondisi Pemicu
|
|
306
312
|
- Menulis TypeScript dengan generic constraints tingkat lanjut.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ui-ux-pro-max
|
|
3
3
|
description: "Comprehensive design guide & BM25 search engine for web and mobile applications across 11 tech stacks / Panduan desain komprehensif & mesin pencari BM25 untuk aplikasi web dan mobile di 11 tech stack."
|
|
4
|
-
author: "Roedy Rustam"
|
|
4
|
+
author: "Roedy Rustam"
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# UI/UX Pro Max - Design Intelligence System
|
|
@@ -13,8 +13,11 @@ author: "Roedy Rustam"
|
|
|
13
13
|
<a name="english"></a>
|
|
14
14
|
## English
|
|
15
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
|
+
|
|
16
19
|
### Description
|
|
17
|
-
UI/UX Pro Max is a comprehensive design intelligence engine equipped with an offline BM25 search index covering color palettes, typography, responsive patterns, icon sets, chart recommendations, UX guidelines, and stack-specific best practices across **11 technology stacks**.
|
|
20
|
+
UI/UX Pro Max is a comprehensive design intelligence engine equipped with an offline BM25 search index covering color palettes, typography, responsive patterns, icon sets, chart recommendations, UX guidelines, **Material Design 3 (M3)**, and stack-specific best practices across **11 technology stacks**.
|
|
18
21
|
|
|
19
22
|
### Trigger Conditions
|
|
20
23
|
Reference these guidelines or run the CLI search engine when:
|
|
@@ -55,6 +58,8 @@ python scripts/search.py "<query>" --domain <domain> --max-results 3
|
|
|
55
58
|
- `icons`: Icon usage guidance, SVG libraries (Lucide, Heroicons), and code imports
|
|
56
59
|
- `react`: React & Next.js performance optimizations, re-render fixes & dynamic imports
|
|
57
60
|
- `web`: Web interface guidelines (ARIA, focus traps, virtual list, form inputs)
|
|
61
|
+
- `m3`: Material Design 3 specific design tokens, color roles, elevation, and component specs
|
|
62
|
+
- `preset-monday`: Monday.com spacious SaaS aesthetic (Vibrant Blue `#0073ea`, Clean White `#FFFFFF` + Light Grays `#F9F9F9`/`#F5F6F8`, Dark Footer `#111111`, Figtree/Inter fonts, 12-16px card radius, 80-120px vertical spacing)
|
|
58
63
|
|
|
59
64
|
*Example:* `python scripts/search.py "fintech dark theme" --domain color`
|
|
60
65
|
|
|
@@ -92,6 +97,7 @@ python scripts/search.py "<query>" --stack <stack> --max-results 3
|
|
|
92
97
|
- **Dark Mode**: High contrast foreground elements over dark slate/gray backgrounds; avoid pure black `#000000` text containers unless requested.
|
|
93
98
|
|
|
94
99
|
#### 5. Dashboard & Information Hierarchy
|
|
100
|
+
- **Material Design 3 (M3) Integration**: Follow M3 Layouts (compact, medium, expanded). Use M3 elevation for layering instead of heavy borders.
|
|
95
101
|
- **Layout Flow**: KPI summary cards top -> Trend charts middle -> Detailed data tables bottom.
|
|
96
102
|
- **Visual Grid**: Consistent gaps/padding (16px / 24px). Clean subtle borders instead of heavy black dividers.
|
|
97
103
|
- **Data Viz**: Maximum 3–5 coordinated colors in graphs. Responsive tooltips and legend alignment.
|
|
@@ -110,8 +116,11 @@ python scripts/search.py "<query>" --stack <stack> --max-results 3
|
|
|
110
116
|
<a name="bahasa-indonesia"></a>
|
|
111
117
|
## Bahasa Indonesia
|
|
112
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
|
+
|
|
113
122
|
### Deskripsi
|
|
114
|
-
UI/UX Pro Max adalah mesin kecerdasan desain komprehensif yang dilengkapi indeks pencarian BM25 offline. Mencakup palet warna, tipografi, pola tata letak responsif, rekomendasi ikon, grafik visualisasi data, pedoman UX, serta praktik terbaik untuk **11 tumpukan teknologi (technology stacks)**.
|
|
123
|
+
UI/UX Pro Max adalah mesin kecerdasan desain komprehensif yang dilengkapi indeks pencarian BM25 offline. Mencakup palet warna, tipografi, pola tata letak responsif, rekomendasi ikon, grafik visualisasi data, pedoman UX, **Material Design 3 (M3)**, serta praktik terbaik untuk **11 tumpukan teknologi (technology stacks)**.
|
|
115
124
|
|
|
116
125
|
### Kondisi Pemicu
|
|
117
126
|
Gunakan pedoman ini atau jalankan mesin pencari CLI ketika:
|
|
@@ -151,6 +160,8 @@ python scripts/search.py "<kueri>" --domain <domain> --max-results 3
|
|
|
151
160
|
- `icons`: Panduan penggunaan ikon, pustaka SVG (Lucide, Heroicons), & import kode
|
|
152
161
|
- `react`: Optimasi performa React & Next.js, perbaikan re-render & dynamic import
|
|
153
162
|
- `web`: Pedoman antarmuka web (ARIA, focus trap, virtual list, input form)
|
|
163
|
+
- `m3`: Token desain spesifik Material Design 3, peran warna, elevasi, dan spesifikasi komponen
|
|
164
|
+
- `preset-monday`: Estetika SaaS lapang ala Monday.com (Biru Cerah `#0073ea`, Putih Bersih `#FFFFFF` + Abu-abu Terang `#F9F9F9`/`#F5F6F8`, Footer Gelap `#111111`, font Figtree/Inter, radius kartu 12-16px, jarak seksi vertikal 80-120px)
|
|
154
165
|
|
|
155
166
|
*Contoh:* `python scripts/search.py "fintech dark theme" --domain color`
|
|
156
167
|
|
|
@@ -188,6 +199,7 @@ python scripts/search.py "<kueri>" --stack <stack> --max-results 3
|
|
|
188
199
|
- **Mode Gelap**: Kontras tinggi antara elemen latar depan dengan latar belakang gelap; hindari kontainer teks serba hitam pekat `#000000` kecuali diminta khusus.
|
|
189
200
|
|
|
190
201
|
#### 5. Dashboard & Hierarki Informasi
|
|
202
|
+
- **Integrasi Material Design 3 (M3)**: Ikuti tata letak M3 (compact, medium, expanded). Gunakan elevasi M3 untuk pelapisan alih-alih border tebal.
|
|
191
203
|
- **Alur Tata Letak**: Kartu ringkasan KPI di atas -> Grafik tren di tengah -> Tabel detail data di bawah.
|
|
192
204
|
- **Grid Visual**: Konsistensi gap/padding (16px / 24px). Gunakan border halus daripada pembatas tebal hitam.
|
|
193
205
|
- **Visualisasi Data**: Maksimal 3–5 warna terkoordinasi dalam grafik. Tooltip responsif & perataan legenda yang rapi.
|
|
@@ -200,3 +212,13 @@ python scripts/search.py "<kueri>" --stack <stack> --max-results 3
|
|
|
200
212
|
- [ ] **Kontras**: Rasio kontras teks minimal 4.5:1 pada mode terang. Border terlihat di kedua mode (terang & gelap).
|
|
201
213
|
- [ ] **Tata Letak & Responsif**: Diuji pada breakpoint 375px, 768px, 1024px, 1440px. Tidak ada scroll horizontal tak disengaja pada perangkat mobile.
|
|
202
214
|
- [ ] **Aksesibilitas**: Semua gambar memiliki `alt` text yang bermakna. Form input memiliki `<label>` terhubung atau `aria-label`.
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
### 🎨 Automatic Visual Assets Generation Mandate (CRITICAL)
|
|
218
|
+
**MANDATORY**: Whenever you are building a new application, scaffolding a project, or finalizing the initial UI/UX, you MUST automatically use the `generate_image` tool to create a custom logo that perfectly matches the application's core concept and aesthetic.
|
|
219
|
+
This generated image MUST be explicitly used as:
|
|
220
|
+
1. The primary application logo (e.g., in the header/navbar).
|
|
221
|
+
2. The website favicon (`favicon.ico` or equivalent).
|
|
222
|
+
3. The Open Graph (OG) image for SEO metadata (`og:image`).
|
|
223
|
+
|
|
224
|
+
Do not use placeholders for these assets. Generate and integrate them automatically.
|