Claude Code Harness Lite: शुरुआती बदलावों के लिए छोटा सुरक्षित ढांचा

Claude Code को असली repository में पहली बार इस्तेमाल करते समय सबसे बड़ी गलती केवल खराब prompt नहीं होती। असली गलती यह है कि सीमा तय किए बिना agent को बहुत बड़ा काम दे दिया जाता है। Harness Lite एक छोटा सुरक्षित ढांचा है: पहले पढ़ना, फिर edit करना, फिर proof छोड़ना, उसके बाद public URL और revenue CTA देखना।

यह Claude Code harness engineering का शुरुआती रूप है। अनजान repository में इसे repo map first pass और permission receipt pattern के साथ रखें, ताकि हर बदलाव का scope साफ रहे।

task से पहले boundary लिखें

Harness Lite Claude Code को कमजोर नहीं बनाता। यह बदलाव को explainable बनाता है। पहले तय करें कि कौन से files पढ़ने हैं, कौन से edit हो सकते हैं, कौन से area बाहर रहेंगे, कौन सा command proof देगा, और deploy के बाद कौन सा public page देखना है।

Content या product site में यह जरूरी है, क्योंकि article, free PDF form, Gumroad link और consultation link अक्सर पास-पास होते हैं। छोटी copy change भी search traffic से lead या sale तक जाने वाले रास्ते को तोड़ सकती है।

harness_lite:
  owner: "Masa"
  scope:
    allowed:
      - "read repository"
      - "edit selected files"
      - "run build or test"
    blocked:
      - "delete unrelated files"
      - "touch secrets"
      - "hide failed verification"
  proof:
    - "git diff reviewed"
    - "build command recorded"
    - "public URL opened"
    - "CTA path checked"

copy-paste शुरूआती prompt

मैं इस repository में केवल एक छोटा और सुरक्षित बदलाव करना चाहता हूँ।
अभी files edit न करें।
कृपया लौटाएँ:
1. पहले पढ़ने वाली files
2. सुरक्षित रूप से edit होने वाली files
3. scope से बाहर रहने वाले area
4. सबसे छोटा verification command
5. public URL पर h1, canonical, hero image और CTA checks
6. free PDF, Gumroad और consultation links बचाने के notes

मुख्य बात implementation माँगना नहीं है। पहले boundary माँगें। boundary साफ होने के बाद ही एक change, एक proof command और एक receipt माँगें।

proof को छोटे object में बदलें

change के बाद Claude Code से proof receipt भरवाएँ। नीचे का JavaScript आसान है, लेकिन commit से पहले minimum done condition साफ कर देता है।

const proof = {
  goal: "change one small thing",
  filesChanged: 2,
  commands: ["npm run build"],
  publicUrlChecked: true,
  ctaChecked: true,
};

export function isReadyToCommit(receipt) {
  return receipt.filesChanged <= 3 &&
    receipt.commands.length > 0 &&
    receipt.publicUrlChecked &&
    receipt.ctaChecked;
}

console.log(isReadyToCommit(proof)); // true का मतलब minimum commit gate पास है

इससे अधूरे state पकड़े जाते हैं: build pass हुआ पर public URL नहीं खुला; HTTP 200 आया पर गलत article दिखा; body सही है पर Gumroad या consultation CTA गलत जगह जा रहा है।

तीन real examples

• Astro article edit में scope को एक MDX, एक hero image और एक related product page तक रखें। deploy के बाद h1, opening body, canonical, free PDF form, Gumroad button और consultation link देखें।
• छोटे React fix में target component, nearby test और screenshot या Storybook check रखें। auth, billing, secrets और migration को पहले pass से बाहर रखें।
• team rollout में safe commands, protected areas, receipt format और rollback note को CLAUDE.md में लिखें। अगला teammate वही rule लेकर शुरू करेगा।

failure cases

आम गलती है “सब check करके ठीक कर दो” कहना। Claude Code मदद करना चाहता है, diff बड़ा हो जाता है और proof धुंधला हो जाता है। दूसरी गलती local build को publication मान लेना है। public route HTTP 200 दे सकता है, लेकिन fallback page या पुराना article दिखा सकता है।

Revenue path में भी गलती होती है। body free PDF सुझाती है, पर article-end CTA दूसरे product पर जाता है। multilingual article यह नहीं बताता कि Gumroad अभी English-first self-serve path है। consultation link है, लेकिन यह नहीं बताता कि guide की जगह call कब चाहिए। Harness Lite इन checks को task के अंदर रखता है।

free PDF, Gumroad और consultation

Commands और safe habits सीख रहे हैं तो free cheatsheet लें। review, debugging और refactoring prompts बार-बार लिखते हैं तो 50 Prompt Templates लें। permissions, CLAUDE.md, hooks, MCP या CI/CD bottleneck है तो Setup Guide देखें। team workflow या revenue path design चाहिए तो consultation पर जाएँ।

इस article में क्या verify किया

इस article में lightweight harness, copy prompt, proof object, तीन examples, failure cases, और free PDF, Gumroad, consultation path शामिल हैं। अगले numbers हैं PDF registrations, Gumroad clicks और consultation visits from this slug.

publication के बाद operating note

Production में इस pattern को use करते समय “file बन गई” पर न रुकें। काम तब पूरा है जब public URL पर reader अगला step चुन सके। Mobile width में h1, opening body, hero image, free PDF form, Gumroad links और consultation link देखें। Body सही है पर article-end CTA गलत product पर जाता है, तो revenue path अभी incomplete है।

Localized articles में same slug काफी नहीं है। Japanese, English, Chinese, Korean, Spanish, French, German, Portuguese, Hindi और Indonesian में opening body और CTA language देखें। केवल heading translated हो और body या CTA English रहे, तो localization fail है क्योंकि reader next step trust नहीं करेगा।

Next improvement में सिर्फ PV न देखें। PDF signup starts, Gumroad clicks, Products visits, Training visits, country mix और search source को एक brief में रखें। Claude Code बेहतर decision लेता है जब metric बताता है कि free asset, Prompt Templates, Setup Guide या consultation path में से किसे मजबूत करना है।