ai-agent-rules

AI Rules ایک کمانڈ لائن ٹول ہے جو کئی AI کوڈنگ ایجنٹس کی کنفیگریشن کو ایک ہی، git-tracked جگہ میں رکھنے اور اسے ہر ایجنٹ کی متوقع کنفیگریشن ڈائریکٹری میں symlinks کے ذریعے لنک کرنے کے لیے استعمال ہوتا ہے۔ بیان کردہ مقصد "ایک بار ایڈٹ کریں، ہر جگہ لاگو کریں" ہے جبکہ فی ایجنٹ اور فی مشین حسب ضرورت کی اجازت بھی دی جاتی ہے۔ معاون ایجنٹس اور ان کی کنفیگریشن ڈائریکٹریز: - Amp: ~/.config/amp/ (مہارتیں ~/.config/agents/skills/ میں) - Claude Code: ~/.claude/ (مہارتیں ~/.claude/skills/ میں) - Codex CLI: ~/.codex/ (مہارتیں ~/.agents/skills/ میں) - Gemini CLI: ~/.gemini/ (~/.agents/skills/ کے ذریعے مہارتیں دریافت کرتا ہے) - Goose: ~/.config/goose/ (مہارتیں ~/.config/goose/skills/ میں) - مشترکہ مواد جیسے AGENTS.md اور مہارتیں تنصیب کے لیے Python 3.10+ اور uv درکار ہے۔ تجویز کردہ طریقہ PyPI سے ایک کمانڈ سیٹ اپ ہے (uvx --from ai-agent-rules ai-agent-rules setup)، جو symlinks انسٹال کرتا ہے، ai-agent-rules کمانڈ (اور ai-rules ایلیاس) کو سسٹم وائیڈ دستیاب بناتا ہے، اور اختیاری طور پر معاون ٹولز انسٹال کرتا ہے۔ ایک --github فلیگ اس کے بجائے مین برانچ سے انسٹال کرتا ہے، اور مقامی ڈیولپمنٹ کے لیے uv run ai-agent-rules install استعمال ہوتا ہے۔ ایک اپ گریڈ کمانڈ اپ ڈیٹس کی جانچ اور انسٹال کرتا ہے، جس میں صرف چیک، فورس، پوسٹ اپ گریڈ انسٹال کو چھوڑنے، یا صرف مخصوص ٹول کو اپ گریڈ کرنے کے فلیگز شامل ہیں۔ بنیادی کمانڈز سیٹ اپ، انسٹال/سنک، اسٹیٹس اور معائنہ، کنفیگریشن، اخراج اور اوور رائڈز، مہارتیں، ٹولز، اور شیل کمپلیشنز کا احاطہ کرتی ہیں۔ قابل ذکر رویے: - انسٹال مخصوص ایجنٹس کے انتخاب، ڈرائی رن پیش نظارہ، آٹو تصدیق، کیش ری بلڈ، اور پروفائل سلیکشن کو سپورٹ کرتا ہے۔ - اسٹیٹس symlink حالت، اختیاری ٹولز، اور فعال پروفائل کو اسٹیٹس علامتوں اور ڈیفز کے ساتھ رپورٹ کرتا ہے؛ validate چیک کرتا ہے کہ سورس فائلیں موجود ہیں؛ uninstall symlinks ہٹاتا ہے۔ - کنفیگریشن init/show/edit خام یا ضم شدہ ترتیبات کو ظاہر کرتا ہے، اختیاری طور پر فی ایجنٹ۔ - exclude add/remove/list ان فائلوں کے لیے glob پیٹرن کا انتظام کرتا ہے جنہیں symlink نہیں کیا جانا چاہیے (مثال کے طور پر کمپنی کے زیر انتظام فائلیں)۔ - override set/unset/list نیسٹڈ ترتیبات میں ترمیم کرتا ہے، بشمول ڈھانچے جیسے ہک کمانڈ اریز کے لیے array-index نوٹیشن، پاتھ کی توثیق کے ساتھ جو ٹائپوز پر درست کلیدوں کا مشورہ دیتی ہے۔ - skill list/show بنڈل شدہ مہارتوں کو رینڈر کرتا ہے، شیئرنگ کے لیے ورژن شدہ GitHub URL پرنٹ کرسکتا ہے، یا پائپنگ کے لیے خام مارک ڈاؤن جاری کرسکتا ہے۔ - tool list/show اور tool source get/set اختیاری ٹولز اور ان کے انسٹال سورس (pypi، github، لوکل پاتھ، ری سیٹ) کا انتظام کرتے ہیں۔ - completions install/uninstall/update/status اور خام bash/zsh اسکرپٹ آؤٹ پٹ فراہم کیے جاتے ہیں۔ کنفیگریشن پرت دار ہے۔ ایک یوزر لیول فائل ~/.ai-agent-rules-config.yaml پر اخراج اور مشین مخصوص settings_overrides رکھتی ہے۔ اسٹیٹ (فعال پروفائل، آخری انسٹال ٹائم اسٹیمپ) ~/.ai-agent-rules/state.yaml میں رہتی ہے، اور ضم شدہ ترتیبات ~/.ai-agent-rules/cache/ کے تحت کیش ہوتی ہیں۔ دستاویزی merge pipeline ہے: بیس git-tracked ترتیبات، پھر پروفائل اوور رائڈز، پھر یوزر اوور رائڈز، پھر کیش سے ضم شدہ محفوظ ایجنٹ کے زیر انتظام فیلڈز، پھر کیشنگ، پھر ایجنٹ کی ڈائریکٹری میں symlinking۔ محفوظ فیلڈز میں Claude کا enabledPlugins اور hooks، Goose کا extensions، Codex کا projects، اور Gemini کا ide شامل ہیں۔ اوور رائڈز تبدیل کرنے کے لیے install --rebuild-cache چلانے کی ضرورت ہوتی ہے۔ پروفائلز اوور رائڈز کو نامزد پری سیٹس میں گروپ کرتی ہیں اور وراثت کو سپورٹ کرتی ہیں؛ تین بلٹ ان پروفائلز ٹول کے ساتھ آتے ہیں جن کی زنجیر default -> personal -> work ہے، جہاں default کو عام اور personal/work مصنف کے اپنے پری سیٹس کے طور پر بیان کیا گیا ہے نہ کہ عمومی سفارشات کے طور پر۔ پروفائلز settings_overrides، plugins، marketplaces، منظم ٹول انسٹال سورس، AGENTS.md ٹکڑے (agents_md_file، والدین سے پہلے inheritance کے ذریعے منسلک، inline agents_md کے ساتھ باہمی طور پر خصوصی)، اخراج، اور MCP اوور رائڈز کی وضاحت کرسکتی ہیں۔ مقامی یوزر کنفیگریشن پروفائل اوور رائڈز پر ترجیح لیتی ہے۔ صارف کی وضاحت شدہ پروفائل فائلیں فی الحال تعاون یافتہ نہیں ہیں؛ فی مشین حسب ضرورت یوزر کنفیگریشن فائل میں جاتی ہے۔ MCP سرورز ایک بار مشترکہ mcps.json میں بیان کیے جاتے ہیں اور ہر ایجنٹ کے مینیجر کے ذریعہ مقامی فارمیٹس (Amp، Claude، Gemini کے لیے JSON؛ Codex کے لیے TOML؛ Goose کے لیے YAML ایکسٹینشنز) میں ترجمہ کیے جاتے ہیں۔ منظم اندراجات صارف کے شامل کردہ سرورز سے ممتاز کرنے کے لیے _managedBy مارکر رکھتے ہیں، اور mcp_overrides API کلیدوں جیسی فی مشین اقدار کی اجازت دیتے ہیں۔ Claude Code پلگ انز پروفائلز یا یوزر کنفیگریشن میں اعلان کیے جا سکتے ہیں؛ install غائب مارکیٹ پلیسز اور پلگ انز شامل کرتا ہے، پہلے سے منظم پلگ انز کو خودکار طور پر ان انسٹال کرتا ہے، اور دستی طور پر انسٹال شدہ پلگ انز کے بارے میں انہیں ہٹائے بغیر انتباہ کرتا ہے۔ پلگ ان اسٹیٹ ایک منظم JSON فائل میں ٹریک کی جاتی ہے۔ حفاظتی خصوصیات میں پہلی بار چلانے کے انتباہات، ٹائم اسٹیمپڈ بیک اپ، انٹرایکٹو پرامپٹس، ڈرائی رن موڈ، یہ دعویٰ کہ صرف symlinks منظم ہیں اور اصلی فائلیں کبھی حذف نہیں ہوتیں، اور سیاق و سباق کے مطابق غلطی کے پیغامات شامل ہیں۔ ٹربل شوٹنگ گائیڈنس غلط اہداف، بیک اپ بحال کرنے، اخراج کے ذریعے symlink کو غیر فعال کرنے، اوور رائڈز لاگو نہ ہونے پر کیش کو دوبارہ بنانے، ضم شدہ ترتیبات دیکھنے، اور pre-v0.35 کنفیگریشن پاتھز سے خودکار منتقلی کا احاطہ کرتی ہے۔ یہ پروجیکٹ MIT لائسنس یافتہ ہے۔