तपाई एआई सहायकलाई आफ्नो प्रजेक्टको कोडिङ सम्मेलनहरू पालन गर्न कसरी बनाउनु हुन्छ?

Question

Accepted Answer

एआई यसको प्रशिक्षण डेटाको एक सामान्य औसतमा पूर्वनिर्धारित हुन्छ, त्यसैले आफ्नो **शैली** पाउनको लागि तपाईले **उदाहरण, स्पष्ट नियम फाइल, र लिन्टर लुपको माध्यमबाट देखाउनु र लागू गर्नु** पर्छ जसले बाहिर आउने कुरा पक्रन्छ। यसलाई आफ्नो मानकहरू (WordPress Coding Standards, PSR-12, आदि) अनुमान गर्न दिनु हुँदैन।

## प्रविधिहरू (leverage को क्रमानुसार)

- **लिन्टर कन्फिग र उदाहरणहरू प्रदान गर्नुहोस्** — आफ्नो `.eslintrc`, `phpcs.xml`, वा `.editorconfig` पेस्ट गर्नुहोस्। यी मेसिन-जाँच गर्न योग्य रूपमा नियमहरू हुन्, र एआईले तिनलाई पढ्न सक्छ।
- **नियम/निर्देशन फाइल राख्नुहोस्** — `CLAUDE.md` वा system prompt जसले मानक स्पष्ट रूपमा बताउँछ: "यो प्रजेक्ट **PSR-12** अनुसरण गर्छ। 4-space indent, फङ्क्शनहरूको लागि अर्को लाइनमा braces, hooks को लागि snake_case प्रयोग गर्नुहोस्।" स्थायी निर्देशनले हरेक prompt मा आफूलाई दोहोर्याउनु भन्दा राम्रो।
- **प्रतिनिधि अवस्थित कोड देखाउनुहोस्** — एक वा दुई स्वच्छ फाइलहरू नामकरण, संरचना, र idioms को विवरणको तुलनामा अधिक छिटो सिखाउँछन्। एआई यसले देख्ने कुरासँग pattern-match गर्छ।
- **एआई आउटपुटमा लिन्टर चलाउनुहोस् र त्रुटिहरू फिर्ता खुवाउनुहोस्** — सबैभन्दा विश्वसनीय कदम। लिन्टर आधार सत्य हो; यसको त्रुटिहरू पेस्ट गर्नुहोस् र एआईलाई तिनलाई ठीक गर्न सोध्नुहोस्।

## लिन्टर लुप

```bash
# 1. AI generates the change, then you run the project linter on it:
phpcs --standard=phpcs.xml src/NewClass.php
# => src/NewClass.php  12 | ERROR | Expected 1 space after FUNCTION keyword; 0 found
#    src/NewClass.php  14 | ERROR | Line indented incorrectly; expected 4 spaces, found 2

# 2. Paste those exact errors back to the AI: "Fix these phpcs errors."
# 3. Re-run until clean. The linter — not the AI's claim — is the source of truth.
```

यो लुप छिटो अभिसरित हुन्छ किनभने लिन्टरले सुस्पष्ट, लाइन-स्तरको फिडब्याक दिन्छ जस लाई एआीले सीधा कार्य गर्न सक्छ, बजाय तपाईले गद्य मा शैली वर्णन गर्ने।

## किन यो महत्त्वपूर्ण हो

कोड जसले प्रजेक्ट सम्मेलनहरू उपेक्षा गर्छ **समीक्षा घर्षण र असंगति** सृजना गर्छ यद्यपि यो कार्यात्मकरूपमा सही छ — समीक्षाकर्ताहरूले स्वरूपन्नमा समय बर्बाद गर्छन्, र codebase बहाव गर्छ। एआईलाई तपाईले यो आपूर्ति नगर्दासम्म आफ्नो house style को कुनै जागरूकता छैन, त्यसैले काम नियमहरू **स्पष्ट र जाँच योग्य** बनाउनु हो: intent को लागि नियम फाइल, idioms को लागि प्रतिनिधि कोड, र लुपमा enforcer को रूपमा लिन्टर। समान अनुशासन (config + उदाहरण + automated check) तपाईको सम्मेलनहरूमा मानव टोलीको सदस्यलाई onboard गर्ने तरिका हो, पनि।