Claude Code Routines: شیڈول شدہ کلاؤڈ ایجنٹس، ذیلی روٹینز اور باہمی روٹینز

یہ تفصیلی رہنما ہے۔ پانچ منٹ کے جائزے کے لیے ساتھی بلاگ پوسٹ پڑھیں۔

1. شیڈول شدہ ایجنٹس کیوں اہم ہیں

کچھ عرصہ پہلے تک، AI کوڈنگ ایجنٹ صرف اسی وقت کام کرتا تھا جب کوئی اسے دیکھ رہا ہو۔ آپ ٹرمینل کھولتے، اسے ٹاسک دیتے، اس کے اقدامات کی منظوری دیتے اور نتیجہ پڑھتے۔ سیشن بند کرتے ہی کام رک جاتا۔ یہ ماڈل تحقیقی نوعیت کے کام کے لیے موزوں ہے، لیکن انجینئرنگ کا بہت سا کام نہ تحقیقی ہوتا ہے نہ فوری۔ وہ بار بار دہرایا جانے والا ہوتا ہے: رات بھر جمع ہونے والے issues کی درجہ بندی، یہ جانچنا کہ دستاویزات اب بھی API سے مطابقت رکھتی ہیں، ہر پُل ریکویسٹ کا ایک ہی چیک لسٹ کے مطابق جائزہ، اور ریلیز ونڈو بند ہونے سے پہلے ڈیپلائمنٹ کی تصدیق۔

جو ٹیمیں چاہتی تھیں کہ کوئی ایجنٹ یہ کام بغیر نگرانی کے کرے، انہیں بنیادی ڈھانچہ خود تیار کرنا پڑتا تھا۔ عام طریقے یہ تھے: GitHub Actions میں cron جاب، کسی الماری میں مسلسل چلتی ایک فالتو مشین، یا Trigger.dev یا n8n جیسا ورک فلو انجن جس کے ساتھ ایجنٹ کال جوڑ دی جائے۔ ہر طریقہ کام کرتا ہے، لیکن ہر ایک ایک سادہ سی ہدایت کے گرد انفراسٹرکچر، اسناد (credentials)، لاگت اور دیکھ بھال کا بوجھ بڑھا دیتا ہے، جبکہ ہدایت دراصل بس اتنی ہے: "یہ کام ہر رات کرو اور مجھے بتاؤ کہ تمہیں کیا ملا۔"

Routines اس سارے ڈھانچے کی ضرورت ختم کر دیتی ہیں۔ شیڈول، کمپیوٹ، ریپوزٹری کی چیک آؤٹ اور آڈٹ ٹریل، سب کچھ خود Claude Code کے اندر موجود ہے۔

2. روٹین کیا ہے

Anthropic روٹین کی تعریف Claude Code کی ایک محفوظ شدہ کنفیگریشن کے طور پر کرتا ہے۔ اس کے پانچ حصے ہیں:

• پرامپٹ۔ وہ ہدایت جس پر Claude ہر رن میں عمل کرتا ہے۔ چونکہ سوالات کا جواب دینے کے لیے کوئی موجود نہیں ہوتا، اس لیے اسے خود مکتفی ہونا چاہیے اور واضح کرنا چاہیے کہ "مکمل" ہونا کیسا دکھائی دیتا ہے۔ ماڈل کا انتخاب بھی یہیں ہوتا ہے، اور وہی ماڈل ہر رن میں استعمال ہوتا ہے۔
• ریپوزٹریز۔ ایک یا زیادہ GitHub ریپوزٹریز۔ ہر رن کے آغاز پر ہر ایک کو نئے سرے سے کلون کیا جاتا ہے، اس کی ڈیفالٹ برانچ سے، الّا یہ کہ پرامپٹ کچھ اور کہے۔
• کلاؤڈ ماحول۔ یہ نیٹ ورک رسائی، انوائرنمنٹ ویری ایبلز اور ایک اختیاری سیٹ اپ اسکرپٹ کو کنٹرول کرتا ہے جو ڈیپینڈنسیز انسٹال کرتا ہے۔ سیٹ اپ کا نتیجہ کیش ہو جاتا ہے، اس لیے یہ ہر بار دوبارہ نہیں چلتا۔
• کنیکٹرز۔ آپ کے claude.ai اکاؤنٹ پر موجود MCP انٹیگریشنز، جیسے Slack، Linear یا Google Drive، جن سے روٹین پڑھ اور جن میں لکھ سکتی ہے۔
• ٹرگرز۔ شیڈول، API اور GitHub ایونٹ میں سے ایک یا زیادہ۔ ایک ہی روٹین تینوں کو یکجا کر سکتی ہے۔

ہر رن Claude Code کا ایک مکمل کلاؤڈ سیشن ہوتا ہے۔ یہ شیل کمانڈز چلا سکتا ہے، کلون شدہ ریپوزٹری میں کمٹ کی گئی اسکلز استعمال کر سکتا ہے اور شامل کیے گئے کنیکٹرز کا ہر ٹول کال کر سکتا ہے۔ یہاں پرمیشن موڈ کا کوئی انتخاب نہیں اور کوئی چیز منظوری کا انتظار نہیں کرتی۔ یہی خودمختاری اس کا مقصد ہے، اور اسی لیے دائرہ کار کا تعین اہم ہے (دیکھیں سیکشن 8)۔

3. ٹرگرز کی تین اقسام

3.1 شیڈول

سب سے سادہ ٹرگر روٹین کو پہلے سے طے شدہ وقفے (ہر گھنٹے، روزانہ، کاروباری دنوں میں یا ہفتہ وار) پر، یا مستقبل کے کسی مخصوص وقت پر ایک بار چلاتا ہے۔ چند تفصیلات جاننے کے لائق ہیں:

• مقامی وقت۔ آپ اوقات اپنے ٹائم زون میں درج کرتے ہیں اور Claude Code انہیں تبدیل کر دیتا ہے، اس لیے 09:00 کا رن آپ کی گھڑی کے مطابق 09:00 پر ہی ہوتا ہے، چاہے کلاؤڈ ہارڈ ویئر کہیں بھی ہو۔ کچھ ابتدائی تھرڈ پارٹی گائیڈز میں کہا گیا تھا کہ شیڈول صرف UTC میں ہوتے ہیں، لیکن Anthropic کی دستاویزات میں ایسا نہیں ہے۔
• ٹھیک پورے گھنٹے سے گریز کریں۔ بالکل پورے گھنٹے پر شیڈول کیے گئے رنز کئی منٹ تاخیر سے شروع ہو سکتے ہیں۔ 09:00 کے بجائے 09:07 منتخب کرنے سے وقت زیادہ قابلِ پیش گوئی رہتا ہے۔
• حسبِ ضرورت cron۔ ایسے وقفوں کے لیے جو پہلے سے طے شدہ اختیارات میں شامل نہیں، جیسے ہر دو گھنٹے یا مہینے کی پہلی تاریخ، قریب ترین آپشن منتخب کریں اور پھر CLI میں /schedule update چلا کر cron ایکسپریشن سیٹ کریں۔ کم از کم وقفہ ایک گھنٹہ ہے؛ اس سے زیادہ کثرت والا کوئی بھی وقفہ مسترد ہو جاتا ہے۔
• ایک بار کے رنز۔ وقت کو سادہ زبان میں بیان کریں، مثلاً /schedule in 2 weeks, open a cleanup PR that removes the feature flag۔ Claude محفوظ کرنے سے پہلے درست ٹائم اسٹیمپ کی تصدیق کرتا ہے۔ چلنے کے بعد روٹین خود کو غیر فعال کر لیتی ہے اور Ran کے طور پر نشان زد ہو جاتی ہے۔ ایک بار کے رنز روزانہ رنز کی حد میں شمار نہیں ہوتے۔

3.2 API

API ٹرگر روٹین کو اس کا اپنا HTTPS اینڈ پوائنٹ دیتا ہے۔ کوئی بھی سسٹم جو تصدیق شدہ POST ریکویسٹ بھیج سکتا ہو، رن شروع کر سکتا ہے: الرٹنگ ٹول، ڈیپلائمنٹ پائپ لائن یا کوئی اندرونی ایڈمن صفحہ۔ ٹوکن ویب انٹرفیس میں بنایا جاتا ہے، صرف ایک بار دکھایا جاتا ہے، صرف اسی روٹین تک محدود ہوتا ہے، اور کسی بھی وقت دوبارہ بنایا یا منسوخ کیا جا سکتا ہے۔

curl -X POST https://api.anthropic.com/v1/claude_code/routines/<ROUTINE_TRIGGER_ID>/fire \
  -H "Authorization: Bearer <ROUTINE_TOKEN>" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Error rate on checkout-api above 5% for 10 minutes."}'

جواب میں ایک سیشن ID اور سیشن URL ہوتا ہے جسے کھول کر آپ رن کو براہِ راست دیکھ سکتے ہیں۔ اختیاری text فیلڈ اس رن سے متعلق سیاق و سباق لے کر جاتی ہے۔ سیکیورٹی کا خیال رکھنے والی ٹیموں کو نوٹ کرنا چاہیے کہ Claude Code اس متن کو ایک <routine-fire-payload> بلاک میں لپیٹ کر اسے غیر معتبر ڈیٹا کا لیبل دیتا ہے۔ Claude اس کے اندر موجود ہدایات پر اس وقت تک عمل نہیں کرتا جب تک روٹین کا اپنا محفوظ شدہ پرامپٹ اسے پے لوڈ استعمال کرنے کو نہ کہے۔ اگر آپ کی روٹین کو کسی الرٹ کے متن پر عمل کرنا ہے تو پرامپٹ میں یہ صراحت سے لکھیں، مثلاً: "routine-fire-payload بلاک میں بیان کردہ الرٹ کی تحقیق کرو۔" اس ڈیزائن کا مطلب یہ ہے کہ لیک شدہ ٹوکن سے کوئی رن تو شروع کر سکتا ہے، لیکن روٹین کی ہدایات دوبارہ نہیں لکھ سکتا۔

یہ اینڈ پوائنٹ تاریخ والے ایک beta ہیڈر کے پیچھے ہے۔ Anthropic کا کہنا ہے کہ بریکنگ تبدیلیاں نئے ہیڈر ورژنز کے تحت جاری ہوں گی، اور پچھلے دو ورژن کام کرتے رہیں گے تاکہ کال کرنے والوں کو منتقلی کا وقت مل سکے۔

3.3 GitHub ایونٹس

جب بھی کسی منسلک ریپوزٹری پر کوئی مطابقت رکھنے والا واقعہ ہوتا ہے، GitHub ٹرگر ایک نیا سیشن شروع کرتا ہے۔ اس کے لیے اس ریپوزٹری پر Claude GitHub App انسٹال ہونا ضروری ہے۔ دو قسم کے ایونٹس معاون ہیں:

• پُل ریکویسٹ: کھولا گیا، بند کیا گیا، تفویض کیا گیا، لیبل لگایا گیا، ہم آہنگ (synchronised) کیا گیا اور دیگر اپ ڈیٹس۔
• ریلیز: بنائی گئی، شائع کی گئی، ترمیم کی گئی یا حذف کی گئی۔

فلٹرز طے کرتے ہیں کہ کون سے ایونٹس شمار ہوں۔ آپ مصنف، عنوان، متن، بیس برانچ، ہیڈ برانچ، لیبلز، ڈرافٹ حالت اور مرج حالت پر فلٹر لگا سکتے ہیں، اور یہ آپریٹرز استعمال کر سکتے ہیں: equals، contains، starts with، is one of، is not one of اور matches regex۔ تمام شرائط کا پورا ہونا لازمی ہے۔ ایک عام غلطی: matches regex پوری فیلڈ کو جانچتا ہے، اس لیے "hotfix" پر مشتمل کسی بھی عنوان کو پکڑنے کے لیے آپ کو .*hotfix.* لکھنا ہوگا، نہ کہ hotfix۔

ہر ایونٹ اپنا الگ اور آزاد سیشن بناتا ہے، اس لیے ایک ہی پُل ریکویسٹ پر دو پُش کا مطلب دو رنز ہے۔ پری ویو کے دوران GitHub ایونٹس پر فی روٹین اور فی اکاؤنٹ گھنٹہ وار حدیں بھی لاگو ہیں۔ حد سے زائد ایونٹس ونڈو ری سیٹ ہونے تک نظر انداز کر دیے جاتے ہیں۔

4. روٹین بنانا، مرحلہ وار

آپ روٹینز تین جگہوں سے بنا سکتے ہیں: ویب پر claude.ai/code/routines، Claude Desktop ایپ کے Code ٹیب کا Routines سیکشن، یا CLI۔ تینوں ایک ہی اکاؤنٹ میں محفوظ کرتے ہیں، اس لیے ایک جگہ بنائی گئی روٹین فوراً باقی جگہوں پر بھی نظر آتی ہے۔

4.1 ویب پر

1. claude.ai/code/routines کھولیں اور New routine منتخب کریں۔
2. اسے نام دیں اور پرامپٹ لکھیں۔ ماڈل منتخب کریں۔
3. وہ ریپوزٹریز شامل کریں جن میں Claude کو کام کرنا ہے۔
4. کلاؤڈ ماحول منتخب کریں۔ Default ماحول کو Trusted نیٹ ورک رسائی حاصل ہوتی ہے، جو عام پیکیج رجسٹریز، کلاؤڈ فراہم کنندگان کے APIs اور ڈیولپمنٹ ڈومینز تک رسائی دیتی ہے۔ اگر روٹین کو آپ کی اپنی سروسز تک پہنچنا ہے تو پہلے ماحول کے اجازت یافتہ ڈومینز میں تبدیلی کریں۔
5. ایک یا زیادہ ٹرگرز منتخب کریں۔ API ٹرگر کے لیے پہلے روٹین محفوظ کریں؛ URL اور ٹوکن اس کے بعد بنتے ہیں۔
6. کنیکٹرز کا جائزہ لیں۔ آپ کے تمام منسلک کنیکٹرز بطورِ طے شدہ شامل ہوتے ہیں، اور Claude ان کے ہر ٹول کو، بشمول لکھنے والے اقدامات کے، پوچھے بغیر استعمال کر سکتا ہے۔ جو کچھ ٹاسک کے لیے ضروری نہیں اسے ہٹا دیں۔
7. Create منتخب کریں، پھر شیڈول پر انحصار کرنے سے پہلے جانچ کے لیے Run now منتخب کریں۔

4.2 CLI سے

کسی بھی مقامی Claude Code سیشن میں، /schedule (متبادل نام /routines) گفتگو کے ذریعے ایک شیڈول شدہ روٹین بناتا ہے۔ Claude وقفے، ریپوزٹریز اور پرامپٹ کے بارے میں پوچھتا ہے، پھر اسے آپ کے اکاؤنٹ میں محفوظ کر دیتا ہے۔

/schedule daily PR review at 9am
/schedule tomorrow at 9am, summarise yesterday's merged PRs
/schedule list
/schedule update
/schedule run
/schedule why did my nightly review do nothing this morning?

آخری مثال خاص طور پر مفید ہے۔ Claude روٹین کے حالیہ رنز کی فہرست دیتا ہے، متعلقہ لاگ پڑھتا ہے اور بتاتا ہے کہ کیا ہوا، بشمول ٹول کی خرابیوں اور اجازت سے انکار کے۔ نئے CLI ورژنز GitHub App انسٹال ہونے کے بعد گفتگو کے ذریعے GitHub ٹرگر بھی منسلک کر سکتے ہیں۔ تاہم API ٹوکنز صرف ویب پر ہی بنائے یا منسوخ کیے جا سکتے ہیں۔

اگر /schedule پہچانا نہ جائے تو وجہ تقریباً ہمیشہ تصدیق (authentication) ہوتی ہے۔ Routines کے لیے claude.ai سبسکرپشن لاگ اِن درکار ہے۔ Console API کی، ANTHROPIC_API_KEY انوائرنمنٹ ویری ایبل، یا Amazon Bedrock جیسے کلاؤڈ فراہم کنندہ کا لاگ اِن اس کمانڈ کو چھپا دیتا ہے۔ Team اور Enterprise پلانز پر Owner پوری تنظیم کے لیے روٹینز بند بھی کر سکتا ہے۔

5. ایسے پرامپٹس لکھنا جو بغیر نگرانی کے رنز میں کارگر رہیں

روٹین کا پرامپٹ کسی چیٹ پیغام کے بجائے رن بُک سے زیادہ مشابہ ہوتا ہے۔ ابہام دور کرنے کے لیے کوئی موجود نہیں ہوتا، اس لیے مبہم ہدایات مبہم نتائج دیتی ہیں، یا اس سے بھی بدتر، ایسے پُراعتماد اقدامات جن کا آپ نے ارادہ نہیں کیا تھا۔ موازنہ کریں:

ایک اچھا روٹین پرامپٹ یہ باتیں واضح کرتا ہے:

• دائرہ کار: کون سی ریپوزٹریز، کون سی مدت اور کون سے آئٹمز۔
• اجازت یافتہ اقدامات: Claude کیا تبدیل کر سکتا ہے، اور اتنا ہی اہم، کس چیز کو ہاتھ نہیں لگانا۔
• آؤٹ پُٹ: درست منزل اور فارمیٹ، جیسے ڈرافٹ PR، کوئی Slack چینل یا ٹریکر پر تبصرہ۔
• رکنے کی شرائط: جب کرنے کو کچھ نہ ہو تو کیا کرنا ہے، اور کب ہار مان لینی ہے۔
• پے لوڈ کا استعمال: API ٹرگرز کے لیے، آیا اور کیسے فائر متن استعمال کرنا ہے۔

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

6. ذیلی روٹینز: ایک رن کے اندر کام کی ترتیب

Anthropic "ذیلی روٹینز" (sub-routines) نام کا کوئی فیچر فراہم نہیں کرتا۔ Workstation میں ہم یہ اصطلاح ایک ڈیزائن پیٹرن کے لیے استعمال کرتے ہیں جو طویل، غیر نگرانی شدہ رنز کو کہیں زیادہ قابلِ اعتماد بنا دیتا ہے: روٹین کا پرامپٹ ہم آہنگ کنندہ (orchestrator) کا کردار ادا کرتا ہے، اور ہر واضح طور پر متعین مرحلہ ریپوزٹری میں کمٹ کیے گئے کسی ذیلی ایجنٹ یا اسکل کے سپرد کرتا ہے۔

یہ اس لیے ممکن ہے کہ Claude Code کے دو بنیادی اجزاء آپ کی ریپوزٹری کے ساتھ ہی رہتے ہیں:

• ذیلی ایجنٹس (subagents) .claude/agents/ میں YAML فرنٹ میٹر والی Markdown فائلیں ہیں۔ ہر ایک کا اپنا سسٹم پرامپٹ، ٹولز کی اجازت فہرست اور اختیاری ماڈل ہوتا ہے، اور وہ اپنی الگ کانٹیکسٹ ونڈو میں چلتا ہے۔ کال کرنے والے کو صرف ایک خلاصہ واپس ملتا ہے۔ ذیلی ایجنٹس متوازی چل سکتے ہیں، اور بطورِ طے شدہ خود بھی تین سطحوں تک کام آگے سونپ سکتے ہیں۔
• اسکلز (skills) .claude/skills/ میں دوبارہ قابلِ استعمال طریقۂ کار کو پیک کرتی ہیں، جیسے آپ کا ریلیز نوٹس کا انداز یا سیکیورٹی ریویو چیک لسٹ، جنہیں Claude ضرورت کے وقت لوڈ کرتا ہے۔ Routines کلون شدہ ریپوزٹری میں کمٹ کی گئی اسکلز استعمال کرتی ہیں۔

اس طریقے سے بنائی گئی رات کی دیکھ بھال والی روٹین کچھ یوں دکھائی دے سکتی ہے:

# Routine prompt (orchestrator)
1. Use the issue-triager subagent to label and assign issues opened since the last run.
2. Pick the single highest-priority bug labelled "good-first-fix".
3. Use the bug-fixer subagent to implement a fix on a claude/ branch.
4. Use the test-runner subagent to run the test suite; if it fails twice, stop and report.
5. Open ONE draft PR, using the release-notes skill for the description.
6. Post a three-line summary to #eng-nightly.

# .claude/agents/issue-triager.md
---
name: issue-triager
description: Labels and assigns new issues. Never edits code.
tools: Read, Grep, Glob
model: haiku
---
You triage GitHub issues. Apply area labels from CODEOWNERS and
assign the owning team. Return a table of issue, label and owner.

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

7. باہمی روٹینز: تعاون کرنے والی روٹینز

یہاں بھی "باہمی روٹینز" (co-routines) ہماری اصطلاح ہے، Anthropic کا فیچر نہیں۔ ہم اسے ایسی کئی آزاد روٹینز کے لیے استعمال کرتے ہیں جو ایک دوسرے کو کام منتقل کرتی ہیں، بالکل ویسے جیسے پروڈکشن لائن کسی پرزے کو ایک اسٹیشن سے اگلے تک پہنچاتی ہے۔ روٹینز ایک دوسرے کو براہِ راست کال نہیں کر سکتیں اور ان کی کوئی مشترکہ میموری نہیں ہوتی۔ اس کے بجائے، ایک روٹین کوئی پائیدار آرٹیفیکٹ تیار کرتی ہے جس پر دوسری روٹین کا ٹرگر نظر رکھتا ہے۔

ایک عام سلسلہ:

1. روٹین A (شیڈول) ہفتے کی راتوں میں بیک لاگ کی درجہ بندی کرتی ہے اور claude/fix-… برانچ سے ایک ڈرافٹ PR کھولتی ہے۔
2. روٹین B (GitHub، pull_request.opened) ایسی ہیڈ برانچز تک فلٹر ہوتی ہے جو claude/ سے شروع ہوں۔ یہ ٹیم کی ریویو چیک لسٹ لاگو کرتی ہے اور PR پر لیبل لگاتی ہے۔
3. ایک انسان جائزہ لے کر مرج کرتا ہے۔ یہی منظوری کا مرحلہ ہے۔
4. روٹین C (GitHub، pull_request.closed، merged = true) دستاویزات اپ ڈیٹ کرتی ہے یا تبدیلی کو کسی ہم زاد SDK میں منتقل کرتی ہے اور ایک فالو اَپ PR کھولتی ہے۔
5. روٹین D (API) کو ریلیز کے بعد ڈیپلائمنٹ پائپ لائن کال کرتی ہے۔ یہ اسموک چیکس چلاتی ہے اور go یا no-go پوسٹ کرتی ہے۔ no-go کی صورت میں یہ ٹریکر میں ایک issue درج کرتی ہے، جسے روٹین A اگلی رات اٹھا لیتی ہے۔

کام منتقل کرنے کے ذرائع، سب سے زیادہ منظم سے کم منظم تک:

• GitHub ایونٹس: مقامی طور پر معاون، قابلِ فلٹر اور مکمل طور پر قابلِ آڈٹ۔
• لیبلز اور برانچ کے ناموں کے ضوابط: کوئی گلو کوڈ لکھے بغیر کام کو آگے بھیجتے ہیں۔
• API کالز: CI، مانیٹرنگ یا اندرونی ٹولز سے، جن کا پے لوڈ غیر معتبر سیاق و سباق سمجھا جاتا ہے۔
• مشترکہ ٹریکر یا آرٹیفیکٹ: کوئی Linear issue یا اسٹیٹس پیج جسے اگلا شیڈول شدہ رن پڑھتا ہے۔

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

8. سیکیورٹی اور گورننس

• روٹینز آپ کی شناخت سے کام کرتی ہیں۔ روٹینز کسی ایک فرد کے claude.ai اکاؤنٹ سے وابستہ ہوتی ہیں اور ٹیم کے ساتھیوں کے ساتھ شیئر نہیں ہوتیں۔ کمٹس اور پُل ریکویسٹس پر آپ کی GitHub شناخت ہوتی ہے، اور کنیکٹر کے اقدامات آپ کے منسلک اکاؤنٹس استعمال کرتے ہیں۔ روٹین کو ایک ایسا ذاتی ایکسیس ٹوکن سمجھیں جس کے ساتھ دماغ بھی جڑا ہو۔
• برانچ کا تحفظ۔ Claude بطورِ طے شدہ claude/ سابقے والی برانچز پر پُش کرتا ہے۔ یہ محفوظ برانچز، کسی اور کی کھلی PR والی برانچز، اور دوسرے لوگوں کے کمٹس پر مشتمل برانچز پر پُش کرنے سے انکار کرتا ہے۔
• کم سے کم اختیار۔ غیر ضروری کنیکٹرز ہٹا دیں۔ جب تک کسی مخصوص ڈومین کی ضرورت نہ ہو، نیٹ ورک رسائی Trusted پر رکھیں؛ بلاک شدہ ریکویسٹس 403 اور x-deny-reason: host_not_allowed کے ساتھ ناکام ہوتی ہیں۔ Pro اور Max پلانز پر API کیز کو عام ویری ایبلز کے بجائے ماحول کی API credentials کے طور پر محفوظ کریں، کیونکہ عام ویری ایبلز ماحول استعمال کرنے والے ہر شخص کو نظر آتے ہیں۔
• غیر معتبر ان پُٹ۔ API پے لوڈز اور Run now کا متن غیر معتبر کے لیبل کے ساتھ آتے ہیں۔ رن کے دوران حاصل کردہ مواد، جیسے issues کا متن اور ویب صفحات، پر پرامپٹ انجیکشن سے بچاؤ کا معمول کا طریقہ لاگو رہتا ہے۔ ایسے پرامپٹس لکھیں جو Claude کو بتائیں کہ کس پر بھروسہ کرنا ہے۔
• کنکشن کی صحت۔ اگر GitHub کنکشن کی میعاد ختم ہو جائے تو رنز 72 گھنٹے تک چھوڑ دیے جاتے ہیں اور پھر روٹین خود کو بند کر لیتی ہے جب تک آپ دوبارہ منسلک نہ کریں۔
• تنظیمی کنٹرول۔ Team اور Enterprise کے Owners ایڈمن سیٹنگز سے تمام اراکین کے لیے روٹینز غیر فعال کر سکتے ہیں۔

9. پلانز، استعمال اور حدود

Routines سبسکرپشن کا استعمال اسی طرح کرتی ہیں جیسے انٹرایکٹو سیشنز۔ روزانہ حد اس کے علاوہ لاگو ہوتی ہے۔ آپ کی موجودہ حد claude.ai/code/routines پر دکھائی جاتی ہے اور پری ویو کے دوران بدل سکتی ہے۔ یوزج کریڈٹس فعال ہوں تو حد سے زائد رنز میٹرڈ اوورج کے طور پر جاری رہتے ہیں؛ ان کے بغیر اضافی رنز ونڈو ری سیٹ ہونے تک مسترد کر دیے جاتے ہیں۔ ایک بار کے شیڈول شدہ رنز حد میں شمار نہیں ہوتے۔ جب سبسکرپشن معطل ہو تو اس کی روٹینز بھی رکی رہتی ہیں۔

10. روٹینز کا دیگر شیڈولنگ اختیارات سے موازنہ

10.1 Claude Code کے اندر

/loop ٹاسکس سیشن تک محدود ہوتے ہیں اور سات دن بعد ختم ہو جاتے ہیں۔ یہ آپ کے کام کے دوران کسی بلڈ یا پُل ریکویسٹ پر نظر رکھنے کے لیے بہترین ہیں، لیکن روٹین کا متبادل نہیں۔

10.2 Claude Code سے باہر

• GitHub Actions سستا ہے، کوڈ کے ساتھ ہی رہتا ہے اور رنر پر مکمل کنٹرول دیتا ہے۔ اس کی قیمت YAML، سیکرٹس کا انتظام اور رنر کی دیکھ بھال ہے۔ متعین (deterministic) بلڈ مراحل کے لیے Actions اور فیصلہ سازی کے متقاضی کام کے لیے روٹینز کا انتخاب کریں۔
• ورک فلو انجنز جیسے Trigger.dev ری ٹرائیز، فین آؤٹ اور طویل دورانیے کی ہم آہنگی سنبھالتے ہیں، لیکن ہم آہنگی کا کوڈ آپ کو خود لکھنا پڑتا ہے۔ انہیں تب استعمال کریں جب ورک فلو خود ہی پروڈکٹ ہو۔
• انٹیگریشن پلیٹ فارمز جیسے n8n اور Zapier مختلف SaaS ٹولز کے درمیان ڈیٹا منتقل کرنے میں مہارت رکھتے ہیں۔ روٹینز کوڈ، لاگز اور دستاویزات پر استدلال میں مہارت رکھتی ہیں۔ دونوں اچھی طرح ساتھ چلتے ہیں: n8n کا کوئی فلو روٹین کے API اینڈ پوائنٹ کو کال کر سکتا ہے۔

11. استعمال کے کامیاب منظرنامے

• بیک لاگ کی صفائی: رات کو لیبلنگ، ذمہ داری کا تعین اور صبح کا خلاصہ۔
• الرٹ کی درجہ بندی: مانیٹرنگ API ٹرگر کو کال کرتی ہے، اور Claude اسٹیک ٹریس کو حالیہ کمٹس سے جوڑ کر ڈرافٹ فکس کھولتا ہے۔
• حسبِ ضرورت کوڈ ریویو: ریویو کے لیے تیار ہر PR پر آپ کی اپنی چیک لسٹ۔
• ڈیپلائمنٹ کی تصدیق: ہر ریلیز کے بعد اسموک چیکس اور لاگ اسکینز، جن کا اختتام go یا no-go پر ہوتا ہے۔
• دستاویزات کا انحراف: مرج شدہ PRs کا ہفتہ وار جائزہ، اور تبدیل شدہ APIs کا حوالہ دینے والی دستاویزات کے لیے اپ ڈیٹ PRs۔
• لائبریری کی منتقلی: ایک SDK میں مرج شدہ تبدیلیوں کو کسی دوسری زبان میں اس کے ہم زاد SDK میں منعکس کرنا۔
• ڈیپینڈنسیز کی دیکھ بھال: پرانے پیکیجز کا ہفتہ وار جائزہ اور ایک واحد، جانچا ہوا اپ گریڈ PR۔

Routines ایک گھنٹے سے کم وقفے والے کام، ایسے ٹاسکس جن میں رن کے دوران انسانی فیصلہ درکار ہو، اور ری ٹرائیز والے پیچیدہ کثیر شاخی ورک فلوز کے لیے کم موزوں ہیں۔

12. کمیونٹی کا ردِعمل

ردِعمل ملا جلا لیکن زیادہ تر مثبت رہا ہے۔ InfoQ نے ایسے انجینئرز کے حوالے دیے جو webhooks کے ذریعے AI کو براہِ راست آبزرویبلٹی ڈیش بورڈز اور CI ورک فلوز سے جوڑنے کے بارے میں پُرجوش تھے۔ کچھ دوسرے شکوک کا شکار تھے۔ انہوں نے Claude کے سابقہ شیڈولنگ فیچرز کی طرف اشارہ کیا جو صرف صارف کی اپنی مشین پر چلتے تھے، اور کہا کہ نئے فیچرز سے پہلے قابلِ اعتمادی، اپ ٹائم اور کوٹہ کی حدود توجہ کی مستحق ہیں۔ ہمارا تجربہ یہ ہے کہ روٹینز سیکیورٹی کے لحاظ سے عمدگی سے ڈیزائن کی گئی ہیں، خاص طور پر غیر معتبر پے لوڈ کے استعمال اور برانچ کے تحفظ میں۔ اصل عملی خطرات حد سے زیادہ وسیع کنیکٹرز اور ناکافی حد تک مخصوص پرامپٹس ہیں۔

13. Workstation اسے کیسے استعمال کرتا ہے

Workstation میں ہم DevOps، مالیاتی آپریشنز اور کسٹمر ورک فلوز میں اپنے کلائنٹس کے لیے ایجنٹک آٹومیشن چلاتے ہیں۔ Routines ہمارے طریقۂ کار سے بخوبی مطابقت رکھتی ہیں: بنیادی ڈھانچے کے لیے متعین انفراسٹرکچر، فیصلہ سازی کے لیے AI، اور پروڈکشن تک کچھ بھی پہنچنے سے پہلے انسانی منظوری کا مرحلہ۔ اگر آپ روٹین کے سلسلوں، ذیلی ایجنٹس کی لائبریریوں یا ان کے گرد گورننس کو ڈیزائن کرنے میں مدد چاہتے ہیں تو ہماری ٹیم سے بات کریں۔

14. اہم نکات

• روٹین ایک محفوظ شدہ پرامپٹ، ریپوزٹریز، ماحول، کنیکٹرز اور ٹرگرز کا مجموعہ ہے جو کلاؤڈ میں خودمختار طور پر چلتا ہے۔
• ٹرگرز شیڈول (کم از کم ایک گھنٹہ، مقامی وقت)، API کال (bearer ٹوکن، غیر معتبر پے لوڈ) یا GitHub پُل ریکویسٹ یا ریلیز ایونٹ ہو سکتے ہیں۔
• Pro، Max، Team اور Enterprise پر دستیاب، معمول کے استعمال کے علاوہ روزانہ رن کی حدوں کے ساتھ۔ یہ فیچر ابھی ریسرچ پری ویو میں ہے۔
• ایک طویل رن کو مرکوز اور کم سے کم اختیار پر رکھنے کے لیے ذیلی روٹینز (ذیلی ایجنٹس اور اسکلز) استعمال کریں۔
• کثیر مرحلہ پائپ لائنز کے لیے باہمی روٹینز (PRs، لیبلز اور API کالز کے ذریعے کام منتقل کرنے والی روٹینز) استعمال کریں، جن کے بیچ میں انسانی مرج کا مرحلہ ہو۔
• کنیکٹرز اور نیٹ ورک رسائی کا دائرہ سختی سے محدود رکھیں، پرامپٹس رن بُک کی طرح لکھیں، اور ٹرانسکرپٹس پڑھیں۔

ماخذ اور مزید مطالعہ

• Anthropic: Introducing routines in Claude Code (14 اپریل 2026)
• Claude Code دستاویزات: Automate work with routines
• Claude Code دستاویزات: Run prompts on a schedule (/loop)
• Claude Code دستاویزات: Subagents
• Claude Platform دستاویزات: Trigger a routine through the API
• InfoQ: Anthropic Introduces Routines for Claude Code Automation
• MindStudio: Claude Code Routines: How to Run Scheduled AI Agents Without a Server
• Medium پر Tahir: What is Claude Code Routines?

Routines ریسرچ پری ویو میں ہیں۔ رویہ، حدود اور API تبدیل ہو سکتے ہیں۔ اس رہنما میں دیے گئے حقائق 25 ستمبر 2026 تک Anthropic کی شائع شدہ دستاویزات کی عکاسی کرتے ہیں۔