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

# ایجنٹ ٹیمز انجینئرنگ فاؤنڈیشن یہ ریپوزٹری ایجنٹ ٹیمز کے ریپوزٹریز کے لیے ورژن شدہ انجینئرنگ پالیسی، ٹولنگ اور مطابقت فراہم کرتی ہے۔ اس میں صرف دوبارہ قابل استعمال ڈیولپمنٹ ٹولنگ شامل ہے؛ پروڈکٹ رن ٹائم کوڈ اسے امپورٹ نہیں کر سکتا۔ ہر کنزیومر اپنے ڈومین ماڈل، پیکیج کیٹلاگ، ڈیپنڈنسی اجازتوں، سیکیورٹی درجہ بندیوں اور ADRs کا خود اختیار رکھتا ہے۔ ## دائرہ کار - سخت ڈیٹا-صرف کنزیومر کنفیگریشن اور ورژن شدہ اسکیمے - قابل عمل ورک اسپیس اعلان اور سورس ڈیپنڈنسی پالیسیاں - زیرِ انتظام ان لائن سپریشنز اور جاری شدہ پبلک API مطابقت - جامد قابل عمل-تفصیلات اور کنزیومر-گیٹ کنیکٹیویٹی - ریپوزٹری ورک فلو، SBOM، پروویننس اور پیکیج-مواد سیکیورٹی پالیسی - پورٹیبل ایجنٹ ہدایات اور تبدیل شدہ فائل پری فلائٹ روٹنگ - موجودہ پیکیج-اسکرپٹ کوالٹی گیٹس کی آپٹ-ان ڈیٹرمینسٹک ترکیب - مشترکہ Oxlint اور TypeScript 7 بیس لائن پریسیٹس - واضح رجسٹری اور لوکل-لنک موڈز - ڈیٹرمینسٹک اٹیچ، اسٹیٹس، ڈیٹیچ اور رجسٹری دعوے - بند ڈیٹرمینسٹک `Intent -> Plan -> Apply -> Receipt` اسکافولڈنگ - زیرِ انتظام دستاویز کیٹلاگ، ڈیٹرمینسٹک غیر محفوظ منصوبہ بندی، صرف تخلیق کی اشاعت اور درست ورژن ریکوری کمانڈز - الگ تھلگ پیکیج-مواد اور کنزیومر تصدیق - ناقابل تبدیل پبلک npm ورژنز کے لیے ریلیز آٹومیشن صلاحیتیں ثابت شدہ ریپوزٹریز سے بتدریج نکالی جاتی ہیں۔ کوئی صلاحیت یہاں صرف اسی صورت منتقل ہوتی ہے جب اس کے ساتھ پیریٹی فکسچرز اور کنزیومر مطابقت ٹیسٹ موجود ہوں۔ `workspace.dependency-declarations` اور `architecture.source-dependencies` فعال اور ڈوگ فوڈ شدہ ہیں۔ یہ ریپوزٹری اسکیمہ v2 استعمال کرتی ہے جس میں واضح `packages` پیکیج روٹ ہے، جبکہ شائع شدہ v1 کنٹریکٹ موجودہ کنزیومرز کے لیے لوڈ کے قابل رہتا ہے۔ ## کمانڈز ```bash pnpm install pnpm check:changed pnpm check:fast pnpm check pnpm verify pnpm package:check pnpm quality:gate:fast pnpm foundation:qualification ``` کنزیومرز استعمال کرتے ہیں: ```bash pnpm foundation:check pnpm foundation:attach -- /absolute/path/to/engineering-foundation pnpm foundation:status pnpm foundation:detach pnpm foundation:assert-dev-only pnpm foundation:assert-registry ``` کوئی بھی ریپوزٹری بغیر تبدیلی کے پورٹیبل دستاویزات سیٹ اپ کا پیش نظارہ کر سکتی ہے: ```bash docs-protocol init --project-id example/widgets \ --owner documentation/team --dry-run --json ``` جائزہ شدہ ڈائجسٹ لاگو کرنے کے بعد، `docs.config.yaml` خودکار طور پر دریافت ہو جاتی ہے۔ تلاش اور محدود سیاق و سباق قابلِ تلف پروجیکشنز رہتے ہیں: ```bash docs-protocol find "tenant isolation" --fuzzy docs-protocol context "tenant isolation" --fuzzy --max-documents 12 docs-protocol check ``` زیرِ انتظام دستاویز تصنیف نصب شدہ Docs Protocol CLI استعمال کرتی ہے۔ `owner` اور `summary` واضح Intent اختیار ہیں اور انہیں کبھی فاؤنڈیشن ڈیفالٹس نہیں ملتے: ```bash agent-teams-docs find "tenant isolation" agent-teams-docs new --type adr --id ADR-0083 \ --title "Tenant isolation" --owner architecture/tooling \ --summary "Defines the tenant-isolation boundary and its verification evidence." \ --dry-run agent-teams-docs doctor agent-teams-docs recover agent-teams-docs-managed upgrade --to docs-YYYY-MM-DD-N --target-generation 2 --json ``` ڈرائی رن کا جائزہ لینے کے بعد، `agent-teams-docs new` کو `--apply` کے ساتھ دہرائیں، اس کی درست رسائی کی ہدایت پر عمل کریں، اور کنزیومر کا معیاری ریپوزٹری چیک چلائیں۔ `foundation:check` ایک ڈیٹرمینسٹک مجموعی رپورٹ جاری کرتا ہے اور ہر اعلان شدہ صلاحیت کو نافذ کرتا ہے۔ اختیاری `repository.agent-workflow` صلاحیت `AGENTS.md` کو تمام کوڈنگ ایجنٹس میں کینونیکل رکھتی ہے اور `check:changed` کو مشترکہ فاؤنڈیشن امپلیمنٹیشن کے ذریعے روٹ کرتی ہے؛ مطلوبہ CI پھر بھی مکمل `verify` ثبوت کو آزاد فیل-کلوزڈ لینز کے طور پر چلاتی ہے۔ `foundation:assert-dev-only` رن ٹائم ڈیپنڈنسی کی جگہ کو مسترد کرتا ہے۔ `foundation:assert-registry` مزید ثابت کرتا ہے کہ درست اعلان شدہ ورژن کے پاس مماثل pnpm لاک فائل امپورٹر، npm پیکیج انٹری، sha512 انٹیگریٹی، اور بغیر لنکس، سورس URLs، اوور رائیڈز یا پیچز کے اسنیپ شاٹ موجود ہے۔ اسکافولڈنگ کرنل سخت اسکیمے اور جرنل شدہ فائل سسٹم اڈاپٹر ظاہر کرتا ہے۔ اس میں صرف-ٹیسٹنگ مطابقت فکسچر اور ایک عمومی نجی Node TypeScript لائبریری-باؤنڈری ریسیپی شامل ہے۔ مؤخر الذکر صرف پیکیج لفافہ بناتی ہے؛ کنزیومر بزنس پیکیجز، رولز، اونر دستاویزات اور فیچر سلائسز کنزیومر کی ملکیت رہتے ہیں۔ دیکھیں [ownership](docs/architecture/ownership.md)، [consistency evidence gate](docs/architecture/consistency-evidence-gate.md)، [governance capability acceptance review](docs/research/governance-capability-acceptance-review.md)، [local development](docs/development/local-mode.md)، اور [release procedure](docs/release.md)۔ مکمل دستاویزات انڈیکس [docs/README.md](docs/README.md) ہے۔