Agent skills، MCP servers یا rules files: کیا چنیں؟
coding agent کے لیے skill، MCP server اور rules file میں فرق سمجھیں: ہر طریقے کی token لاگت، maintenance اور context میں درست استعمال کا اصول جانیں۔
ایجنٹ skills بمقابلہ MCP servers بمقابلہ rules files: مختصر جواب
ایجنٹ skills، MCP servers اور rules files سبھی coding agent کے سامنے معلومات رکھتے ہیں۔ انتخاب اس بات کی بنیاد پر کریں کہ یہ معلومات کیا کام کرتی ہیں۔ MCP (model context protocol) ایسے data کے لیے ہے جو اگلی بار دیکھنے پر مختلف ہو سکتا ہے۔ skill ایسے طریقۂ کار کے لیے ہے جسے آپ آج لکھ سکتے ہیں اور چھ ہفتے بعد بھی وہ درست رہے گا۔ rules file ان چند facts کے لیے ہے جو ہر session میں لازماً برقرار رہنے چاہییں۔
اس انتخاب کی ایک قیمت ہے، اور وہ قیمت context ہے۔ agent کو درکار نہ ہونے والی instruction پر خرچ ہونے والا ہر token اس code کے لیے دستیاب نہیں رہتا جسے agent پڑھ رہا ہے۔ ہر turn پر اس token کی قیمت دوبارہ ادا ہوتی ہے، کیونکہ ہر request کے ساتھ مکمل context window دوبارہ بھیجی جاتی ہے۔ اس لیے مفید سوال یہ نہیں کہ کون سا mechanism یہ کام کر سکتا ہے۔ اکثر دنوں میں تینوں یہ کام کر سکتے ہیں۔ سوال یہ ہے کہ idle رہتے ہوئے کون سا mechanism سب سے کم لاگت رکھتا ہے۔
استعمال سے پہلے ہر ایک کی لاگت
یہ تینوں مختلف مراحل پر load ہوتے ہیں، اور سارا فرق اسی timing کا ہے۔
ایک unconditional rules file launch کے وقت load ہوتی ہے، ہر session میں، چاہے متعلقہ ہو یا نہ ہو، جب تک اسے exclude نہ کیا جائے۔ Claude Code ہر conversation کے آغاز پر startup CLAUDE.md files پڑھتا ہے، code blocks سے باہر موجود block-level HTML comments کو content inject کرنے سے پہلے ہٹا دیتا ہے، اور 4 MiB سے بڑی files کو skip کر دیتا ہے؛ claudeMdExcludes managed policy file کے علاوہ files کو exclude بھی کر سکتا ہے۔ documented target ہر file کے لیے 200 lines سے کم ہے، کیونکہ لمبی file زیادہ context استعمال کرتی ہے اور اس پر کم قابلِ اعتماد طریقے سے عمل ہوتا ہے۔ یہ دونوں اثرات ایک ہی سمت میں کام کرتے ہیں، اسی لیے 900-line rules file بے فائدہ ہونے سے بھی بدتر ہے۔
ایک skill دو stages میں load ہوتی ہے۔ startup پر ہر SKILL.md frontmatter سے صرف description line context میں داخل ہوتی ہے، تاکہ model کو معلوم ہو کہ skill موجود ہے اور تقریباً کب لاگو ہوتی ہے۔ body اس وقت load ہوتی ہے جب skill invoke کی جاتی ہے۔ اس لیے 400-line reference document کی لاگت skill کی ضرورت پڑنے تک تقریباً نہ ہونے کے برابر رہتی ہے۔
MCP server پہلے مہنگا option ہوا کرتا تھا، اور اب آپ جو زیادہ تر comparisons پڑھیں گے وہ اسی وجہ سے پرانے ہو چکے ہیں۔ موجودہ Claude Code میں tool search by default فعال ہے۔ session start پر صرف tool names اور server کا instructions field load ہوتے ہیں، جبکہ مکمل JSON (JavaScript object notation) schemas اس وقت تک مؤخر رہتے ہیں جب تک Claude انہیں search نہ کرے۔ server شامل کرنے پر اب ابتدا ہی میں ہزاروں tokens خرچ نہیں ہوتے۔ پھر بھی کچھ لاگت رہتی ہے، اور جن configurations میں tool search بند ہو وہاں تمام لاگت اب بھی ابتدا ہی میں ہو جاتی ہے۔
اس چارٹ کے پیچھے کا ڈیٹا
[
{
"label": "Rules file, 200 lines",
"at_startup": "2,500",
"after_use": "2,500"
},
{
"label": "Skill, 12 KB body",
"at_startup": 40,
"after_use": "3,000"
},
{
"label": "MCP server, tool search on",
"at_startup": 500,
"after_use": "3,200"
},
{
"label": "MCP server, tool search off",
"at_startup": "4,500",
"after_use": "4,500"
}
]یہ estimates ہیں، آپ کی machine سے کی گئی measurements نہیں۔ یہ ہر mechanism کے load کیے جانے والے text کے حجم سے اخذ کیے گئے ہیں، جہاں تقریباً چار characters فی token شمار کیے گئے ہیں: 200-line rules file تقریباً 10 KB markdown ہوتی ہے، skill description تقریباً 160 characters کی ہوتی ہے، اور بارہ tools expose کرنے والا server تقریباً 18 KB schema اور 2 KB instructions block رکھتا ہے۔ Claude Code server کے instructions field اور ابتدا میں load ہونے والے ہر tool کی description کو default طور پر 4,096 characters تک محدود کرتا ہے، جبکہ tool search کے ذریعے load ہونے والی tool description کی حد 16,384 characters ہے۔ v2.1.296 سے پہلے مختصر حد 2,048 characters تھی، اور اگر آپ اسے set کریں تو CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH دونوں limits کو replace کرتا ہے۔ کچھ Anthropic-hosted MCP servers کی instructions اور descriptions اس variable کے set ہونے کے باوجود مکمل طور پر Claude تک پہنچتی ہیں، اس لیے یہ limits universal ceiling نہیں ہیں۔ اگلا section بتاتا ہے کہ اپنے حقیقی numbers کیسے پڑھنے ہیں۔
پہلی دو rows کو ساتھ پڑھیں۔ rules file اس session میں 2,500 tokens خرچ کرتی ہے جہاں کسی کو اس کی ضرورت نہیں پڑی۔ اسی session میں skill 40 tokens خرچ کرتی ہے، اور ان دس میں سے ایک session میں 3,000 tokens خرچ کرتی ہے جس میں یہ فعال ہوتی ہے۔ آخری دو rows ایک ہی server کو دو مرتبہ دکھاتی ہیں، tool search کے on اور off ہونے کی صورت میں: 500 tokens بمقابلہ 4,500۔ یہی فرق ہے جس کی وجہ سے MCP context bloat کے بارے میں پرانا مشورہ اب بھی گردش میں ہے۔
October 2026 تک، Claude Code Claude Opus 4، Sonnet 4، Haiku 4.5 اور بعد کے models پر tool search استعمال کرتا ہے، اور Google Cloud's Agent Platform پر Opus 4.5، Sonnet 4.5، Haiku 4.5 اور بعد کے models پر بھی۔ اس سے پرانے models پر، اور Azure پر hosted Microsoft Foundry deployments میں، آپ کی setting سے قطع نظر ہر MCP tool ابتدا ہی میں load ہوتا ہے۔ ANTHROPIC_BASE_URL کو LLM gateway کی طرف point کرنے پر v2.1.304 سے tool search by default on ہے؛ اس سے پرانے versions میں یہ وہاں off تھا، جب تک آپ نے اسے opt in نہ کیا ہو۔ v2.1.305 سے Claude Code 400 یا 422 کے بعد tool search کے بغیر gateway request دوبارہ try کر سکتا ہے؛ اگر یہ retry کامیاب ہو تو tools ابتدا ہی میں load ہو جاتے ہیں۔ اسے control کرنے کے لیے ENABLE_TOOL_SEARCH set کریں: false ہر schema کو ابتدا ہی میں load کرتا ہے، true انہیں اسی model اور deployment fallbacks کے ساتھ defer کرتا ہے جو اسے unset چھوڑنے پر استعمال ہوتے ہیں، اور auto tools کو ابتدا ہی میں load کرتا ہے جب تک ان کی definitions کا مجموعی حجم context window کے 10% سے کم ہو؛ یہ threshold پہنچنے کے بعد tool search on رکھتا ہے، چاہے مجموعی حجم بعد میں دوبارہ اس سے کم ہو جائے۔ "alwaysLoad": true کے ساتھ configured server اپنے tools کو ENABLE_TOOL_SEARCH سے قطع نظر ابتدا ہی میں load کرتا ہے۔
# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claudeفیصلہ کن سوال: کیا ہر بار استعمال کرنے کے درمیان ڈیٹا تبدیل ہوتا ہے؟
یہ سوال پہلے پوچھیں، کیونکہ اس سے ایک اختیار فوراً خارج ہو جاتا ہے۔ اگر agent کو ایسی چیز پڑھنے یا لکھنے کی ضرورت ہے جو اگلی بار دیکھنے تک مختلف ہو سکتی ہے، تو آپ کو server درکار ہے۔ Issue tracker، database، monitoring dashboard، یا آپ کی اپنی internal API (application programming interface)۔ اسے لکھ کر رکھ دینا مددگار نہیں، کیونکہ جیسے ہی کوئی دوسرا شخص record میں ترمیم کرتا ہے، آپ کی تحریر پرانی ہو جاتی ہے۔ آپ کا اپنا codebase بھی اسی فہرست میں شامل ہے، کیونکہ ہر commit کے ساتھ اس کی ساخت بدلتی ہے۔ اسی وجہ سے MCP کے ذریعے agent کو repository کا parsed map فراہم کرنا اس کے layout کو ایسی file میں بیان کرنے سے بہتر ہے جو وقت کے ساتھ پرانی ہو جائے۔
اگر کوئی شخص اس کی دیکھ بھال نہ کرے تو بھی چھ ہفتے بعد جواب درست رہے گا، تو آپ کو skill درکار ہے۔ Release checklist۔ Migration procedure۔ آپ کے error responses کی ساخت۔ اس repository میں tests کس طریقے سے لکھے جانے چاہییں۔ skill، git میں موجود ایک file ہوتی ہے۔ اس کا کوئی port یا process نہیں ہوتا، اور غلط ہونے کے علاوہ اس کا کوئی failure mode نہیں ہوتا؛ code review اس غلطی کو پکڑ سکتا ہے۔
اگر یہ ایک ایسی حقیقت ہے جس کا اطلاق ایسے کام پر ہونا ہے جس کے بارے میں آپ نے ابھی سوچا بھی نہیں، تو اسے rules file میں رکھیں۔ Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. ہر سطر میں ایک حقیقت لکھیں۔ جیسے ہی کوئی entry steps میں تبدیل ہونے لگے، وہ حقیقت نہیں رہتی بلکہ procedure بن جاتی ہے، اور اسے skill میں منتقل کر دینا چاہیے۔
جب rules file کافی ہو
Rules files کئی مقامات سے load ہوتی ہیں۔ ترتیب وسیع ترین scope سے مخصوص ترین scope تک ہوتی ہے: managed policy file، آپ کی ذاتی ~/.claude/CLAUDE.md، project کی ./CLAUDE.md یا ./.claude/CLAUDE.md، اور gitignored ./CLAUDE.local.md۔ دریافت ہونے والی تمام files ایک دوسرے کو override کرنے کے بجائے concatenate ہوتی ہیں، اور working directory کے قریب موجود files آخر میں پڑھی جاتی ہیں۔
v2.1.277 سے Claude Code AGENTS.md بھی پڑھتا ہے، لیکن default طور پر صرف اس وقت جب working directory یا اس کے اوپر CLAUDE.md، .claude/CLAUDE.md یا CLAUDE.local.md موجود نہ ہو۔ اگر repository میں دونوں موجود ہوں تو Claude صرف CLAUDE.md files پڑھتا ہے، اس لیے ایسی دو copies برقرار نہ رکھیں جو وقت کے ساتھ مختلف ہو جائیں۔
ln -s AGENTS.md CLAUDE.mdکامیابی کی صورت میں symlink کوئی output نہیں دیتا۔ ایک session شروع کریں، /context all چلائیں، اور تصدیق کریں کہ Memory files کے تحت CLAUDE.md ظاہر ہو۔ اگر یہ وہاں درج نہیں ہے تو agent نے اسے کبھی نہیں دیکھا، اور الفاظ بدلنے سے کوئی فائدہ نہیں ہوگا۔ اگر آپ Claude کے لیے مخصوص lines بھی شامل کرنا چاہتے ہیں تو اس کے بجائے import form استعمال کریں اور انہیں import کے نیچے رکھیں۔
@AGENTS.md
## Claude Code
Use plan mode for changes under `src/billing/`.یہاں ایک اہم مسئلہ ہے۔ @path imports context محفوظ نہیں کرتے۔ Imported file کو launch کے وقت، اس file کے ساتھ expand اور load کیا جاتا ہے جس نے اسے reference کیا ہو، اور یہ عمل زیادہ سے زیادہ چار hops تک ہوتا ہے۔ 600 لائنوں کی rules file کو چھ imports میں تقسیم کرنے سے اسے انسانوں کے لیے منظم کیا جا سکتا ہے، لیکن token cost میں بالکل کوئی تبدیلی نہیں آتی۔ AGENTS.md اور اس کے human-facing twin کے پس پشت conventions پڑھ لینا layout طے کرنے سے پہلے مفید ہے۔
Cost کم کرنے والی چیز .claude/rules/ ہے، جس میں paths field شامل ہو۔ paths frontmatter رکھنے والی rule file صرف اس وقت load ہوتی ہے جب agent ایسی file کو touch کرے جو patterns میں سے کسی ایک سے match کرتی ہو۔
---
paths:
- "src/api/**/*.ts"
---
# API rules
- Every endpoint validates its input.
- Use the standard error response shape.جس rule میں paths field نہ ہو، وہ launch کے وقت .claude/CLAUDE.md جیسی priority کے ساتھ load ہوتی ہے۔ اس لیے عملی طریقہ یہ ہے کہ مختصر unconditional rules رکھیں، اور ہر ایسی چیز کے لیے paths list شامل کریں جو صرف ایک directory کے اندر متعلقہ ہو۔
جب آپ کو کسی skill کی ضرورت ہو
skill ایک directory ہوتی ہے جس کے اندر SKILL.md موجود ہوتی ہے۔ ذاتی skills، ~/.claude/skills/<name>/SKILL.md میں رہتی ہیں اور آپ کی machine پر موجود ہر project پر لاگو ہوتی ہیں۔ project skills، .claude/skills/<name>/SKILL.md میں رہتی ہیں، repository کے ساتھ منتقل ہوتی ہیں، اور دیگر files کی طرح pull request میں review کی جا سکتی ہیں۔
mkdir -p ~/.claude/skills/summarize-changes---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---
Run `git status` and `git diff` against the merge base.
Group the changes by intent, not by file.
Call out anything touching auth, migrations or deletions.description اس file کا واحد حصہ ہے جو skill کے چلنے سے پہلے context میں موجود ہوتا ہے، اس لیے یہ دو کام کرتا ہے۔ یہ بتاتا ہے کہ skill کیا کرتی ہے، اور یہ بھی بتاتا ہے کہ اسے کب استعمال کرنا چاہیے۔ "Helps with deploys" جیسی description میں model کے لیے request کو match کرنے کے لیے کوئی مفید معلومات نہیں ہوتیں، اس لیے skill خاموشی سے کبھی trigger نہیں ہوتی اور آپ یہ نتیجہ نکالتے ہیں کہ skills کام نہیں کرتیں۔
directory کا نام command بن جاتا ہے، اس لیے اوپر کی مثال میں آپ کو /summarize-changes ملتا ہے۔ ذاتی یا project skill میں frontmatter name جو directory کے نام سے مختلف ہو، وہ / menu میں دکھائی جانے والی command مقرر کرتا ہے، بشرطیکہ کوئی دوسری command پہلے سے وہ نام استعمال نہ کر رہی ہو۔ تاہم directory کا نام skill کو invoke کرنے کے لیے بدستور استعمال ہوتا ہے۔
جب skill invoke کی جاتی ہے تو اس کا rendered content ایک single message کے طور پر conversation میں شامل ہو جاتا ہے اور session کے بقیہ حصے میں موجود رہتا ہے۔ Claude Code بعد کی turns پر file کو دوبارہ نہیں پڑھتا۔ ایک بار کے steps کے بجائے مستقل instructions لکھیں، اور body کو مختصر رکھیں، کیونکہ اس مرحلے کے بعد ہر line ہر request پر بار بار context cost بنتی ہے۔ auto-compaction کے بعد Claude Code ہر skill کی حالیہ ترین invocation دوبارہ attach کرتا ہے۔ ہر skill کے پہلے 5,000 tokens کو 25,000 tokens کے مشترکہ budget میں شامل کیا جاتا ہے۔ ایک session میں کئی بڑی skills invoke کریں تو سب سے پرانی skills مکمل طور پر خارج ہو جاتی ہیں۔ اسی لیے طویل conversation کے بعد کوئی skill غیر مؤثر محسوس ہو سکتی ہے۔ اسے دوبارہ invoke کریں تو وہ واپس آ جاتی ہے۔ procedure-heavy skill اس trade-off کو واضح کرتی ہے: unlazy skill اور اس کا Depth Tree طریقہ gates اور plan file کے لیے حقیقی context استعمال کرتی ہے، بدلے میں ایسا agent ملتا ہے جو کام کو وقت سے پہلے مکمل قرار دینا بند کر دیتا ہے۔ جب ایک ہی procedure ایک سے زیادہ codebases پر لاگو ہو، تو file کو copy کرنے کے بجائے متعدد repositories میں ایک skill share کریں۔
MCP سرور کی ضرورت کب ہوتی ہے
اسے شامل کرنا ایک ہی command سے ممکن ہے، جبکہ transport اس کی ساخت طے کرتا ہے۔
# Remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp
# Remote HTTP server behind a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
# Local stdio server: everything after -- is passed through untouched
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
-- npx -y airtable-mcp-server-- اہم ہے۔ stdio سرور کے لیے یہ Claude Code کے اپنے options کو وہ command line سے الگ کرتا ہے جو آپ کے سرور کو شروع کرتی ہے۔ اسے چھوڑ دینے پر سرور کے لیے مقررہ --port 8080 کو claude mcp add کے option کے طور پر parse کیا جاتا ہے، اور claude mcp add اسے مسترد کر دیتا ہے۔
claude mcp list
claude mcp get notionclaude mcp add ایک Added ... line کے ذریعے تصدیق کرتا ہے، جو صرف یہ بتاتی ہے کہ configuration disk پر لکھ دی گئی ہے۔ claude mcp list وہ command ہے جو اصل صورتِ حال بتاتی ہے، کیونکہ یہ ہر سرور کے ساتھ health status دکھاتا ہے: ✔ Connected، ! Needs authentication، یا ✘ Failed to connect۔ failure status کا مطلب ہے کہ Claude Code اس سرور تک نہیں پہنچ سکا، یہ نہیں کہ list command ناکام ہو گئی۔ session کے اندر /mcp ہر سرور کے لیے یہی معلومات اور اس کے tools کی تعداد دکھاتا ہے۔
MCP سرور کو کی جانے والی ہر call مستقل ہوتی ہے اور اس میں اپنی ضرورت کا تمام data شامل ہوتا ہے۔ اسی لیے MCP سرور آپ کی پچھلی request یاد نہیں رکھتا۔ یہ ایک design choice ہے، جس کا نتیجہ آپ کو قبول کرنا ہوتا ہے: برقرار رکھنے کے قابل ہر state سرور کے پیچھے، database یا file میں موجود ہونی چاہیے، اور اب اس کی operation آپ کی ذمہ داری ہے۔
MCP server ایک ایسا process ہے جسے آپ کو چلانا پڑتا ہے
یہ وہ لاگت ہے جسے vendor comparisons نظرانداز کرتے ہیں۔ Skill ایک file ہے۔ MCP server ایسا software ہے جو کسی جگہ چلتا ہے، اور جب وہ جگہ آپ کا VPS (virtual private server) ہو تو اس کے uptime کی ذمہ داری آپ کی ہوتی ہے۔
stdio server کم لاگت والا معاملہ ہے۔ Session شروع ہونے پر Claude Code اسے child process کے طور پر شروع کرتا ہے، اور session ختم ہونے پر یہ بند ہو جاتا ہے۔ اس کی نگرانی کے لیے کچھ نہیں ہوتا، اور نہ ہی اسے اپنے شیڈول کے مطابق patch کرنے کی ضرورت ہوتی ہے۔ Remote HTTP server ایک طویل مدت تک چلنے والی service ہے، اور اسے ہر ایسی service کی طرح کچھ تقاضے پورے کرنے ہوتے ہیں، جن میں سب سے پہلے اس کے لیے الگ user بنانا شامل ہے۔ نیچے دیا گیا unit جس mcp user کے طور پر چلتا ہے، وہ user بنائیں اور اسے server کی directory کا مالک بنائیں:
sudo useradd --system --home-dir /srv/notes-mcp --shell /usr/sbin/nologin mcp
sudo chown -R mcp:mcp /srv/notes-mcp[Unit]
Description=Notes MCP server
After=network-online.target
Wants=network-online.target
[Service]
User=mcp
WorkingDirectory=/srv/notes-mcp
ExecStart=/usr/bin/node /srv/notes-mcp/dist/server.js
Environment=PORT=8931
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now notes-mcp
systemctl is-active notes-mcp
journalctl -u notes-mcp -n 50 --no-pagersystemctl is-active کو active دکھانا چاہیے۔ اگر یہ failed دکھائے تو journal میں وجہ موجود ہوگی۔ پہلی بار ایسا عموماً کسی missing environment variable یا اس port کی وجہ سے ہوتا ہے جسے کوئی اور process پہلے ہی استعمال کر رہا ہو۔ یہاں Restart=on-failure اختیاری نہیں ہے، کیونکہ crashed MCP server خود اپنی خرابی کی اطلاع نہیں دیتا۔ آپ کو اس وقت معلوم ہوتا ہے جب agent بتاتا ہے کہ وہ آپ کے issue tracker کو پڑھ نہیں سکتا۔
Process کو 127.0.0.1 پر bind کریں اور اس کے سامنے TLS (transport layer security) کے ساتھ reverse proxy رکھیں۔ ایسا MCP server جو آپ کے database تک رسائی رکھتا ہو اور authentication کے بغیر public port پر جواب دیتا ہو، دراصل وہ database ہے جسے آپ نے public کر دیا ہے۔ VPS پر MCP server چلانا proxy، certificate اور firewall کے حصے کو درست طریقے سے بیان کرتا ہے۔
اس کے بعد recurring کام کا دیانت داری سے اندازہ لگائیں۔ یہ service اپنے شیڈول کے مطابق security updates لیتی ہے، اور یہ شیڈول اس agent سے متعلق نہیں ہوتا جو اس سے رابطہ کرتا ہے۔ اس کا OAuth token expire ہو جاتا ہے، اور claude mcp list کسی نامناسب وقت پر ! Needs authentication دکھانا شروع کر دیتا ہے۔ اس کے credentials کسی config file یا Authorization header میں موجود ہوتے ہیں، اس لیے انہیں بھی ہر دوسرے secret جیسی احتیاط درکار ہوتی ہے۔ یہ الگ موضوع ہے: secrets کو AI agent کی رسائی سے دور رکھنا۔ Skill کے لیے یہ کام درکار نہیں ہوتا۔
Build کرنے سے پہلے اس کا متبادل سامنے رکھ کر موازنہ کریں۔ اگر مجوزہ server کے پیچھے موجود data تقریباً ہر quarter میں ایک بار تبدیل ہوتا ہے تو ایسی service کے مقابلے میں skill کم لاگت والی ہے جسے آپ کو مسلسل چلتا رکھنا پڑتا ہے۔ Skill agent کو صرف یہ بتاتی ہے کہ کہاں دیکھنا ہے اور fields کا مطلب کیا ہے۔
اپنے context cost کی پیمائش کیسے کریں
اندازہ لگانا چھوڑیں اور session کے اندر /context all چلائیں۔ یہ موجودہ breakdown دکھاتا ہے: system prompt، memory files، tools اور MCP servers، ساتھ ہی ہر ایک کا token weight بھی۔
دو چیزیں چیک کریں۔ Memory files کے تحت تصدیق کریں کہ آپ کی توقع کے مطابق ہر rules file فہرست میں موجود ہے۔ missing file agent کے لیے invisible ہوتی ہے، اس لیے جب instructions نظرانداز ہوں تو سب سے پہلے اسی امکان کو خارج کریں۔ اگر file فہرست میں موجود ہے لیکن rule پھر بھی skip ہو رہا ہے، تو وجہ کہیں اور ہے۔ line دوبارہ rewrite کرنے سے پہلے وہ وجوہات دیکھیں جن کی بنا پر agent نظر آنے والی instruction کو نظرانداز کر دیتا ہے۔ پھر دیکھیں کہ آپ کے servers کتنی لاگت پیدا کرتے ہیں۔ اگر کوئی server ماہ میں دو بار استعمال ہوتا ہے لیکن اس فہرست میں بڑی lines میں شامل ہے، تو اسے /mcp میں off کریں اور ضرورت والے sessions کے لیے دوبارہ on کریں۔ configuration ہر صورت برقرار رہتی ہے۔
اگر آپ کے account کے لیے discovery cache on ہے، تو پہلے استعمال کیا گیا remote server cached 2h ago · connects on first use · 5 tools جیسی status دکھا سکتا ہے۔ اس کا مطلب ہے کہ Claude Code نے startup پر connect ہونے کے بجائے پچھلے session سے tool list پڑھ لی ہے، اور پہلی بار کوئی tool call ہونے پر connect کرے گا۔ پہلے message سے ہی tools available ہوتے ہیں، اس لیے کچھ ٹھیک کرنے کی ضرورت نہیں۔ cache default طور پر off ہوتا ہے، جب تک gradual rollout کے ذریعے اسے آپ کے لیے enable نہ کیا گیا ہو: ہر server کو startup پر connect کرتے رکھنے کے لیے MCP_DISCOVERY_CACHE=0 set کریں، یا cache on کرنے کے لیے 1 set کریں۔ مکمل تصویر کے لیے Claude Code context window کا انتظام بتاتا ہے کہ compaction کے بعد کیا برقرار رہتا ہے، جبکہ ان tokens کی حقیقی لاگت ان نمبروں کو مالی لاگت میں تبدیل کرتا ہے۔
میری skill trigger کیوں نہیں ہوتی؟
عام وجہ description ہے۔ skill چلنے سے پہلے context میں یہی واحد متن ہوتا ہے، اس لیے اگر اس میں صورتحال کا نام نہ ہو تو کوئی match نہیں ہوتا۔ trigger کو جملے میں واضح طور پر لکھیں: "Use when the user asks what changed, wants a commit message, or asks to review their diff." مبہم وضاحتیں خاموشی سے ناکام ہوتی ہیں، اس لیے مسئلہ محسوس کرنا مشکل ہوتا ہے۔
دوسری وجہ frontmatter میں typo ہے، اور Claude Code میں یہ بھی خاموشی سے ناکام ہوتا ہے۔ field name میں hyphens سمیت ہر چیز بالکل درست ہونی چاہیے، اور Claude Code ایسے field کو نظرانداز کر دیتا ہے جسے وہ پہچانتا نہیں، بغیر کسی error کی اطلاع دیے۔ واضح error صرف اس وقت ظاہر ہوتا ہے جب آپ skill کو package کریں یا اسے claude.ai یا Skills API پر upload کریں، کیونکہ یہ کم fields قبول کرتے ہیں اور باقی کو فوراً reject کر دیتے ہیں:
Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, nameتیسری وجہ location ہے۔ Project skills آپ کی working directory کے .claude/skills/ اور repository root تک ہر parent directory سے load ہوتی ہیں۔ آپ کے شروع کیے گئے مقام سے نیچے موجود nested directories کی skills launch کے وقت load نہیں ہوتیں۔ Agent جب پہلی بار اس subdirectory کے اندر کسی file کو read یا edit کرتا ہے تو وہ skills ظاہر ہوتی ہیں۔ اس سے پہلے وہ autocomplete میں نہیں آتیں اور نام سے invoke نہیں کی جا سکتیں۔
MCP میں اسی خاموش failure کی مساوی وجہ url اور type کے بغیر موجود .mcp.json entry ہے۔ Claude Code ہر ایسی entry کو، جس میں type نہ ہو، stdio server سمجھتا ہے۔ اس لیے یہ entry skip ہو جاتی ہے اور درج ذیل رپورٹ ہوتا ہے:
MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entryتینوں کو ایک ساتھ استعمال کرنا
یہ طریقۂ کار ایک ہی جگہ کے لیے باہم مقابلہ نہیں کرتے۔ مؤثر setup میں ہر طریقے کو وہاں استعمال کیا جاتا ہے جہاں اس کی لاگت کم ہو۔ rules file میں چند ایسی سطریں ہوتی ہیں جو ہر جگہ درست رہتی ہیں۔ skills میں طریقۂ کار شامل ہوتے ہیں اور انہیں صرف متعلقہ صورت میں load کیا جاتا ہے۔ ایک MCP server، اور کبھی کبھار دو، ان systems کو connect کرتے ہیں جن کے contents کا آپ پہلے سے اندازہ نہیں لگا سکتے۔ اگر آپ کو اب بھی پہلے طریقے کا ذہنی خاکہ بنانے میں دشواری ہو رہی ہے تو agent skill حقیقت میں کیا ہوتی ہے میں format کی تفصیل موجود ہے۔
کسی چیز کی مناسب جگہ کے بارے میں زیادہ تر اختلاف ایک test سے ختم ہو جاتا ہے۔ اسے delete کریں، نئی session شروع کریں، اور agent کو task دیں۔ اگر agent صرف سست ہو جائے تو وہ skill میں ہونی چاہیے تھی۔ اگر agent پُراعتماد انداز میں غلط جواب دے تو وہ rules file میں ہونی چاہیے تھی۔ اگر agent معلومات بالکل حاصل نہ کر سکے تو server درکار تھا، اور اب اس server کو چلتا رکھنے کا plan بھی درکار ہے۔
FAQ
کیا مجھے skill لکھنی چاہیے یا MCP server قائم کرنا چاہیے؟
اس کا فیصلہ اس بنیاد پر کریں کہ معلومات ایک invocation سے اگلی invocation کے درمیان تبدیل ہوتی ہیں یا نہیں۔ اگر agent کو live state پڑھنی ہو جس میں کوئی دوسرا شخص ترمیم کر سکتا ہو، مثلاً issue tracker، database یا dashboard، تو آپ کو MCP server درکار ہے، کیونکہ record تبدیل ہوتے ہی آپ کی لکھی ہوئی کوئی بھی چیز stale ہو جاتی ہے۔ اگر آپ جواب ایک بار لکھ سکتے ہوں اور چھ ہفتے بعد بھی وہ درست رہے، تو skill لکھیں۔ skill، git میں موجود ایک file ہوتی ہے۔ اسے چلانے کے لیے کوئی process، expose کرنے کے لیے کوئی port، اور maintain کرنے کے لیے کوئی patch schedule درکار نہیں ہوتا۔ اس لیے جہاں ممکن ہو، یہ کم خرچ اختیار ہے۔
کیا MCP servers اب بھی میری context window بھر دیتے ہیں؟
اب پہلے کی نسبت بہت کم۔ موجودہ Claude Code میں tool search بطور default enabled ہے۔ اس لیے session شروع ہوتے وقت صرف tool names اور server کا instructions field load ہوتا ہے۔ full schemas اس وقت fetch ہوتے ہیں جب Claude انہیں search کرتا ہے۔ اب اس میں ANTHROPIC_BASE_URL کے ذریعے set کیے گئے LLM gateway کے پیچھے چلنے والے sessions بھی شامل ہیں، اور یہ v2.1.304 سے لاگو ہے۔ Upfront loading اب بھی ENABLE_TOOL_SEARCH=false کے ساتھ، "alwaysLoad": true پر set کیے گئے server کے لیے، Claude Opus 4 اور Sonnet 4 سے پرانے model پر (Google Cloud's Agent Platform پر 4.5 generation سے پرانے model پر)، اور Azure پر hosted Microsoft Foundry deployments میں ہوتا ہے۔ یہ دیکھنے کے لیے /context all چلائیں کہ آپ کس صورت حال میں ہیں، کیونکہ پرانی comparison posts میں موجود numbers upfront loading فرض کرتے ہیں۔
کیا Claude Code AGENTS.md پڑھتا ہے؟
ہاں، v2.1.277 سے۔ لیکن default طور پر صرف اس وقت جب آپ کی working directory یا اس سے اوپر CLAUDE.md، .claude/CLAUDE.md یا CLAUDE.local.md موجود نہ ہو۔ اگر آپ کی repository میں دونوں موجود ہوں، تو Claude صرف CLAUDE.md files پڑھتا ہے۔ اس لیے دو copies رکھنے کے بجائے ایک کو دوسری کی طرف point کریں۔ سادہ symlink کے لیے ln -s AGENTS.md CLAUDE.md چلائیں، یا @AGENTS.md کو CLAUDE.md کی پہلی line پر رکھیں اور اس کے نیچے Claude-specific instructions شامل کریں۔ پھر session شروع کریں اور /context all چلائیں تاکہ تصدیق ہو جائے کہ CLAUDE.md، Memory files کے تحت ظاہر ہو رہا ہے۔
session کے دوران میری skill نے اچانک اثر کرنا کیوں بند کر دیا؟
عام طور پر وجہ auto-compaction ہوتی ہے۔ جب conversation کا خلاصہ بنایا جاتا ہے، تو Claude Code ہر skill کی حالیہ ترین invocation دوبارہ attach کرتا ہے، اور ہر skill کے پہلے 5,000 tokens رکھتا ہے۔ تمام skills کے لیے مجموعی budget 25,000 tokens ہے۔ یہ budget سب سے حالیہ invoked skill سے شروع ہو کر بھرا جاتا ہے۔ اس لیے اگر آپ نے کئی بڑی skills invoke کی ہوں، تو پرانی skills مکمل طور پر drop ہو جاتی ہیں۔ skill کو دوبارہ invoke کریں تاکہ اس کا مکمل content بحال ہو جائے۔
میں لمبی rules file کو ہر session میں load ہونے سے کیسے روک سکتا ہوں؟
صرف کبھی کبھار درکار حصوں کو .claude/rules/ files میں منتقل کریں اور ان کے frontmatter میں paths field شامل کریں۔ اس طرح ہر file صرف اس وقت load ہوگی جب agent کسی matching file کو touch کرے گا۔ file کو @path imports میں تقسیم کرنے سے مدد نہیں ملتی، کیونکہ imported files expand ہو کر launch کے وقت اسی file کے ساتھ load ہو جاتی ہیں جس نے ان کا حوالہ دیا تھا۔ جو چیز standing fact کے بجائے multi-step procedure ہو، اسے skill بنائیں، کیونکہ skill body اس وقت تک کوئی لاگت نہیں ڈالتی جب تک اسے invoke نہ کیا جائے۔