دانا ڈویلپر ورک فلو + ملٹی ایجنٹ ڈویلپمنٹ ٹیمیں

ایک عقلمند ڈویلپر دیوہیکل پل کی درخواست کھول کر کوئی نیا پروجیکٹ شروع نہیں کرتا ہے۔ وہ ذہن سازی، ٹیم میٹ ڈسکشن، پروٹو ٹائپنگ، ڈائیگرامس، پروپوزل، ADRs، MRs/PRs، اور GitOps کے ذریعے آگے بڑھتے ہیں — ہر تبدیلی پر ریویو بوٹ کے ساتھ — اور، جب اسکیل اس کا مطالبہ کرتا ہے، تو ورک سٹیشن کا ملٹی ایجنٹ فن تعمیر ایک عظیم ترقیاتی ٹیم کو جمع کرنے کے لیے جو پروڈکشن گریڈ کے کام کو تیزی سے بھیجتا ہے۔

1. نئے پروجیکٹ پر "دانشمند" کا کیا مطلب ہے۔

عقل سستی ہے جلدی سیکھنا اور نایاب مہنگی غلطیاں دیر سے۔ ذیل کی ترتیب ترتیب دی گئی ہے لہذا ہر قدم اگلے کے دھماکے کے رداس کو سکڑتا ہے:

Brainstorm → Discuss with workmates → Prototype → Diagram → Propose → ADR
      → Implement in small slices → MR/PR + Review Bot → Merge
      → GitOps promote (dev → staging → prod) → Observe → Iterate

Optional scale-up:
      Workstation multi-agent crew (Planner / Builders / Reviewers / Ops)
      with human gates on risky actions

2. ذہن سازی کرنا

دوسرے لوگوں کا وقت گزارنے سے پہلے، 30-90 منٹ اکیلے گزاریں:

• نتیجہ - جب ہم مکمل کر لیں تو کاروبار کے لیے کیا سچ ہونا چاہیے؟
• پابندیاں - وقت، تعمیل، پلیٹ فارم، مہارت، بجٹ۔
• غیر اہداف - کیا v1 واضح طور پر شامل نہیں ہوگا۔
• خطرات - ڈیٹا، سیکورٹی، کارکردگی، لاک ان، آپریشنز لوڈ۔
• کامیابی کی پیمائش - دو منتخب کریں (جیسے تاخیر + اپنانے، یا لاگت + غلطی کی شرح)۔

اسے نیچے لکھ دیں۔ docs/ideas/. غیر تحریری دماغی طوفان بھاپ بن جاتے ہیں۔

3. ساتھیوں کے ساتھ بات چیت

سب سے چھوٹے مفید دائرے کو مدعو کریں: ایک ہم مرتبہ عمل درآمد کرنے والا، ملحقہ نظام کا مالک، اور سیکیورٹی/SRE جب خطرہ اس کی ضمانت دیتا ہے۔

• ٹائم باکس (25-45 منٹ)۔ فیصلوں یا کھلے سوالات کے ساتھ ختم کریں۔
• زبردستی کے اختیارات: A بمقابلہ B بمقابلہ ڈیفر - مبہم معاہدہ نہیں۔
• ایک کاتب تفویض کریں؛ نوٹ تجویز کو بیج دیتا ہے۔
• تکلیف کو ADR کے لیے خطرات کے طور پر پکڑیں ​​- کوئی خاموش ویٹو نہیں۔

اگر کوئی لوپ بند کر دے تو Async RFCs ٹھیک ہیں۔

4. پروٹو ٹائپنگ

جب غیر یقینی صورتحال زیادہ ہو تو اسپائک کریں۔ حکمت کے اصول:

1. اس پر اسپائک کا لیبل لگائیں؛ ایک کیلنڈر اسٹاپ سیٹ کریں (1-3 دن عام)۔
2. اسے پھینکنے والی شاخ پر رکھیں یا spikes/ - پالش نہ کرو.
3. آپ نے جو سیکھا اس پر دس گولیاں لکھیں (خاص طور پر ناکامیاں)۔
4. فیصلہ کریں: فروغ دیں، دوبارہ لکھیں یا ترک کریں — کبھی بھی "خاموشی سے پروڈکٹ نہ بنیں۔"

5. خاکہ

تین خاکے عام طور پر کافی ہوتے ہیں:

خاکہ	جوابات
سیاق و سباق (C4 L1)	کون کس سے بات کرتا ہے؟ اعتماد کی حدود؟
ترتیب	خوشی کا راستہ + ایک ناکامی کا راستہ
تعیناتی	جہاں یہ چلتا ہے؛ تشکیل اور راز کا بہاؤ

تجویز کے آگے Mermaid یا SVG اسٹور کریں۔ ADRs تبدیل ہونے پر اپ ڈیٹ کریں۔

6. تجاویز

RFC مختصر رکھیں (1–3 صفحات): مسئلہ، اختیارات (کم از کم دو)، سفارش، اثر (سیکیورٹی/لاگت/آپس)، رول آؤٹ اور رول بیک، کھلے سوالات۔ منظور ہونے پر، فیصلے کو ADR میں تبدیل کریں۔

7. ADR - آرکیٹیکچر فیصلہ ریکارڈز

# ADR-00XX: Title

Status: Proposed | Accepted | Superseded by ADR-00YY
Date: YYYY-MM-DD
Deciders: @alice @bob

## Context
## Decision
## Consequences
## Alternatives considered

ADRs کو گٹ میں رکھیں (docs/adr/)۔ انہیں PRs سے لنک کریں۔ تاریخ کو دوبارہ لکھنے کے بجائے سپرسیڈ کریں۔

8. MR اور PR - ترسیل کی اکائی

مسٹر (ضم کرنے کی درخواست) اور PR (Pull Request) ایک ہی خیال ہیں: ایک قابلِ جائزہ تبدیلی سیٹ۔

• چھوٹا (بامعنی اختلاف کی <400 لائنوں کو ترجیح دیں)؛ فی تبدیلی ایک ارادہ
• تفصیل: کیوں، ٹیسٹ کیسے کریں، خطرہ، رول بیک۔
• لنکس: ٹکٹ + ADR + خاکہ۔
• آراء کے لیے جلد ڈرافٹ؛ بغیر کسی تحریری استثناء کے ریڈ سی آئی یا ہائی سیوریٹی بوٹ فائنڈنگز کے ارد گرد زبردستی ضم نہ کریں۔

## Summary
## Test plan
- [ ] Unit / contract tests
- [ ] Manual path …
## Risk & rollback
## References (ADR, ticket)

9. بوٹ کا جائزہ لیں - خودکار تبصرے جو پیداوار کی حفاظت کرتے ہیں۔

ایک جائزہ بوٹ ایک خودکار پہلا جائزہ لینے والا ہے۔ یہ انسانوں کی جگہ نہیں لیتا۔ یہ بورنگ اور خطرناک کو سامنے لاتا ہے لہذا ڈویلپر ڈیزائن اور مصنوعات کے خطرے پر وقت صرف کرتے ہیں۔

9.1 اس پر کیا تبصرہ کرنا چاہیے۔

• سیکیورٹی: انجیکشن، اوتھز گیپس، خفیہ رساو، غیر محفوظ ڈیفالٹس
• درستگی: ناکارہ راستے، نسلیں، ٹوٹی ہوئی نقل مکانی۔
• ٹیسٹ: نئی شاخوں پر کوریج غائب ہے۔
• API/معاہدے: ورژن کے ٹکرانے کے بغیر تبدیلیاں توڑنا
• آپریشنز: لاپتہ ٹائم آؤٹ، غیر محدود دوبارہ کوششیں، غیر قابل تحریر تحریریں۔

9.2 یہ کس طرح ڈویلپر کی زندگی کو ہموار کرتا ہے۔

1. مصنف منٹوں میں PR → بوٹ تبصرے کھولتا ہے۔
2. مصنف انسانوں سے پوچھنے سے پہلے درست کرتا ہے یا جواب دیتا ہے۔
3. انسان بوٹ کا خلاصہ پڑھتا ہے + فن تعمیر اور دھماکے کے رداس پر فوکس کرتا ہے۔
4. کم نٹ راؤنڈ؛ پیداوار میں فرار ہونے والی کم بندوقیں

9.3 پالیسی جو بوٹ کو کارآمد رکھتی ہے۔

• شدت: بلاکر / ٹھیک کرنا / نِٹ - نِٹس کو انضمام کو بلاک نہیں کرنا چاہئے۔
• پیدا شدہ راستوں کو نظر انداز کریں؛ جھوٹے مثبت کو ماہانہ ٹیون کریں۔
• پر انسانی منظوری کی ضرورت ہے۔ auth/, infra/، IAM، اور پیسے کے راستے۔
• بوٹ کو کبھی بھی پیداواری اہم خدمات کا واحد جائزہ لینے والا نہ بننے دیں۔

وائر SaaS بوٹس (جیسے CodeRabbit)، کرسر بگ بوٹ، یا PR فرق پر ایک حسب ضرورت ایکشن + LLM۔ مضبوط ترین کرنسی کے لیے لیئر لِنٹ → SAST → LLM۔

10. پروڈکشن گریڈ کے معیار کے لیے GitOps کے بہترین طریقے

مطلوبہ ریاست گٹ میں رہتی ہے۔ ایک مصالحت کرنے والا (آرگو سی ڈی، فلوکس، وغیرہ) کلسٹر کو میچ کرتا ہے۔ فروغ ایک انضمام ہے؛ رول بیک واپسی ہے۔

• علیحدہ ایپ کوڈ اور env تشکیل (یا صاف envs/dev|staging|prod اوورلیز)۔
• کوئی ایڈہاک نہیں۔ kubectl apply خوشی کے راستے کے طور پر تیار کرنے کے لئے - صرف گلاس توڑنا، آڈٹ کیا گیا۔
• پروگریسو ڈیلیوری: خودکار مطابقت پذیری لوئر envs؛ پروڈکٹ کے لیے گیٹڈ سنک۔
• پروڈ میں متغیر ٹیگز پر تصویر ہضم ہوتی ہے۔
• پالیسی بطور کوڈ (OPA/Kyverno) استحقاق اور رجسٹریوں کے لیے۔
• مطابقت پذیری کے بعد مشاہدہ کریں؛ واپسی کی مشق کریں.

کوڈ کا معیار نہ صرف صاف افعال ہے - یہ بھی ہے۔ تبدیلی پیداوار میں کیسے داخل ہوتی ہے۔.

11. ورک سٹیشن ملٹی ایجنٹ فن تعمیر — عظیم ترقیاتی ٹیموں کی تعمیر

ایک عقلمند ڈویلپر کو اب بھی لیوریج کی ضرورت ہے۔ ورک سٹیشن کا ملٹی ایجنٹ فن تعمیر (Agentic AI ورک سٹیشن پیکجز، اور OpenClaw for Business جہاں آپ کو مجسم یا خصوصی ایجنٹ کے عملے کی ضرورت ہے) آپ کو اجازت دیتا ہے ایک ترقیاتی ٹیم کو خود بخود بنائیں کاروباری مختصر کے ارد گرد - ایک جامد تنظیم چارٹ نہیں.

11.1 کمپوزیشن لوپ

1. مختصر - اسٹیک ہولڈر کا نتیجہ، رکاوٹیں، SLA۔
2. تحریر کریں۔ - مہارتوں کا نقشہ رول (منصوبہ ساز، بلڈر، جائزہ لینے والا، آپریشنز، تعمیل)۔
3. بوٹسٹریپ — ایجنٹ رن ٹائم + MCP ٹولز + میموری + آڈٹ ٹریل۔
4. پھانسی - ایجنٹ کام کو کھینچتے ہیں، Spec/AC کے خلاف عمل درآمد کرتے ہیں، ہر قدم کا چھوٹا جائزہ لیتے ہیں۔
5. صاف ہونے تک جائزہ لیں۔ - بوٹ + جائزہ لینے والے ایجنٹوں + انسانی دروازے کا جائزہ لیں۔
6. جہاز - GitOps اہم ماحول کو فروغ دیتے ہیں۔

11.2 کردار کا نقشہ (انسانی + ایجنٹ)

کردار	ایجنٹ کرتا ہے۔	انسان اب بھی مالک ہے۔
منصوبہ ساز	ایپکس، کہانیاں، سپیک سے AC	ترجیح اور دائرہ کار میں کمی
بلڈرز	متوازی نفاذ، ٹیسٹ	سخت کناروں پر ڈومین کا فیصلہ
جائزہ لینے والے	تفصیلات کی تعمیل، بوٹ ٹرائیج کا جائزہ لیں۔	فن تعمیر اور پروڈکٹ سائن آف
آپریشنز	GitOps مطابقت پذیری، SLO واچ، ڈرافٹ رول بیک	گو لائیو اور واقعہ کا حکم
HITL گیٹ	خطرناک لکھنا / خرچ کرنا	منظور یا رد کرنا

11.3 یہ عظیم ٹیمیں کیوں بناتا ہے۔

• تخصص - ہر ایجنٹ کا ایک کام ہے؛ جب کردار دھندلا نہیں ہوتے ہیں تو معیار بڑھتا ہے۔
• افراتفری کے بغیر تھرو پٹ - ایک ہی اسپیک اور ریویو بوٹ کے پیچھے متوازی بلڈر۔
• فیصلوں کی یادداشت مشترکہ — ADRs + Spec + PR کی تاریخ ٹیم کی طویل مدتی میموری بن جاتی ہے۔
• انسانوں کی طرح ایک ہی دروازے — CI, Review Bot, CODEOWNERS, GitOps — ایجنٹس پروڈکشن ڈسپلن کو نظرانداز نہیں کرتے ہیں۔
• کاروبار کی رفتار - ہر اسپائیک کے لیے بھرتی کرنے کے لیے ہفتوں کے بجائے ایک قابل عملہ کھڑا کرنے کے لیے گھنٹے۔

11.4 یہ کس طرح دانشمندانہ راستے میں شامل ہوتا ہے۔

ذہن سازی اور بحث اب بھی انسانوں کے ساتھ ہوتی ہے۔ پروٹو ٹائپ اور خاکے اب بھی ہوتے ہیں۔ ملٹی ایجنٹ کا عملہ تیز کرتا ہے۔ پروپوزل ڈرافٹنگ، ADR سہاروں، نفاذ کے سلائسز، ریویو بوٹ ٹرائیج، اور GitOps پروموشن - جب کہ انسان نتائج اور خطرے کے بارے میں فیصلہ کرتے ہیں۔ یہ ہے ورک سٹیشن ماڈل: ایجنٹ ورک سٹیشنز اور اوپن کلاؤ پیکجز جو آپ کے ورک فلو کے لیے ترتیب دیے گئے ہیں، نہ کہ ایک ٹیم ہونے کا بہانہ کرنے والی چیٹ ونڈو۔

12. آخر سے آخر تک معیار کے دروازے

Local:     pre-commit (fmt, lint, secrets) + unit tests
PR open:   CI + Review Bot comments
PR merge:  human approve + branch protection + required checks
Main:      immutable artifact (image digest)
GitOps:    update env overlay → sync → verify
Agents:    Planner/Builder/Reviewer/Ops stay inside the same gates
Prod:      SLOs + alerts + runbook linked from ADR/PR

13. سٹارٹر چیک لسٹ

1. بنائیں docs/ideas/, docs/architecture/, docs/adr/
2. PR/MR ٹیمپلیٹ + CODEOWNERS + برانچ تحفظ شامل کریں۔
3. پری کمٹ + CI مطلوبہ چیک کو فعال کریں۔
4. ریویو بوٹ انسٹال کریں؛ ٹیون پاتھ فلٹرز اور شدت
5. ADR-0001 لکھیں: "ہم تعیناتی کے لیے GitOps استعمال کرتے ہیں"
6. env پروموشن کے قواعد اور رول بیک گیم ڈے کی وضاحت کریں۔
7. اگر اسکیلنگ ڈیلیوری: اسٹینڈ اپ ورک سٹیشن ملٹی ایجنٹ کریو (پلانر/بلڈرز/ریویورز/اوپس) HITL گیٹس کے ساتھ

14. مخالف پیٹرن

• جائنٹ "WIP برائے مہربانی منظور کریں" PRs
• فن تعمیر صرف سلیک میں - کبھی بھی ADR میں نہیں۔
• پروٹو ٹائپ بغیر کسی ٹیسٹ کے پروڈ کے طور پر ضم ہو گئی۔
• ریویو بوٹ کو غیر فعال کر رہا ہے کیونکہ یہ پریشان ہے۔
• لکھنے تک رسائی کے ساتھ ایجنٹ اور کوئی انسانی دروازہ نہیں۔
• GitOps کے باہر پروڈکشن کے لیے ہاٹ فکس بغیر کسی واپسی کے منصوبے کے

15. بند کرنا

ایک سمجھدار ڈویلپر ایک نئے پروجیکٹ کو سیکھنے کے نمونے کے طور پر دیکھتا ہے - نوٹس، خاکے، تجاویز، ADRs - پھر چھوٹے MRs/PRs کے ذریعے ڈیلیور کرتا ہے جسے Review Bot کے ذریعے دیکھا جاتا ہے اور GitOps کے ذریعے فروغ دیا جاتا ہے۔ ورک سٹیشن کا ملٹی ایجنٹ فن تعمیر اس حکمت کو ایک مکمل ڈیولپمنٹ ٹیم میں پھیلاتا ہے: خصوصی ایجنٹس، مشترکہ تفصیلات، انسانی فیصلہ جہاں اس کی اہمیت ہے، اور زندگی گزارنے کے ہر راستے پر پیداواری درجے کے دروازے۔ اس طرح کوڈ کا معیار پیداوار کے لیے بہتر رہتا ہے جبکہ کاروبار اب بھی تیزی سے آگے بڑھتا ہے۔

کی طرف سے شائع ورک سٹیشن.