Playbooks सिस्टम

नोट: यह पृष्ठ हमारे Constitutional Engineering दर्शन के तकनीकी कार्यान्वयन का वर्णन करता है। यदि आपने अभी तक दार्शनिक नींव के बारे में नहीं पढ़ा है, तो हम सुझाव देते हैं कि Playbooks के पीछे के "क्यों" को समझने के लिए वहां से शुरुआत करें।

Playbooks सिस्टम AI विकास में संदर्भ समस्या के लिए Hatcher का दूसरी पीढ़ी का समाधान है। जहां Claude.md जैसी स्थिर फ़ाइलें एक शुरुआती बिंदु प्रदान करती हैं, Playbooks एक डायनामिक, केंद्रीकृत, और शासनीय सिस्टम प्रदान करती हैं जो आपके AI एजेंटों के लिए एक सच्चे कॉर्पोरेट संविधान के रूप में कार्य करती हैं।

Playbooks क्या हैं?

Playbooks संरचित कॉन्फ़िगरेशन फ़ाइलें हैं जो आपकी टीम की निम्नलिखित चीज़ों को कैप्चर करती हैं:

• कोडिंग मानक: फ़ॉर्मेटिंग, नामकरण सम्मेलन, और शैली प्राथमिकताएं
• आर्किटेक्चर निर्णय: कॉम्पोनेंट पैटर्न, स्टेट मैनेजमेंट दृष्टिकोण
• फ्रेमवर्क विशिष्टताएं: लाइब्रेरी-विशिष्ट सर्वोत्तम प्रथाएं और पैटर्न
• व्यावसायिक नियम: डोमेन-विशिष्ट तर्क और बाधाएं

Playbook संरचना

एक बुनियादी Playbook इस संरचना का अनुसरण करती है:

{
  "name": "Vue 3 Component Standards",
  "version": "1.0.0",
  "framework": "vue",
  "rules": [
    {
      "category": "components",
      "type": "naming",
      "pattern": "PascalCase",
      "description": "All Vue components must use PascalCase naming"
    },
    {
      "category": "composition",
      "type": "api",
      "preference": "composition-api",
      "description": "Prefer Composition API over Options API"
    }
  ],
  "examples": [
    {
      "title": "Standard Component Structure",
      "code": "..."
    }
  ]
}

अंतर्निहित Playbooks

Hatcher लोकप्रिय फ्रेमवर्क के लिए क्यूरेटेड Playbooks के साथ आती है:

Vue.js Playbooks

• Vue 3 + TypeScript: आधुनिक composition पैटर्न
• Nuxt.js: SSR और फ़ाइल-आधारित रूटिंग सम्मेलन
• Pinia: स्टेट मैनेजमेंट सर्वोत्तम प्रथाएं

React Playbooks

• React + TypeScript: फंक्शनल कॉम्पोनेंट और hooks
• Next.js: App Router और सर्वर कॉम्पोनेंट
• Zustand: हल्का स्टेट मैनेजमेंट

Universal Playbooks

• TypeScript Standards: टाइप परिभाषाएं और generics
• CSS-in-JS: Styled-components और emotion पैटर्न
• Testing: Jest और Cypress सम्मेलन

कस्टम Playbooks बनाना

टीम-विशिष्ट नियम

Playbooks बनाएं जो आपकी टीम के अनूठे सम्मेलनों को कैप्चर करती हैं:

{
  "name": "Acme Corp Standards",
  "extends": ["vue3-typescript"],
  "rules": [
    {
      "category": "api",
      "type": "structure",
      "pattern": "services/api/*.service.ts",
      "description": "All API calls must go through service layer"
    },
    {
      "category": "components",
      "type": "props",
      "requirement": "interfaces",
      "description": "Component props must use TypeScript interfaces"
    }
  ]
}

परियोजना-विशिष्ट संदर्भ

परियोजना-विशिष्ट ज्ञान जोड़ें:

{
  "name": "E-commerce Dashboard",
  "extends": ["acme-corp-standards"],
  "context": {
    "domain": "e-commerce",
    "entities": ["Product", "Order", "Customer"],
    "apis": [
      {
        "name": "OrdersAPI",
        "baseUrl": "/api/orders",
        "methods": ["GET", "POST", "PUT", "DELETE"]
      }
    ]
  }
}

Playbook विरासत

Playbooks स्केलेबल कॉन्फ़िगरेशन के लिए विरासत का समर्थन करती हैं:

Universal TypeScript
    ↓
Vue 3 + TypeScript
    ↓
Acme Corp Standards
    ↓
Project-Specific Rules

AI एकीकरण

Hatcher स्वचालित रूप से प्रासंगिक Playbook संदर्भ को AI प्रॉम्प्ट में इंजेक्ट करता है:

संदर्भ चयन

• स्वचालित: फ़ाइल प्रकार और परियोजना संरचना के आधार पर
• मैनुअल: स्पष्ट रूप से निर्दिष्ट करें कि कौन सी Playbooks का उपयोग करना है
• स्मार्ट: समय के साथ आपकी प्राथमिकताओं से सीखें

प्रॉम्प्ट संवर्धन

AI इंजन संरचित संदर्भ प्राप्त करते हैं जैसे:

CONTEXT: Vue 3 Component Creation
PLAYBOOK: vue3-typescript, acme-corp-standards
RULES:
- Use Composition API with <script setup>
- Props must use TypeScript interfaces
- Components must be PascalCase
- API calls go through service layer

बाज़ार और साझाकरण

समुदाय Playbooks

समुदाय द्वारा बनाई गई Playbooks ब्राउज़ करें और स्थापित करें:

• फ्रेमवर्क-विशिष्ट: लोकप्रिय लाइब्रेरीज़ के लिए अनुकूलित पैटर्न
• उद्योग-विशिष्ट: विभिन्न क्षेत्रों के लिए डोमेन ज्ञान
• टीम-परीक्षित: सफल परियोजनाओं से वास्तविक दुनिया के सम्मेलन

अपनी Playbooks प्रकाशित करना

अपनी टीम की विशेषज्ञता साझा करें:

hatcher playbook publish acme-corp-standards

संस्करण प्रबंधन

• Semantic Versioning: परिवर्तन और संगतता को ट्रैक करें
• अपडेट सूचनाएं: समुदाय सुधारों के साथ अद्यतित रहें
• रोलबैक समर्थन: समस्याग्रस्त अपडेट को सुरक्षित रूप से वापस करें

कॉन्फ़िगरेशन

वैश्विक Playbooks

सभी परियोजनाओं के लिए डिफ़ॉल्ट Playbooks सेट करें:

{
  "globalPlaybooks": ["typescript-standards", "git-conventions"]
}

परियोजना ओवरराइड

hatcher.config.json में परियोजना-विशिष्ट Playbooks निर्दिष्ट करें:

{
  "playbooks": ["vue3-typescript", "team-standards", "./custom-playbook.json"]
}

सशर्त लोडिंग

संदर्भ के आधार पर विभिन्न Playbooks लोड करें:

{
  "conditional": {
    "**/*.test.ts": ["testing-standards"],
    "src/components/**": ["component-standards"],
    "src/api/**": ["api-standards"]
  }
}

सर्वोत्तम प्रथाएं

सरल शुरुआत करें

फ्रेमवर्क मूल बातों से शुरू करें और धीरे-धीरे टीम-विशिष्ट नियम जोड़ें:

1. फ्रेमवर्क Playbook स्थापित करें: तुरंत 80% कवरेज प्राप्त करें
2. टीम नियम जोड़ें: अनूठे सम्मेलनों को कैप्चर करें
3. समय के साथ परिष्कृत करें: वास्तविक उपयोग के आधार पर अपडेट करें

इसे वर्तमान रखें

• नियमित समीक्षा: पैटर्न विकसित होने पर Playbooks अपडेट करें
• टीम फीडबैक: Playbook रखरखाव में पूरी टीम को शामिल करें
• संस्करण नियंत्रण: कोड के साथ-साथ Playbook परिवर्तनों को ट्रैक करें

प्रभाव मापें

• स्थिरता मेट्रिक्स: परिभाषित पैटर्न के पालन को ट्रैक करें
• गति सुधार: विकास वेग लाभ को मापें
• गुणवत्ता संकेतक: कम कोड समीक्षा फीडबैक की निगरानी करें

भविष्य की सुविधाएं

AI-जनरेटेड Playbooks

मौजूदा कोडबेस का विश्लेषण करके स्वचालित रूप से Playbooks जेनरेट करें।

वास्तविक समय सत्यापन

जैसे आप कोड करते हैं, लाइव फीडबैक, Playbook अनुपालन सुनिश्चित करना।

टीम सहयोग

Playbook अपडेट के लिए सहयोगात्मक संपादन और अनुमोदन वर्कफ़्लो।

Playbooks सिस्टम AI को एक सामान्य कोड जनरेटर से आपकी टीम के एक विशेष सदस्य में बदल देती है जो आपकी सटीक आवश्यकताओं और सम्मेलनों को समझता है।

अपनी पहली Playbook बनाएं

AI को एक विशेष टीम सदस्य में बदलें जो आपके सटीक मानकों का पालन करता है

Playbooks बनाना शुरू करें→

आपके पैटर्न। आपके मानक। लगातार लागू किए गए।