Viserys کے ساتھ مستقل AI کوڈنگ ورک فلو کیسے بنائیں

ویسیرس کیا ہے؟

ویسیرس، AI کوڈنگ ایجنٹس کے لیے انجینئرنگ ورک فلو کا ایک خودکفیل مجموعہ ہے۔ ہر درخواست کے لیے ایجنٹ کو عمل خود ایجاد کرنے دینے کے بجائے، یہ دوبارہ استعمال کے قابل Markdown ہدایات، جائزہ لینے والی شخصیات، مشترکہ حوالہ جات، لائف سائیکل کمانڈز، تشخیصی فکسچرز اور توثیقی اسکرپٹس فراہم کرتا ہے۔

یہ پروجیکٹ سافٹ ویئر کے کام کو چھ مراحل پر مشتمل لائف سائیکل میں منظم کرتا ہے:

DEFINE -> PLAN -> BUILD -> VERIFY -> REVIEW -> SHIP

ہر ورک فلو ایک SKILL.md فائل میں موجود ہے اور اس میں طریقۂ کار کے مراحل، اختتامی معیار اور غیرمنطقی جواز تراشی سے بچنے کی رہنمائی شامل ہے۔ چونکہ اسکلز سادہ Markdown میں ہیں، اس لیے انہیں اسکل سے واقف کوڈنگ ایجنٹس لوڈ کر سکتے ہیں یا اسٹینڈ الون ہدایات کے طور پر براہِ راست پڑھا جا سکتا ہے۔

اہم خصوصیات

• لائف سائیکل کی مکمل کوریج: ورک فلو ضروریات، منصوبہ بندی، عمل درآمد، ٹیسٹنگ، جائزے اور ریلیز کی تیاری کا احاطہ کرتے ہیں۔
• 26 پیکج شدہ اسکلز: skills/ ڈائریکٹری میں دوبارہ استعمال کے قابل انجینئرنگ ورک فلو موجود ہیں۔
• جائزہ لینے والی شخصیات: خصوصی ایجنٹس کوڈ کے معیار، ٹیسٹنگ، سیکیورٹی اور ویب کارکردگی کا جائزہ لیتے ہیں۔
• OpenCode انضمام: بنیادی موڈ والا ویسیرس ایجنٹ شامل ہے، جو عالمی کنفیگریشن کے بغیر اسکلز لوڈ کرتا ہے۔
• مشترکہ حوالہ جات: چیک لسٹس کو ضرورت کے وقت لوڈ کیا جا سکتا ہے، انہیں مستقل طور پر ایجنٹ کے سیاق و سباق میں رکھنے کی ضرورت نہیں۔
• توثیق اور تشخیص: Node.js اسکرپٹس اسکلز، کمانڈز، آرٹیفیکٹ پاتھس، حوالہ جاتی لنکس، ورژنز اور تشخیصی کیسز کو چیک کرتی ہیں۔

ریپوزٹری کی ساخت سمجھیں

• skills/ میں اسکل ورک فلو موجود ہیں۔
• agents/ میں جائزہ لینے والی چار ماہر شخصیات موجود ہیں۔
• references/ ضرورت کے وقت استعمال ہونے والی مشترکہ چیک لسٹس فراہم کرتا ہے۔
• commands/ لائف سائیکل کمانڈز کی تعریف کرتا ہے۔
• evals/ میں اسکل کی تشخیصی مثالیں اور فکسچرز موجود ہیں۔
• scripts/ میں توثیق کار اور تشخیصی رنر موجود ہیں۔
• hooks/ سیشن لائف سائیکل ہکس فراہم کرتا ہے۔
• docs/ میں اندرونی دستاویزات موجود ہیں۔
• .opencode/agent/viserys.md OpenCode ایجنٹ کی تعریف کرتا ہے۔
• .opencode/opencode.json OpenCode کے لیے اسکل پاتھس رجسٹر کرتا ہے۔

انسٹالیشن اور سیٹ اپ

آپشن 1: OpenCode میں ویسیرس فعال کریں

1. Git کے ذریعے ویسیرس ریپوزٹری کلون کریں۔
2. OpenCode میں کلون کیے گئے ریپوزٹری فولڈر کو کھولیں۔
3. ایجنٹ سلیکٹر کھولنے کے لیے Tab دبائیں۔
4. viserys منتخب کریں۔

شامل ویسیرس ایجنٹ بنیادی موڈ میں چلتا ہے، اس لیے یہ OpenCode کی ایجنٹ فہرست میں دکھائی دیتا ہے۔ اس کا پرامپٹ درخواست پر کارروائی کرنے سے پہلے قابل اطلاق اسکل تلاش کرتا ہے اور کام کو پروجیکٹ لائف سائیکل کے مطابق آگے بڑھاتا ہے۔ ریپوزٹری کی سطح کی OpenCode کنفیگریشن تمام پیکج شدہ اسکلز رجسٹر کرتی ہے، اس لیے عالمی کنفیگریشن درکار نہیں۔

آپشن 2: ویسیرس کو کسی دوسرے اسکل سے واقف ایجنٹ کے ساتھ استعمال کریں

Claude Code، Cursor یا کسی ایسے ایجنٹ کے لیے جو دوبارہ استعمال کے قابل اسکلز کو سپورٹ کرتا ہو، ایجنٹ کو ریپوزٹری کی skills/ ڈائریکٹری کی طرف اشارہ کریں۔ متبادل طور پر، اس ڈائریکٹری کو ٹول کے مقامی اسکلز مقام میں کاپی کریں۔

درست منزل کوڈنگ ایجنٹ پر منحصر ہے۔ ویسیرس کو اپنے Markdown ورک فلو کو کسی دوسرے فارمیٹ میں تبدیل کرنے کی ضرورت نہیں، لیکن میزبان ٹول کو معلوم ہونا چاہیے کہ انہیں کہاں تلاش کرنا ہے۔

آپشن 3: اسکلز کو سادہ سیاق و سباق کے طور پر استعمال کریں

اگر کسی ایجنٹ میں مقامی اسکل سسٹم موجود نہ ہو تو متعلقہ SKILL.md فائل کھولیں اور اس کا مواد سیاق و سباق کے طور پر فراہم کریں۔ ہر اسکل کو خودکفیل انداز میں ڈیزائن کیا گیا ہے، اس لیے آپ اس کے مراحل دستی طور پر پورے کر سکتے ہیں یا ایجنٹ کو ان پر عمل کرنے کی ہدایت دے سکتے ہیں۔

درست ورک فلو منتخب کریں

جب آپ کو یقین نہ ہو کہ کون سا ورک فلو موزوں ہے تو میٹا اسکل using-agent-skills سے آغاز کریں۔ بصورت دیگر، موجودہ لائف سائیکل مرحلے کے مطابق اسکل منتخب کریں۔

DEFINE: کام واضح کریں

• جب کوئی تصور مبہم ہو اور منظم غور و فکر کی ضرورت ہو تو idea-refine استعمال کریں۔
• جب ضروریات ایک وقت میں ایک سوال کے ذریعے جمع کرنی ہوں تو interview-me استعمال کریں۔
• جب کسی specification کے بغیر پروجیکٹ، فیچر یا اہم تبدیلی شروع کرنی ہو تو spec-driven-development استعمال کریں۔
• جب معیار کا کوئی واضح پیمانہ موجود نہ ہو یا صرف build کامیاب بنانے کے لیے چیکس دبائے جا رہے ہوں تو constraint-driven-development استعمال کریں۔

PLAN: specification کو کاموں میں تبدیل کریں

ضروریات مستحکم ہونے کے بعد planning-and-task-breakdown استعمال کریں۔ یہ specification کو قبولیت کے معیار کے ساتھ ترتیب وار، قابل توثیق کاموں میں تبدیل کرتا ہے۔

BUILD: سوچ سمجھ کر عمل درآمد کریں

• incremental-implementation متعدد فائلوں پر پھیلی تبدیلیوں کو چھوٹے مرحلوں میں شامل کرنے میں مدد کرتا ہے۔
• منطق نافذ کرنے، بگ درست کرنے یا رویے میں تبدیلی کے وقت test-driven-development استعمال کریں۔
• سیشن شروع کرنے، کام تبدیل کرنے یا آؤٹ پٹ کا معیار کم ہونے پر بحالی کے لیے context-engineering مددگار ہے۔
• جب درستگی موجودہ سرکاری دستاویزات پر منحصر ہو تو source-driven-development موزوں ہے۔
• جب معاملہ اہم ہو اور ابھی جانچ کرنا بعد میں ڈیبگ کرنے سے سستا ہو تو doubt-driven-development توثیق کی حوصلہ افزائی کرتا ہے۔
• frontend-ui-engineering صارفین کو نظر آنے والے انٹرفیس کے کام کی رہنمائی کرتا ہے۔
• api-and-interface-design API، ماڈیول کی حدود اور عوامی انٹرفیس کے ڈیزائن میں معاونت کرتا ہے۔

VERIFY: ثابت کریں کہ تبدیلی کام کرتی ہے

• براؤزر پر مبنی عمل درآمد یا ڈیبگنگ کے لیے browser-testing-with-devtools استعمال کریں۔
• جب ٹیسٹ ناکام ہو، build ٹوٹ جائے یا رن ٹائم رویہ غیر متوقع ہو تو debugging-and-error-recovery استعمال کریں۔

REVIEW: معیار اور خطرے کا جائزہ لیں

• کسی تبدیلی کو merge کرنے سے پہلے code-review-and-quality استعمال کریں۔
• جب کام کرنے والا کوڈ سمجھنے یا برقرار رکھنے میں مشکل ہو تو code-simplification مفید ہے۔
• security-and-hardening کا اطلاق صارف کے ان پٹ، توثیق، ڈیٹا اسٹوریج اور بیرونی انضمامات پر ہوتا ہے۔
• جب کارکردگی کے تقاضے موجود ہوں یا خرابی کا شبہ ہو تو performance-optimization استعمال کریں۔

SHIP: پروڈکشن کے لیے تیاری

• git-workflow-and-versioning کوڈ کی تبدیلیوں اور ورژن کنٹرول کی رہنمائی کرتا ہے۔
• ci-cd-and-automation build اور deployment pipeline کی تبدیلیوں میں معاونت کرتا ہے۔
• deprecation-and-migration پرانے سسٹمز کو ہٹانے یا صارفین کو منتقل کرنے میں مدد دیتا ہے۔
• documentation-and-adrs آرکیٹیکچرل فیصلوں اور عوامی API کی تبدیلیوں کا ریکارڈ رکھتا ہے۔
• observability-and-instrumentation لاگز، میٹرکس، ٹریسز اور الرٹس کا احاطہ کرتا ہے۔
• shipping-and-launch حتمی پروڈکشن deployment کی تیاری کی رہنمائی کرتا ہے۔

بنیادی استعمال کی مثال

فرض کریں آپ کسی AI coding agent سے نیا authenticated API endpoint شامل کرنے کو کہتے ہیں۔ براہِ راست implementation شروع کرنے کے بجائے lifecycle کو ترتیب وار نافذ کریں۔

1. Define: اگر authentication rules، inputs یا responses واضح نہ ہوں تو interview-me چلائیں۔ پھر متوقع رویے کا تعین کرنے کے لیے spec-driven-development استعمال کریں۔
2. Plan: ترتیب وار tasks اور acceptance criteria تیار کرنے کے لیے planning-and-task-breakdown نافذ کریں۔
3. Build: endpoint contract کے لیے api-and-interface-design اور رویے کے لیے test-driven-development استعمال کریں۔ اگر کئی فائلوں میں تبدیلی درکار ہو تو incremental-implementation بھی استعمال کریں۔
4. Verify: اگر tests ناکام ہوں یا endpoint غیر متوقع طور پر کام کرے تو debugging-and-error-recovery کی پیروی کریں۔
5. Review: چونکہ یہ feature authentication اور input سے متعلق ہے، اس لیے code-review-and-quality اور security-and-hardening نافذ کریں۔
6. Ship: پروڈکشن deployment سے پہلے موزوں Git، documentation، observability اور launch workflows استعمال کریں۔

OpenCode integration فعال ہونے پر Viserys agent پہلے مطابقت رکھنے والی skills تلاش کرنے کے لیے بنایا گیا ہے۔ plain-context setup میں یہ انتخاب آپ خود کرتے ہیں اور agent سے منتخب کردہ ہر Markdown workflow کی پیروی کرنے کو کہتے ہیں۔

Reviewer Personas استعمال کریں

Viserys میں agents/ کے اندر چار reviewer personas شامل ہیں۔ یہ lifecycle skills کی تکمیل کے لیے مرکوز نقطۂ نظر فراہم کرتے ہیں۔

• agents/code-reviewer.md staff-engineer approval standard استعمال کرتے ہوئے پانچ محوروں پر review کرتا ہے۔
• agents/test-engineer.md prove-it pattern استعمال کرتے ہوئے test strategy اور coverage کا جائزہ لیتا ہے۔
• agents/security-auditor.md vulnerability detection، threat modeling اور OWASP assessment کا احاطہ کرتا ہے۔
• agents/web-performance-auditor.md quick یا deep modes میں Core Web Vitals کا audit کرتا ہے۔

تبدیلی کے خطرات کی بنیاد پر persona منتخب کریں۔ مثال کے طور پر authentication کے کام کے لیے security auditor کو security-and-hardening کے ساتھ استعمال کریں، یا user-facing interface میں تبدیلی کے بعد web performance auditor استعمال کریں۔

Workflow Pack کی توثیق کریں

skills، commands، references، versions یا evaluation fixtures تبدیل کرنے کے بعد فراہم کردہ Node.js scripts چلائیں:

node scripts/validate-skills.js
node scripts/validate-commands.js
node scripts/validate-artifact-paths.js
node scripts/validate-reference-links.js
node scripts/validate-versions.js
node scripts/run-evals.js

یہ commands pack کی داخلی ساخت کی توثیق کرتی ہیں اور اس کا evaluation suite چلاتی ہیں۔ یہ خاص طور پر Viserys کو صرف موجودہ workflows استعمال کرنے کے بجائے توسیع دیتے وقت اہم ہیں۔

اعلیٰ سطحی تجاویز

Lifecycle Gates چھوڑے بغیر Skills کو یکجا کریں

کسی task کے لیے ایک سے زیادہ skills درکار ہو سکتی ہیں۔ مثال کے طور پر browser feature میں frontend-ui-engineering، test-driven-development اور browser-testing-with-devtools کو یکجا کیا جا سکتا ہے۔ ہر skill کے exit criteria نمایاں رکھیں تاکہ workflows شامل کرنا غیر منظم prompting میں تبدیل نہ ہو۔

References صرف ضرورت کے وقت لوڈ کریں

references/ directory مشترکہ checklists کو ضرورت کے وقت لوڈ کرنے کے لیے ہے۔ اس سے agent کا فعال context مرکوز رہتا ہے اور تفصیلی رہنمائی تک رسائی بھی برقرار رہتی ہے۔

Version-Sensitive کام کے لیے سرکاری ذرائع استعمال کریں

جب implementation details موجودہ documentation پر منحصر ہوں تو source-driven-development نافذ کریں۔ جب بظاہر درست مگر غلط assumption مہنگی ثابت ہو سکتی ہو تو اسے doubt-driven-development کے ساتھ استعمال کریں۔

Agent کا معیار کم ہونے پر بحالی کریں

اگر طویل session میں عدم تسلسل پیدا ہو جائے تو context-engineering استعمال کریں۔ یہ خاص طور پر session setup، task switching اور output quality کم ہونے کی صورتِ حال کے لیے ہے۔

شامل Documentation سے رجوع کریں

• docs/README.md pack اور lifecycle map کی وضاحت کرتا ہے۔
• docs/skill-anatomy.md SKILL.md format کی تعریف کرتا ہے۔
• evals/README.md skill evaluation کے طریقۂ کار کی وضاحت کرتا ہے۔

workflows شامل کرنے یا ان کی ساخت تبدیل کرنے سے پہلے skill anatomy specification پڑھیں، پھر نتیجے کی جانچ کے لیے validators اور evaluations چلائیں۔

نتیجہ

Viserys AI-assisted development کو ایک قابلِ تکرار engineering process میں تبدیل کرتا ہے۔ آغاز کے لیے skills/ directory کو کسی compatible agent سے منسلک کریں یا OpenCode میں bundled Viserys agent منتخب کریں۔ پھر DEFINE، PLAN، BUILD، VERIFY، REVIEW اور SHIP کے مراحل سے منظم انداز میں گزریں، اور جہاں فائدہ ہو specialist personas اور validation scripts استعمال کریں۔