केस स्टडी: Agent के साथ Pagination जोड़ना

अनुरोध से merged PR तक

कार्य: छोटी web service में GET /orders में cursor pagination जोड़ना। Setup: साफ़ checkout, नई branch agent/orders-pagination, शुरू करने से पहले branch पर tests हरे, test/lint commands और नियम "money integer paise है" वाली AGENTS.md, और production credentials के बिना container में चलता agent। कार्य पाठ: लक्ष्य और कारण, देखने की files, बाधाएँ (response backward compatible रहे; कोई नई dependency नहीं), सत्यापन कैसे (unit-test command), दायरा (सिर्फ़ orders endpoint)। पहले योजना: agent चरण और cursor डिज़ाइन प्रस्तावित करता है (last-id cursor, डिफ़ॉल्ट पृष्ठ आकार 20, अधिकतम 100); engineer अनुमोदित करता है, अंतिम-पृष्ठ मामले की आवश्यकता जोड़कर। कार्यान्वयन: agent विफल tests लिखता है (पृष्ठ आकार, अगला cursor, अंतिम पृष्ठ, अमान्य cursor), engineer tests की समीक्षा करता है, फिर वह दो छोटे commits में लागू करता है, हर बार tests चलाते हुए। सुरक्षाएँ: चरण सीमा और लागत बजट; patch द्वार और secret scan पास; अटके-run की पहचान कभी ट्रिगर नहीं होती। समीक्षा: 60-पंक्ति का diff और सार; engineer जाँचता है कि कोई test कमज़ोर नहीं हुआ, अमान्य cursors का error सँभाल पढ़ता है, और service स्थानीय रूप से चलाता है। Merge: CI पास, एक मानव समीक्षक अनुमोदन देता है, PR में लिखा है कि AI agent उपयोग हुआ और कैसे सत्यापित हुआ।

दिशा दें, बाँधें, सत्यापित करें, समीक्षा करें

अच्छे परिणाम स्पष्ट कार्यों, बँधे runs, स्वतंत्र सत्यापन और मानव समीक्षा से आते हैं।

एक पन्ने पर workflow

हर पंक्ति इस कोर्स के एक खंड से जुड़ती है।

Setup      clean branch, green baseline, AGENTS.md, container without prod credentials      (Sec 1, 2, 3)
Task       goal + files + constraints + verify command + scope                                (Sec 4)
Plan       agent proposes, human approves (cursor design, last-page case)                      (Sec 4)
Implement  failing tests (reviewed) -> small commits -> tests each time                        (Sec 2, 4)
Safeguards step/cost caps, stuck-run detection, patch gate, secret scan, protected paths        (Sec 5)
Review     60-line diff, test changes scrutinised, local run, summary                          (Sec 5, 7)
Merge      CI green + one human approval + PR notes AI use and verification                   (Sec 2, 7)

सीखें instruction file में दर्ज करें

समय खाने वाली हर ग़लती AGENTS.md में एक-पंक्ति के नियम की उम्मीदवार है।

त्वरित जाँच: Engineer ने agent के कोड लिखने से पहले योजना क्यों अनुमोदित की?

• योजनाएँ CI के लिए ज़रूरी हैं
• योजना सुधारना सस्ता है; ग़लत कार्यान्वयन पलटना महँगा
• Agents manager की अनुमति के बिना कोड नहीं लिख सकते
• यह मॉडल तेज़ करता है