Claude Code Small PR Proof Pack: छोटे PR को review-ready बनाना

Claude Code से बना change सिर्फ इसलिए review-ready नहीं होता क्योंकि diff छोटा है। Reviewer को goal, बदली हुई files, चलाए गए commands, public URL, CTA path और rollback plan चाहिए।

इस bundle को मैं Small PR Proof Pack कहता हूं। यह AI-assisted छोटे PR के लिए review receipt है।

Related guides: review gate before commit, team handoff rules, और build error triage loop। External references: Claude Code documentation, GitHub pull request docs, GitHub Actions docs।

Minimum Proof Pack

small_pr_proof_pack:
  owner: "Masa"
  goal: "article CTA को clear बनाना"
  changed_files:
    - "site/src/content/blog/example.mdx"
  verification:
    - command: "npm run build"
      result: "passed"
    - command: "node scripts/check-code-fences.mjs"
      result: "passed"
  public_checks:
    - url: "https://claudecode-lab.com/hi/blog/example/"
      checked:
        - "h1 correct"
        - "mobile horizontal scroll नहीं"
        - "CTA expected product खोलता है"
  rollback:
    command: "revert this PR"
    risk: "content-only change"

Goal, scope, verification, public URL, revenue path और rollback सबसे जरूरी fields हैं।

PR template

## Goal
-

## Scope
- Changed:
- Not changed:

## Proof
- Command:
- Result:

## Public URL Check
- URL:
- H1:
- Mobile:
- Code block:
- CTA:

## Revenue Path Check
- Free PDF:
- Gumroad:
- Training/contact:

## Rollback
-

Not changed Claude Code PR में खास जरूरी है। इससे reviewer को पता चलता है कि task scope scripts, products या external settings तक नहीं फैला।

तीन use cases

पहला use case article CTA है। सिर्फ copy नहीं, free PDF, Gumroad, Products और consultation path भी check करें।

दूसरा use case mobile code block है। Build pass हो सकता है, फिर भी 390px mobile width पर लंबी command बाहर निकल सकती है।

तीसरा use case multilingual article है। Japanese version मजबूत हो सकता है, लेकिन zh या ko thin रह सकते हैं। Proof Pack में locale coverage, code fences और representative visual check लिखें।

Simple gate

const proof = {
  filesChanged: 2,
  commands: ["npm run build"],
  publicUrlChecked: true,
  mobileChecked: true,
  revenuePathChecked: true,
  rollbackWritten: true,
};

export function isReadyToCommit(receipt) {
  return receipt.filesChanged <= 5 &&
    receipt.commands.length > 0 &&
    receipt.publicUrlChecked &&
    receipt.mobileChecked &&
    receipt.revenuePathChecked &&
    receipt.rollbackWritten;
}

यह human review को replace नहीं करता। यह Claude Code से मिलने वाला minimum evidence साफ करता है।

Common mistakes

सबसे कमजोर PR body है: “fixed with Claude Code”। इससे reviewer को कोई context नहीं मिलता। दूसरा mistake है build pass को full proof समझना। Build H1, canonical, hero image, CTA, Gumroad या mobile layout prove नहीं करता।

Rollback भी अक्सर नहीं लिखा जाता। Content-only change में revert काफी हो सकता है। Product links, mail scripts, Cloudflare variables या external settings हों तो concrete steps लिखें।

Monetization path

ClaudeCodeLab सिर्फ articles जमा नहीं करता। Site traffic को signup, purchase या consultation में बदलती है। Beginners के लिए free cheatsheet, repeat users के लिए 50 Prompt Templates, और teams के लिए Setup Guide या training consultation बेहतर है।

इसलिए content PR जब copy, CTA, product cards या navigation छूता है, तो revenue path check जरूर करें।