यह पोस्ट 2 मई, 2026 को दाबाकोदान दाओलैब वाइबकोडिंग गिल्ड में 'हार्नेस इंजीनियरिंग' पर एक केस स्टडी प्रस्तुति की सामग्री है।
नेक्स्टेन एक ऐसी कंपनी है जो सॉफ्टवेयर उत्पादों वाली कंपनियों के लिए AX (AI Transformation) तकनीकों का विकास और समर्थन करती है। इसने कोरियाई चर्च पोर्टल ऑनमाम.कॉम के सिस्टम संचालन को संभाला है और AX पर काम कर रही है। हम पुराने IDC सेंटर में स्थित लेगेसी सिस्टम के माइग्रेशन का काम कर रहे हैं, प्रोजेक्ट के लिए एजेंट-आधारित विकास और संचालन के लिए एक वातावरण स्थापित कर रहे हैं, और स्थिरीकरण और कार्यक्षमता सुधार के काम में लगे हुए हैं। एक पुरानी लेगेसी प्रणाली होने के कारण, इसमें कुछ परीक्षण और त्रुटियाँ हुई हैं, और हम naia-business-adk को ऑनमाम.कॉम पर लागू करके इसे अपनी कंपनी के अनुभव और तकनीक के साथ एकीकृत कर रहे हैं। इस अनुभव के आधार पर, हमने हार्नेस इंजीनियरिंग को समझाने के लिए एक केस स्टडी के रूप में इसे कार्यक्रम में साझा किया।
इस लेख का एक-पंक्ति संदेश "AI का अच्छी तरह से उपयोग करने से ज़्यादा महत्वपूर्ण है, एक ऐसा वातावरण बनाना जहाँ AI गलतियाँ न करे।"
1. सबसे पहले, हमारी सेवा का परिचय
ऑनमाम.कॉम — देश भर के 13,876 चर्चों द्वारा उपयोग किया जाने वाला चर्च प्रबंधन प्लेटफॉर्म
www.onmam.com ← चर्च खोजें, सदस्य पोर्टल
home.onmam.com ← चैनल ऐप (सामग्री/भुगतान)
{चर्च का नाम}.onmam.com ← व्यक्तिगत चर्च वेबसाइट
इंफ्रास्ट्रक्चर: पुराने IDC सर्वर → अप्रैल 2026 में GCP (गूगल क्लाउड) में पूर्ण माइग्रेशन पूरा हुआ DB: 13,876 चर्चों का डेटा × Cloud SQL
2. आइए एक घटना से शुरू करें
"अप्रैल 2026 के किसी दिन"
सुबह 11 बजे। अचानक ऑनमाम.कॉम की पूरी सेवा अनुत्तरदायी हो गई।
उपयोगकर्ता: "साइट काम क्यों नहीं कर रही है?"
कारण का पता लगाने पर — Board.php नामक फ़ाइल में बुलेटिन बोर्ड सूची क्वेरी कोड।
-- समस्याग्रस्त क्वेरी (सरलीकृत)
SELECT * FROM boards
JOIN (
SELECT bbs_id, COUNT(*) FROM all_boards GROUP BY bbs_id -- ← यह समस्या है
) AS summary ON boards.id = summary.bbs_id
WHERE church_id = ?
यह एक क्वेरी हर बार 13,876 चर्चों के पूरे डेटा को पूर्ण रूप से स्कैन कर रही थी। जब ट्रैफ़िक बढ़ा, तो 600-800 सेकंड की क्वेरी 145 बार एक साथ निष्पादित हुई → सर्वर पूरी तरह से क्रैश हो गया।
इसका AI से क्या संबंध है?
यह कोड पहली बार शायद किसी मानव डेवलपर ने लिखा था। लेकिन आज के डेवलपर्स ऐसे कोड AI के साथ लिखते हैं।
समस्या यह है — AI को यह नहीं पता कि "यह कोड 13,876 चर्चों के वातावरण में कैसे काम करेगा।" AI अनुरोधित कार्यक्षमता को लागू करने पर ध्यान केंद्रित करता है, और हमारी सेवा के संदर्भ को नहीं जानता।
इसलिए डेवलपर्स ने सोचना शुरू किया: "अगर AI हमारी सेवा को जाने बिना कोड लिखता है, तो इसे कैसे रोका जाए?"
3. हार्नेस इंजीनियरिंग — 30 सेकंड का स्पष्टीकरण
जैसे घोड़े को नियंत्रित करने के लिए लगाम और हार्नेस की आवश्यकता होती है,
वैसे ही AI एजेंट को भी प्रतिबंध, मार्गदर्शन और सत्यापन तंत्र की आवश्यकता होती है।
एजेंट = मॉडल + हार्नेस
हार्नेस = AI के काम करने के पूरे वातावरण को डिज़ाइन करना
यह सिर्फ "AI से अच्छे प्रश्न पूछना" नहीं है। यह एक सिस्टम डिज़ाइन है जो AI द्वारा गलती करने पर संरचनात्मक रूप से उसी गलती को दोबारा होने से रोकता है।
4. ऑनमाम.कॉम में वास्तव में बनाए गए हार्नेस
[हार्नेस #1] AGENTS.md — AI को दिया गया "हमारी सेवा का नक्शा"
alpha-adk/
├── CLAUDE.md ← AI सत्र शुरू करते समय इसे अवश्य पढ़ता है
├── AGENTS.md ← परियोजना नियमों की सूची
└── .agents/
└── context/
└── agents-rules.json ← विशिष्ट संचालन नियम
AI ऑनमाम.कॉम कोड को छूने से पहले इन फ़ाइलों को अवश्य पढ़ता है। इसमें निम्नलिखित सामग्री शामिल है:
- "परीक्षण और कोड संशोधन केवल अल्फा वातावरण में किए जाते हैं"
- "home.onmam.com एक पोर्टल नहीं बल्कि एक अलग चैनल ऐप है"
- "Board.php में GROUP BY व्युत्पन्न तालिका पैटर्न पूरी तरह से निषिद्ध है"
वह पिछली समस्या? अब अगर AI उसी पैटर्न को बनाने की कोशिश करता है, तो वह इस नियम को देखकर रुक जाता है।
[हार्नेस #2] हुक्स — AI के व्यवहार से पहले और बाद में काम करने वाले "सुरक्षा उपकरण"
वर्तमान में इस वर्कस्पेस में सक्रिय हुक्स:
AI द्वारा बैश कमांड निष्पादित करने से ठीक पहले →
✓ pr-guard.js : समीक्षा के बिना PR मर्ज को रोकता है
✓ commit-guard.js : नियम उल्लंघन वाले कमिट को रोकता है
✓ deploy-guard.js : बिना अनुमोदन के उत्पादन सर्वर पर डिप्लॉयमेंट को रोकता है
✓ git-push-guard.js : बिना अनुमोदन के git push को रोकता है
✓ destructive-git-guard.js : git reset --hard जैसे विनाशकारी कमांड को रोकता है
AI द्वारा फ़ाइल संशोधित करने से ठीक पहले →
✓ prod-gateway-guard.js : उत्पादन API कुंजी को dev वातावरण फ़ाइलों में उपयोग करने से रोकता है
✓ design-doc-guard.js : डिज़ाइन दस्तावेज़ों के अनधिकृत संशोधन को रोकता है
AI द्वारा फ़ाइल संशोधित करने के तुरंत बाद →
✓ cascade-check.js : संशोधित फ़ाइल से प्रभावित होने वाली कैस्केडिंग फ़ाइलों की जाँच करता है
deploy-guard.js का वास्तविक कार्य उदाहरण:
AI द्वारा उत्पादन डिप्लॉयमेंट कमांड निष्पादित करने का प्रयास:
$ gcloud run deploy onmam-web ...
→ [हार्नेस] उत्पादन डिप्लॉयमेंट कमांड अवरुद्ध: gcloud run deploy
परियोजना: onmam-web
उत्पादन डिप्लॉयमेंट के लिए पूर्व-अनुमोदन की आवश्यकता है।
अनुमोदन विधि: .claude/deploy/approvals.json में अनुमोदन आइटम जोड़ें
AI सीधे उत्पादन डिप्लॉयमेंट निष्पादित नहीं करता है।
भले ही AI गलती से, या बहुत आक्रामक तरीके से, उत्पादन सर्वर पर कुछ अपलोड करने की कोशिश करे, तो भी उसे भौतिक रूप से अवरुद्ध कर दिया जाता है।
[हार्नेस #3] अल्फा वातावरण — AI के प्रयोगों के लिए एक समर्पित खेल का मैदान
उत्पादन (Production) : www.onmam.com ← वास्तविक चर्च उपयोग करते हैं
स्टेजिंग (Staging) : staging.onmampick.org ← डिप्लॉयमेंट से पहले अंतिम पुष्टि
अल्फा (Alpha) : luke-*-alpha.onmampick.org ← AI के साथ काम करने का स्थान
नियम: AI के साथ सभी कार्य केवल अल्फा में।
यह क्यों महत्वपूर्ण है — 29 अप्रैल, 2026 को वास्तव में क्या हुआ था:
AI ने
home.onmam.comकोportalऐप समझकर गलत vhost सेटिंग्स लिखीं। अल्फा वातावरण होने के कारण → वास्तविक सेवा पर कोई प्रभाव नहीं पड़ा। इस गलती को AGENTS.md में रिकॉर्ड किया गया → AI ने वही गलती दोबारा नहीं की।
हार्नेस का सार यहाँ है: जब कोई गलती होती है → उसे हार्नेस में रिकॉर्ड किया जाता है → अगली बार वह गलती संरचनात्मक रूप से असंभव हो जाती है।
[हार्नेस #4] स्किल्स — AI को दिए गए "हमारे अपने उपकरण"
skills/
├── email/ ← ईमेल भेजना (प्राप्तकर्ता, SMTP नियम शामिल)
├── sms/ ← SMS भेजना
├── web-monitoring/ ← सेवा स्थिति की निगरानी
└── service-management/ ← सेवा संचालन कमांड
जब AI कहता है "मुझे ईमेल भेजो" — तो वह इस स्किल फ़ाइल को पढ़ता है और स्वचालित रूप से जानता है कि किसे, किस प्रारूप में, और किस SMTP के माध्यम से भेजना है। हर बार "प्राप्तकर्ता का ईमेल पता क्या है?" पूछने की आवश्यकता नहीं है।
5. डेवलपर्स इसमें क्यों रुचि रखते हैं
"AI के बिना विकास के युग की समस्या"
डेवलपर की व्यक्तिगत क्षमता पर निर्भरता → यदि सीनियर चला जाता है तो गुणवत्ता गिर जाती है
कोड समीक्षा द्वारा पकड़ना पड़ता है → लोगों को मैन्युअल रूप से देखना पड़ता है
"AI होने पर भी हार्नेस रहित टीम की समस्या"
AI तेजी से कोड बनाता है लेकिन → हमारी सेवा के संदर्भ को नहीं जानता
वही गलतियाँ दोहराता है → AI बग बनाता है और लोग उन्हें ठीक करते हैं
AI सीधे उत्पादन सर्वर तक पहुँच सकता है → कभी भी दुर्घटना हो सकती है
"AI + हार्नेस वाली टीम"
AI हमारे नियमों को जानता है और कोड लिखता है → संदर्भ के साथ निर्माण
गलती होने पर हार्नेस में रिकॉर्ड किया जाता है → उसी गलती को संरचनात्मक रूप से रोकता है
उत्पादन तक पहुँच मानव द्वारा अनुमोदित → सुरक्षित स्वायत्तता
टॉस के शब्दों में कहें तो:
"हार्नेस संगठन की समग्र उत्पादकता के निचले स्तर को ऊपर उठाता है। व्यक्तिगत क्षमताओं पर निर्भर हुए बिना, सभी टीम सदस्य एक निश्चित स्तर से ऊपर के परिणाम प्राप्त करते हैं।"
6. सारांश — गैर-डेवलपर्स को मैं क्या बताना चाहता हूँ
AI युग में "अच्छा करना" की परिभाषा बदल रही है।
पहले: कोड लिखने वाला एक अच्छा डेवलपर अब: AI के कोड लिखने के वातावरण को अच्छी तरह से डिज़ाइन करने वाला डेवलपर
उस वातावरण के डिज़ाइन का मूल हार्नेस इंजीनियरिंग है।
और यह केवल डेवलपर्स की कहानी नहीं है।
गैर-डेवलपर्स भी हार्नेस कर सकते हैं:
→ व्यावसायिक नियमों को स्पष्ट रूप से दस्तावेज़ित करना
→ AI के लिए "यह किया जा सकता है, और यह नहीं किया जा सकता है" को परिभाषित करना
→ AI द्वारा गलती करने पर "गलती क्यों हुई" को रिकॉर्ड करना
= यही हार्नेस इंजीनियरिंग की शुरुआत है
ऑनमाम.कॉम हार्नेस संरचना एक नज़र में
alpha-adk/
├── CLAUDE.md ← [गाइड] AI सत्र शुरू करते समय अनिवार्य रूप से पढ़ा जाए
├── AGENTS.md ← [गाइड] परियोजना नियम (SoT)
├── .agents/context/
│ └── agents-rules.json ← [गाइड] विशिष्ट संचालन नियम
├── .claude/
│ ├── hooks/
│ │ ├── deploy-guard.js ← [सेंसर] उत्पादन डिप्लॉयमेंट को रोकता है
│ │ ├── prod-gateway-guard.js← [सेंसर] उत्पादन API कुंजी को रोकता है
│ │ ├── commit-guard.js ← [सेंसर] कमिट नियमों का सत्यापन
│ │ ├── pr-guard.js ← [सेंसर] PR अनुमोदन लागू करता है
│ │ ├── session-inject.js ← [सेंसर] प्रत्येक सत्र में संदर्भ इंजेक्ट करता है
│ │ └── cascade-check.js ← [सेंसर] संशोधन के बाद कैस्केडिंग प्रभावों की जाँच करता है
│ └── settings.json ← [अनुमति] हुक निष्पादन सेटिंग्स
├── skills/
│ ├── email/ ← [टूल] ईमेल भेजने का स्किल
│ ├── web-monitoring/ ← [टूल] सेवा निगरानी
│ └── service-management/ ← [टूल] सेवा संचालन कमांड
└── data-private/memory/ ← [फीडबैक लूप] गलतियों को रिकॉर्ड करना → पुनरावृत्ति को रोकना
├── project_onmam_incidents.md ← Board.php समस्या पैटर्न रिकॉर्ड
├── project_onmam_app_structure.md← home≠portal गलती रिकॉर्ड
└── feedback_alpha_only.md ← अल्फा-विशिष्ट नियम रिकॉर्ड
हार्नेस = इन फ़ाइलों का संग्रह सभी git रेपो में कमिट किए जाते हैं। टीम का पूरा संदर्भ! कोड के रूप में जमा होता है।
