इस प्रोजेक्ट के बारे में

# एजेंट टीम्स इंजीनियरिंग फाउंडेशन यह रिपॉजिटरी एजेंट टीम्स रिपॉजिटरी के लिए संस्करणित इंजीनियरिंग नीति, टूलिंग और अनुरूपता प्रदान करती है। इसमें केवल पुन: प्रयोज्य विकास टूलिंग शामिल है; उत्पाद रनटाइम कोड इसे आयात नहीं कर सकता। प्रत्येक उपभोक्ता अपने स्वयं के डोमेन मॉडल, पैकेज कैटलॉग, निर्भरता अनुमतियों, सुरक्षा वर्गीकरण और ADR के लिए अधिकारी बना रहता है। ## दायरा - सख्त डेटा-केवल उपभोक्ता कॉन्फ़िगरेशन और संस्करणित स्कीमा - निष्पादन योग्य वर्कस्पेस घोषणा और स्रोत निर्भरता नीतियां - शासित इनलाइन दमन और जारी सार्वजनिक API संगतता - स्थैतिक निष्पादन-विनिर्देश और उपभोक्ता-गेट कनेक्टिविटी - रिपॉजिटरी वर्कफ़्लो, SBOM, प्रोवेनेंस और पैकेज-सामग्री सुरक्षा नीति - पोर्टेबल एजेंट निर्देश और परिवर्तित-फ़ाइल प्रीफ़्लाइट रूटिंग - मौजूदा पैकेज-स्क्रिप्ट गुणवत्ता द्वारों की वैकल्पिक नियतात्मक रचना - साझा Oxlint और TypeScript 7 बेसलाइन प्रीसेट - स्पष्ट रजिस्ट्री और स्थानीय-लिंक मोड - नियतात्मक अटैच, स्थिति, डिटैच और रजिस्ट्री अभिकथन - बंद नियतात्मक `इंटेंट -> योजना -> लागू करें -> रसीद` स्कैफोल्डिंग - शासित दस्तावेज़ कैटलॉग, नियतात्मक गैर-आरक्षित योजना, केवल-निर्माण प्रकाशन और सटीक-संस्करण पुनर्प्राप्ति कमांड - पृथक पैकेज-सामग्री और उपभोक्ता सत्यापन - अपरिवर्तनीय सार्वजनिक npm संस्करणों के लिए रिलीज़ स्वचालन क्षमताएं सिद्ध रिपॉजिटरी से चरणबद्ध रूप से निकाली जाती हैं। एक क्षमता यहां केवल समानता फिक्स्चर और उपभोक्ता अनुरूपता परीक्षण के साथ आती है। `workspace.dependency-declarations` और `architecture.source-dependencies` सक्रिय और डॉगफूडेड हैं। रिपॉजिटरी स्पष्ट `packages` पैकेज रूट के साथ स्कीमा v2 का उपयोग करती है, जबकि प्रकाशित 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` स्पष्ट इंटेंट अधिकार हैं और कभी भी फाउंडेशन डिफ़ॉल्ट प्राप्त नहीं करते: ```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 ``` ड्राई रन की समीक्षा के बाद, `--apply` के साथ `agent-teams-docs new` दोहराएं, इसकी सटीक पहुंच निर्देश का पालन करें, और उपभोक्ता की मानक रिपॉजिटरी जांच चलाएं। `foundation:check` एक नियतात्मक समग्र रिपोर्ट उत्सर्जित करता है और प्रत्येक घोषित क्षमता को लागू करता है। वैकल्पिक `repository.agent-workflow` क्षमता कोडिंग एजेंटों में `AGENTS.md` को विहित रखती है और `check:changed` को साझा फाउंडेशन कार्यान्वयन के माध्यम से रूट करती है; आवश्यक CI अभी भी स्वतंत्र फेल-क्लोज्ड लेन के रूप में पूर्ण `verify` साक्ष्य चलाता है। `foundation:assert-dev-only` रनटाइम निर्भरता प्लेसमेंट को अस्वीकार करता है। `foundation:assert-registry` अतिरिक्त रूप से साबित करता है कि सटीक घोषित संस्करण में मेल खाता pnpm लॉकफ़ाइल इम्पोर्टर, npm पैकेज प्रविष्टि, sha512 अखंडता और स्नैपशॉट बिना लिंक, स्रोत URL, ओवरराइड या पैच के है। स्कैफोल्डिंग कर्नेल सख्त स्कीमा और एक जर्नल्ड फ़ाइलसिस्टम एडाप्टर उजागर करता है। इसमें केवल-परीक्षण अनुरूपता फिक्स्चर और एक सामान्य निजी Node TypeScript लाइब्रेरी-बाउंड्री रेसिपी शामिल है। उत्तरार्द्ध केवल पैकेज लिफाफा बनाता है; उपभोक्ता व्यावसायिक पैकेज, भूमिकाएं, स्वामी दस्तावेज़ और फीचर स्लाइस उपभोक्ता-स्वामित्व में रहते हैं। [स्वामित्व](docs/architecture/ownership.md), [संगति साक्ष्य द्वार](docs/architecture/consistency-evidence-gate.md), [शासन क्षमता स्वीकृति समीक्षा](docs/research/governance-capability-acceptance-review.md), [स्थानीय विकास](docs/development/local-mode.md) और [रिलीज़ प्रक्रिया](docs/release.md) देखें। पूर्ण दस्तावेज़ीकरण सूचकांक [docs/README.md](docs/README.md) है।