وہی پرامپٹ، وہی ڈایاگرام
Prateek Rai نے tldraw-canvas-kit جاری کیا ہے، جو 19 "Agent Skills" کا ایک مجموعہ ہے جو Claude Code یا Cursor جیسے مقامی AI اسسٹنٹس کو آف لائن tldraw ڈیسک ٹاپ ایپ چلانے اور ہر بار ایک جیسے انجینئرنگ ڈایاگرامز تیار کرنے کی اجازت دیتا ہے۔ یہ کٹ کسی بھی کلاؤڈ کنکشن یا ٹیلی میٹری کے بغیر کام کرتا ہے، جس کا مطلب ہے کہ ٹیمیں اپنے بصری اثاثوں (visual assets) کو مکمل طور پر آن پریمیس (on-premises) رکھ سکتی ہیں۔
ایک مقامی اور یقینی (deterministic) ڈایاگرام ٹول کیوں اہم ہے
انجینئرنگ ٹیمیں سلائیڈ ڈیکس، ڈاکومنٹیشن سائٹس اور ڈیزائن ٹولز کے درمیان فلو چارٹس، کلاس ڈایاگرامز اور آرکیٹیکچر میپس منتقل کرنے میں گھنٹوں صرف کرتی ہیں۔ ہر کاپی پیسٹ کا مرحلہ معمولی تبدیلیاں لاتا ہے—لائن اسٹائل بدل جاتے ہیں، IDs دوبارہ بن جاتی ہیں، اور لے آؤٹ میں فرق آ جاتا ہے۔ جب کسی LLM کے ذریعے ڈایاگرام دوبارہ تیار کیا جاتا ہے، تو نتیجہ اکثر مختلف ترتیب میں ہوتا ہے، چاہے ٹیکسٹ پرامپٹ تبدیل نہ ہوا ہو۔ ان تنظیموں کے لیے جنہیں آڈٹ کے قابل ڈاکومنٹیشن یا دوبارہ پیدا کیے جانے والے (reproducible) ڈیزائن آرٹفیکٹس کی ضرورت ہوتی ہے، یہ تبدیلی ایک نقصان ہے۔
Prateek نے tldraw-canvas-kit دو اہم مسائل کو حل کرنے کے لیے بنایا ہے: (1) ایک ایسا ٹول جو مکمل طور پر صارف کی مشین پر چلتا ہے، اور (2) یہ ضمانت کہ وہی پرامپٹ وہی ڈایاگرام فراہم کرے گا۔ ایک مقامی HTTP API فراہم کر کے جسے AI ایجنٹ کال کر سکتا ہے، یہ کٹ نیٹ ورک لیٹنسی (latency)، ڈیٹا چوری کے خطرے اور SaaS سبسکرپشن کی ضرورت کو ختم کر دیتا ہے۔
یہ کٹ کیسے کام کرتا ہے
- Offline core – tldraw ڈیسک ٹاپ ایپ ایک مقامی سرور چلاتی ہے جو JSON-encoded کمانڈز کو قبول کرتا ہے۔ کوئی بیرونی کال نہیں کی جاتی، اور استعمال کا کوئی ڈیٹا مشین سے باہر نہیں جاتا۔
- Agent Skills – ہر اسکل (skill) ایک مقررہ ڈھانچے کی وضاحت (structure specification) کو انکوڈ کرتی ہے: لے آؤٹ میتھ، اسٹینسل انتخاب، اور مستحکم IDs۔ جب کوئی ایجنٹ کسی اسکل کو استعمال کرتا ہے، تو اسے ڈرائنگ کی ہدایات کا ایک یقینی (deterministic) سیٹ ملتا ہے۔
- Idempotent updates – اگر کوئی اسکل موجودہ ڈایاگرام پر چلتی ہے، تو یہ شکلوں کو وہیں اپ ڈیٹ کرتی ہے، پرانے عناصر کو ہٹاتی ہے، اور کناروں (edges) کو دوبارہ ترتیب دیتی ہے۔ اس کا نتیجہ ایک ایسا کینوس ہوتا ہے جسے ڈپلیکیٹ اشیاء جمع کیے بغیر ریفریش کیا جا سکتا ہے۔
- File format – ڈایاگرامز کو سادہ .tldraw فائلوں کے طور پر اسٹور کیا جاتا ہے۔ چونکہ لے آؤٹ لاجک فائل کے اندر ہوتی ہے، اس لیے ڈیک شیئر کرنے میں خود بخود وہ نیویگیشن رولز شامل ہو جاتے ہیں جو ویو کو دوبارہ بنانے کے لیے ضروری ہوتے ہیں۔
یہ کٹ تیرہ ڈایاگرام کیٹیگریز کو سپورٹ کرتا ہے، جن میں سیکوئنس اور فلو چارٹس سے لے کر ER diagrams، state machines، swimlanes، use-case، component، package، deployment، architecture، mind maps، اور code-base maps تک شامل ہیں۔ صارفین صرف مطلوبہ ڈایاگرام کی وضاحت کرتے ہیں؛ اسکل بنیادی ڈھانچے کو خود سنبھال لیتی ہے۔
ترقی کے دوران سیکھے گئے اسباق
- Arrow styling defaults to a hand-drawn look – اگرچہ صاف ستھری لائن کی درخواست کی جاتی ہے، لیکن API شروع میں ایک اسکیچ اسٹائل کا تیر (arrow) بناتی ہے۔ اسٹائل تبدیل کرنے کے لیے اسکل کو ایک فالو اپ کمانڈ جاری کرنی پڑتی ہے۔
- Arrows can intersect shapes silently – اگر کوئی کنیکٹر کسی نوڈ (node) کے درمیان سے گزرتا ہے تو API کوئی ایرر نہیں دیتی۔ اس طرح کے ٹکراؤ کو پکڑنے کے لیے تیار کردہ اسکرین شاٹس کا بصری معائنہ ضروری ہے۔
- Edge-label wrapping breaks on short arrows – اگر کنیکٹر بہت چھوٹا ہو تو لیبلز غلط طریقے سے ریپ (wrap) ہو سکتے ہیں، اس لیے اسکل کو کم از کم لمبائی کو یقینی بنانا چاہیے یا لیبل کی جگہ کو ایڈجسٹ کرنا چاہیے۔
یہ خامیاں ظاہر کرتی ہیں کہ اسکلز کو API کے بارے میں مفروضوں کے بجائے اس کے اصل طرزِ عمل (behavior) پر کیوں بنایا گیا تھا۔
کٹ کو انسٹال کرنا اور استعمال کرنا
npx skills add prateek11rai/tldraw-canvas-kit
یہ کمانڈ macOS اور Linux پر کام کرتی ہے۔ انسٹالیشن کے بعد، اسی ورک اسٹیشن پر موجود ایک AI ایجنٹ مقامی دستاویزات کو دریافت کر سکتا ہے، کوڈ تیار کر سکتا ہے، اور چلتے ہوئے tldraw سرور کو ڈرائنگ کمانڈز بھیج سکتا ہے۔ اس کا نتیجہ ایک ایسا قابلِ دوبارہ (reproducible) ڈایاگرام ہے جسے مزید ایڈٹ کیا جا سکتا ہے یا ہوسٹ کو چھوڑے بغیر پریزنٹیشنز میں ایکسپورٹ کیا جا سکتا ہے۔
کون فائدہ اٹھا سکتا ہے، اور اس کے نقصانات کیا ہیں
- Security-focused teams – سخت ڈیٹا ہینڈلنگ پالیسیوں والی کمپنیاں تمام ڈیزائن آرٹفیکٹس کو اپنے فائر والز کے پیچھے رکھ سکتی ہیں۔
- Documentation engineers – وہ لوگ جنہیں ورژن کنٹرولڈ ریپوزٹریز میں ڈایاگرامز شامل کرنے کی ضرورت ہوتی ہے، انہیں حقیقت کا ایک یقینی (deterministic) ذریعہ مل جاتا ہے۔
- Individual contributors – وہ ڈویلپرز جو ہر LLM رن کے بعد مینوئل طور پر لے آؤٹ کو ٹھیک کرنے سے تھک چکے ہیں، وہ اس عمل کو خودکار بنا سکتے ہیں۔
بنیادی حد مقامی طور پر چلنے والے tldraw کے انسیٹنس (instance) پر انحصار ہے۔ وہ تنظیمیں جو پہلے سے کلاؤڈ پر مبنی ڈایاگرام سروسز پر انحصار کرتی ہیں، انہیں ڈیسک ٹاپ ایپ اپنانے اور ورک فلو کو ایڈجسٹ کرنے کی ضرورت ہوگی۔ مزید برآں، موجودہ اسکل سیٹ کسٹم اسٹینسل لائبریریز کو کور نہیں کرتا؛ صارفین کو پہلے سے طے شدہ شکلوں کے اندر کام کرنا ہوگا۔
آگے کیا ہے
پرتیک کا ارادہ ہے کہ کمیونٹی کے فیڈ بیک کی بنیاد پر اسکل لائبریری کو وسعت دی جائے اور ونڈوز کے لیے سپورٹ شامل کی جائے، جس سے ممکنہ صارفین کی بنیاد وسیع ہو سکے۔ وہ یہ بھی امید رکھتے ہیں کہ تھرڈ پارٹی ایجنٹس اس کٹ کو مربوط کریں گے، جس سے مخصوص ڈائیگرام جنریٹرز کی ایک ایسی مارکیٹ پلیس بنے گی جو ایک ہی ڈٹرمینسٹک کور (deterministic core) کا استعمال کرتی ہوگی۔
خلاصہ
tldraw-canvas-kit یہ ثابت کرتا ہے کہ AI پر مبنی ڈائیگرام کی تخلیق کا عمل صرف کلاؤڈ تک محدود یا محض ایک احتمالی (probabilistic) عمل ہونا ضروری نہیں ہے۔ ڈرائنگ لاجک کو لوکل API میں مستحکم کر کے اور مستحکم آئیڈنٹیفائرز (stable identifiers) کا استعمال کرتے ہوئے، یہ انجینئرز کو پرائیویسی یا کنٹرول سے سمجھوتہ کیے بغیر بار بار بنائے جانے والے اور آڈٹ کے لیے تیار ویژولز تخلیق کرنے کی سہولت دیتا ہے۔