Template handoff sesi Claude Code: simpan konteks untuk manusia atau agen berikutnya

Claude Code jauh lebih berguna ketika satu sesi bisa diteruskan tanpa kehilangan konteks. Masalah yang sering terjadi bukan karena Claude Code tidak menemukan file. Ia sudah membaca file yang tepat, mempersempit penyebab bug, membuang beberapa dugaan yang salah, dan mungkin sudah mengubah sebagian kode. Lalu sesi berhenti dengan “lanjut besok”. Orang berikutnya, atau AI agent berikutnya, harus membangun konteks dari awal lagi.

Di artikel ini, handoff berarti catatan singkat untuk meneruskan pekerjaan. Ini bukan diary panjang. Handoff yang baik menjawab hal penting: goal, current state, file yang relevan, bukti verifikasi, risiko yang tersisa, dan prompt berikutnya yang bisa langsung diberikan ke Claude Code.

Untuk rujukan resmi, gunakan dokumentasi Claude Code yang terbaru. How Claude Code works menjelaskan agentic loop, akses project, git state, sesi, dan konteks. Memory menjelaskan CLAUDE.md dan instruksi project. CLI reference mencakup penggunaan command line. Untuk konteks ClaudeCodeLab, baca juga CLAUDE.md best practices, verification receipt workflow, dan team handoff rules.

Pisahkan Aturan Tetap Dan Status Sementara

Pemula sering mencampur CLAUDE.md dengan catatan handoff. CLAUDE.md adalah memori project yang tahan lama: command build, standar kode, aturan arsitektur, kebijakan review, dan path yang harus diperlakukan hati-hati di setiap sesi.

Catatan handoff adalah status sementara dari tugas hari ini. Isinya: dugaan mana yang gagal, file mana yang penting, apa yang sudah diverifikasi, apa yang belum diverifikasi, dan apa yang harus diminta pada sesi berikutnya. Secara sederhana, context adalah latar kerja, verification receipt adalah bukti pengecekan, dan harness adalah kerangka kerja yang menjaga agent tetap berada di batas yang berguna.

flowchart LR
  A["Goal<br/>Hasil apa yang penting"] --> B["Current state<br/>Pekerjaan berhenti di mana"]
  B --> C["Evidence<br/>Apa yang sudah dicek"]
  C --> D["Risk<br/>Apa yang masih tidak pasti"]
  D --> E["Next prompt<br/>Apa yang diminta dulu"]

Dengan alur ini, orang berikutnya tidak perlu membaca ulang seluruh percakapan sebelum menjalankan langkah yang berguna.

Template Markdown Siap Pakai

# 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 paling penting adalah not checked. Build lokal yang berhasil tidak membuktikan URL publik, tampilan mobile, link CTA, event analytics, atau terjemahan sudah benar. Menulis hal yang belum dicek membuat sesi berikutnya mulai dari verifikasi, bukan tebakan.

Contoh JSON Terstruktur

Jika tim mengirim handoff ke GitHub Issues, Slack, Notion, atau dashboard internal, simpan ringkasan JSON kecil di samping catatan Markdown.

{
  "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 mudah diproses tool, tetapi kurang cukup untuk alasan keputusan. Tulis reasoning dan konteks di Markdown. Simpan state, file, check, dan next action di JSON.

Script Node.js Yang Bisa Dijalankan

Simpan kode berikut sebagai scripts/write-handoff.mjs. Script ini hanya memakai modul bawaan Node.js, membaca git state saat ini, dan membuat file Markdown bertanggal di handoffs/.

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}`);

Cek sintaks, lalu jalankan:

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

Use Case Praktis

Use case pertama adalah publikasi konten multibahasa. Ketika satu slug memiliki file Jepang, Inggris, Mandarin, Korea, Spanyol, Prancis, Jerman, Portugis, Hindi, dan Indonesia, tantangannya bukan mengedit satu file. Tantangannya adalah mengingat locale mana yang masih butuh review natural, scan mojibake, pengecekan panjang description, internal link, dan CTA ke /products/ atau /training/.

## 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 kedua adalah investigasi bug yang berhenti di tengah. Jika temuan sebenarnya adalah “pada 390px CTA overflow karena pricing card masih punya min-width tetap”, tulis kalimat itu. “Sudah lihat CSS” membuat orang berikutnya mengulang investigasi.

Use case ketiga adalah review kode berisiko. Authentication, billing, database migration, dan permission perlu catatan yang menjelaskan risiko mana yang sudah dicek, test mana yang belum ada, dan siapa yang harus approve sebelum merge.

Use case keempat adalah kerja paralel beberapa manusia atau agent. Jika worker lain mengedit slug atau branch lain, handoff harus menyebut file yang boleh disentuh dan file yang tidak boleh disentuh.

Kegagalan Yang Sering Terjadi

Kegagalan pertama: hanya menulis path tanpa alasan. site/src/pages/products.astro kurang berguna dibanding “min-width pada pricing card menyebabkan overflow di 390px”.

Kegagalan kedua: hanya mencatat check yang sukses. npm run build bisa sukses meskipun URL publik, mobile layout, click tracking, form, atau terjemahan masih bermasalah.

Kegagalan ketiga: menulis ringkasan percakapan yang panjang. Jika next action tidak jelas, catatan itu hanya menambah beban baca.

Kegagalan keempat: menempel data privat. API key, data pelanggan, harga internal, dan link incident privat tidak boleh masuk ke handoff yang bisa dipakai ulang.

CTA Dan Monetisasi

Untuk situs seperti ClaudeCodeLab, kualitas teknis dan jalur monetisasi harus ikut dijaga. Artikel yang bagus tetap kurang lengkap jika internal link, resource gratis, product page, atau consultation link hilang. Pembaca individu bisa mulai dari resource gratis. Untuk template dan checklist, buka products. Tim yang perlu mendesain CLAUDE.md, permission, review gate, verification receipt, dan handoff ritual di repository nyata bisa memakai Claude Code training and consultation.

Kebiasaan ini hanya butuh 30 detik: tulis goal, current state, evidence, missing checks, dan next prompt sebelum sesi selesai. Saat diuji di workflow publikasi Masa, manfaat terbesarnya adalah tidak perlu lagi mencari ulang di mana sesi sebelumnya berhenti.