[English](README.md) · [العربية](README.ar.md) · [简体中文](README.zh.md) · [繁體中文](README.zh-TW.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · **हिन्दी** · [Bahasa Indonesia](README.id.md) · [Tiếng Việt](README.vi.md) · [ไทย](README.th.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Español](README.es.md) · [Português](README.pt-BR.md) · [Italiano](README.it.md) · [Русский](README.ru.md) · [Türkçe](README.tr.md)

# ux-skill — Claude Code, Cursor और हर दूसरे AI कोडिंग टूल के लिए डिज़ाइन इंटेलिजेंस इंजन

> **v3.1.0 स्टेबल — THE BRAIN.** AI कोडिंग के लिए सबसे मज़बूत UX प्लगइन। 12 क्वेरी-योग्य JSON मैनिफ़ेस्ट के साथ एक Python रीज़निंग कोर (84 शैलियाँ, 176 पैलेट, 70 टाइप पेयरिंग, 148 कंपोनेंट, 184 इंडस्ट्री, 35 चार्ट प्रकार, 57 मोशन प्रीसेट, 112 UX नियम, 152 एंटी-पैटर्न नियम, 25 टेक स्टैक, 160 ब्रांड स्पेक), 25 स्लैश कमांड, 5 सब-एजेंट, और एक डिटरमिनिस्टिक एंटी-AI-स्लॉप लिंटर। क्रॉस-IDE: Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, Codex, Kiro, Cline, Continue, Aider, Zed, JetBrains AI, Pieces, Tabby, Tabnine, CodeWhisperer, और Roo Cline में उपलब्ध।

> **ब्रांड नाम `ux-skill` है।** PyPI / npm पैकेज नाम `uxskill` ही रहेगा। GitHub रिपॉज़िटरी [`Laith0003/ux-skill`](https://github.com/Laith0003/ux-skill) पर है।

**साइट:** [uxskill.laithjunaidy.com](https://uxskill.laithjunaidy.com) · **हर Claude UX प्लगइन के साथ तुलना:** [compare.html](https://uxskill.laithjunaidy.com/compare.html) · **GitHub:** [Laith0003/ux-skill](https://github.com/Laith0003/ux-skill) · **PyPI:** [uxskill](https://pypi.org/project/uxskill/) · **npm:** [uxskill](https://www.npmjs.com/package/uxskill)

[![Version](https://img.shields.io/badge/version-3.1.0-stable-cc785c.svg)](https://github.com/Laith0003/ux-skill/releases)
[![Python](https://img.shields.io/badge/python-3.9%2B-3776ab.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![IDEs](https://img.shields.io/badge/IDEs-17-181715)](#17-ide-इंस्टॉलर)
[![Brands](https://img.shields.io/badge/brand_specs-160-cc785c.svg)](data/brands/_index.json)
[![Components](https://img.shields.io/badge/components-148-cc785c.svg)](data/components.json)
[![Linter](https://img.shields.io/badge/anti--patterns-145-181715.svg)](data/anti-patterns.json)
[![Tests](https://img.shields.io/badge/tests-223_passing-cc785c.svg)](https://github.com/Laith0003/ux-skill/actions)
[![Motion](https://img.shields.io/badge/motion_presets-57-181715.svg)](data/motion-presets.json)
[![GitHub stars](https://img.shields.io/github/stars/Laith0003/ux-skill?style=social)](https://github.com/Laith0003/ux-skill/stargazers)
[![PyPI downloads](https://img.shields.io/pypi/dm/uxskill.svg)](https://pypi.org/project/uxskill/)
[![Discord](https://img.shields.io/badge/discord-community-cc785c?logo=discord&logoColor=white)](https://discord.gg/uxskill)

### v3 में नया क्या है

- **ब्रांड स्पेक्स अब टेम्पलेट नहीं, ट्रेनिंग डेटा हैं।** 160 ब्रांड स्पेक्स अब वह कैटलॉग नहीं जिसमें से recommender चुनता है — वे वह शब्दावली हैं जिन्हें synthesizer आसवित करता है। हर कॉल पर नया आउटपुट।
- **7-अक्ष synthesizer** (warmth, contrast, density, geometry, formality, motion, type_personality)। ब्रीफ निर्धारक रूप से अक्ष मानों पर मैप होता है; अक्ष मान ताज़ा palette + टाइपोग्राफी + spacing + radius + motion टोकन में कंपाइल होते हैं।
- **तीन स्वचालित-डिस्पैच मोड** — `strict_brand` (एक ब्रांड का 100%), `brand_anchor` (एक ब्रांड का 70% + समान ब्रांडों से अक्ष-अनुकूलित 30%), `pure_synthesis` (कोई ब्रांड नामित नहीं — अक्ष-मिलान वाले 8 उदाहरणों से आसवन)।
- **निर्णय बही recommender को पुनः-रैंक करती है।** `.ux/decisions.jsonl` समान `(industry, ui_type)` बकेट में पिछली जीत के अनुसार उम्मीदवारों को पुनः-रैंक करता है। कोल्ड-स्टार्ट सुरक्षित। केवल `lint_score >= 80` + `user_accepted = true` वाले निर्णय गिने जाते हैं।
- **अक्ष-संपर्क मैट्रिक्स** — प्रतिस्पर्धी अक्षों के बीच स्पष्ट संघर्ष समाधान (dense + corporate → 4px, airy + corporate → 12px, soft + playful → 18px radius)। अब कोई मूक तदर्थ नियम नहीं।
- **`/ux-evolve` स्वचालित लूप** — स्कोर ≥ 90, पठार, या 5 राउंड तक lint → polish → re-lint। गुणवत्ता गेट 65 पर।
- **3 नए MCP टूल** (15 → 18): `ux_synthesize`, `ux_decisions_query`, `ux_decisions_stats`।
- **स्थानीय stats डैशबोर्ड** — `uxskill stats --html` `.ux/stats.html` लिखता है जो दिखाता है कि **आपकी** स्थापना ने क्या सीखा। कोई टेलीमेट्री नहीं, कोई वैश्विक एकत्रीकरण नहीं।
- **223 परीक्षण पास।** ऑफ़लाइन। निर्धारक। LLM कभी नहीं बुलाया।

पूर्ण विवरण [CHANGELOG.md](CHANGELOG.md#300--2026-05-28--the-brain) में।

### स्टार इतिहास

[![Star History Chart](https://api.star-history.com/svg?repos=Laith0003/ux-skill&type=Date)](https://star-history.com/#Laith0003/ux-skill&Date)

---

## ux-skill क्या है

ux-skill AI कोडिंग टूल्स के लिए एक **डिज़ाइन इंटेलिजेंस इंजन** है। यह एक Python पैकेज (`pip install uxskill`), एक Claude Code प्लगइन, और 17-IDE मल्टी-इंस्टॉलर के रूप में चलता है। इंजन एक प्रोजेक्ट ब्रीफ़ (इंडस्ट्री, ऑडियंस, टोन, अनिवार्य तत्व, वर्जित तत्व, स्टैक, क्षेत्र) लेता है और एक पूर्ण अनुशंसित डिज़ाइन सिस्टम लौटाता है: शैली, पैलेट, टाइप पेयर, मोशन प्रीसेट, कंपोनेंट, अध्ययन योग्य ब्रांड उदाहरण, और जो एंटी-पैटर्न रेलिंग्स अनिवार्य हैं। यह अनुशंसा डिटरमिनिस्टिक है — एक ही इनपुट हमेशा एक ही आउटपुट देगा।

प्लगइन आपके और AI कोडिंग टूल के बीच बैठता है। जब आप Claude Code, Cursor, या किसी और AI असिस्टेंट से "एक फ़िनटेक लैंडिंग पेज बनाओ" कहते हैं, तो असिस्टेंट आमतौर पर सुधार करता है — और परिणाम पाँच सेकंड में AI-जनरेटेड के रूप में पहचाना जा सकता है (पर्पल-टू-ब्लू ग्रेडिएंट, तीन समान कार्ड, डिस्प्ले साइज़ पर Inter, टेस्टीमोनियल में "John Doe", 300ms डिफ़ॉल्ट ट्रांज़िशन, सेंटर्ड हीरो, बाउंसिंग एरो CTA)। ux-skill सुधार की जगह **संरचित बाधाएँ** लाता है: आप ब्रीफ़ कैप्चर करने के लिए `/ux-discover` चलाते हैं, सिस्टम चुनने के लिए `/ux-recommend`, कोड जेनरेट करने के लिए `/ux-design`, और कमिट से पहले यह सत्यापित करने के लिए कि कोड 152 डिटरमिनिस्टिक एंटी-AI-स्लॉप नियमों को पास करता है `/ux-lint` चलाते हैं।

यह README कैनोनिकल संदर्भ है। हर कमांड, हर सब-एजेंट, हर डेटा मैनिफ़ेस्ट, हर इंस्टॉल पाथ, हर ब्रांड स्पेक, हर एंटी-पैटर्न श्रेणी — सब यहीं डॉक्यूमेंट किया है। अगर आप एक Claude Code डिज़ाइन प्लगइन ढूँढ रहे हैं या Cursor, Windsurf, या Codex के लिए AI डिज़ाइन टूल्स की तुलना कर रहे हैं, तो इसे ऊपर से नीचे तक पढ़ें और साथ में [compare.html](https://uxskill.laithjunaidy.com/compare.html) भी।

---

## विषय-सूची

1. [द ब्रेन — v3.0 क्या है](#द-ब्रेन--v30-क्या-है)
2. [त्वरित इंस्टॉलेशन](#त्वरित-इंस्टॉलेशन)
3. [संख्याएँ — शीर्ष 8 Claude UX स्किल्स के साथ लाइव तुलना](#संख्याएँ--शीर्ष-8-claude-ux-स्किल्स-के-साथ-लाइव-तुलना)
4. [आर्किटेक्चर — टुकड़े कैसे जुड़ते हैं](#आर्किटेक्चर--टुकड़े-कैसे-जुड़ते-हैं)
5. [25 स्लैश कमांड — विस्तृत संदर्भ](#22-स्लैश-कमांड--विस्तृत-संदर्भ)
6. [5 सब-एजेंट](#5-सब-एजेंट)
7. [12 डेटा मैनिफ़ेस्ट](#11-डेटा-मैनिफ़ेस्ट)
8. [152 एंटी-AI-स्लॉप नियम — लिंटर](#145-एंटी-ai-स्लॉप-नियम--लिंटर)
9. [160 ब्रांड DESIGN.md स्पेक — श्रेणी के अनुसार](#160-ब्रांड-designmd-स्पेक--श्रेणी-के-अनुसार)
10. [MCP सर्वर — असममित चाल](#mcp-सर्वर--असममित-चाल)
11. [17-IDE इंस्टॉलर](#17-ide-इंस्टॉलर)
12. [उपयोग के मामले — ठोस परिदृश्य](#उपयोग-के-मामले--ठोस-परिदृश्य)
13. [विकल्पों की तुलना में](#विकल्पों-की-तुलना-में)
14. [रोडमैप](#रोडमैप)
15. [योगदान](#योगदान)
16. [लाइसेंस, लेखक, आभार](#लाइसेंस-लेखक-आभार)

---

## द ब्रेन — v3.0 क्या है

v3.1.0 ux-skill के इतिहास का सबसे बड़ा वास्तुशिल्प परिवर्तन है। Recommender अब कैटलॉग से टेम्पलेट नहीं चुनता — इंजन प्रत्येक ब्रीफ के लिए ताज़ा डिज़ाइन भाषा का **संश्लेषण** करता है। एक ही ब्रीफ हमेशा एक ही आउटपुट देता है (पूर्णतः निर्धारक), लेकिन हर अलग ब्रीफ को अपना नया सिस्टम मिलता है। ब्रांड स्पेक्स अब टेम्पलेट नहीं हैं; वे प्रशिक्षण डेटा हैं जिनसे इंजन शब्दावली सीखता है। सिस्टम की अपने इतिहास पर नज़र है, फीडबैक लूप को स्थानीय रूप से बंद करता है, और LLM कभी नहीं बुलाता।

संकलक एक **निर्धारक 7-अक्ष synthesizer** है — warmth, contrast, density, geometry, formality, motion, type_personality। हर ब्रीफ अक्ष मानों पर मैप होता है; अक्ष मान ताज़ा palette + टाइपोग्राफी + spacing + radius + motion टोकन में कंपाइल होते हैं। मॉड्यूलर टाइप स्केल contrast से अपना अनुपात चुनते हैं (1.200 quiet / 1.250 balanced / 1.333 loud)। लेआउट प्रिमिटिव निर्माण द्वारा प्रतिक्रियाशील हैं (`auto-fit minmax(min(N, 100%), 1fr)` + container queries)। टूटे लेआउट उत्सर्जित नहीं हो सकते क्योंकि वे प्रतिनिधित्व करने योग्य नहीं हैं।

तीन स्वचालित-डिस्पैच मोड हैं: `strict_brand` (`reference_brands=[stripe] strict=True` → 100% Stripe टोकन, सबसे तेज़ पथ); `brand_anchor` (`reference_brands=[stripe]` → 70% Stripe + 4 समान ब्रांडों से अक्ष-अनुकूलित 30%); और `pure_synthesis` (कोई ब्रांड नामित नहीं → अनंत स्थान, अक्ष-मिलान वाले 8 उदाहरणों से एक नई डिज़ाइन भाषा में आसवन)। प्रतिस्पर्धी अक्षों को एक प्रलेखित **अक्ष-संपर्क मैट्रिक्स** द्वारा हल किया जाता है — dense + corporate 4px पर कंपाइल होता है (density जीतता है, Bloomberg स्कूल), airy + corporate 12px पर (formality जीतता है, लक्ज़री), soft + playful 18px radius पर, sharp + corporate 2px पर। कार्यान्वयन में कोई मूक तदर्थ नियम नहीं।

**निर्णय बही** (`.ux/decisions.jsonl`, schema `_v: 1` लॉक) फीडबैक लूप बंद करती है। Recommender अब समान `(industry, ui_type)` बकेट में पिछली जीत के अनुसार उम्मीदवारों को पुनः-रैंक करता है। कोल्ड-स्टार्ट सुरक्षित — 3 पूर्व-डेटा से कम होने पर छोड़ देता है। केवल `lint_score >= 80` AND `user_accepted = true` वाले निर्णय गिने जाते हैं। साथ ही `/ux-evolve` स्कोर ≥ 90, पठार, या 5 राउंड तक lint → polish → re-lint चलाता है, 65 पर गुणवत्ता गेट जिसके नीचे आउटपुट `--force` के बिना अस्वीकार होता है। परिणाम: प्रत्येक स्थापना अपने corpus पर अधिक स्मार्ट हो जाती है, हर रन मशीनों के बीच पुनरुत्पादित होता है, और इंजन पूरी तरह ऑफ़लाइन रहता है।

---

## त्वरित इंस्टॉलेशन

तीन इंस्टॉल पाथ। जो आपके माहौल से मेल खाता है उसे चुनें।

### पाथ 1 — Claude Code मार्केटप्लेस (कैनोनिकल)

अगर आप Claude Code में काम करते हैं, प्लगइन मार्केटप्लेस के ज़रिए इंस्टॉल करें:

```bash
/plugin marketplace add Laith0003/ux-skill
/plugin install ux@ux-skill
```

यह सभी 25 स्लैश कमांड और 5 सब-एजेंट को आपके Claude Code सेशन से जोड़ देता है। इंस्टॉल के बाद, प्रति-प्रोजेक्ट `.ux/` स्टेट डायरेक्टरी सेट करने और यह सत्यापित करने के लिए कि Python इंजन पहुँच योग्य है, `/ux-init` चलाएँ।

### पाथ 2 — pip (यूनिवर्सल)

अगर आप Claude Code के बाहर रहते हैं (Cursor, Windsurf, CLI, CI), Python पैकेज इंस्टॉल करें:

```bash
pip install uxskill
uxskill init                       # आपके IDE का स्वत: पता लगाता है, सही आर्टिफ़ैक्ट इंस्टॉल करता है
uxskill stats                      # इंस्टॉल सत्यापित करने के लिए मैनिफ़ेस्ट गिनती प्रिंट करें
uxskill lint .                     # वर्तमान डायरेक्टरी पर लिंटर चलाएँ
```

पैकेज `ux` और `uxskill` दोनों को CLI एंट्री पॉइंट के रूप में उजागर करता है — वे एक ही बाइनरी हैं।

### पाथ 3 — npx (Python ज़रूरी नहीं)

अगर आप सीधे Python संभालना नहीं चाहते, npx रैपर `pipx` के ज़रिए सब कुछ बूटस्ट्रैप करता है:

```bash
npx uxskill init                  # पहली बार चलाने पर pipx + uxskill डाउनलोड करता है
npx uxskill recommend --industry=fintech-neobank --tone=warm --stack=nextjs-15-app-router
```

### इंस्टॉल सत्यापित करें

```bash
ux stats
# {
#   "version": "3.1.0-stable",
#   "counts": {
#     "styles": 84,
#     "palettes": 176,
#     "type-pairs": 70,
#     "components": 148,
#     "industries": 184,
#     "chart-types": 35,
#     "tech-stacks": 25,
#     "ux-guidelines": 112,
#     "motion-presets": 57,
#     "anti-patterns": 145,
#     "brands": 160
#   }
# }
```

अगर कोई गिनती 0 लौटाती है, JSON फ़ाइल गुम है — [github.com/Laith0003/ux-skill/issues](https://github.com/Laith0003/ux-skill/issues) पर एक इश्यू खोलें।

---

## संख्याएँ — शीर्ष 8 Claude UX स्किल्स के साथ लाइव तुलना

स्टार की गिनती अंतिम बार `gh api` के ज़रिए **2026-05-28** को सत्यापित की गई। ux-skill (Laith0003/ux-skill) सबसे नया प्रवेशक है — हम जागरूकता पर छोटे हैं, आर्किटेक्चर पर गहरे। नीचे की तुलना ईमानदार है: हम कहाँ हारते हैं, कहाँ जीतते हैं।

| प्लगइन | स्टार | आर्किटेक्चर | स्लैश कमांड | लिंटर (CI-सेफ़) | ब्रांड स्पेक | कंपोनेंट | मोशन प्रीसेट | समर्थित IDE |
|---|---:|---|---:|---|---:|---:|---:|---:|
| nextlevelbuilder/ui-ux-pro-max-skill | **83,958** | Python BM25 + CSV, सिंगल स्किल | 1 | — | — | 0 | 0 | 18 |
| nexu-io/open-design | **54,406** | Node.js + 19 स्किल + प्रीव्यू | 19 | — | — | 0 | 0 | 1 |
| Leonxlnx/taste-skill | **25,202** | Bash + शोध-समर्थित रुचि | 1 | — | — | 0 | 0 | 1 |
| alchaincyf/huashu-design | **15,455** | सिंगल 62 KB SKILL.md + स्क्रिप्ट | 1 | — | — | 0 | 0 | 1 |
| google-labs-code/stitch-skills | **5,762** | MCP-जुड़ी स्किल लाइब्रेरी | multi | — | — | 0 | 0 | 1 |
| dominikmartn/nothing-design-skill | **2,391** | सिंगल-सौंदर्य स्किल | 1 | — | — | 0 | 0 | 1 |
| Nutlope/hallmark | **2,164** | एंटी-स्लॉप डिज़ाइन स्किल | 1 | — | — | 0 | 0 | 1 |
| hamen/material-3-skill | **955** | MD3 कंपोनेंट + ऑडिट | 1 | — | (केवल MD3) | 0 | 0 | 1 |
| **Laith0003/ux-skill (ux-skill)** | **14** | **Python इंजन + 12 मैनिफ़ेस्ट + 25 कमांड + 5 सब-एजेंट + CI लिंटर** | **22** | **152 regex नियम** | **160** | **148** | **57** | **17** |

### हम कहाँ हारते हैं

- **जागरूकता।** उनके पास लाखों स्टार हैं। हमारे पास 14 हैं। हमें स्टार करें — यह मदद करने का सबसे सस्ता तरीका है।
- **ब्रांड पहचान।** ui-ux-pro-max और open-design के पास महीनों में मापी जाने वाली बढ़त है, दिनों में नहीं।
- **मार्केटिंग पॉलिश।** उनके पास स्क्रीनशॉट, डेमो वीडियो, और एक खोजने योग्य लैंडिंग पेज है। हमारे पास एक संपूर्ण README और एक पतली लैंडिंग है।

### हम कहाँ जीतते हैं

- **कंपोनेंट लाइब्रेरी:** एनाटॉमी, स्टेट, उपयोग किए गए टोकन, और मोशन स्पेक के साथ 148 डॉक्यूमेंटेड कंपोनेंट। अन्य 8 में से कोई भी एक कंपोनेंट मैनिफ़ेस्ट नहीं भेजता।
- **मोशन प्रीसेट:** रिड्यूस्ड-मोशन फ़ॉलबैक के साथ 57 स्टैक-तैयार एंट्री (Framer Motion, GSAP, CSS)। अन्य में से कोई भी मोशन मैनिफ़ेस्ट नहीं भेजता।
- **एंटी-पैटर्न लिंटर:** 152 डिटरमिनिस्टिक regex नियम, CI में चलते हैं, Critical/High पर non-zero exit करते हैं। अन्य में से कोई भी डिटरमिनिस्टिक लिंटर नहीं भेजता।
- **ब्रांड स्पेक:** 160 असली DESIGN.md स्पेक (Apple, Stripe, Linear, Figma, Tesla, BMW, Notion, Spotify, Airbnb, Vercel, Supabase, Cursor, Raycast, Claude, और 146 और)। अन्य में से कोई भी ब्रांड लाइब्रेरी नहीं भेजता।
- **17 IDE समर्थित:** एक ही इंजन, प्रति IDE अलग गोंद।
- **25 स्लैश कमांड:** डिस्कवरी, जेनरेशन, ऑडिट, लिंट, पॉलिश, फ़िक्स लूप, केस-स्टडी, वर्कशॉप, कॉपी, मोशन, a11y, डैशबोर्ड, कंडक्टर — पूरी तरह एकीकृत।

पूरी टेबल-दर-टेबल साथ-साथ तुलना [uxskill.laithjunaidy.com/compare.html](https://uxskill.laithjunaidy.com/compare.html) पर।

---

## आर्किटेक्चर — टुकड़े कैसे जुड़ते हैं

```
ux-skill (पैकेज नाम: uxskill)
│
├── data/                              मस्तिष्क — क्वेरी-योग्य JSON मैनिफ़ेस्ट
│   ├── styles.json                    84 डिज़ाइन शैलियाँ + when/skip + टोकन
│   ├── palettes.json                  176 पैलेट (हल्का/गहरा, कंट्रास्ट सत्यापित)
│   ├── type-pairs.json                70 display × body × mono ट्रिपलेट
│   ├── components.json                148 कंपोनेंट (एनाटॉमी, स्टेट, मोशन)
│   ├── industries.json                184 इंडस्ट्री नियम + ऑडियंस सिग्नल
│   ├── chart-types.json               35 चार्ट प्रकार (when/skip, एनकोडिंग)
│   ├── tech-stacks.json               25 स्टैक (Next, Astro, SvelteKit, Blade...)
│   ├── ux-guidelines.json             112 नामित UX नियम (Hick, Fitts, Miller...)
│   ├── motion-presets.json            57 मोशन प्रीसेट (entry, exit, hover...)
│   ├── anti-patterns.json             152 regex नियम (CI-सेफ़ लिंटर स्रोत)
│   └── brands/*.json                  160 ब्रांड DESIGN स्पेक + _index.json
│
├── engine/                            Python — रीज़निंग
│   ├── synthesizer/                   v3 — निर्धारक 7-अक्ष संकलक
│   ├── decisions/                     v3 — .ux/decisions.jsonl बही + recommender पुनः-रैंक
│   ├── recommender/                   5-समानांतर-खोज मर्ज इंजन
│   ├── linter/                        डिटरमिनिस्टिक एंटी-स्लॉप स्कैनर
│   ├── discovery/                     10-फ़ील्ड फ़ोर्सिंग प्रोटोकॉल
│   ├── generator/                     टोकन + मैनिफ़ेस्ट एमिटर
│   ├── installer/                     17-IDE मल्टी-इंस्टॉलर
│   └── cli/                           `ux` / `uxskill` एंट्री पॉइंट
│
├── commands/                          25 Claude Code स्लैश कमांड (.md)
│   ├── ux-init.md                     बूटस्ट्रैप
│   ├── ux-stats.md                    इन्वेंटरी स्नैपशॉट
│   ├── ux-discover.md                 10-फ़ील्ड इनटेक (गेट)
│   ├── ux-recommend.md                फ़्लैगशिप — 5-समानांतर खोज
│   ├── ux-lint.md                     डिटरमिनिस्टिक लिंटर
│   ├── ux-design.md                   फ़्रंटएंड कोड जेनरेट करें
│   ├── ux-component.md                एक कंपोनेंट जेनरेट करें
│   ├── ux-system.md                   पूरा डिज़ाइन सिस्टम जेनरेट करें
│   ├── ux-dashboard.md                डैशबोर्ड सर्फ़ेस जेनरेट करें
│   ├── ux-motion.md                   मोशन ट्रीटमेंट + ऑडिट
│   ├── ux-audit.md                    6-लेंस डिज़ाइन ऑडिट
│   ├── ux-a11y.md                     WCAG 2.1 AA ऑडिट
│   ├── ux-critique.md                 रुचि आलोचना (3 जीत, 3 चूक, 1 चाल)
│   ├── ux-copy.md                     माइक्रोकॉपी समीक्षा + पुनर्लेखन
│   ├── ux-fix.md                      निष्कर्षों को परमाणु कमिट के रूप में लागू करें
│   ├── ux-polish.md                   कॉस्मेटिक पास + AI-स्लॉप किल
│   ├── ux-frame.md                    4-फ़ील्ड फ़्रेमिंग ब्लॉक
│   ├── ux-research.md                 अनुसंधान योजना + संश्लेषण
│   ├── ux-workshop.md                 5-चरण डिज़ाइन थिंकिंग वर्कशॉप
│   ├── ux-case-study.md               प्रकाशन योग्य Wfrah-संपादकीय केस स्टडी
│   ├── ux-next.md                     वर्कफ़्लो कंडक्टर (केवल-पठनीय)
│   └── ux-expert.md                   परामर्श हुक
│
├── agents/                            5 सब-एजेंट (.md)
│   ├── frontend-engineer.md           React/Next/Vue/Blade/Astro
│   ├── motion-engineer.md             Framer Motion / GSAP / CSS
│   ├── copy-writer.md                 ब्रांड आवाज़ में माइक्रोकॉपी
│   ├── research-synthesizer.md        साक्षात्कार + एनालिटिक्स + प्रतिस्पर्धी
│   └── design-system-architect.md     टोकन / कंपोनेंट / फ़ाउंडेशन
│
├── references/                        डेटा का गद्य स्रोत + डेमो पेज
│   ├── foundations/                   anti-patterns.md, सिद्धांत, रुचि
│   ├── laws/                          UX नियम लंबे रूप में
│   ├── process/                       discovery-protocol.md (महत्वपूर्ण)
│   ├── styles/                        प्रति-शैली गद्य (anti-slop.md, आदि)
│   ├── components/                    कंपोनेंट लंबा रूप
│   ├── output/                        आउटपुट रूब्रिक
│   └── conditional/                   स्टैक-विशिष्ट मार्गदर्शन
│
├── bin/
│   ├── uxskill.mjs                    npx रैपर -> Python इंजन
│   ├── ux-lint.py                     v2 लिंटर (पसंदीदा)
│   └── ux-lint.sh                     v1 फ़ॉलबैक (bash + perl-PCRE)
│
└── .ux/                               (प्रति प्रोजेक्ट निर्मित)
    ├── last-discovery.json            ब्रीफ़ स्नैपशॉट
    ├── last-recommendation.json       चयनित सिस्टम
    ├── last-frame.json                फ़्रेमिंग ब्लॉक
    ├── last-audit.json / last-a11y.json / last-copy.json / last-motion.json
    ├── last-design.json / last-component.json / last-dashboard.json
    └── last-critique.json / last-polish.json / last-research.json / last-workshop.json / last-case-study.json
```

### इंजन वास्तव में कैसे काम करता है

1. **इनपुट।** आप एक ब्रीफ़ देते हैं — या तो इंटरैक्टिव रूप से `/ux-discover` के ज़रिए (10 फ़ील्ड) या `ux recommend` के flags के ज़रिए गैर-इंटरैक्टिव रूप से।
2. **5 समानांतर खोज।** इंजन मैनिफ़ेस्ट में पाँच लुकअप समवर्ती रूप से चलाता है:
   - **इंडस्ट्री → recommended_styles** (industries.json)
   - **शैली → पैलेट + टाइप + मोशन संगतता** (styles.json)
   - **टोन × अनिवार्य → पैलेट फ़िल्टर** (palettes.json)
   - **स्टैक → कंपोनेंट संगतता + मोशन प्रीसेट** (tech-stacks.json, motion-presets.json)
   - **वर्जित + क्षेत्र → रेलिंग्स + ब्रांड उदाहरण शॉर्टलिस्ट** (anti-patterns.json, brands/)
3. **मर्ज।** एक डिटरमिनिस्टिक मर्जर उम्मीदवारों को रैंक करता है, संघर्षों को हल करता है (उदाहरण के लिए, अनिवार्य डार्क-मोड पैलेट मोड को बाध्य करता है), और एक एकल अनुशंसित सिस्टम उत्सर्जित करता है।
4. **आउटपुट।** चयनित शैली, पैलेट, टाइप पेयर, शीर्ष 5 मोशन प्रीसेट, शीर्ष 12 कंपोनेंट, शीर्ष 5 ब्रांड उदाहरण, और सभी 152 एंटी-पैटर्न रेलिंग्स सक्रिय के साथ एक JSON दस्तावेज़। साथ ही हर चयन को समझाने वाला एक तर्क ब्लॉक।
5. **जेनरेशन।** डाउनस्ट्रीम कमांड (`/ux-design`, `/ux-component`, `/ux-system`, `/ux-dashboard`) सब-एजेंट के ज़रिए वास्तविक कोड जेनरेट करने के लिए अनुशंसा का उपभोग करते हैं।
6. **सत्यापन।** `/ux-lint` जेनरेट किए गए कोड को 152 regex नियमों के विरुद्ध पुनः स्कैन करता है। CI में Critical/High पर non-zero exit करता है।

**Python सोचता है। HTML दिखाता है। Markdown जोड़ता है।**

---

## 25 स्लैश कमांड — विस्तृत संदर्भ

हर कमांड `commands/` के तहत `.md` फ़ाइल के रूप में भेजा जाता है, जिसमें `description`, `allowed-tools`, `triggers`, `when to use`, `when to skip`, `input`, `process`, और `output state file` होते हैं। नीचे के विवरण संक्षिप्त हैं; पूर्ण स्रोत कैनोनिकल स्पेक है।

कमांड पाँच श्रेणियों में समूहित हैं: **बूटस्ट्रैप और इन्वेंटरी**, **डिस्कवरी और अनुशंसा**, **जेनरेशन**, **ऑडिट और सत्यापन**, **फ़िक्स और पॉलिश**, और **कंडक्टर**।

### बूटस्ट्रैप और इन्वेंटरी

#### `/ux-init` — प्रोजेक्ट को बूटस्ट्रैप करें

- **क्या:** पहचानता है कि आप कौन सा IDE उपयोग कर रहे हैं (`.claude/`, `.cursor/`, `.windsurf/`, आदि), सही आर्टिफ़ैक्ट इंस्टॉल करता है, सत्यापित करता है कि Python इंजन पहुँच योग्य है, स्टैट्स स्नैपशॉट प्रिंट करता है।
- **कब उपयोग करें:** नए प्रोजेक्ट में पहली बार इंस्टॉल करते समय। ux-skill उपयोग करने वाले प्रोजेक्ट को क्लोन करने के बाद। `pip install --upgrade uxskill` के बाद।
- **कब छोड़ें:** आप पहले से इस प्रोजेक्ट में चला चुके हैं और कुछ नहीं बदला।
- **आह्वान:** `/ux-init` (कोई आर्ग नहीं) या CLI से `uxskill init`।
- **आउटपुट:** प्रति-IDE आर्टिफ़ैक्ट ([17-IDE इंस्टॉलर](#17-ide-इंस्टॉलर) देखें) + `.ux/` डायरेक्टरी + stdout सारांश।
- **जोड़ता है:** अगला `/ux-discover`।

#### `/ux-stats` — डेटा इन्वेंटरी प्रिंट करें

- **क्या:** 12 डेटा मैनिफ़ेस्ट के लिए संस्करण + एंट्री गिनती प्रिंट करता है, ताकि आप सत्यापित कर सकें कि क्या इंस्टॉल किया गया है।
- **कब उपयोग करें:** इंस्टॉल के बाद। अपग्रेड के बाद। जब `/ux-recommend` आश्चर्यजनक चयन लौटाता है और आप संदेह करते हैं कि मैनिफ़ेस्ट अधूरे हैं।
- **कब छोड़ें:** कभी नहीं — यह 50ms का केवल-पठनीय कमांड है।
- **आह्वान:** `/ux-stats` या `uxskill stats`।
- **आउटपुट:** stdout पर JSON (ऊपर [इंस्टॉल सत्यापित करें](#इंस्टॉल-सत्यापित-करें) देखें)।
- **जोड़ता है:** केवल डायग्नोस्टिक; डाउनस्ट्रीम कुछ फ़ीड नहीं करता।

### डिस्कवरी और अनुशंसा

#### `/ux-discover` — फ़ोर्सिंग फ़ंक्शन (10-फ़ील्ड इनटेक)

- **क्या:** हर प्रोजेक्ट किसी भी जेनरेशन कमांड से पहले गुज़रता है अनिवार्य 10-फ़ील्ड इनटेक से। प्रोजेक्ट प्रकार, ऑडियंस, प्राथमिक लक्ष्य, टोन, अनिवार्य, वर्जित, संदर्भ ब्रांड, स्टैक, क्षेत्र, सफलता मीट्रिक। **कोई सुधार नहीं।** प्रतिबंधित वाक्यांश ("modern", "clean") उपयोगकर्ता को विशिष्ट होने के लिए मजबूर करते हैं।
- **कब उपयोग करें:** किसी भी `/ux-design`, `/ux-component`, `/ux-system`, या `/ux-dashboard` से पहले। जब पिछला ब्रीफ़ बासी हो गया हो।
- **कब छोड़ें:** आप बग ठीक कर रहे हैं (`/ux-fix`)। आप केवल लिंटर पास चला रहे हैं (`/ux-lint`)। ब्रीफ़ पिछले सत्र से अपरिवर्तित है।
- **आह्वान:** `/ux-discover`। प्लगइन पूछता है; आप जवाब देते हैं।
- **आउटपुट:** `.ux/last-discovery.json` लिखता है (10-फ़ील्ड ब्रीफ़)।
- **जोड़ता है:** `/ux-recommend` → शैली + पैलेट + टाइप + मोशन + कंपोनेंट चुनने के लिए डिस्कवरी का उपयोग करता है। `/ux-design [अतिरिक्त ब्रीफ़]` → अनुशंसा में निहित फ़्रंटएंड कोड जेनरेट करता है। `/ux-component <नाम>` → खोजी गई बाधाओं के साथ संरेखित एक कंपोनेंट जेनरेट करता है।

#### `/ux-recommend` — फ़्लैगशिप 5-समानांतर-खोज इंजन

- **क्या:** Python इंजन की 5-समानांतर-खोज को 12 मैनिफ़ेस्ट पर चलाता है और एक मर्ज किया हुआ डिज़ाइन सिस्टम लौटाता है। इंडस्ट्री → शैली → पैलेट → टाइप → मोशन + कंपोनेंट + ब्रांड उदाहरण + रेलिंग्स।
- **कब उपयोग करें:** शून्य से नया प्रोजेक्ट शुरू करना। थका हुआ दिखने वाला उत्पाद पिवट करना। किसी भी `/ux-design` या `/ux-component` से पहले प्री-फ़्लाइट।
- **कब छोड़ें:** आपने पहले से `/ux-discover` चलाया और ब्रीफ़ सेव किया — `/ux-recommend` उस फ़्लो में स्वचालित है। आप एक बग ठीक कर रहे हैं (`/ux-fix` का उपयोग करें)। आपको केवल लिंट करना है (`/ux-lint` का उपयोग करें)।
- **आह्वान (Claude Code):**
  ```
  /ux-recommend
  ```
  **आह्वान (CLI):**
  ```bash
  ux recommend \
    --project-type=landing \
    --industry=fintech-neobank \
    --tone=warm --tone=editorial \
    --must-have=dark-mode --must-have=a11y-AA \
    --forbidden=brutalism --forbidden=purple-gradients \
    --stack=nextjs-15-app-router \
    --region=mena
  ```
- **आउटपुट:** `.ux/last-recommendation.json` लिखता है — चयनित शैली, चयनित पैलेट, चयनित टाइप पेयर, शीर्ष 5 मोशन प्रीसेट, शीर्ष 12 कंपोनेंट, शीर्ष 5 ब्रांड उदाहरण, सभी 152 एंटी-पैटर्न रेलिंग्स सक्रिय, साथ ही तर्क।
- **जोड़ता है:** `/ux-design [ब्रीफ़]` → अनुशंसित टोकन का उपयोग करके फ़्रंटएंड कोड। `/ux-system` → अनुशंसा से पूरा डिज़ाइन सिस्टम। `/ux-component <नाम>` → अनुशंसित शैली का उपयोग करने वाला एक कंपोनेंट। `/ux-lint` → जेनरेट किए गए कोड को सत्यापित करें।

### जेनरेशन

#### `/ux-design` — ब्रीफ़ से एक सुंदर, एंटी-स्लॉप सर्फ़ेस जेनरेट करें

- **क्या:** डिस्कवरी ब्रीफ़ + अनुशंसा से पूर्ण, उत्पादन-ग्रेड फ़्रंटएंड आर्टिफ़ैक्ट (लैंडिंग, मार्केटिंग साइट, ऐप शेल) जेनरेट करता है। एंटी-स्लॉप और आर्सेनल संदर्भों से रचनात्मक दिशा के साथ `frontend-engineer` को डिस्पैच करता है।
- **कब उपयोग करें:** "Design a", "build me a", "generate a landing page", "create a dashboard", "make a component" — कोई भी फ़्री-फ़ॉर्म दृश्य डिलीवरेबल अनुरोध।
- **कब छोड़ें:** आप समीक्षा चाहते हैं, निर्माण नहीं (`/ux-audit` या `/ux-critique` का उपयोग करें)। आप केवल एक कंपोनेंट चाहते हैं (`/ux-component` का उपयोग करें)। बैकएंड या इंफ़्रास्ट्रक्चर कार्य।
- **आह्वान:** `/ux-design generate a fintech landing for a MENA neobank, warm editorial tone, dark-mode AA, no purple gradients`।
- **आउटपुट:** जेनरेट किया गया कोड (HTML / Blade / JSX / Vue / Astro), साथ ही `.ux/last-design.json`।
- **जोड़ता है:** `/ux-lint` → रेलिंग्स के विरुद्ध सत्यापित करें। `/ux-polish` → कॉस्मेटिक पास। `/ux-a11y` → सुलभता ऑडिट। `/ux-copy` → माइक्रोकॉपी समीक्षा। `/ux-fix` → निष्कर्षों को परमाणु कमिट के रूप में लागू करें।

#### `/ux-component` — एक कंपोनेंट जेनरेट करें

- **क्या:** एक स्पेक से एक एकल, उत्पादन-ग्रेड कंपोनेंट (बटन, मोडल, navbar, sidebar, कार्ड, टेबल, फ़ॉर्म, चार्ट) उत्पन्न करता है। चारों इंटरैक्शन स्टेट, सुलभ, ऑन-ब्रांड। पहले `.ux/last-recommendation.json` में कंपोनेंट खोजता है, सीधे मैनिफ़ेस्ट क्वेरी पर फ़ॉलबैक करता है।
- **कब उपयोग करें:** कोई भी सिंगल-एलिमेंट अनुरोध — "build a button", "create a pricing card", "make a modal", "add a navbar", "design a sidebar", "I need a data table", "build a form", "make a chart component"।
- **कब छोड़ें:** पूरा पेज या मल्टी-सेक्शन सर्फ़ेस (`/ux-design` का उपयोग करें)। बैकएंड या इंफ़्रास्ट्रक्चर।
- **आह्वान:** `/ux-component pricing-card-trio --brief="fintech, dark, monospace numbers"`।
- **आउटपुट:** जेनरेट किया गया कंपोनेंट कोड, साथ ही `.ux/last-component.json`।
- **जोड़ता है:** `/ux-lint` → सत्यापित करें। `/ux-polish` → कसें।

#### `/ux-system` — एक पूर्ण स्टार्टर डिज़ाइन सिस्टम जेनरेट करें

- **क्या:** एक ऐसे प्रोजेक्ट के लिए जिसके पास सिस्टम नहीं है, पूर्ण स्टार्टर डिज़ाइन सिस्टम प्रस्तावित करता है — टोकन (रंग, टाइप, स्पेस, मोशन, रेडियस, शैडो), फ़ाउंडेशन डॉक्स, कंपोनेंट कॉन्ट्रैक्ट, डार्क-मोड पेयरिंग, थीम स्विचर। `design-system-architect` को डिस्पैच करता है।
- **कब उपयोग करें:** "We don't have a design system", "build us a system", "propose tokens", "what should our theme be", "set up our DS"।
- **कब छोड़ें:** प्रोजेक्ट के पास पहले से एक डिज़ाइन सिस्टम है — मौजूदा सिस्टम के विरुद्ध `/ux-component` का उपयोग करें। बैकएंड या इंफ़्रास्ट्रक्चर।
- **आह्वान:** `/ux-system` (अगर फ़ाइल में पहले से डिस्कवरी नहीं है तो पहले डिस्कवरी चलाता है)।
- **आउटपुट:** `tokens.json`, `foundations.md`, `components/*.md` कॉन्ट्रैक्ट, वैकल्पिक Tailwind / vanilla / SCSS एमिट। चेन संदर्भ के लिए `.ux/last-system.json` लिखता है।
- **जोड़ता है:** `/ux-component` → नए सिस्टम के विरुद्ध निर्माण करें। `/ux-design` → नए टोकन का उपयोग करके एक सर्फ़ेस जेनरेट करें।

#### `/ux-dashboard` — विशेष डैशबोर्ड जेनरेशन

- **क्या:** डेटा घनत्व अनुशासन के साथ डैशबोर्ड — बेंटो लेआउट, टैबुलर मोनोस्पेस अंकों, स्पार्कलाइन पैटर्न, एंटी-कार्ड-ओवरयूज़, अर्थपूर्ण स्टेट रंग, संयमित मोशन। चार्ट चिपकाई गई मार्केटिंग साइट नहीं।
- **कब उपयोग करें:** "Build a dashboard", "design the admin panel", "make a metrics page", "operator console", "analytics view", "KPI board", "monitoring screen"।
- **कब छोड़ें:** आँकड़ों के साथ मार्केटिंग लैंडिंग पेज (`/ux-design` का उपयोग करें)। केवल एक विजेट (`/ux-component` का उपयोग करें)। बैकएंड या इंफ़्रास्ट्रक्चर।
- **आह्वान:** `/ux-dashboard`।
- **आउटपुट:** जेनरेट किया गया डैशबोर्ड कोड + `.ux/last-dashboard.json`।
- **जोड़ता है:** `/ux-lint`, `/ux-audit`, `/ux-a11y`।

#### `/ux-motion` — मोशन ट्रीटमेंट

- **क्या:** एक सर्फ़ेस की मोशन परत जेनरेट करता है — अवधि, ईज़िंग, कोरियोग्राफ़ी, रिड्यूस्ड-मोशन फ़ॉलबैक, प्रदर्शन अनुशासन। 5 आयामों (टाइमिंग, ईज़िंग, अर्थ, रिड्यूस्ड-मोशन, प्रदर्शन) के विरुद्ध मौजूदा मोशन का ऑडिट भी करता है।
- **कब उपयोग करें:** "Motion check", "are the animations good", "fix the motion", "review the animations", "motion audit", "performance pass on the motion"।
- **कब छोड़ें:** सर्फ़ेस में कोई मोशन नहीं है (`/ux-audit` या `/ux-polish` का उपयोग करें)। बैकएंड या इंफ़्रास्ट्रक्चर।
- **आह्वान:** `/ux-motion path/to/component.tsx` (ऑडिट मोड) या `/ux-motion --generate hero-entry` (जेनरेशन)।
- **आउटपुट:** अपडेट किया गया कोड (जेनरेशन मोड में) या `.ux/last-motion.json` रिपोर्ट (ऑडिट मोड में)।
- **जोड़ता है:** `/ux-fix` → मोशन निष्कर्ष लागू करें। `/ux-polish` → कसें।

### ऑडिट और सत्यापन

#### `/ux-lint` — डिटरमिनिस्टिक regex-आधारित लिंटर (कोई LLM नहीं, CI-सेफ़)

- **क्या:** आपके कोड के विरुद्ध 152 regex नियम चलाता है। कोई LLM कॉल नहीं। CI में Critical / High पर non-zero exit करता है। स्रोत: `data/anti-patterns.json`। नियम A11y (23), कंटेंट (15), लेआउट (13), टाइपोग्राफ़ी (10), रंग (9), गुणवत्ता (9), दृश्य (9), मोशन (8), प्रदर्शन (4) को कवर करते हैं।
- **कब उपयोग करें:** प्री-कमिट हुक। CI गेट। `/ux-audit` की लागत चुकाने से पहले बड़े कोडबेस पर तेज़ पहला पास। जेनरेशन सत्यापित करने के लिए `/ux-design` या `/ux-component` के बाद।
- **कब छोड़ें:** आप एक फ़िक्स लूप चाहते हैं (लिंटर रिपोर्ट करता है, संपादित नहीं करता — `/ux-polish --fix` या `/ux-fix` में चेन करें)। आप रुचि निर्णय चाहते हैं (`/ux-critique` का उपयोग करें)।
- **आह्वान (स्लैश):** `/ux-lint src/`।
- **आह्वान (CLI):** `uxskill lint .` या `python3 bin/ux-lint.py .` या `bash bin/ux-lint.sh --ci --fail-on high`।
- **आह्वान (CI):**
  ```yaml
  - name: ux-lint
    run: bash bin/ux-lint.sh --ci --fail-on high
  ```
- **आउटपुट:** stdout पर निष्कर्ष (स्थान, नियम id, गंभीरता, साक्ष्य)। साफ़ होने पर एग्ज़िट कोड 0, `--fail-on high` सेट होने पर Critical/High पर non-zero।
- **जोड़ता है:** `/ux-polish --fix` → समान पैटर्न पर LLM-चालित समकक्ष। `/ux-fix` → गंभीरता-क्रमबद्ध कमिट के रूप में निष्कर्ष लागू करें। `/ux-audit` → पूर्ण 6-लेंस रीज़निंग पास। `/ux-next` → कंडक्टर को निर्णय लेने दें।

#### `/ux-audit` — 6-लेंस डिज़ाइन ऑडिट

- **क्या:** छह लेंसों (स्पष्टता, पदानुक्रम, सुलभता, आवाज़, मोशन, रुचि) के विरुद्ध एक संरचित, मतपूर्ण समीक्षा, गंभीरता-टैग किए गए निष्कर्ष उत्पन्न करती है। Polaris-शैली की रिपोर्ट। पहले `.ux/last-frame.json` पढ़ता है — ऑडियंस और परिणाम हर निष्कर्ष की गंभीरता को एंकर करते हैं।
- **कब उपयोग करें:** सर्फ़ेस मौजूद है और आप एक रक्षात्मक आलोचना चाहते हैं। "Audit", "review the ux", "is this any good", "what's broken", "tear this apart"।
- **कब छोड़ें:** सर्फ़ेस अभी मौजूद नहीं है (`/ux-design` का उपयोग करें)। उपयोगकर्ता एक लेंस चाहता है (लक्षित कमांड का उपयोग करें: `/ux-a11y`, `/ux-copy`, `/ux-motion`, `/ux-polish`)। उपयोगकर्ता रुचि की राय चाहता है (`/ux-critique` का उपयोग करें)। बैकएंड या इंफ़्रास्ट्रक्चर।
- **आह्वान:** `/ux-audit https://example.com/pricing` या `/ux-audit src/components/Pricing.tsx`।
- **आउटपुट:** `.ux/last-audit.json` लिखता है — `{lens, severity, title, principle, evidence, fix}` की `findings` ऐरे, `severity_counts`, `dominant_lens`, `strategic_moves`।
- **जोड़ता है:** `/ux-fix` → निष्कर्ष लागू करें। `/ux-polish` → कॉस्मेटिक पास। `/ux-design` → अगर संरचनात्मक रीडिज़ाइन की ज़रूरत हो।

#### `/ux-a11y` — WCAG 2.1 AA ऑडिट + सामान्य-शिष्टाचार जाँच

- **क्या:** एक संरचित WCAG 2.1 AA ऑडिट, साथ ही सामान्य-शिष्टाचार जाँच जो स्वचालित उपकरण पास कर लेती हैं लेकिन फिर भी असली उपयोगकर्ताओं को चोट पहुँचाती हैं (फ़ोकस दृश्यता, त्रुटि विशिष्टता, मोशन प्राथमिकताएँ, कीबोर्ड ट्रैप, रंग निर्भरता)।
- **कब उपयोग करें:** शिप से पहले सुलभता गेट। रीडिज़ाइन के बाद। "Accessibility check", "WCAG audit", "is this accessible", "a11y review", "screen reader test", "keyboard nav check"।
- **कब छोड़ें:** उपयोगकर्ता-सामना नहीं। बैकएंड या इंफ़्रास्ट्रक्चर। वर्क-इन-प्रोग्रेस स्केच।
- **आह्वान:** `/ux-a11y https://example.com` (लाइव URL पसंदीदा — स्वचालित उपकरण और कीबोर्ड परीक्षण केवल लाइव काम करते हैं)।
- **आउटपुट:** `.ux/last-a11y.json` लिखता है — `{wcag_sc, sc_name, severity, title, evidence, fix, category}` की `findings` ऐरे, `beyond_wcag` ऐरे, `severity_counts`।
- **जोड़ता है:** `/ux-fix` → निष्कर्षों को कमिट के रूप में लागू करें। `/ux-copy` → कॉपी पास के हिस्से के रूप में alt टेक्स्ट और फ़ॉर्म-एरर वायरिंग ठीक करें।

#### `/ux-critique` — रुचि कॉल (3 जीत, 3 चूक, 1 रणनीतिक चाल)

- **क्या:** एक डिज़ाइनर की राय — कोई संरचित ऑडिट नहीं, कोई गंभीरता स्कोर नहीं, बस एक कसी हुई, मतपूर्ण राय जो नाम लेती है कि क्या काम कर रहा है, क्या नहीं, और एक रणनीतिक चाल जो सबसे ज़्यादा बदलाव लाएगी।
- **कब उपयोग करें:** "What do you think", "is this good", "critique this", "honest take", "is the vibe right", "does this feel like us", "should we ship this"।
- **कब छोड़ें:** उपयोगकर्ता स्पष्ट रूप से एक संरचित ऑडिट चाहता है (`/ux-audit` का उपयोग करें)। बैकएंड या इंफ़्रास्ट्रक्चर।
- **आह्वान:** `/ux-critique https://example.com`।
- **आउटपुट:** `.ux/last-critique.json` लिखता है — 3 जीत, 3 चूक, 1 रणनीतिक चाल, साथ ही गद्य।
- **जोड़ता है:** `/ux-design` अगर राय रीडिज़ाइन की सिफ़ारिश करती है। `/ux-polish` अगर राय कसने की सिफ़ारिश करती है।

#### `/ux-copy` — माइक्रोकॉपी समीक्षा + पुनर्लेखन

- **क्या:** आवाज़ रूब्रिक के विरुद्ध हर दृश्यमान स्ट्रिंग का मूल्यांकन करता है और एक पहले/बाद का पुनर्लेखन उत्पन्न करता है। पकड़ता है: "form contains errors" (सामान्य), "John Doe" (प्लेसहोल्डर), AI-प्रसन्न उत्सवपूर्ण कॉपी, सामान्य CTA, मृत खाली स्थिति, बेकार त्रुटियाँ।
- **कब उपयोग करें:** संरचना सही है लेकिन शब्द कमज़ोर हैं। "Review the copy", "fix the microcopy", "the error messages are bad", "rewrite this", "tighten the strings", "the buttons sound generic", "this empty state is dead"।
- **कब छोड़ें:** लेआउट समस्याएँ (`/ux-audit` या `/ux-polish` का उपयोग करें)। alt टेक्स्ट जैसी सुलभता-चालित कॉपी समस्याएँ (`/ux-a11y` का उपयोग करें)। बैकएंड या इंफ़्रास्ट्रक्चर।
- **आह्वान:** `/ux-copy src/views/checkout.blade.php`।
- **आउटपुट:** `.ux/last-copy.json` लिखता है — `{location, severity, before, after, notes}` की `strings` ऐरे, साथ ही रूब्रिक + अनुवाद की ज़रूरत वाले लोकल।
- **जोड़ता है:** `/ux-fix` → पुनर्लेखन लागू करें। `/ux-a11y` → कॉपी फ़िक्स के बाद पुनः जाँच करें।

### फ़िक्स और पॉलिश

#### `/ux-fix` — निष्कर्षों को परमाणु कमिट के रूप में लागू करें

- **क्या:** `.ux/` से नवीनतम रिपोर्ट (ऑडिट, कॉपी, a11y, मोशन, या पॉलिश) पढ़ता है, वर्किंग ट्री को मान्य करता है, और सही सब-एजेंट के ज़रिए निष्कर्षों को परमाणु कमिट के रूप में लागू करता है। मूल कमांड को पुनः चलाकर पुनः सत्यापित करता है।
- **कब उपयोग करें:** एक ऑडिट-क्लास कमांड चलाने और निष्कर्षों की समीक्षा करने के बाद। "Fix the findings", "apply the fixes", "run the fix loop", "patch the surface", "make the changes", "go fix it"।
- **कब छोड़ें:** `.ux/` में कोई पूर्व रिपोर्ट नहीं। वर्किंग ट्री गंदा है और उपयोगकर्ता ने stash/commit पर सहमति नहीं दी है। फ़िक्स को डिज़ाइन निर्णय की ज़रूरत है, यांत्रिक अनुप्रयोग की नहीं (रीडिज़ाइन के लिए `/ux-design` का उपयोग करें)।
- **आह्वान:** `/ux-fix` (किस रिपोर्ट को फ़िक्स करना है यह स्वतः पहचानता है) या `/ux-fix --from=last-a11y.json`।
- **आउटपुट:** प्रति निष्कर्ष परमाणु कमिट। मूल कमांड को पुनः चलाता है और `.ux/last-*.json` फ़ाइल अपडेट करता है। एक सारांश प्रिंट करता है।
- **जोड़ता है:** `/ux-next` → कंडक्टर अगली चाल चुनता है।

#### `/ux-polish` — कॉस्मेटिक पास + AI-स्लॉप किल

- **क्या:** स्पेसिंग लय, पदानुक्रम तीक्ष्णता, AI-स्लॉप पहचान, टोकन निरंतरता। `/ux-lint` का LLM-चालित समकक्ष — रुचि कॉल पर आपके निर्णय का उपयोग करता है।
- **कब उपयोग करें:** संरचना सही है लेकिन कार्यान्वयन ढीला है। "Polish", "tighten this up", "remove the AI-slop", "make it premium", "make this less AI-looking", "the spacing feels off", "this looks generic", "needs more taste"।
- **कब छोड़ें:** सर्फ़ेस में मुख्य कार्यक्षमता गायब है (पहले उसे ठीक करें)। एक रीडिज़ाइन चाहिए, पॉलिश नहीं (`/ux-design` का उपयोग करें)। कॉपी समस्याएँ (`/ux-copy` का उपयोग करें)। मोशन समस्याएँ (`/ux-motion` का उपयोग करें)। a11y समस्याएँ (`/ux-a11y` का उपयोग करें)।
- **आह्वान:** `/ux-polish src/components/Hero.tsx`।
- **आउटपुट:** अपडेट किया गया कोड + परिवर्तनों का वर्णन करने वाला `.ux/last-polish.json`।
- **जोड़ता है:** `/ux-lint` → सत्यापित करें कि पॉलिश टिकी। `/ux-a11y` → सुलभता पुनः जाँचें।

### डिस्कवरी और कथा

#### `/ux-frame` — 4-फ़ील्ड फ़्रेमिंग ब्लॉक

- **क्या:** यह-किसके-लिए-है, परिणाम, परिकल्पना, और सफलता संकेत को एक संरचित फ़्रेमिंग ब्लॉक में कैप्चर करता है। कोई डिज़ाइन कार्य नहीं होता — बस चार-फ़ील्ड इनटेक जो एक अस्पष्ट अनुरोध को एक कार्यशील ब्रीफ़ में बदल देता है। `/ux-discover` से हल्का (4 फ़ील्ड बनाम 10)।
- **कब उपयोग करें:** किसी भी प्रोजेक्ट, स्प्रिंट, या एक बार के एंगेजमेंट की शुरुआत। बीच में जब बातचीत भटक गई हो। "Frame this", "what's the brief", "set up the project", "framing"।
- **कब छोड़ें:** पहले से फ़्रेम किया हुआ (`.ux/last-frame.json` जाँचें)। कोई फ़्रेमिंग प्रभाव वाला एक बार का कंपोनेंट निर्माण। बैकएंड या इंफ़्रास्ट्रक्चर।
- **आह्वान:** `/ux-frame "loyalty wallet for MENA Bashiti pilot"`।
- **आउटपुट:** `.ux/last-frame.json` लिखता है — `{audience, outcome, hypothesis, success_signal}`।
- **जोड़ता है:** `/ux-discover` → फ़्रेम को 10-फ़ील्ड ब्रीफ़ तक विस्तारित करें। `/ux-design` → फ़्रेम को एंकर के रूप में उपयोग करके जेनरेट करें।

#### `/ux-research` — अनुसंधान योजना + संश्लेषण

- **क्या:** योजना मोड: साक्षात्कार स्क्रिप्ट, सर्वेक्षण, भर्ती स्क्रीनर लिखता है। संश्लेषण मोड (`--synthesize`): साक्षात्कार, एनालिटिक्स, प्रतिस्पर्धी साइट, A/B परिणाम, सपोर्ट टिकट को सिफ़ारिशों में पचाता है। `research-synthesizer` को डिस्पैच करता है।
- **कब उपयोग करें:** "Plan a research study", "I need interview questions", "design a survey", "how do I recruit users", "user testing plan", "diary study", "preference test", "fake door", "smoke test", "synthesize my interview notes"।
- **कब छोड़ें:** उत्तर पहले से उच्च आत्मविश्वास के साथ ज्ञात है। कम-जोखिम वाले प्रतिवर्ती निर्णय। बैकएंड या इंफ़्रास्ट्रक्चर।
- **आह्वान:** `/ux-research --plan "loyalty wallet adoption in MENA"` या `/ux-research --synthesize interviews/*.md`।
- **आउटपुट:** `.ux/last-research.json` लिखता है — अनुसंधान योजना या संश्लेषित विषय + साक्ष्य + सिफ़ारिशें।
- **जोड़ता है:** `/ux-frame` → निष्कर्षों को एक फ़्रेम में एकीकृत करें। `/ux-design` → निष्कर्षों से जेनरेट करें। `/ux-workshop` → अनुसंधान को इनपुट के रूप में उपयोग करके वर्कशॉप चलाएँ।

#### `/ux-workshop` — 5-चरण डिज़ाइन थिंकिंग वर्कशॉप

- **क्या:** एक डिस्कवरी / डिज़ाइन-थिंकिंग वर्कशॉप को शुरू से अंत तक सुगम बनाता है। पाँच क्रमिक चरण (अन्वेषण → हीट मैप → हितधारक मैप → समाधान स्केच → गेम प्लान)। समय-सीमित। प्रति चरण ठोस आर्टिफ़ैक्ट। एक निर्णय के साथ समाप्त होता है, "दिलचस्प निष्कर्ष" के साथ नहीं।
- **कब उपयोग करें:** असली प्रश्न, असली प्रतिभागी, असली समय बजट। "Run a workshop", "facilitate a discovery", "let's do a design thinking session", "I have stakeholders for an hour, what do we do", "kick off the project"।
- **कब छोड़ें:** ब्रीफ़ पहले से स्पष्ट और दायरे में है। एकल विचार-मंथन (`/ux-design` या `/ux-frame` का उपयोग करें)। टीम मध्य-निष्पादन में है, डिस्कवरी में नहीं।
- **आह्वान:** `/ux-workshop "loyalty wallet pivot" --participants="2 PMs, 1 designer, 1 eng lead, 1 customer rep" --minutes=90`।
- **आउटपुट:** `.ux/last-workshop.json` लिखता है — गेम प्लान + प्रति-चरण आर्टिफ़ैक्ट।
- **जोड़ता है:** `/ux-design` → गेम प्लान निष्पादित करें। `/ux-research` → वर्कशॉप द्वारा उठाए गए अंतरालों को भरें। `/ux-case-study` → यात्रा प्रकाशित करें।

#### `/ux-case-study` — प्रकाशन योग्य केस स्टडी (Wfrah-संपादकीय प्रारूप)

- **क्या:** शुद्ध-मोनोक्रोम संपादकीय प्रारूप में एक प्रोजेक्ट केस स्टडी जेनरेट करता है — Wfrah टाइपोग्राफ़ी, हेयरलाइन सेपरेटर, क्रमांकित (A)–(G) सेक्शन कोड, द्विभाषी-सुरक्षित लेआउट। एक दस्तावेज़, मार्केटिंग ब्रोशर नहीं। `.ux/last-frame.json`, `.ux/last-workshop.json`, `.ux/last-research.json`, `.ux/last-design.json`, `.ux/last-a11y.json`, `.ux/last-polish.json`, `.ux/last-recommendation.json`, `.ux/last-discovery.json` से पढ़ता है।
- **कब उपयोग करें:** लॉन्च के बाद। एक अलग मील के पत्थर के बाद। "Write a case study", "case study this project", "do the wrap-up doc", "publish this work", "portfolio piece"।
- **कब छोड़ें:** प्रोजेक्ट में (A)–(G) सेक्शन को भरने के लिए डेटा की कमी है। उपयोगकर्ता एक मार्केटिंग लैंडिंग चाहता है, केस स्टडी नहीं (`/ux-design` का उपयोग करें)।
- **आह्वान:** `/ux-case-study --format=html --slug=bashiti-loyalty`।
- **आउटपुट:** `case-studies/<slug>.<ext>` + `.ux/last-case-study.json`।
- **जोड़ता है:** टर्मिनल कमांड — आमतौर पर प्रोजेक्ट का अंत।

### कंडक्टर

#### `/ux-next` — वर्कफ़्लो कंडक्टर (केवल-पठनीय)

- **क्या:** हर `.ux/last-*.json` पढ़ता है और सबसे ज़्यादा लीवरेज वाले अगले कमांड का नाम लेता है। एक कंडक्टर, बिल्डर नहीं। केवल पठनीय।
- **कब उपयोग करें:** कमांडों के बीच। "What should I do next", "what's the next move", "decide for me", "where do we go from here"।
- **कब छोड़ें:** `.ux/` में कोई पूर्व रिपोर्ट नहीं। आपके मन में एक विशिष्ट अगला कमांड है।
- **आह्वान:** `/ux-next` (कोई आर्ग नहीं) या `/ux-next --focus=a11y`।
- **आउटपुट:** stdout — अनुशंसित अगला कमांड + तर्क।
- **जोड़ता है:** जो भी कमांड वह चुनता है।

#### `/ux-expert` — परामर्श हुक

- **क्या:** जब एक उपयोगकर्ता वास्तविक जीवन के UX विशेषज्ञ के लिए पूछता है तो प्लगइन निर्माता की संपर्क जानकारी सामने लाता है। संक्षिप्त, सीधा, कोई मार्केटिंग नहीं।
- **कब उपयोग करें:** "Who built this", "I need a UX expert", "do you do consulting", "can I hire someone for this", "is there a human behind this plugin"।
- **कब छोड़ें:** उपयोगकर्ता प्लगइन सुविधाओं के बारे में पूछ रहा है, परामर्श के बारे में नहीं।
- **आह्वान:** `/ux-expert`।
- **आउटपुट:** LinkedIn / ईमेल / रेपो के साथ एक संक्षिप्त संपर्क कार्ड।

### कमांड चेनिंग ग्राफ़

```
                  ┌──────────────────────┐
                  │  /ux-init            │
                  │  /ux-stats           │
                  └────────────┬─────────┘
                               │
                  ┌────────────▼─────────┐
                  │  /ux-frame           │  4-फ़ील्ड फ़्रेमिंग ब्लॉक
                  └────────────┬─────────┘
                               │
                  ┌────────────▼─────────┐
                  │  /ux-discover        │  10-फ़ील्ड इनटेक (फ़ोर्सिंग गेट)
                  └────────────┬─────────┘
                               │ .ux/last-discovery.json लिखता है
                  ┌────────────▼─────────┐
                  │  /ux-recommend       │  5 समानांतर खोज -> मर्ज सिस्टम
                  └────────────┬─────────┘
                               │ .ux/last-recommendation.json लिखता है
            ┌──────────────────┼──────────────────┐
            │                  │                  │
   ┌────────▼───────┐ ┌────────▼────────┐ ┌──────▼──────┐
   │ /ux-design     │ │ /ux-component   │ │ /ux-system  │
   │ /ux-dashboard  │ │ /ux-motion      │ │             │
   └────────┬───────┘ └────────┬────────┘ └──────┬──────┘
            │                  │                  │
            └──────────────────┼──────────────────┘
                               │ .ux/last-<surface>.json लिखता है
            ┌──────────────────┼──────────────────┐
            │                  │                  │
   ┌────────▼───────┐ ┌────────▼────────┐ ┌──────▼──────┐
   │ /ux-lint       │ │ /ux-audit       │ │ /ux-a11y    │
   │ /ux-critique   │ │ /ux-copy        │ │ /ux-motion  │
   └────────┬───────┘ └────────┬────────┘ └──────┬──────┘
            │                  │                  │
            └──────────────────┼──────────────────┘
                               │ .ux/last-<lens>.json लिखता है
                  ┌────────────▼─────────┐
                  │  /ux-fix             │  निष्कर्ष कमिट के रूप में लागू करें
                  │  /ux-polish          │
                  └────────────┬─────────┘
                               │
                  ┌────────────▼─────────┐
                  │  /ux-case-study      │  प्रकाशन योग्य आर्टिफ़ैक्ट
                  └──────────────────────┘

                  ┌──────────────────────┐
                  │  /ux-next            │  कंडक्टर — केवल-पठनीय
                  │  /ux-expert          │  परामर्श हुक
                  └──────────────────────┘
```

---

## 5 सब-एजेंट

सब-एजेंट कमांड द्वारा डिस्पैच किए गए भूमिका-विशिष्ट जेनरेटर हैं। वे कभी स्वतंत्र रूप से नहीं चलते — उन्हें `/ux-design`, `/ux-component`, `/ux-system`, `/ux-fix`, `/ux-research`, आदि द्वारा बुलाया जाता है। हर एजेंट के पास एक परिभाषित स्वामित्व सीमा है: वे ब्रीफ़ का निर्णय नहीं लेते; वे उसके विरुद्ध निष्पादन करते हैं।

### `frontend-engineer`

- **स्वामी:** एंटी-AI-स्लॉप अनुशासन के साथ उत्पादन-ग्रेड फ़्रंटएंड कोड (React, Next.js, Vue, Blade+Alpine, vanilla HTML, Astro)।
- **डिस्पैच करने वाला:** `/ux-design`, `/ux-component`, `/ux-dashboard`, `/ux-fix`।
- **इनपुट:** ब्रीफ़ + रचनात्मक दिशा + टोकन (`.ux/last-recommendation.json` से)।
- **आउटपुट:** कार्यशील कोड जो सामान्य AI आउटपुट से अलग पहचाना जा सकता है। कोई पर्पल ग्रेडिएंट नहीं, कोई सेंटर्ड हीरो नहीं, कोई तीन समान कार्ड नहीं, कोई डिस्प्ले साइज़ पर Inter नहीं, कोई "John Doe" नहीं, कोई इमोजी नहीं, कोई 300ms डिफ़ॉल्ट नहीं।
- **टूल:** `Read, Write, Edit, Bash, Glob, Grep`।

### `motion-engineer`

- **स्वामी:** उत्पादन फ़्रंटएंड कोड में मोशन — Framer Motion, GSAP, CSS एनिमेशन। अवधि, ईज़िंग, कोरियोग्राफ़ी, रिड्यूस्ड-मोशन फ़ॉलबैक, प्रदर्शन अनुशासन।
- **डिस्पैच करने वाला:** `/ux-design`, `/ux-motion --fix`, `/ux-component`।
- **इनपुट:** मोशन ब्रीफ़ + टोकन + `data/motion-presets.json` से 57 मोशन प्रीसेट।
- **आउटपुट:** मोशन जो अपनी जगह कमाता है। हमेशा `prefers-reduced-motion` फ़ॉलबैक में लिपटा। हमेशा Core Web Vitals के विरुद्ध परीक्षित।
- **टूल:** `Read, Write, Edit, Bash, Glob, Grep`।

### `copy-writer`

- **स्वामी:** शिप होने वाली स्ट्रिंग्स — त्रुटि संदेश, खाली स्थिति, CTA, लोडिंग स्थिति, सफलता संदेश, टोस्ट, हेल्पर टेक्स्ट, फ़ॉर्म लेबल, बटन टेक्स्ट।
- **डिस्पैच करने वाला:** `/ux-copy --fix`, `/ux-design`, `/ux-frame`, `/ux-component`।
- **इनपुट:** आवाज़ प्रोफ़ाइल (नामित या पेस्ट की गई) + सर्फ़ेस की स्ट्रिंग्स।
- **आउटपुट:** उत्पादन माइक्रोकॉपी एक सर्फ़ेस की हर स्थिति में लगातार लागू ताकि उत्पाद एक उत्पाद की तरह लगे, दस की तरह नहीं। प्रतिबंध: "form contains errors", "John Doe", AI-प्रसन्न उत्सवपूर्ण कॉपी, सामान्य CTA, मृत खाली स्थिति।
- **टूल:** `Read, Write, Edit, Bash, Glob, Grep`।

### `research-synthesizer`

- **स्वामी:** अनुसंधान इनपुट (साक्षात्कार, एनालिटिक्स, प्रतिस्पर्धी साइट, A/B परिणाम, सपोर्ट टिकट) को क्रियाशील डिज़ाइन सिफ़ारिशों में पचाना।
- **डिस्पैच करने वाला:** `/ux-research`, `/ux-workshop`, `/ux-frame`।
- **इनपुट:** कच्चा अनुसंधान — ट्रांसक्रिप्ट, एक्सपोर्ट, प्रतिस्पर्धी URL, सपोर्ट क्लस्टर।
- **आउटपुट:** विषय, साक्ष्य, सिफ़ारिशें। कभी उत्तर डिज़ाइन नहीं करता — डिज़ाइनर को डिज़ाइन करने का आधार देता है।
- **टूल:** `Read, Write, WebFetch, Bash, Glob, Grep`।

### `design-system-architect`

- **स्वामी:** पूर्ण डिज़ाइन सिस्टम — टोकन (रंग, टाइप, स्पेस, मोशन, रेडियस, शैडो), फ़ाउंडेशन डॉक्स, कंपोनेंट कॉन्ट्रैक्ट, डार्क-मोड पेयरिंग, थीमिंग परत।
- **डिस्पैच करने वाला:** `/ux-system`, `/ux-component` जब कोई सिस्टम न हो।
- **इनपुट:** ब्रांड ब्रीफ़ + `.ux/last-recommendation.json` (शैली + पैलेट + टाइप पेयर + मोशन प्रीसेट)।
- **आउटपुट:** एक सुसंगत, मतपूर्ण, उत्पादन-तैयार सिस्टम जिसके विरुद्ध डाउनस्ट्रीम एजेंट मूल बातों को पुनः तय किए बिना निर्माण कर सकें। टोकन JSON, फ़ाउंडेशन MD, कंपोनेंट कॉन्ट्रैक्ट, डार्क-मोड मैपिंग।
- **टूल:** `Read, Write, Edit, Bash, Glob, Grep`।

### सब-एजेंट डिस्पैच प्रोटोकॉल

जब एक कमांड एक सब-एजेंट को डिस्पैच करता है, यह पास करता है:

1. ब्रीफ़ / अनुशंसा (`.ux/` से लोड)।
2. प्रासंगिक मैनिफ़ेस्ट स्लाइस (उदाहरण के लिए, `frontend-engineer` को चयनित शैली + पैलेट + कंपोनेंट मिलते हैं; `motion-engineer` को चयनित मोशन प्रीसेट मिलते हैं)।
3. 152 एंटी-पैटर्न रेलिंग्स (हमेशा सक्रिय)।
4. एक सफलता मानदंड (आर्टिफ़ैक्ट को क्या करना चाहिए)।

सब-एजेंट लौटाते हैं:

1. आर्टिफ़ैक्ट (कोड, डॉक, सिस्टम)।
2. एक तर्क ब्लॉक (ये चयन क्यों)।
3. रेलिंग्स के विरुद्ध एक स्व-जाँच (कौन से नियम सत्यापित किए)।

कॉल करने वाला कमांड फिर पूर्ण घोषित करने से पहले स्वचालित रूप से `/ux-lint` चलाता है।

---

## 12 डेटा मैनिफ़ेस्ट

डेटा परत मस्तिष्क है। हर कमांड इससे पढ़ता है; इंजन इसके पार मर्ज करता है; लिंटर इसके विरुद्ध स्कैन करता है। सभी फ़ाइलें `data/` के तहत रहती हैं और स्कीमा संस्करण के लिए अपनी एंट्री को `{_meta, entries}` में लपेटती हैं।

### `styles.json` — 84 डिज़ाइन शैलियाँ

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 84 |
| `keys per entry` | `id`, `name`, `category`, `philosophy`, `when_to_use`, `when_to_skip`, `tokens`, `references`, `compatible_palettes`, `compatible_type_pairs`, `compatible_motion`, `compatible_industries`, `taste_score` |
| `categories` | Minimalist / Swiss, Brutalist, Editorial, Glassmorphism, Neumorphism, Bento, Skeuomorphic, Industrial, Maximalist, AI-Futurist, MENA-modern, Vaporwave, आदि। |
| `sample entry` | `swiss-international` — "ग्रिड कानून है। टाइप भारी काम करता है। सजावट विफलता है।" |

उपयोग द्वारा: `/ux-recommend`, `/ux-system`, `/ux-design`। स्कीमा: [data/SCHEMAS.md](data/SCHEMAS.md)।

### `palettes.json` — 176 रंग पैलेट

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 176 |
| `keys per entry` | `id`, `name`, `mode` (हल्का/गहरा), `tone`, `colors` (canvas, surface, ink, body, muted, primary, primary_active, hairline, success, warning, danger, accent), `wcag_contrast_audit`, `compatible_industries` |
| `tones` | warm, editorial, magazine, clinical, playful, brutalist, monochrome, jewel-tone, MENA-warm, dev-tools-dark, आदि। |
| `sample entry` | `claude-warm-editorial` — हल्का, warm/editorial/magazine, canvas #faf9f5, primary #cc785c |

उपयोग द्वारा: `/ux-recommend`, `/ux-system`। AA / AAA पर कंट्रास्ट सत्यापित। स्कीमा: [data/SCHEMAS.md](data/SCHEMAS.md)।

### `type-pairs.json` — 70 टाइप पेयरिंग

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 70 |
| `keys per entry` | `id`, `name`, `display` (परिवार + वज़न + स्रोत + लाइसेंस + URL), `body`, `mono`, `compatible_styles`, `taste_score` |
| `sample entry` | `cormorant-inter-jetbrains` — Cormorant Garamond × Inter × JetBrains Mono |

सभी परिवारों के पास लाइसेंस + स्रोत URL है। `/ux-recommend`, `/ux-system` द्वारा उपयोग।

### `components.json` — 148 कंपोनेंट

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 148 |
| `keys per entry` | `id`, `name`, `category`, `purpose`, `anatomy`, `states`, `tokens_used`, `motion`, `accessibility`, `compatible_styles`, `compatible_industries`, `code_skeleton` |
| `categories` | Navigation, Forms, Data Display, Feedback, Overlays, Layout, Content, Marketing, E-commerce, Auth, Dashboard, Charts, Empty States, Loading States, Error States |
| `sample entry` | `mega-nav-product-grid` — Mega Navigation, Product Grid — 6-भाग एनाटॉमी, 4 स्टेट |

यह हमारी सबसे बड़ी खाई है। कोई अन्य Claude UX प्लगइन एक संरचित कंपोनेंट मैनिफ़ेस्ट नहीं भेजता।

### `industries.json` — 184 इंडस्ट्री नियम

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 184 |
| `keys per entry` | `id`, `name`, `category`, `characteristics`, `audience_signals`, `recommended_styles`, `recommended_palettes`, `recommended_type_pairs`, `recommended_motion`, `regulatory_notes`, `regional_notes` |
| `categories` | Financial Services, Healthcare, Education, E-commerce, SaaS B2B, SaaS B2C, Developer Tools, Media, Gaming, Travel, Real Estate, MENA-specific, आदि। |
| `sample entry` | `fintech-neobank` — उच्च विश्वास, नियामक प्रकटीकरण, बैलेंस/लेनदेन प्राथमिक UI, मोबाइल-पहले दैनिक-उपयोग |

`/ux-recommend` द्वारा पहले समानांतर खोज अक्ष के रूप में उपयोग।

### `chart-types.json` — 35 चार्ट प्रकार

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 35 |
| `keys per entry` | `id`, `name`, `category`, `when_to_use`, `when_to_skip`, `encoding`, `accessibility`, `data_shape`, `compatible_styles` |
| `categories` | Comparison, Time Series, Distribution, Composition, Relationship, Flow, Geographic |
| `sample entry` | `bar-vertical` — 4–15 असतत श्रेणियों की तुलना करें। x-अक्ष के साथ स्थिति श्रेणी को मैप करती है; ऊँचाई मान को मैप करती है। |

`/ux-dashboard`, `/ux-component` (चार्ट इंस्टेंस) द्वारा उपयोग।

### `tech-stacks.json` — 25 स्टैक

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 25 |
| `keys per entry` | `id`, `name`, `category`, `tier`, `languages`, `ssr`, `rsc`, `compatible_styling`, `scaffold_command`, `compatible_motion`, `gotchas` |
| `tiers` | production, prerelease, experimental |
| `sample entry` | `nextjs-15-app-router` — Next.js 15 (App Router), TS/JS, SSR, RSC, Tailwind 4 / CSS Modules / vanilla-extract / styled-components / panda-css के साथ संगत |

अन्य स्टैक में Astro, SvelteKit, Remix, Nuxt 3, Solid Start, Qwik, Blade+Alpine, Hotwire, Phoenix LiveView, Hydrogen 2025 शामिल हैं।

### `ux-guidelines.json` — 112 नामित UX नियम

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 112 |
| `keys per entry` | `id`, `name`, `category`, `source`, `principle`, `application`, `examples`, `caveats`, `related_laws` |
| `categories` | Decision Cost, Attention, Memory, Motor Control, Visual Perception, Social, Emotional, Form, Error Handling, Onboarding, Empty State, आदि। |
| `sample entry` | `hicks-law` — प्रस्तुत विकल्पों की संख्या के साथ निर्णय समय लघुगणक रूप से बढ़ता है |

`/ux-audit` (6-लेंस स्कोरिंग) और `/ux-critique` (रुचि एंकर) द्वारा उपयोग।

### `motion-presets.json` — 57 मोशन प्रीसेट

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 57 |
| `keys per entry` | `id`, `name`, `category`, `tokens` (duration_ms, easing, transform_from/to, opacity_from/to), `stacks` (framer_motion, gsap, css), `accessibility` (रिड्यूस्ड-मोशन फ़ॉलबैक), `when_to_use` |
| `categories` | Entry, Exit, Hover, Focus, Tap, Loading, Empty, Success, Error, Scroll-linked |
| `sample entry` | `fade-up-12px` — 360ms, `cubic-bezier(0.16, 1, 0.3, 1)`, translateY(12px) → 0, opacity 0 → 1 |

हर प्रीसेट में एक रिड्यूस्ड-मोशन वैरिएंट है। Framer Motion, GSAP, और शुद्ध CSS के लिए स्टैक-तैयार कोड।

### `anti-patterns.json` — 152 regex नियम

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 152 |
| `keys per entry` | `id`, `name`, `severity` (critical/high/medium/low), `category`, `detection` (type, pattern, flags, scope), `evidence_template`, `fix`, `references` |
| `categories` | A11y (23), Content (15), Layout (13), Typography (10), Color (9), Quality (9), Visual (9), Motion (8), Performance (4) |

पूरी नियम सूची [152 एंटी-AI-स्लॉप नियम](#145-एंटी-ai-स्लॉप-नियम--लिंटर) में है।

### `brands/*.json` — 160 ब्रांड स्पेक

| फ़ील्ड | विवरण |
|---|---|
| `entries` | 160 (साथ ही सभी को सूचीबद्ध करने वाला `_index.json`) |
| `keys per entry` | `id`, `name`, `category`, `voice`, `tokens` (color, type, motion), `design_principles`, `signature_moves`, `anti-moves`, `references` |
| `categories` | Developer Tools (36), Consumer / Lifestyle / Retail (19), Fintech / Crypto (14), Editorial / Media (13), AI / ML Platform (12), Productivity / Collaboration (8), Automotive (8) |

पूरी सूची [160 ब्रांड DESIGN.md स्पेक](#160-ब्रांड-designmd-स्पेक--श्रेणी-के-अनुसार) में।

---

## 152 एंटी-AI-स्लॉप नियम — लिंटर

ux-skill एक डिटरमिनिस्टिक regex-आधारित लिंटर भेजता है। **कोई LLM नहीं।** **कोई API नहीं।** **कोई नेटवर्क नहीं।** एक विशिष्ट Next.js ऐप पर CI में ~200ms में चलता है। `--fail-on high` सेट होने पर Critical / High निष्कर्षों पर non-zero exit करता है।

नियम `data/anti-patterns.json` (v2 पसंदीदा) से स्रोत हैं, `references/foundations/anti-patterns.md` फ़ॉलबैक (v1 bash) के साथ। दो बाइनरी भेजे जाते हैं: `bin/ux-lint.py` (Python, तेज़, विस्तारयोग्य) और `bin/ux-lint.sh` (Bash + perl-PCRE, Python के बिना वातावरणों के लिए)।

### श्रेणी के अनुसार नियम

#### टाइपोग्राफ़ी (3 नियम)

| गंभीरता | नियम ID | नाम |
|---|---|---|
| high | `inter-as-display` | Inter को डिस्प्ले फ़ॉन्ट के रूप में उपयोग |
| medium | `hero-text-arbitrary-90px` | मनमाना हीरो फ़ॉन्ट साइज़ |
| low | `font-system-only` | बिना चयनित टाइपफ़ेस के सिस्टम फ़ॉन्ट स्टैक |

#### रंग (6 नियम)

| गंभीरता | नियम ID | नाम |
|---|---|---|
| high | `purple-to-blue-gradient` | डिफ़ॉल्ट purple-to-blue AI ग्रेडिएंट |
| high | `dark-text-on-dark-card` | कार्ड पर कम-कंट्रास्ट टेक्स्ट |
| medium | `gradient-text-rainbow` | मल्टी-स्टॉप ग्रेडिएंट टेक्स्ट |
| medium | `card-glow-purple-shadow` | कार्ड पर पर्पल ग्लो शैडो |
| medium | `gradient-mesh-purple-pink` | पर्पल-पिंक मेश ग्रेडिएंट हीरो |
| low | `tailwind-color-named-vague` | बिना सिमैंटिक टोकन के नामित Tailwind रंग |

#### लेआउट (5 नियम)

| गंभीरता | नियम ID | नाम |
|---|---|---|
| high | `three-equal-card-grid` | एक पंक्ति में तीन समान कार्ड |
| medium | `centered-everything-hero` | सेंटर्ड हीरो संरचना |
| medium | `avatar-stack-overlapping` | सामान्य ओवरलैपिंग अवतार स्टैक |
| low | `pill-rounded-full-everywhere` | हर चीज़ पर लागू `rounded-full` |
| low | `nav-equal-hamburger-desktop` | डेस्कटॉप पर हैमबर्गर मेनू |

#### कंटेंट (5 नियम)

| गंभीरता | नियम ID | नाम |
|---|---|---|
| high | `lorem-ipsum-leak` | शिपिंग कोड में Lorem ipsum |
| high | `emoji-in-ui` | UI एलिमेंट के रूप में इमोजी उपयोग |
| high | `icon-emoji-stamp` | आइकन स्टैम्प के रूप में इमोजी उपयोग |
| high | `testimonial-fake-five-stars` | हार्डकोडेड पाँच-स्टार टेस्टीमोनियल |
| medium | `fake-name-john-doe` | सामान्य प्लेसहोल्डर नाम |

#### मोशन (3 नियम)

| गंभीरता | नियम ID | नाम |
|---|---|---|
| medium | `cta-arrow-rightward-bouncing` | CTA पर बाउंसिंग एरो |
| low | `timing-300ms-default` | डिफ़ॉल्ट 300ms ट्रांज़िशन टाइमिंग |
| low | `cubic-bezier-material-only` | हर जगह Material डिफ़ॉल्ट ईज़िंग |

#### A11y (6 नियम)

| गंभीरता | नियम ID | नाम |
|---|---|---|
| high | `inline-svg-no-aria` | aria-label या aria-hidden के बिना SVG |
| high | `img-no-alt` | alt एट्रिब्यूट गायब छवि |
| high | `link-onclick-no-href` | onClick के साथ लेकिन href के बिना एंकर |
| medium | `button-no-type` | type एट्रिब्यूट गायब बटन |
| medium | `heading-skip-h1-h3` | छोड़ा गया हेडिंग स्तर |
| medium | `infinite-scroll-no-pagination` | कीबोर्ड फ़ॉलबैक के बिना अनंत स्क्रॉल |

#### गुणवत्ता (6 नियम)

| गंभीरता | नियम ID | नाम |
|---|---|---|
| high | `console-log-leak` | कंपोनेंट कोड में `console.log` |
| medium | `inline-style-attribute` | इनलाइन style एट्रिब्यूट |
| medium | `any-type-leak` | TypeScript `any` टाइप |
| medium | `arbitrary-z-index-9999` | आलसी z-index मान |
| low | `shadcn-default-everywhere` | अपरिवर्तित डिफ़ॉल्ट shadcn टोकन ब्लॉक |
| low | `todo-fixme-comment` | शिपिंग कोड में TODO या FIXME |

#### विज़ुअल (1 नियम)

| गंभीरता | नियम ID | नाम |
|---|---|---|
| low | `blur-bg-only-decoration` | बिना ग्लास सर्फ़ेस के बैकड्रॉप ब्लर |

### लिंटर उपयोग

**एक-बार स्कैन:**

```bash
uxskill lint .
# या
python3 bin/ux-lint.py src/
# या
bash bin/ux-lint.sh src/
```

**CI गेट (GitHub Actions):**

```yaml
- name: ux-lint
  run: bash bin/ux-lint.sh --ci --fail-on high
```

**प्री-कमिट हुक:**

```bash
# .git/hooks/pre-commit
#!/usr/bin/env bash
bash bin/ux-lint.sh --staged --fail-on high
```

**आउटपुट (नमूना):**

```
─── /ux-lint रिपोर्ट ───
src/components/Hero.tsx:24  [high]   purple-to-blue-gradient
  साक्ष्य: bg-gradient-to-br from-purple-500 to-blue-500
  फ़िक्स: अनुशंसित पैलेट के प्राथमिक ग्रेडिएंट से बदलें या ग्रेडिएंट हटाएँ

src/components/Pricing.tsx:12  [high] three-equal-card-grid
  साक्ष्य: grid grid-cols-3 gap-6 (3 समान Card चिल्ड्रन)
  फ़िक्स: एक कार्ड को फ़ीचर करें; दो कम-ज़ोर वाले कार्ड से घेरें

3 फ़ाइलें स्कैन की गईं · 2 high · 0 medium · 0 low · exit 1
अनुशंसित अगला: /ux-polish --fix (LLM-चालित, लिंटेबल और सौंदर्य दोनों निष्कर्षों को संबोधित करता है)
```

---

## 160 ब्रांड DESIGN.md स्पेक — श्रेणी के अनुसार

असली ब्रांड। असली डिज़ाइन भाषाएँ। असली DESIGN.md स्पेक — सामान्य पैलेट नहीं। प्लगइन को बताएँ "Stripe की शैली में एक लैंडिंग बनाओ" और यह वास्तविक ब्रांड शब्दावली पढ़ता है: आवाज़ रूब्रिक, रंग टोकन, मोशन सम्मेलन, हस्ताक्षर चालें, एंटी-चालें।

हर ब्रांड एक संरचित JSON (`data/brands/<slug>.json`) और एक गद्य संदर्भ (`references/brands/<slug>.md`) के रूप में भेजा जाता है।

### Developer Tools (36)

ClickHouse, Composio, Cursor, Datadog, dbt Labs, Expo, Fivetran, Fly.io, Framer, HashiCorp, Honeycomb, IBM, Lovable, Mintlify, Modal, MongoDB, Neon, Ollama, OpenCode, PostHog, Railway, Raycast, Render, Replicate, Resend, Retool, Sanity, Sentry, Slack, Snowflake, Sourcegraph, Supabase, Superhuman, Vercel, Warp, Webflow

### Consumer / Lifestyle / Retail (19)

Aesop, Airbnb, Allbirds, Apple, Apple Music, Glossier, HP, Hims & Hers, Instagram, Meta, Nike, Patagonia, Pinterest, PlayStation, Shopify, Spotify, Starbucks, TikTok, Uber

### Fintech / Crypto (14)

Binance, Brex, Coinbase, Kraken, Mastercard, Mercury, Monzo, N26, Plaid, Ramp, Revolut, Robinhood, Stripe, Wise

### Editorial / Media (13)

Bloomberg, Clay, Dezeen, NVIDIA, Pitchfork, Substack, The Atlantic, The Economist, The New York Times, The Verge, The Wall Street Journal, Vodafone, Wired

### AI / ML Platform (12)

Anthropic, Claude, Cohere, ElevenLabs, MiniMax, Mistral AI, OpenAI, Perplexity, Runway, Together AI, VoltAgent, xAI

### Productivity / Collaboration (8)

Airtable, Cal.com, Figma, Intercom, Linear, Miro, Notion, Zapier

### Automotive (8)

BMW, BMW M, Bugatti, Ferrari, Lamborghini, Renault, SpaceX, Tesla

### यह क्यों मायने रखता है

अन्य 8 लोकप्रिय Claude UX प्लगइन "modern minimal" या "clean dashboard" जेनरेट करते हैं — एक ही डिफ़ॉल्ट सौंदर्य के संस्करण। ux-skill आपको माँगने देता है **Linear की स्पष्टता**, **Stripe की गंभीरता**, **Apple का संयम**, **Tesla का मोनोलिथ**, **Notion की मित्रता**, **Cursor का ग्रेडिएंट अनुशासन**, **Raycast का हेयरलाइन घनत्व**, **Claude का गर्म संपादकीय** — और इंजन ब्रांड स्पेक से सही टोकन, आवाज़, मोशन सम्मेलन, और हस्ताक्षर चालें खींचता है।

---

## MCP सर्वर — असममित चाल

ux-skill एक **Model Context Protocol सर्वर** भेजता है। `ux-mcp` चलाएँ और इंजन एक लंबे समय तक चलने वाली stdio प्रक्रिया बन जाता है जिसे कोई भी MCP-सक्षम होस्ट — Claude Desktop, Cursor, Windsurf, सामान्य एजेंट — कॉल कर सकते हैं। चौदह टूल: `ux_recommend`, `ux_lint`, `ux_styles`, `ux_palettes`, `ux_type_pairs`, `ux_components`, `ux_industries`, `ux_motion_presets`, `ux_anti_patterns`, `ux_brands`, `ux_landing_patterns`, `ux_persist_save`, `ux_persist_load`, `ux_stats`। वही Python हैंडलर जो स्लैश कमांड उपयोग करते हैं; वही डेटा मैनिफ़ेस्ट; वही डिटरमिनिस्टिक रिकमेंडर।

**यह असममित चाल क्यों है:** शीर्ष आठ Claude UX स्किल्स (ui-ux-pro-max-skill, open-design, taste-skill, huashu-design, stitch, nothing-design, hallmark, material-3) में से कोई भी MCP सर्वर नहीं भेजता। वे Claude Code के प्लगइन रनटाइम के अंदर बंद हैं। ux-skill MCP बोलने वाले किसी भी होस्ट से पहुँच योग्य है, उन एजेंटों सहित जिन्होंने कभी Claude Code प्लगइन के बारे में नहीं सुना।

```bash
pip install 'uxskill[mcp]'             # mcp एक opt-in extra है
ux-mcp                                  # stdio JSON-RPC सर्वर शुरू होता है
```

अपने क्लाइंट को `ux-mcp` बाइनरी की ओर इंगित करें। पूर्ण टूल डॉक्स, JSON उदाहरण, और Claude Desktop, Cursor, और Windsurf के लिए प्रति-क्लाइंट कॉन्फ़िग [docs/mcp.html](docs/mcp.html) पर और `commands/ux-mcp.md` में रहते हैं।

---

## 17-IDE इंस्टॉलर

`uxskill init` (या Claude Code के अंदर `/ux-init`) स्वतः पता लगाता है कि आप कौन सा IDE उपयोग कर रहे हैं और सही आर्टिफ़ैक्ट लिखता है। एक ही Python इंजन। एक ही अनुशंसाएँ। प्रति IDE अलग गोंद।

| IDE / टूल | पहचान संकेत | इंस्टॉल किया गया आर्टिफ़ैक्ट |
|---|---|---|
| Claude Code | `.claude/` या `CLAUDE.md` | `.claude-plugin/plugin.json` पर प्लगइन मैनिफ़ेस्ट + सभी 25 कमांड + सभी 5 सब-एजेंट |
| Cursor | `.cursor/` या `.cursorrules` | `.cursorrules` प्रॉम्प्ट हेडर इंजन की ओर इशारा करते हुए |
| Windsurf | `.windsurf/` या `.windsurfrules` | `.windsurfrules` समान प्रॉम्प्ट हेडर के साथ |
| GitHub Copilot | `.github/copilot-instructions.md` या `.vscode/` | `.github/copilot-instructions.md` |
| Gemini CLI | `GEMINI.md` | `GEMINI.md` |
| Codex | `AGENTS.md` | `AGENTS.md` |
| Kiro | `.kiro/` | `.kiro/instructions.md` |
| Cline | `.cline/` | `.cline/instructions.md` |
| Continue | `.continue/` | `.continue/config.json` पैच |
| Aider | `.aider.conf.yml` | `.aider.conf.yml` + `AIDER.md` |
| Zed | `.zed/` | `.zed/instructions.md` |
| JetBrains AI | `.jetbrains-ai/` या `.idea/` | `.jetbrains-ai/instructions.md` |
| Pieces | `.pieces/` | `.pieces/instructions.md` |
| Tabby | `.tabby/` | `.tabby/instructions.md` |
| Tabnine | `.tabnine/` | `.tabnine/instructions.md` |
| CodeWhisperer | `.aws-codewhisperer/` | `.aws-codewhisperer/instructions.md` |
| Roo Cline | `.roo/` | `.roo/instructions.md` |

हर IDE में, टर्मिनल से वही `uxskill recommend` / `uxskill lint` / `uxskill stats` CLI कमांड काम करते हैं। Python इंजन सत्य का स्रोत है; IDE आर्टिफ़ैक्ट पतले प्रॉम्प्ट-हेडर हैं जो इसमें मार्ग बनाते हैं।

---

## उपयोग के मामले — ठोस परिदृश्य

आठ असली परिदृश्य। अपनी स्थिति के सबसे करीब वाला चुनें और आह्वान को अनुकूलित करें।

### 1. Cursor में फ़िनटेक डैशबोर्ड बनाना

आप एक MENA neobank डैशबोर्ड पर काम कर रहे Cursor में हैं। आप प्लगइन इंस्टॉल करते हैं और डिस्कवरी, अनुशंसा, फिर डैशबोर्ड जेनरेशन चलाते हैं।

```bash
pip install uxskill
uxskill init                                # Cursor का पता लगाता है, .cursorrules लिखता है
uxskill discover                            # 10-फ़ील्ड इनटेक
uxskill recommend \
  --project-type=dashboard \
  --industry=fintech-neobank \
  --tone=clinical --tone=precise \
  --must-have=dark-mode --must-have=a11y-AA --must-have=RTL \
  --forbidden=brutalism --forbidden=purple-gradients \
  --stack=nextjs-15-app-router \
  --region=mena
```

फिर Cursor में पूछें: *"Generate the dashboard surface using the recommendation in .ux/last-recommendation.json"*। Cursor `.cursorrules` हेडर पढ़ता है, अनुशंसा लोड करता है, स्पष्ट बाधाओं के साथ एक डैशबोर्ड जेनरेशन डिस्पैच करता है।

### 2. Claude Code में Stripe-शैली लैंडिंग जेनरेट करना

```
/plugin marketplace add Laith0003/ux-skill
/plugin install ux@ux-skill
/ux-discover
> Project type? landing
> Industry? fintech-payments
> Tone? serious, technical, confident
> Must have? dark-mode, AA, mobile-first
> Forbidden? purple-gradients, three-equal-cards
> Reference brands? stripe
> Stack? nextjs-15-app-router
> Region? global
> Success metric? signup conversion

/ux-recommend
> [चयनित शैली, पैलेट, टाइप पेयर, मोशन प्रीसेट, कंपोनेंट, ब्रांड उदाहरण लौटाता है]

/ux-design "generate the landing using the Stripe brand spec as exemplar"
> [frontend-engineer पेज जेनरेट करता है]

/ux-lint .
> [पास होता है — Stripe ब्रांड स्पेक का सम्मान किया गया]
```

### 3. CI में AI स्लॉप के लिए मौजूदा कोड का ऑडिट

आपने दो हफ़्ते पहले एक Next.js ऐप शिप किया। आप हर PR पर AI फ़िंगरप्रिंट के विरुद्ध एक कठोर मंज़िल चाहते हैं।

```yaml
# .github/workflows/ux-lint.yml
name: ux-lint
on: [pull_request]
jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with: { python-version: '3.11' }
      - run: pip install uxskill
      - run: uxskill lint . --ci --fail-on high
```

PR जो purple-to-blue ग्रेडिएंट, 96px पर Inter, "John Doe" टेस्टीमोनियल, या emoji-as-icons लाते हैं CI में फ़ेल हो जाते हैं। कोई LLM लागत नहीं। ~200ms।

### 4. एक मौजूदा सर्फ़ेस को पॉलिश करना जो "AI-जनरेटेड लगता है"

आपको एक React ऐप विरासत में मिला जो हर दूसरी AI-जनरेटेड SaaS साइट जैसा दिखता है। आप चाहते हैं कि यह वैसा न दिखे।

```
/ux-critique src/components/Hero.tsx
> [3 जीत, 3 चूक, 1 रणनीतिक चाल — राय ईमानदार है]

/ux-lint src/
> [15 high-severity AI फ़िंगरप्रिंट फ़्लैग किए गए]

/ux-polish src/components/Hero.tsx
> [LLM-चालित कॉस्मेटिक पास + AI-स्लॉप किल]

/ux-fix
> [निष्कर्षों को परमाणु कमिट के रूप में लागू करता है, लिंटर को पुनः चलाता है]
```

तीन कमांड, एक पॉलिश की हुई सर्फ़ेस, प्रति फ़िक्स परमाणु कमिट।

### 5. Linear-शैली कमांड पैलेट डिज़ाइन करना

```
/ux-component command-palette --brief="Linear-style, dark, monospace shortcuts, recent items first"
> [टोकन + हस्ताक्षर चालों के लिए data/brands/linear.app.json पढ़ता है]
> [command-palette एनाटॉमी + स्टेट के लिए data/components.json पढ़ता है]
> [स्पष्ट Linear स्पेक के साथ frontend-engineer को डिस्पैच करता है]
```

जेनरेट किया गया कंपोनेंट Linear के वास्तविक रंग टोकन, टाइप स्टैक, मोशन सम्मेलन, हेयरलाइन घनत्व का उपयोग करता है — "सामान्य डार्क UI" नहीं।

### 6. हितधारकों के साथ 90 मिनट का डिज़ाइन थिंकिंग वर्कशॉप चलाना

आपके पास 90 मिनट के लिए 5 लोगों का एक कमरा है। आप चाहते हैं कि वे एक गेम प्लान के साथ चले जाएँ, न कि एक वाइब के साथ।

```
/ux-workshop "loyalty wallet pivot" \
  --participants="2 PMs, 1 designer, 1 eng lead, 1 customer rep" \
  --minutes=90
```

प्लगइन पाँच चरणों (अन्वेषण → हीट मैप → हितधारक मैप → समाधान स्केच → गेम प्लान) को शुरू से अंत तक सुगम बनाता है, समय-सीमित, प्रति-चरण ठोस आर्टिफ़ैक्ट के साथ। आउटपुट `.ux/last-workshop.json` है — गेम प्लान, न कि केवल "दिलचस्प निष्कर्ष"।

### 7. लॉन्च के बाद एक प्रकाशन योग्य केस स्टडी लिखना

आपने लॉयल्टी वॉलेट शिप किया। आप एक पोर्टफ़ोलियो पीस चाहते हैं।

```
/ux-case-study --format=html --slug=bashiti-loyalty
> [.ux/last-frame.json, last-workshop.json, last-research.json, last-design.json, last-a11y.json, last-polish.json, last-recommendation.json, last-discovery.json पढ़ता है]
> [क्रमांकित (A)-(G) सेक्शन, हेयरलाइन सेपरेटर, द्विभाषी-सुरक्षित लेआउट के साथ Wfrah-संपादकीय केस स्टडी जेनरेट करता है]
> [case-studies/bashiti-loyalty.html लिखता है]
```

केस स्टडी एक तैयार, प्रकाशन योग्य आर्टिफ़ैक्ट है — ड्राफ़्ट नहीं। शुद्ध मोनोक्रोम, संपादकीय टाइपोग्राफ़ी, आपके पोर्टफ़ोलियो पर शिप करने के लिए तैयार।

### 8. एक गैर-AI संदर्भ में डिस्कवरी चलाना (बस संरचित इनटेक)

आप एक प्रोजेक्ट का दायरा कर रहे हैं। आपको अभी अनुशंसा की ज़रूरत नहीं है — आपको एक संरचित ब्रीफ़ चाहिए।

```bash
uxskill discover
# 10-फ़ील्ड इनटेक, .ux/last-discovery.json में सेव करता है

cat .ux/last-discovery.json
# {
#   "project_type": "...",
#   "audience": "...",
#   ...
# }
```

आप JSON को अपनी टीम को सौंप सकते हैं, Notion डॉक में पेस्ट कर सकते हैं, या इसे एक अलग AI टूल में फ़ीड कर सकते हैं। ux-skill एक इंजन होने के अलावा एक संरचित इनटेक टूल भी है।

### 9. MASTER.md दृढ़ता — आपके डिज़ाइन निर्णय, रेपो में

`/ux-recommend` के बाद, चयनित शैली + पैलेट + टाइप + मोशन + कंपोनेंट + ब्रांड उदाहरण + रेलिंग्स को एक मानव-पठनीय Markdown फ़ाइल के रूप में बनाए रखें जिसे आपकी टीम समीक्षा, diff, और संस्करण-नियंत्रण कर सकती है।

```bash
python3 -m engine.cli.main persist save --project-root .
```

`.ux/design-system/MASTER.md` (YAML फ़्रंटमैटर + बॉडी) और `persist save-page` के ज़रिए प्रति जेनरेट की गई सर्फ़ेस `.ux/design-system/pages/<name>.md` लिखता है। बेकार — एक ही इनपुट बाइट-समान आउटपुट देता है, इसलिए अपरिवर्तित स्थिति पर पुनः चलाना git में no-op है।

---

## विकल्पों की तुलना में

संक्षिप्त सारांश तालिका। पूरी टेबल-दर-टेबल तुलना [uxskill.laithjunaidy.com/compare.html](https://uxskill.laithjunaidy.com/compare.html) पर है।

| आयाम | ux-skill | ui-ux-pro-max | open-design | taste-skill | huashu-design | stitch-skills | nothing-design | hallmark | material-3 |
|---|---|---|---|---|---|---|---|---|---|
| स्लैश कमांड | **22** | 1 | 19 | 1 | 1 | multi | 1 | 1 | 1 |
| कंपोनेंट | **148** | 0 | 0 | 0 | 0 | 0 | 0 | 0 | (MD3) |
| मोशन प्रीसेट | **57** | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| ब्रांड स्पेक | **160** | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| एंटी-पैटर्न नियम | **145** | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| CI-सेफ़ डिटरमिनिस्टिक लिंटर | **हाँ** | नहीं | नहीं | नहीं | नहीं | नहीं | नहीं | नहीं | नहीं |
| समर्थित IDE | **17** | 18 | 1 | 1 | 1 | 1 | 1 | 1 | 1 |
| डिस्कवरी गेट | **10 फ़ील्ड** | अंतर्निहित | अंतर्निहित | अंतर्निहित | अंतर्निहित | अंतर्निहित | अंतर्निहित | अंतर्निहित | अंतर्निहित |
| `.ux/` स्टेट चेन | **हाँ** | नहीं | नहीं | नहीं | नहीं | नहीं | नहीं | नहीं | नहीं |
| स्टार (2026-05-28) | 14 | 83,958 | 54,406 | 25,202 | 15,455 | 5,762 | 2,391 | 2,164 | 955 |

### ईमानदार आकलन

- **ui-ux-pro-max** जागरूकता पर बड़ा है, 18 IDE भेजता है, अपने CSV पर BM25-शैली खोज है। यह एक कंपोनेंट मैनिफ़ेस्ट, मोशन मैनिफ़ेस्ट, ब्रांड लाइब्रेरी, या डिटरमिनिस्टिक लिंटर नहीं भेजता।
- **open-design** के पास 19 स्किल + प्रीव्यू है लेकिन केवल Claude Code समर्थन और कोई एंटी-स्लॉप परत नहीं।
- **hallmark** भावना में सबसे करीब है (वह भी एंटी-स्लॉप) लेकिन एक एकल स्किल है — कोई इंजन नहीं, कोई मैनिफ़ेस्ट नहीं, कोई जुड़े कमांड नहीं।
- **material-3-skill** उत्कृष्ट है अगर आप विशेष रूप से Material Design 3 चाहते हैं। हम MD3 पर प्रतिस्पर्धा नहीं करते।

प्रति आयाम पूर्ण विवरण के लिए, [compare.html](https://uxskill.laithjunaidy.com/compare.html) देखें।

---

## रोडमैप

### v2.1 — लिंटर पूर्णता (Q3 2026)

- कुल 52 तक पहुँचने के लिए **+17 स्थगित एंटी-पैटर्न नियम**। लक्ष्य: dark-on-dark hover स्टेट, color-only स्टेट एनकोडिंग, अनावश्यक z-index वृद्धि, JS में हार्डकोडेड ब्रेकपॉइंट, disabled स्थिति के बजाय opacity, आदि।
- यांत्रिक रूप से ठीक करने योग्य निष्कर्षों (button-no-type, img-no-alt खाली-स्ट्रिंग, console-log-leak हटाना) के सुरक्षित पुनर्लेखन के लिए **`uxskill lint --fix`**।
- **VS Code एक्सटेंशन** जो लिंट निष्कर्षों को इनलाइन सामने लाता है (CI चलाने की ज़रूरत नहीं)।

### v2.2 — कंपोनेंट मैनिफ़ेस्ट विस्तार (Q4 2026)

- कुल 198 तक पहुँचने के लिए **+50 कंपोनेंट**। बिल्कुल नए: async फ़िल्टर के साथ combobox, recent-items heuristic के साथ command-palette, conditional-form-step, payment-element वैरिएंट, RTL-aware date picker, MENA-विशिष्ट phone input, hijri overlay के साथ calendar grid।
- 6 स्टैक्स में **प्रति-कंपोनेंट कोड एमिट** (Next.js + React, Vue 3 + Nuxt, SvelteKit, Astro, Blade + Alpine, vanilla HTML/CSS)।
- uxskill.laithjunaidy.com/playground पर **कंपोनेंट प्लेग्राउंड** — अनुशंसा इंजन आज़माएँ + लाइव कंपोनेंट प्रीव्यू देखें।

### v3 — मार्केटप्लेस + लॉक-इन (2027)

- **ब्रांड स्पेक मार्केटप्लेस** — समुदाय ब्रांड स्पेक प्रकाशित और खोजें। मॉडरेशन को निधि देने के लिए pay-to-publish।
- **कस्टम एंटी-पैटर्न नियम** — प्रोजेक्ट `data/anti-patterns.local.json` में अपने स्वयं के regex नियम परिभाषित कर सकते हैं (v2 में पहले से शिप; v3 खोज + साझाकरण जोड़ता है)।
- **`uxskill plan`** — एक ब्रीफ़ से पूर्ण मल्टी-पेज साइट योजना, केवल एक सर्फ़ेस नहीं।
- **Figma प्लगइन समानता** — वही अनुशंसा इंजन, Figma में सामने आया।

---

## योगदान

इश्यू और PR का स्वागत है। तीन उच्च-लीवरेज क्षेत्र:

### एक एंटी-पैटर्न नियम जोड़ें

1. `data/anti-patterns.json` संपादित करें — `id`, `name`, `severity`, `category`, `detection.pattern`, `detection.flags`, `detection.scope`, `evidence_template`, `fix`, `references` के साथ एक एंट्री जोड़ें।
2. `tests/linter/` में एक परीक्षण जोड़ें — एक फ़ाइल जो नियम को ट्रिगर करती है, एक जो नहीं करती।
3. `uxskill lint tests/linter/should-trigger/<rule>.tsx` चलाएँ — पुष्टि करें कि यह आग लगाता है। `tests/linter/should-not-trigger/<rule>.tsx` पर चलाएँ — पुष्टि करें कि यह नहीं करता।
4. एक PR खोलें।

### एक ब्रांड स्पेक जोड़ें

1. `id`, `name`, `category`, `voice`, `tokens`, `design_principles`, `signature_moves`, `anti-moves`, `references` के साथ `data/brands/<slug>.json` बनाएँ।
2. संगत गद्य `references/brands/<slug>.md` पर जोड़ें।
3. `data/brands/_index.json` में पंजीकृत करें।
4. एक PR खोलें। स्पेक प्राथमिक-स्रोत संदर्भों द्वारा समर्थित होना चाहिए (ब्रांड का वास्तविक उत्पाद, सार्वजनिक डिज़ाइन सिस्टम, या DESIGN.md अगर वे एक प्रकाशित करते हैं)।

### एक मोशन प्रीसेट जोड़ें

1. `data/motion-presets.json` संपादित करें — `id`, `name`, `category`, `tokens`, `stacks` (framer_motion, gsap, css), `accessibility.reduced_motion_fallback`, `when_to_use` के साथ एक एंट्री जोड़ें।
2. प्रीसेट के पास एक रिड्यूस्ड-मोशन वैरिएंट होना चाहिए। कोई अपवाद नहीं।
3. एक PR खोलें।

### प्रक्रिया

- पूर्ण प्रक्रिया के लिए [CONTRIBUTING.md](CONTRIBUTING.md) पढ़ें।
- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) पढ़ें।
- नए नियम और ब्रांड स्पेक की समीक्षा की जाती है: प्राथमिक-स्रोत आधार, एक ही प्रोजेक्ट में ओवरफ़िट नहीं, किसी भी डेटा में कोई इमोजी नहीं, जहाँ लागू हो वहाँ RTL-सुरक्षित व्यवहार।

---

## लाइसेंस, लेखक, आभार

### लाइसेंस

MIT। इसे उपयोग करें, फ़ोर्क करें, इस पर निर्माण करें। अगर यह आपको AI स्लॉप शिप करने से बचाता है, रेपो को स्टार करें — यह इसका समर्थन करने का सबसे सस्ता तरीका है।

### लेखक

**Laith Aljunaidy** — [Dot](https://thedotwallet.com) के एकल संस्थापक, एक MENA-पहले लॉयल्टी प्लेटफ़ॉर्म। ux-skill बना रहे हैं ताकि AI-जनरेटेड फ़्रंटएंड सब एक जैसा न दिखे।

- LinkedIn: [linkedin.com/in/laithaljunaidy](https://www.linkedin.com/in/laithaljunaidy/)
- ईमेल: laith.aljunaidy.laith@gmail.com
- रेपो: [github.com/Laith0003/ux-skill](https://github.com/Laith0003/ux-skill)
- साइट: [uxskill.laithjunaidy.com](https://uxskill.laithjunaidy.com)
- PyPI: [pypi.org/project/uxskill](https://pypi.org/project/uxskill/)
- npm: [npmjs.com/package/uxskill](https://www.npmjs.com/package/uxskill)

### आभार

- Anthropic की टीम को Claude Code और skill / plugin आर्किटेक्चर के लिए जिसने इसे वितरण योग्य बनाया।
- Nielsen Norman Group, Laws of UX (lawsofux.com), और UX अनुसंधान समुदाय जिनका काम `data/ux-guidelines.json` को सूचित करता है।
- `data/brands/` में सूचीबद्ध हर ब्रांड — उनकी सार्वजनिक डिज़ाइन प्रणालियाँ ब्रांड स्पेक के लिए सत्य का स्रोत हैं।
- मूल v1 योगदानकर्ता: एक सिंगल-शॉट Claude skill जो v2 Python इंजन के लिए बीज बना।
- 8 लोकप्रिय Claude UX प्लगइन जिनसे हमने तुलना की — उन्होंने मानदंड उठाया; यह हमारा उत्तर है।

---

**ux-skill** · **v3.1.0-stable** · इसलिए बनाया गया ताकि Claude Code, Cursor, Windsurf, और हर दूसरा AI कोडिंग टूल फ़्रंटएंड आउटपुट करे जो AI-जनरेटेड के रूप में न पढ़ा जाए।

> [github.com/Laith0003/ux-skill](https://github.com/Laith0003/ux-skill) पर रेपो को स्टार करें · `pip install uxskill` या `npx uxskill init` के ज़रिए इंस्टॉल करें · [uxskill.laithjunaidy.com/compare.html](https://uxskill.laithjunaidy.com/compare.html) पर तुलना देखें
