ایہ کیویں کم کردا اے
RADAR کیویں کم کردا اے۔
ڈویلپراں لئی اک تکنیکی جائزہ۔ RADAR کوڈنگ ایجنٹاں نوں چلاندا اے تے کسے کم نوں اوس ویلے ای بند کردا اے جدوں اوہ اوس کم دا قبولیت ٹیسٹ آپ فیر چلا لوے۔ ایجنٹ دا “مک گیا” اک دعویٰ اے؛ فیر چلانا ثبوت اے۔
01 لوپ
ہر کم لئی اکو لوپ۔
ہر کم اوسے لوپ وچوں لنگھدا اے، تے ہر قدم اوس ویلے ای چلدا اے جدوں اوہدے توں پہلاں والا قدم پاس ہو چکیا ہووے۔
- 01 · کھولنا کم تے قبولیت ٹیسٹ کم شروع ہون توں پہلاں لکھیا جاندا اے
- 02 · لیز اک مالک، اپنا worktree lease تے fence token
- 03 · کم ایجنٹ کم کردا اے پروجیکٹ دی اپنی کاپی وچ
- 04 · دعویٰ ایجنٹ آکھدا اے مک گیا نتیجہ نئیں، دعوے وجوں لکھیا جاندا اے
- 05 · تصدیق RADAR ٹیسٹ فیر چلاندا اے موجودہ revision اتے
- جے پاس ہووے بند ثبوت لیجر وچ سانبھیا جاندا اے
- جے فیل ہووے · 3 وچوں کوشش n فیر کھلیا، ناکامی نال لگی اوہی ایجنٹ قدم 03 توں فیر کوشش کردا اے
- 3 کوششاں مگروں کوئی ہور ایجنٹ کم سنبھالدا اے 3 ہور کوششاں تک، قدم 03 توں
- 3 ہور مگروں کم تہاڈی اڈیک کردا اے لیجر ہور کوششاں توں انکار کردا اے
- کھولنا
- کم اپنے مقصد تے اک فیر چلائی جا سکن والی قبولیت کمانڈ نال کھولیا جاندا اے۔ کم کھلن ویلے کمانڈ نوں چلائے بغیر جانچیا جاندا اے: جیہڑا معیار لکھے ہوئے طریقے نال چل نہ سکے اوہ اوسے ویلے رد ہو جاندا اے، اخیر تے جا کے پتہ نئیں لگدا۔
- لیز
- اک ویلے اک ای مالک کم اپنے کول رکھدا اے، اک lease تے fence token راہیں۔ پرانے مالک ولوں کیتی گئی لکھت رد کر دتی جاندی اے۔
- کم
- ایجنٹ اپنے git worktree وچ، اپنی branch اتے کم کردا اے۔
- دعویٰ
- ایجنٹ دی ایہ رپورٹ پئی کم مک گیا اے، دعوے وجوں لکھی جاندی اے۔ دعویٰ کم نوں بند نئیں کردا۔
- تصدیق
- RADAR قبولیت کمانڈ آپ چلاندا اے، کم دی موجودہ revision اتے۔ ایجنٹ دی اپنی رپورٹ پڑھی جاندی اے، پر اوہ ثبوت نئیں۔
- بند کرنا یا فیر کھولنا
- پاس ہون تے کم بند ہو سکدا اے، تے تصدیق دا ریکارڈ اوہدے ثبوت وجوں سانبھیا جاندا اے۔ ناکامی کم نوں فیر کھول دیندی اے تے ناکامی اوہدے نال لا دتی جاندی اے۔
- حداں
- ورکر دیاں تن کوششاں، فیر کسے ہور ایجنٹ ولوں تن وار کم سنبھالنا۔ اوہدے مگروں لیجر ہور کوششاں توں انکار کر دیندا اے تے کم تہاڈی اڈیک کردا اے۔ ماڈل، سیشن یا مشین بدلن نال گنتی صفر نئیں ہوندی، تے ہر فیر کوشش نوں دسنا پیندا اے پئی کیہ بدلیا۔
02 لیجر
اک ریکارڈ جیہدے وچ ہر ایجنٹ لکھدا اے۔
ہر ایجنٹ کماں دا اکو لیجر پڑھدا تے اوہدے وچ لکھدا اے: اک لوکل SQLite فائل۔ ایہو اکلا ریکارڈ اے پئی ہر کم کس کول اے، کیہ دعویٰ کیتا گیا تے ٹیسٹ نے کیہ وکھایا۔
- کم
- مقصد تے قبولیت کمانڈ، جیہڑے کم شروع ہون توں پہلاں لکھے جاندے نیں۔
- ملکیت
- ہر کم دا موجودہ مالک، اوہدے lease تے fence token نال۔
- کوششاں
- ہر کم لئی گنیاں جاندیاں نیں، سارے ایجنٹاں، ماڈلاں تے مشیناں نوں رلا کے۔
- دعوے
- ایجنٹ دی ایہ رپورٹ پئی کم مک گیا اے، نتیجیاں توں وکھ رکھی جاندی اے۔
- تصدیق دے ریکارڈ
- قبولیت دا ہر رن، اوس commit تے working tree نال بجھا ہویا جیہدے اتے اوہ چلیا۔
- تبدیلیاں
- قبولیت کمانڈ وچ تبدیلی پرانے تے نویں ورژن نال لکھی جاندی اے؛ override وی لکھیا جاندا اے۔
یادداشت
فیصلے تے سبق Markdown نوٹ نیں جنہاں دا اک ماخذ تے اک دائرہ ہوندا اے۔ اک لوکل انڈیکس اوہناں نوں آف لائن لبھدا اے، تے اک hook ملدے جلدے نوٹ ایجنٹ دے کم کرن توں پہلاں اوہدے سامنے رکھ دیندا اے۔ کیوں جے نوٹ سادے Markdown نیں، تسیں اوہناں نوں Obsidian وچ کھول سکدے او۔
03 علیحدگی
ہر کوشش اپنی وکھری کاپی وچ۔
- ہر کوشش اپنے git worktree وچ، اپنی branch اتے کم کردی اے۔ دو ورکر کدی اکو tree سانجھا نئیں کردے۔
- ورکر اپنی قبولیت کمانڈ فیر نئیں لکھ سکدا۔ صرف مینیجر ایہنوں بدل سکدا اے، تے اوہ وی کم بند ہون توں پہلاں؛ ہر تبدیلی پرانا تے نواں ورژن سانبھ کے رکھدی اے۔
- کم تہاڈی main branch تک صرف تصدیق پاس ہون مگروں اپڑدا اے، تے merge مگروں قبولیت کمانڈ اک وار ہور چلدی اے۔
- force-push ہر رول لئی رد کیتا جاندا اے۔
- ایہ قاعدے کوڈ وجوں چلدے نیں، ماڈل نوں کال کرن توں پہلاں تے مگروں۔ ایہ prompt نئیں، ایس لئی ایجنٹ گلاں راہیں ایہناں توں بچ کے نئیں نکل سکدا۔
04 ایجنٹ
اوہ ایجنٹ جیہڑے تسیں پہلاں ای ورتدے او۔
RADAR، Claude Code، Codex CLI، OMP تے Hermes Agent نوں تہاڈے کمپیوٹر اتے یا تہاڈے اپنے Linux سرورز اتے چلاندا اے۔ ایہ اوہناں دی تھاں نئیں لیندا: کم ہن وی اوہی کردے نیں۔
- Claude Code
- Codex CLI
- OMP
- Hermes Agent
- اک معاہدہ
- اوہی قاعدے، اوہی لیجر، اوہی تصدیقی گیٹ تے کوششاں دیاں اوہی حداں چاراں اتے لاگو ہوندیاں نیں۔
- مینیجر
- جس ایجنٹ نال تسیں گل کردے او، اوہی انتظام کردا اے: کم کھولدا اے، اوہناں نوں ورکراں دے حوالے کردا اے تے کسے کم نوں صرف پاس ہوئے تصدیقی ریکارڈ نال بند کردا اے۔
- ورکر
- ورکر کم اپنے اپنے worktree وچ کردے نیں۔ اوہ کم بند نئیں کر سکدے تے اپنی قبولیت کمانڈ نئیں بدل سکدے۔
05 پہلاں لوکل
پہلاں لوکل۔
RADAR نوں نہ اکاؤنٹ چاہیدا اے نہ کلاؤڈ۔
- تہاڈی مشین اتے
- لیجر، یادداشت دے نوٹ، worktree تے ہر تصدیقی رن، تہاڈے کمپیوٹر اتے یا تہاڈے اپنے Linux سرورز اتے۔
- نیٹ ورک چاہیدا اے
- تہاڈے ایجنٹ، جیہڑے اج وانگوں اپنے فراہم کنندگان نال گل کردے نیں۔ باقی ہر باہرلی سروس اختیاری اے تے اوس ویلے تک بند رہندی اے جدوں تک تسیں اوہنوں چالو نہ کرو۔
- لوڑاں
- Windows یا Linux (macOS نوں ہالے سپورٹ نئیں کیتا جاندا)، Python 3.12 یا ایہدے توں نواں، تے Git۔ RADAR صرف Python دی سٹینڈرڈ لائبریری ورتدا اے۔
- لاگت
- ایہدا اپنا کوئی بل نئیں۔ ایجنٹ اوہی اکاؤنٹ ورتدے رہندے نیں جنہاں نال تسیں اوہناں نوں سائن اِن کیتا اے۔ کوئی پیسیاں والی API صرف اوس ویلے ورتی جاندی اے جدوں تسیں فراہم کنندہ تے بجٹ دا ناں دسو۔
- انسٹال
- اپنے کوڈنگ ایجنٹ نوں ریپوزٹری دا لنک دیو تے آکھو “ایہنوں انسٹال کرو”۔ اوہ تہاڈا کمپیوٹر جانچدا اے، جو کجھ موجود نہ ہووے اوہنوں انسٹال کرن توں پہلاں پچھدا اے، RADAR نوں اک ورچوئل انوائرمنٹ وچ انسٹال کردا اے تے دسدا اے پئی radar init تے radar doctor کیہ آکھدے نیں۔
06 کمانڈاں
کمانڈاں دی اک چھوٹی لسٹ۔
اوہ کمانڈاں جیہڑیاں تسیں سبھ توں پہلاں ورتوگے۔ پلیس ہولڈر کونیاں والیاں بریکٹاں وچ نیں۔
| کمانڈ | ایہ کیہ کردی اے |
|---|---|
radar init | RADAR دی ہوم ڈائریکٹری تے لیجر سیٹ اپ کردی اے۔ |
radar doctor | انسٹال نوں جانچدی اے تے کوئی وی اختیاری سروس جیہڑی ہلے ترتیب نئیں دتی گئی، اوہدی لسٹ وکھاندی اے۔ |
radar task new --project P --goal "…" --accept "<command>" | کسے کم نوں اوہدی قبولیت کمانڈ نال کھولدی اے۔ |
radar dispatch <task> | کم کسے ایجنٹ دے حوالے کردی اے، جیہڑا اپنے worktree وچ کم کردا اے۔ |
radar status | پورا سسٹم وکھاندی اے۔ |
radar verify <task> | موجودہ revision اتے قبولیت کمانڈ فیر چلاندی اے۔ |
radar task done <task> --evidence "<verification report>" | کم بند کردی اے۔ تصدیق پاس ہون تک رد ہوندی اے۔ |
radar collect | مکیا ہویا کم اکٹھا کردی اے۔ |
radar integrate | تصدیق شدہ کم نوں main وچ merge کردی اے۔ |
radar stop | کم نوں پاسے رکھدی اے تے STOP لاندی اے۔ |
radar go | STOP ہٹاندی اے تے دسدی اے پئی کیہ اگے چل سکدا اے۔ |
radar memory search --local "<words>" | یادداشت دے نوٹ آف لائن لبھدی اے۔ |
radar uiradar web | کاک پٹ نوں ٹرمینل یا براؤزر وچ کھولدی اے۔ |
radar help --all | ہر کمانڈ دی لسٹ دیندی اے۔ radar <command> -h تفصیل دیندی اے۔ |
07 ایہ کیہ نئیں کردا
RADAR کیہ نئیں کردا۔
- ایہ تہاڈے ایجنٹاں دی تھاں نئیں لیندا۔ کوڈ ہن وی اوہی لکھدے نیں؛ RADAR اوہناں نوں اک ریکارڈ، اک ایسی جانچ جیہنوں اوہ چھڈ نئیں سکدے، تے اک یادداشت دیندا اے۔
- ایہ تہاڈے ٹیسٹ نئیں لکھدا۔ جانچ اونی ای چنگی ہوندی اے جنا اوہدا ٹیسٹ؛ RADAR کم شروع ہون توں پہلاں ٹیسٹ نوں واضح کر دیندا اے، تاں جے کوئی بندہ اوہنوں پڑھ سکے۔
- ایہ اوہ کم بند نئیں کردا جیہدا کوئی ٹیسٹ نہ ہووے۔ جس کم دی چلن یوگ قبولیت کمانڈ نہ ہووے، اوہ کھولن ویلے ای رد ہو جاندا اے۔
- ایہ تہاڈے ایجنٹاں نوں آف لائن نئیں رکھدا۔ اوہ اج وانگوں اپنے فراہم کنندگان نال گل کردے رہندے نیں۔
- اوپن ایڈیشن انفرادی ڈویلپراں لئی اے، ٹیماں لئی نئیں؛ کمپنی ایڈیشن تیاری وچ اے۔
08 حالت
ابتدائی رسائی وچ
ہن ابتدائی رسائی۔ عام جاری ہون تے اوپن سورس۔
RADAR ابتدائی رسائی وچ اے۔ عام جاری ہون تے ایہنوں Apache-2.0 لائسنس ہیٹھ اوپن سورس وجوں شائع کیتا جاوے گا۔ شامل ہون لئی سانوں لکھو۔