منصوبے کے بارے میں

ContextAtlas ایک MCP سرور ہے جو Claude Code کو کوڈ بیس کا پہلے سے حساب شدہ "atlas" فراہم کرتا ہے، تاکہ معماری سوالات کا جواب بہت سی grep اور فائل پڑھنے کی کالوں کے بجائے ایک ملا ہوا context bundle سے دیا جا سکے۔ یہ کیا کرتا ہے - index کے وقت یہ ADRs، READMEs اور design docs، exported symbols کے docstrings، اور filtered git commit messages سے ساختہ دعوے نکالتا ہے، جو مخصوص کوڈ symbols سے منسلک ہوتے ہیں۔ - query کے وقت یہ فی symbol چار اشارے جوڑتا ہے: LSP ساختی ڈیٹا (تعریف، حوالہ جات، اقسام، diagnostics)، معماری ارادے کے دعوے، git تاریخ (حالیہ commits، hot/cold، co-change)، اور test روابط۔ - تین MCP ٹولز دستیاب ہیں: get_symbol_context (معلوم symbol کے لیے مکمل bundle، multi-symbol موڈ میں 10 تک)، find_by_intent (مقامی SQLite FTS5 میں indexed claim متن پر BM25 تلاش)، اور impact_of_change (co-change اور test اثرات استعمال کرتے ہوئے blast radius)۔ - query کا حل مقامی ہے: SQLite lookup اور مقامی language-server کالز، عام استعمال میں کوئی نیٹ ورک ٹریفک یا model کالز نہیں۔ زبان کی معاونت TypeScript، Python، Go، Ruby اور C# language servers کے ذریعے معاون ہیں (typescript-language-server، Pyright، gopls، ruby-lsp، csharp-ls)، جو peer dependencies ہیں اور صارف انہیں انسٹال کرتا ہے۔ Node.js 20+ درکار ہے۔ سیٹ اپ کے دو راستے - Skills راستہ: پیکیج انسٹال کریں، init چلائیں، پھر Claude Code کے اندر /generate-adrs، /index-atlas اور /prime-atlas استعمال کریں؛ کسی API key کی ضرورت نہیں۔ - CLI راستہ: انسٹال کریں، ANTHROPIC_API_KEY سیٹ کریں، init، generate-adrs، index اور doctor چلائیں۔ وہ repos جن کے پاس پہلے سے docs/adr/ کے تحت ADRs موجود ہیں، generate-adrs چھوڑ سکتے ہیں، کیونکہ موجودہ ADRs خودکار طور پر نکالے جاتے ہیں۔ Committed atlas پیٹرن بنایا گیا atlas.json کوڈ اور ADRs کے ساتھ repository میں commit کرنے کے لیے ہے۔ repo clone کرنے والے ساتھی اسے براہ راست مقامی cache میں import کرتے ہیں بغیر extraction دوبارہ چلائے، اور contributors اسے دوبارہ بنا سکتے ہیں جب تبدیلیاں معماری دعووں پر اثر ڈالیں۔ جو ٹیمیں اسے commit نہیں کر سکتیں وہ atlas.committed: false سیٹ کر سکتی ہیں اور ہر ڈویلپر اپنی extraction چلاتا ہے۔ رازداری کے نوٹس index کے وقت، configuration سے مماثل ADR/doc فائلیں، exported symbols کا docstring متن، اور filtered commit messages Anthropic API کو بھیجے جاتے ہیں؛ source code، ان messages سے آگے git تاریخ، LSP ڈیٹا اور runtime query مواد نہیں بھیجے جاتے۔ docs.include glob جو source فائلوں سے مماثل ہو، وہ ان فائلوں کو مکمل بھیج دے گا۔ Extraction streams محدود کی جا سکتی ہیں (مثلاً صرف ADRs تک)۔ تمام نکالے گئے دعوے اور query کا حل مقامی SQLite فائل میں رہتے ہیں۔ بتائے گئے benchmarks README honojs/hono، encode/httpx اور spf13/cobra پر ایک benchmark suite رپورٹ کرتا ہے جس میں pre-registered prompts اور blind grading شامل ہیں، اور معماری ارادے کے prompts پر 45-72% token کمی اور hono reference run میں مجموعی طور پر 39% کم tool calls کا ذکر کرتا ہے۔ یہ paired quality deltas (factual correctness، hallucination، actionability، completeness) بھی رپورٹ کرتا ہے مع confidence intervals، اور بتاتا ہے کہ tie اور trick prompt buckets میں ContextAtlas net-negative رہا، جسے مصنفین متوقع قرار دیتے ہیں۔ یہ اعداد و شمار پروجیکٹ کے اپنے benchmark repository سے ہیں اور انہیں مصنف کی رپورٹ سمجھا جانا چاہیے، آزادانہ تصدیق شدہ نہیں۔ حالت اور لائسنسنگ README بتاتا ہے کہ v0.9.0 2026-05-16 کو جاری ہوا اور پیکیج ابھی npm پر شائع نہیں ہوا، اس لیے انسٹال ہدایات مطلوبہ شکل بیان کرتی ہیں۔ MIT کے تحت لائسنس یافتہ۔