Claude Code सेशन हैंडऑफ टेम्पलेट: अगले व्यक्ति या AI एजेंट के लिए संदर्भ बचाएं

Claude Code तब सबसे ज्यादा उपयोगी होता है जब एक सेशन की बात अगले सेशन तक सुरक्षित पहुंचती है। असली समस्या अक्सर यह नहीं होती कि Claude Code फाइलें नहीं खोज पाया। समस्या यह होती है कि उसने सही फाइलें पढ़ीं, bug की दिशा पकड़ी, कुछ hypothesis गलत साबित किए, थोड़ा code बदला, फिर सेशन “कल जारी रखेंगे” पर खत्म हो गया। अगले दिन वही व्यक्ति या नया AI agent फिर से वही context ढूंढता है।

इस लेख में handoff का मतलब है छोटी कामकाजी नोट, जिससे अगला इंसान या अगला AI coding agent बिना दोबारा पूरा chat पढ़े काम जारी रख सके। यह लंबी diary नहीं है। इसमें लक्ष्य, अभी की स्थिति, महत्वपूर्ण फाइलें, verification evidence, बचे हुए risk और Claude Code को देने वाला अगला prompt होता है।

आधिकारिक जानकारी के लिए Claude Code docs देखें। How Claude Code works agentic loop, project access, git state, sessions और context समझाता है। Memory CLAUDE.md और project instructions बताता है। CLI reference command-line usage के लिए है। ClaudeCodeLab में इससे जुड़ा पढ़ना हो तो CLAUDE.md best practices, verification receipt workflow और team handoff rules देखें।

पहले भूमिका साफ करें

शुरुआत करने वाले लोग अक्सर CLAUDE.md और handoff note को मिला देते हैं। CLAUDE.md में लंबे समय तक लागू रहने वाले project rules होने चाहिए: build command, coding style, architecture नियम, review policy और वे paths जिन्हें सावधानी से छूना है।

handoff note में आज की task state होती है। कौन सी फाइल पढ़ी गई, कौन सा अनुमान गलत निकला, क्या verify हुआ, क्या verify नहीं हुआ और अगला prompt क्या होना चाहिए। आसान भाषा में, context मतलब काम की पृष्ठभूमि, verification receipt मतलब जांच का receipt, और harness मतलब agent के लिए सुरक्षित काम करने की सीमा।

flowchart LR
  A["Goal<br/>क्या हासिल करना है"] --> B["Current state<br/>काम कहां रुका"]
  B --> C["Evidence<br/>क्या verify हुआ"]
  C --> D["Risk<br/>क्या अभी अनिश्चित है"]
  D --> E["Next prompt<br/>पहले क्या पूछना है"]

यह chain होने पर अगला व्यक्ति पूरी बातचीत पढ़े बिना पहला उपयोगी step चला सकता है।

कॉपी-पेस्ट Markdown template

# Claude Code session handoff

## Goal
- target outcome:
- explicitly out of scope:

## Current state
- branch:
- dirty files:
- related URL:
- what is known:

## What changed
- changed files:
- reason for change:
- important files not touched:

## Verification receipt
- commands run:
- result:
- manual checks:
- not checked:

## Risks and constraints
- fragile area:
- do not touch:
- requires approval:

## Next prompt
In the next session, compare git status with this handoff, then continue from the unchecked verification items.

सबसे जरूरी field not checked है। local build pass होना यह साबित नहीं करता कि public URL, mobile layout, CTA link, analytics event या translation सही है। जो verify नहीं हुआ उसे साफ लिखने से अगला सेशन guessing से नहीं, verification से शुरू होता है।

Structured JSON example

अगर team handoff को GitHub Issues, Slack, Notion या internal dashboard में भेजती है, तो Markdown के साथ छोटा JSON summary भी रखें।

{
  "slug": "claude-code-session-handoff-template",
  "goal": "Improve the published multilingual article group",
  "status": "draft updated, verification pending",
  "files": [
    "site/src/content/blog/claude-code-session-handoff-template.mdx",
    "site/src/content/blog-en/claude-code-session-handoff-template.mdx"
  ],
  "checksRun": ["frontmatter parse", "code fence scan"],
  "checksMissing": ["production URL check"],
  "nextAction": "Run targeted validation and review locale copy"
}

JSON tools के लिए अच्छा है, लेकिन reasoning के लिए काफी नहीं है। निर्णय और background Markdown में लिखें। machine-readable status, files, checks और next action JSON में रखें।

Runnable Node.js script

नीचे का code scripts/write-handoff.mjs में रखें। यह सिर्फ Node.js built-ins इस्तेमाल करता है, current git state पढ़ता है और handoffs/ में date वाला Markdown बनाता है।

import { execSync } from "node:child_process";
import { mkdirSync, writeFileSync } from "node:fs";
import { join } from "node:path";

function run(command) {
  try {
    return execSync(command, { encoding: "utf8" }).trim() || "(no output)";
  } catch (error) {
    return `ERROR: ${error.message}`;
  }
}

const date = new Date().toISOString().slice(0, 10);
const branch = run("git branch --show-current");
const status = run("git status --short");
const recentCommit = run("git log -1 --oneline");
const outDir = "handoffs";
const outFile = join(outDir, `${date}-session-handoff.md`);

mkdirSync(outDir, { recursive: true });

const body = `# Claude Code session handoff

## Goal
-

## Current state
- branch: ${branch}
- recent commit: ${recentCommit}
- dirty files:
\`\`\`text
${status}
\`\`\`

## What changed
-

## Verification receipt
- commands:
- result:
- missing:

## Risks and constraints
-

## Next prompt
Read this handoff, compare it with git status, and continue from the missing verification items.
`;

writeFileSync(outFile, body, "utf8");
console.log(`Wrote ${outFile}`);

पहले syntax check करें, फिर script चलाएं:

node --check scripts/write-handoff.mjs
node scripts/write-handoff.mjs

practical handoff use cases

पहला use case multilingual content publishing है। एक ही slug के लिए Japanese, English, Chinese, Korean, Spanish, French, German, Portuguese, Hindi और Indonesian files हों, तो मुश्किल यह नहीं कि एक file edit करनी है। मुश्किल यह है कि कौन सा locale अभी natural copy review, mojibake scan, description length, internal links और /products/ या /training/ CTA check से बाकी है।

## Goal
- raise the 10-locale article group for slug claude-code-session-handoff-template to publish quality

## Current state
- Japanese canonical body updated
- English and Indonesian reviewed for natural tone
- zh, ko, and hi still need mojibake scan

## Verification receipt
- frontmatter parse: pass
- JSON code block parse: pass
- production URL: not checked

## Next prompt
Check the remaining locale files for mojibake, description length, and missing CTA links. Report only unresolved items.

दूसरा use case bug investigation है जो बीच में रुक गई। अगर असली finding है “390px width पर CTA इसलिए overflow कर रहा है क्योंकि pricing card fixed min-width रखता है”, तो यही लिखें। सिर्फ “CSS देखा” लिखने से अगला व्यक्ति फिर से वही जांच करेगा।

तीसरा use case risky code review है। authentication, billing, database migration और permissions में सिर्फ “review चल रहा है” काफी नहीं है। note में लिखें कि कौन से risks check हुए, कौन से tests missing हैं और merge से पहले किस approval की जरूरत है।

चौथा use case parallel agent work है। अगर दूसरे workers दूसरे slug या branch पर काम कर रहे हैं, तो handoff में allowed files और do-not-touch files साफ लिखें। यह छोटी बात दूसरे worker की changes overwrite होने से बचाती है।

common failures

Failure 1: सिर्फ file paths लिखना। site/src/pages/products.astro से कम मदद मिलती है। “pricing card का min-width 390px पर overflow कर रहा है” ज्यादा उपयोगी है।

Failure 2: सिर्फ successful checks लिखना। npm run build pass हो सकता है, फिर भी public URL, mobile layout, click tracking, form flow या translation गलत हो सकते हैं।

Failure 3: लंबा conversation summary लिखना। अगर next action साफ नहीं है, तो note पढ़ने का बोझ बढ़ाता है। अंत में paste करने लायक next prompt रखें।

Failure 4: private data चिपकाना। API keys, customer data, internal pricing और private incident links handoff में नहीं होने चाहिए। secret name या safe internal reference लिखें।

monetization CTA भी बचाएं

ClaudeCodeLab जैसे content site में technical quality और monetization path साथ चलते हैं। article अच्छा हो, लेकिन internal links, free resource, product page या consultation link गायब हों, तो reader का next step टूट जाता है। individual reader free resource से शुरू कर सकता है। templates और checklists के लिए products देखें। अगर team को real repository में CLAUDE.md, permissions, review gates, verification receipts और handoff rules चाहिए, तो Claude Code training and consultation सही अगला कदम है।

सेशन बंद करने से पहले 30 सेकंड दें: goal, current state, evidence, missing checks और next prompt लिखें। Masa के publishing workflow में इसे आजमाने पर सबसे बड़ा फायदा यह था कि अगले दिन यह खोजने में समय नहीं गया कि पिछला सेशन कहां रुका था।