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

# Design-Agent — DSH ডিজাইন এজেন্ট ওয়ার্কস্পেস এটি [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) এর উপর ভিত্তি করে একটি **ডিজাইন এজেন্টের সম্পূর্ণ পুনরুৎপাদনযোগ্য প্যাকেজ**, যাতে `my-agent` প্রিসেট, `design-references` রুটিং স্কিল (DSH অ্যাডাপ্টেড ভার্সন) এবং `design-router` ডিটারমিনিস্টিক টুল প্লাগইন রয়েছে। এই প্রজেক্টটি বিদ্যমান HTML-ভিত্তিক ডিজাইন এজেন্টকে আপগ্রেড করে এবং [design-references](https://github.com/haohaiHuang/my-pi-skills/tree/main/skills/design-references) মেথডোলজি ব্যবহার করে তৈরি করা হয়েছে। > ⚠️ **এই প্যাকেজটি মেকানিজম পুনরুৎপাদন করে, বিষয়বস্তু নয়।** রুটিং, ডিসিপ্লিন এবং টুলগুলি সম্পূর্ণ স্বয়ংসম্পূর্ণ (ক্লোন → `cp -RL` → রান)। তবে *রেফারেন্স লাইব্রেরি* ব্যক্তিগত—কয়েকটি প্রধান রিসোর্স `~/Desktop/Design/...` এবং `~/resources/design-references.md` নির্দেশ করে, যা এই গোপন সম্পদ রেপো সহ সরবরাহ করা হয় না। নতুন মেশিনে, এগুলো ফলব্যাক চেইনে (`web_search` + `dembrandt` + বিল্ট-ইন হ্যালমার্ক ডিসিপ্লিন) অবনতি ঘটাবে। সম্পূর্ণ ব্যক্তিগত রেফারেন্স সেটের জন্য, দয়া করে এই ডিরেক্টরিগুলি নিজে কপি করুন; এগুলি ছাড়াও, এই প্যাকেজটি "হ্যালমার্ক ডিসিপ্লিন + ওয়েব গবেষণা" ডিজাইন এজেন্ট হিসেবে কাজ করতে পারে। ## অন্তর্ভুক্ত উপাদান | কম্পোনেন্ট | ভূমিকা | | --- | --- | | [`plugins/design-router/`](plugins/design-router/) | ডিটারমিনিস্টিক টুল Cordis প্লাগইন (৬টি রিড-অনলি টুল + ১টি লোকাল লগ রাইটার, শূন্য এক্সটার্নাল রানটাইম ডিপেন্ডেন্সি) | | [`presets/my-agent/`](presets/my-agent/) | DSH এজেন্ট প্রিসেট (`agent.cordis.yml` + `preset.yml`): প্রতিটি ধাপের কনফার্মেশন গেট সহ থ্রি-লেয়ার রুটিং রোল (স্টেজ → ব্রাঞ্চ → স্টেজ) | | [`skills/design-references/`](skills/design-references/) | স্টেজ/ব্রাঞ্চ রুটিং স্কিল (স্টেজ ডিভার্শন → A প্রোডাক্ট / B কন্টেন্ট / C জেনেরিক → পাঁচটি স্টেজ), DSH অ্যাডাপ্টেড | | [`skills/hallmark/`](skills/hallmark/) | AI স্লপ বিরোধী এক্সিকিউশন স্কিল ([nutlope/hallmark](https://github.com/nutlope/hallmark) থেকে MIT আপস্ট্রিম কপি; `site/` থিম টোকেন এবং উদাহরণ স্কিলে বিল্ট-ইন, স্বয়ংসম্পূর্ণ) | > **DSH ভার্সন রিকোয়ারমেন্ট: `0.1.5-rc.1` বা তার পরবর্তী।** রোল প্লাগইন মোড 0.1.5 এ পরিবর্তিত হয়েছে (`text` → `prefix` + `suffix`); `text:` ব্যবহারকারী প্রিসেট `$.prefix missing required value` এর কারণে মাউন্ট হবে না। এই রেপোর প্রিসেট 0.1.5 মোডের উপর ভিত্তি করে এবং 0.1.5 এ引入 করা দুই লাইন ব্যবহার করে: `present` (`dsh-tool-present`, ডেলিয়ারেশন স্টেটমেন্ট) এবং `command-goal` (`/goal` কমান্ড)। ### টুল | টুল | ব্যবহার | স্টেজ | | --- | --- | --- | | `design_lookup <branch> <stage>` | ডিজাইন রিসোর্স রেজিস্ট্রি কোয়েরি (R/C/E/V 3-D ইনডেক্স + ফলব্যাক চেইন + সোর্স; আউটপুট ট্যাগ স্টাইল বাকেট) | "আমাকে এই ধাপে কী দেখতে হবে?" | | `design_route <need>` | প্রয়োজনীয় কিওয়ার্ডকে সুপারিশকৃত স্টাইল বাকেট কম্বিনেশনে ম্যাপ করে (প্রধান আবশ্যিক চেক + সেকেন্ডারি অন-ডিমান্ড) + প্রতিটি বাকেটে প্রতিনিধিত্বমূলক রিসোর্স | স্টেজ 1 গবেষণা (হোমোজেনাইজেশন বিরোধী রুটিং) | | `design_diversity <c1> <c2> <c3>` | মেশিন ৩টি ক্যান্ডিডেটের মধ্যে পার্থক্য পরীক্ষা করে (হিউ ফ্যামিলি / ফন্ট টোন / সোর্স বাকেট), পাস/ফেল | | `design_quality <report\|query>` | সোর্স কোয়ালিটি সিগন্যাল রেকর্ড/কোয়েরি (এক্সট্রাকশন সাকসেস রেট / রিওয়ার্ক রেট / অ্যাক্সেসিবিলিটি—অবজেক্টিভ, টেস্ট-নির্ভর নয়); লোকাল লগ, git এ নেই | স্টেজ 4 পর রেকর্ডিং / স্টেজ 1 ডিসিডিং কনজুম্পশন | | `design_audit <target>` | মেশিন স্লপ গেট (হ্যালমার্ক মেশিন সাবসেট) + ইন্টারফেস CS-* ৮ রুল + স্টেজ 4 স্ক্যান + ইনহেরিট্যান্স কনট্রাস্ট | স্টেজ 4 ভ্যালিডেশন | | `design_contrast <target>` | WCAG 2.1 + APCA অ্যাপ্রক্সিমেশন কনট্রাস্ট | স্টেজ 4 ভ্যালিডেশন | ### pi ভার্সনের সাথে ইচ্ছাকৃত পার্থক্য - **সরানো হয়েছে** `design_research` (DSH ledger-grep + refero প্রোব + `web_search` ফলব্যাক চেইন ব্যবহার করে) - **সরানো হয়েছে** `hallmark_study_fetch` (DSH `dembrandt` / `defuddle` ব্যবহার করে) - **সরানো হয়েছে** `before_agent_start` ইনজেকশন এবং `/design-router` কমান্ড (DSH এর স্কিল লোডিং মেকানিজম রুটিংকে কভার করেছে) - **`@deepseek-ai/dsh-tools` এর উপর নির্ভরশীল নয়** (ওয়ার্কস্পেস মডিউল dsh ইনস্টলেশন ডিরেক্টরি রিজলভ করতে পারে না); টুল ডেফিনিশন শুধুমাত্র JSON Schema দিয়ে তৈরি—শূন্য এক্সটার্নাল রানটাইম ডিপেন্ডেন্সি ### লেআউট ``` plugins/design-router/ ├── index.mjs # প্লাগইন এন্ট্রি: ৬টি টুল রেজিস্টার করে (৫টি রিড-অনলি + ১টি লোকাল লগ রাইটার) ├── checks/ # ট্রান্সপ্ল্যান্টেড চেকার (TS→JS): টাইপোগ্রাফি/লেআউট/অ্যাক্সেসিবিলিটি/কপি/কনট্রাস্ট/চিট/স্লপ-কিল/অ্যাসেট/টাইপ │ └── kill-slop.test.mjs # KS-* রিগ্রেশন টেস্ট (node checks/kill-slop.test.mjs) └── data/ └── registry.json # registry.md এর ডেটা ফর্ম (৯১টি রিসোর্স × ৯টি ব্রাঞ্চ রুটিং) ``` ### মেশিন গেট কভারেজ `design_audit` সাতটি চেকার মডিউল চালিয়ে গেট নম্বর সহ টু-ডু লিস্ট ফেরত দেয়: | ফ্যামিলি | গেট | সোর্স | | --- | --- | --- | | Hallmark স্লপ | 1/2/10/14/19/24/26/27/30/33/34/37/38a/39/40/41/46/47/50/51 | hallmark `slop-test.md` (মেশিন সাবসেট) | | ইন্টারফেস CS-* | CS-1…CS-8 | interfaces.dev চিটশিট | | অ্যানিমেশন EM-* | EM-2/3/5 (EM-1/7/8 গেট 10/14/27 এ ম্যাপ করা হয়েছে) | emilkowalski/skills | | kill-ai-slop KS-* | KS-03/04/05/08/14 | kill-ai-slop ট্রান্সক্রিপ্ট | | অ্যাসেট লেয়ার DR-A* | DR-A1/DR-A2 | Anshu অ্যাসেট লেয়ার গেট (ব্র্যান্ড লোগো/ইমেজ এক্সিস্টেন্স) | | design-references স্টেজ 4 | DR-4 (ফন্ট ওয়েট/বর্ডার রেডিওস ওভারস্পেসিফাইড) | design-references workflow.md | ### রক্ষণাবেক্ষণ - `registry.md` হলো **সোর্স অফ ট্রুথ** (`~/.agents/skills/design-references/references/registry.md`); এডিট করার পর `node plugins/design-router/scripts/build-registry.mjs` রান করে `data/registry.json` পুনর্জন্ম দিন (+ `data/manifest.json` ভার্সন মেটাডেটা)। **কখনোই registry.json ম্যানুয়ালি এডিট করবেন না।** - চেকার লজিক আপস্ট্রিম `extensions/design-router/checks/` অনুসরণ করে (TS→MJS ট্রান্সপ্ল্যান্ট); আপস্ট্রিম আপডেটের পর, `node plugins/design-router/scripts/check-checks-sync.mjs /path/to/my-pi-skills/extensions/design-router/checks` রান করে গেট কভারেজ যাচাই করুন—**তারপর ম্যানুয়ালি চেকার কনস্ট্যান্ট তুলনা করুন**: গেট নম্বর সমতুল্যতা ডিটেইল ড্রিফট ধারণ করে না (যেমন এক্সপ্যান্ডেড ডিফল্ট ফন্ট লিস্ট)। KS রিগ্রেশন টেস্ট এই ধরনের ড্রিফট ধারণ করে। - যেকোনো চেকার পরিবর্তনের পর: `node index.test.mjs` এবং `node checks/kill-slop.test.mjs`। ## একবারে পুনরুৎপাদন (নতুন মেশিন) রেপো **মেকানিজম** পুনরুৎপাদন করে: প্লাগইন + প্রিসেট + DSH অ্যাডাপ্টেড স্কিল সব রেপোতেই আছে (রেফারেন্স লাইব্রেরি *কনটেন্ট* ব্যক্তিগত—শীর্ষের সতর্কতা দেখুন)。 ```bash # ── রেপো সহ প্রদত্ত (ক্লোন → রান) ── # 1. স্কিল (design-references হলো DSH অ্যাডাপ্টেড ভার্সন; hallmark হলো MIT আপস্ট্রিম কপি) cp -R skills/design-references ~/.agents/skills/ cp -R skills/hallmark ~/.agents/skills/ # 2. প্রিসেট (cp -RL presets/my-agent/ এর রিলেটিভ প্লাগইন সিম্বলিক লিংককে স্বয়ংসম্পূর্ণ কপিতে এক্সপ্যান্ড করে— # ইনস্টলেশনের পর প্রিসেট আর রেপো প্যাথের উপর নির্ভর করে না, মুভ বা কপি করা যেতে পারে) mkdir -p ~/.dsh/.agent-presets cp -RL presets/my-agent ~/.dsh/.agent-presets/ # 3. প্লাগইন সোর্স (git ম্যানেজমেন্টের জন্য রেপো রুট ডিরেক্টরি plugins/ এ রাখা হয়) # প্রিসেট রিলেটিভ প্যাথ './plugins/design-router/index.mjs' রেফারেন্স করে: # presets/my-agent/plugins হলো রেপো রুট plugins/ এর রিলেটিভ সিম্বলিক লিংক, # cp -RL এটিকে রিয়েল ডিরেক্টরিতে এক্সপ্যান্ড করে—যেকোনো মেশিনে প্যাথ এডিটের প্রয়োজন নেই。 # 4. এক্সটার্নাল ডিপেন্ডেন্সি (সফট ডিপেন্ডেন্সি—মিসিং থাকলে গ্রেসফুলি ডিগ্রেড) npm install -g dembrandt # URL → ডিজাইন টোকেন (স্টেজ 1 ক্যান্ডিডেট ভ্যালিডেশন) # defuddle: npm install -g defuddle # npm install -g @open-pencil/cli # অপশনাল: .fig/.pen ডিজাইন ফাইল রিড/কনভার্ট/ভ্যালিডেট (Figma ফ্যামিলি স্কিল / ম্যানুয়াল রিভিউ এ ফলব্যাক) # ── নিজস্ব (ব্যক্তিগত পছন্দ; মিসিং থাকলে ফলব্যাক চেইনে ডিগ্রেড) # 5. মেশিন লোকাল অ্যাসেট (ledger + kami/zine/logo-generator রেফারেন্স লাইব্রেরি) # এগুলি ছাড়াও, এই প্যাকেজটি চালু থাকবে—"হ্যালমার্ক ডিসিপ্লিন + web_search/dembrandt" # ডিজাইন এজেন্ট হিসেবে—কিন্তু ক্যান্ডিডেট পুল আপনার ব্যক্তিগত পছন্দ হারাবে。 ``` **নোট**: প্রিসেটের প্লাগইন লাইন **রিলেটিভ প্যাথ** ব্যবহার করে (`./plugins/design-router/index.mjs`, `presets/my-agent/plugins` রিলেটিভ সিম্বলিক লিংক হিসেবে `cp -RL` দ্বারা এক্সপ্যান্ড করা হয়), তাই নতুন মেশিনে শুধুমাত্র প্রিসেট ডিরেক্টরি কপি করলেই হয়—**প্যাথ এডিটের প্রয়োজন নেই**। যদি আপনি সিম্বলিক লিংক এড়ানো চান, তবে `plugins/design-router/` কে `presets/my-agent/plugins/` এ কপি করুন এবং সাধারণ `cp -R` ব্যবহার করুন (ফলাফল একই, শুধু একটি অতিরিক্ত কপি থাকে)。 ### রেপো স্ট্রাকচার ``` ├── plugins/design-router/ # ডিটারমিনিস্টিক টুল প্লাগইন (৬টি টুল, শূন্য রানটাইম ডিপেন্ডেন্সি) ├── presets/my-agent/ # DSH প্রিসেট (agent.cordis.yml + preset.yml) ├── skills/ │ ├── design-references/ # রুটিং স্কিল (DSH অ্যাডাপ্টেড) │ └── hallmark/ # AI স্লপ বিরোধী স্কিল (MIT আপস্ট্রিম কপি, site/ থিম অ্যাসেট সহ) ├── README.md # ইংরেজি (প্রধান) └── README.zh.md # চাইনিজ ``` ## থার্ড-পার্টি কনটেন্ট এবং লাইসেন্স অ্যাসাইনমেন্ট এই রেপো নিম্নলিখিত থার্ড-পার্টি কনটেন্ট বান্ডল করে (আপস্ট্রিম লাইসেন্স/অ্যাসাইনমেন্ট সংরক্ষণ করে): | কনটেন্ট | সোর্স | লাইসেন্স | লোকেশন | | --- | --- | --- | --- | | hallmark স্কিল + `site/` থিম টোকেন এবং উদাহরণ | [nutlope/hallmark](https://github.com/nutlope/hallmark) | MIT (পুরো পাঠ্য [`skills/hallmark/LICENSE`](skills/hallmark/LICENSE) এ দেখুন) | `skills/hallmark/` | | রেজিস্ট্রি রেফারেন্সড এক্সটার্নাল ডিজাইন রিসোর্স (kami/zine/logo-generator ইত্যাদি) |各自 আপস্ট্রিম রেপো | শুধুমাত্র লিংক রেফারেন্স (বান্ডল করা নয়; সোর্স URL [`registry.md`](skills/design-references/references/registry.md) এ দেখুন) | — | অন্যান্য সব কিছু (`plugins/`, `presets/`, `skills/design-references/`) এই রেপোর মূল, [MIT লাইসেন্স](LICENSE) এর অধীনে (কপিরাইট © 2026 haohaiHuang)। ## সম্পর্কিত প্রজেক্ট - [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — এই প্যাকেজ চালানোর ইনফ্রাস্ট্রাকচার (`dsh`, everything is a plugin) - [my-pi-skills](https://github.com/haohaiHuang/my-pi-skills) — আপস্ট্রিম স্কিল রেপো (design-references / skill-router / vision) - [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) — নির্বাচিত DSH প্লাগইন তালিকা