AI एजेंटों के लिए प्रभावी स्पेक कैसे लिखें - Addy Osmani

• AI एजेंट की प्रोडक्टिविटी में सबसे बड़ा फर्क पैदा करने वाली चीज़ → स्पष्ट और संरचित SPEC
• खराब SPEC = अस्पष्टता → AI drift, बार-बार विफलता, context overflow
• अच्छा SPEC = living document (SPEC.md) + लगातार अपडेट

अच्छे SPEC के मुख्य घटक

• लक्ष्य / विज़न (क्यों बना रहे हैं, किसके लिए है)
• फीचर सूची + प्राथमिकता
• tech stack (React 18 + TS, Node 20 आदि को स्पष्ट रूप से)
• execution commands (npm test, lint, build आदि)
• test criteria (कौन-से टेस्ट चलने पर सफलता मानी जाएगी)
• code structure / style guide
• Git workflow (branch नियम, commit message)
• boundary setting (✅ हमेशा / ⚠️ पूछो / 🚫 कभी मत करो)

प्रभावी शुरुआती prompt pattern

• “Draft a detailed specification for … covering objectives, features, constraints, step-by-step plan”
• पहले Plan Mode → AI से SPEC का ड्राफ्ट तैयार करवाना
• उसके बाद छोटे-छोटे कामों में बाँटकर निर्देश देना

प्रैक्टिकल टिप्स (सिर्फ़ मुख्य बातें)

• अलग SPEC.md फ़ाइल बनाए रखें → हर काम में सिर्फ़ संबंधित सेक्शन शामिल करें
• modularization + sub-task अलग करना
• हर काम के बाद automatic tests + SPEC अनुपालन की जाँच
• boundary rules के 3 स्तर स्पष्ट रखें (Always / Ask / Never)