প্রকল্প সম্পর্কে

# ux-skill — AI কোডিং টুলের জন্য ডিজাইন ইন্টেলিজেন্স ইঞ্জিন ux-skill হলো একটি **ডিজাইন ইন্টেলিজেন্স ইঞ্জিন**, যা AI-জেনারেটেড UI-কে জেনেরিক না রেখে স্বতন্ত্র করে তোলার জন্য ডিজাইন করা হয়েছে। এটি Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, Codex এবং আরও অনেকসহ ১৭টি AI কোডিং টুলের সাথে ইন্টিগ্রেট করে। ইঞ্জিনটি ফ্রি, MIT-লাইসেন্সপ্রাপ্ত, অফলাইনে কাজ করে এবং কখনো LLM কল করে না। ## মূল বৈশিষ্ট্য - **ডিটারমিনিস্টিক ৭-অক্ষের সিন্থেসাইজার**: টেমপ্লেট থেকে বাছাই না করে ব্রিফকে নতুন ডিজাইন টোকেনে (warmth, contrast, density, geometry, formality, motion, type personality) কম্পাইল করে। - **১৫২টি anti-AI-slop লিন্টার নিয়ম**: ডিটারমিনিস্টিক regex-ভিত্তিক নিয়ম, যা CI-তে চলে এবং Critical/High ইস্যুতে নন-জিরো এক্সিট করে। - **১৬০টি ব্র্যান্ড স্পেক**: Apple, Stripe, Linear, Figma, Tesla, BMW, Notion, Spotify, Airbnb, Vercel, Supabase, Cursor, Raycast, Claude ইত্যাদি ব্র্যান্ডের জন্য প্রকৃত DESIGN.md স্পেক। - **১২টি কোয়েরি-যোগ্য JSON ম্যানিফেস্ট**: ৮৪টি স্টাইল, ১৭৬টি প্যালেট, ৭০টি টাইপ পেয়ারিং, ১৪৮টি কম্পোনেন্ট, ১৮৪টি ইন্ডাস্ট্রি, ৩৫টি চার্ট টাইপ, ৫৭টি মোশন প্রিসেট, ১১২টি UX ল, ১৫২টি anti-pattern নিয়ম, ২৫টি টেক স্ট্যাক এবং ১৬০টি ব্র্যান্ড স্পেক। - **২৫টি স্ল্যাশ কমান্ড**: Discovery, generation, audit, lint, polish, fix loop, case-study, workshop, copy, motion, a11y, dashboard এবং conductor কমান্ড। - **৫টি সাব-এজেন্ট**: Frontend engineer, motion engineer, copy writer, research synthesizer এবং design system architect। - **১৮টি MCP টুল**: যার মধ্যে ux_synthesize, ux_decisions_query এবং ux_decisions_stats রয়েছে। - **১৭টি IDE সাপোর্ট**: একই ইঞ্জিন, প্রতিটি IDE-র জন্য ভিন্ন গ্লু। - **অফলাইন এবং ডিটারমিনিস্টিক**: কোনো LLM কল নেই, একই ইনপুট সবসময় একই আউটপুট দেয়। ## ইনস্টলেশন তিনটি ইনস্টল পথ উপলব্ধ: ### পথ ১ — Claude Code মার্কেটপ্লেস (ক্যানোনিকাল) ```bash /plugin marketplace add Laith0003/ux-skill /plugin install ux@ux-skill ``` ### পথ ২ — pip (সর্বজনীন) ```bash pip install uxskill uxskill init # আপনার IDE স্বয়ংক্রিয়ভাবে শনাক্ত করে সঠিক আর্টিফ্যাক্ট ইনস্টল করে uxskill stats # ইনস্টল যাচাই করতে ম্যানিফেস্ট কাউন্ট প্রিন্ট করে uxskill lint . # বর্তমান ডিরেক্টরির বিরুদ্ধে লিন্টার চালায় ``` ### পথ ৩ — npx (Python প্রয়োজন নেই) ```bash npx uxskill init # প্রথম রানে pipx + uxskill ডাউনলোড করে npx uxskill recommend --industry=fintech-neobank --tone=warm --stack=nextjs-15-app-router ``` ## এটি কীভাবে কাজ করে 1. **ইনপুট**: `/ux-discover` (১০টি ফিল্ড) বা `ux recommend`-এ ফ্ল্যাগের মাধ্যমে একটি ব্রিফ দিন। 2. **৫টি সমান্তরাল সার্চ**: ইঞ্জিন ম্যানিফেস্ট জুড়ে (industry, style, tone, stack, forbidden/region) একসাথে পাঁচটি লুকআপ চালায়। 3. **মার্জ**: একটি ডিটারমিনিস্টিক মার্জার প্রার্থীদের র‍্যাঙ্ক করে এবং দ্বন্দ্ব সমাধান করে। 4. **আউটপুট**: style, palette, type pair, motion presets, components, brand exemplars এবং anti-pattern guardrails সহ একটি JSON ডকুমেন্ট। 5. **জেনারেশন**: ডাউনস্ট্রিম কমান্ডগুলো সাব-এজেন্টের মাধ্যমে কোড জেনারেট করতে সুপারিশটি ব্যবহার করে। 6. **যাচাইকরণ**: `/ux-lint` জেনারেটেড কোডকে ১৫২টি regex নিয়মের বিরুদ্ধে পুনরায় স্ক্যান করে। ## v3.1.0-এর হাইলাইট - **ব্র্যান্ড ফিডেলিটি প্রয়োগ**: লোগো পিক্সেল থেকে প্রাইমারি কালার পড়া হয়, ডিফল্ট ফন্ট প্রত্যাখ্যান করা হয়, evaluate-এ একটি হার্ড ফ্লোর থাকে যা ব্র্যান্ড কালার/লোগো বাদ দেওয়া বা কোনো প্রকৃত ইমেজারি না পাঠানো আউটপুট ফেল করে। - **মোবাইল-ফার্স্ট গেটেড**: নতুন ক্রাফট ফাউন্ডেশন এবং একটি wrap-aware গেট যা অনুভূমিক স্ক্রল, র‍্যাপিং nav/wordmark/button label বা অতিরিক্ত উঁচু sticky header-এ ফেল করে। - **Wow লেয়ার**: ইঞ্জিন প্রতি পেজে ২-৩টি সমন্বিত সিগনেচার মোমেন্ট তৈরি করে। - **আরও তীক্ষ্ণ লিন্টার**: ১৫২টি নিয়ম, যার মধ্যে imagery-mandatory, icon-only detection, placeholder-token এবং 100vw নিয়ম রয়েছে। - **৩১০টি পাসিং টেস্ট**: অফলাইন, ডিটারমিনিস্টিক, কখনো LLM কল করা হয় না। ## আর্কিটেকচার ইঞ্জিনটি নিয়ে গঠিত: - **data/**: কোয়েরি-যোগ্য JSON ম্যানিফেস্ট (styles, palettes, type pairs, components, industries, chart types, tech stacks, UX guidelines, motion presets, anti-patterns, brands)। - **engine/**: Python রিজনিং কোর (synthesizer, decisions, recommender, linter, discovery, generator, installer, CLI)। - **commands/**: ২৫টি Claude Code স্ল্যাশ কমান্ড (.md ফাইল)। - **agents/**: ৫টি সাব-এজেন্ট (.md ফাইল)। - **references/**: ডেটা এবং ডেমো পেজের জন্য গদ্য সোর্স। - **bin/**: npx র‍্যাপার এবং লিন্টার স্ক্রিপ্ট। - **.ux/**: প্রতি-প্রজেক্ট স্টেট ডিরেক্টরি। ## তুলনা README-তে আরও ৮টি Claude UX প্লাগইনের বিরুদ্ধে একটি সৎ তুলনা রয়েছে, যেখানে উল্লেখ করা হয়েছে ux-skill কোথায় জেতে (component library, motion presets, anti-pattern linter, brand specs, ১৭টি IDE সাপোর্ট, ২৫টি স্ল্যাশ কমান্ড) এবং কোথায় হারে (awareness, brand recognition, marketing polish)। ## লাইসেন্স MIT লাইসেন্স। লেখক: Laith Aljunaidy, আম্মানের ডিজাইনার ও CTO। সাইট: uxskill.laithjunaidy.com। GitHub: Laith0003/ux-skill। PyPI: uxskill। npm: uxskill।