handoff is agent-read markdown (skill) from leeyudok/agents-scaffold: 세션을 끊고 다음 세션에 넘긴다 — 재개 가능한 상태를 HANDOFF.md 에 적고, 협업 인프라(GitHub·GitLab·Forgejo·Jira·Plane·Slack)가 있으면 같은 내용으로 이슈를 만들어 URL 하나로 건네고 없으면 그 파일로 끝낸다. 작업 이슈를 닫은 경계에서는 전용 이슈 대신 다음 작업 이슈에 코멘트 하나로 남긴다. 넘겨받은 쪽은 적힌 단언을 실제와 대조한 뒤 이어서 착수하고, 끝나면 결과를 남기고 닫는다. 컨텍스트가 40~50% 에 닿았을 때, "여기서 끊자 / 상태 남겨 / 이어받아 / 재개" 라고 하거나 핸드오프 URL·파일 경로를 붙여넣었을 때 쓴다..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# 세션 핸드오프
핸드오프는 **요약이 아니라 재개 가능한 상태**다. 다음 세션이 이것만 읽고 같은
자리에서 다음 명령을 칠 수 있어야 한다. "뭘 했는지" 보다 **"지금 어디에 서 있고
다음에 뭘 치는지"** 가 본체다.
컨텍스트 사용량이 40~50% 에 닿으면 하던 걸 멈추고 이 스킬을 부른다. compaction 은
모델이 뭘 버릴지 스스로 고르므로 안전망일 뿐이다.
## 어디에 남기나 — 상황당 한 곳
재개 상태를 **두 군데에 나눠 적지 않는다.** 나눠 적으면 어느 쪽도 혼자서는 재개
가능한 상태가 아니게 되고, 다음에 쓸 때 한쪽 내용이 조용히 빠진다(2026-09-21 실측,
이슈 #152 — 함정·기동 명령은 핸드오프 이슈에만, 새로 확정된 패턴은 다음 이슈
메모에만 있었다).
| 상황 | 남기는 곳 | 다음 세션이 받는 것 |
| --- | --- | --- |
| **이슈 도중** — 작업 이슈가 아직 열려 있다(컨텍스트 40~50% 등) | `HANDOFF.md` + 전용 핸드오프 이슈 (아래 "두 갈래") | 핸드오프 이슈 URL |
| **이슈 경계** — 작업 이슈를 닫았고 **다음 작업 이슈가 이미 있다** | **다음 작업 이슈에 코멘트 하나** (1-6) — 전용 핸드오프 이슈는 만들지 않는다 | 다음 작업 이슈 URL |
| 인프라 없음 | `HANDOFF.md` | 파일 경로 |
이슈 경계인데 다음 작업 이슈가 아직 없으면 그 이슈를 먼저 만든다. 다음에 할 일이
정해지지 않았다면 경계가 아니라 그냥 끝난 것이므로 핸드오프를 쓰지 않는다.
## 두 갈래, 원본은 언제나 파일
| | 하는 일 | 다음 세션이 받는 것 |
| --- | --- | --- |
| **인프라 있음** | `HANDOFF.md` 를 쓰고 **그 내용으로 이슈/티켓/스레드를 만든다** | **전체 URL** |
| **인프라 없음** | `HANDOFF.md` 로 끝낸다 | **파일 경로** |
이슈 도중에 끊을 때 `HANDOFF.md` 는 **항상** 쓴다. 이슈는 그것을 팀에 전달하고 상태(열림/닫힘)를
표시하는 경로일 뿐이고, 내용의 단일 원본은 파일이다. 인프라가 없다고 절차가
멈추지 않는다 — 이슈를 못 만들면 파일 모드로 내려가 그대로 끝낸다.
## 모드
| 호출 | 하는 일 |
| --- | --- |
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_ajhp3pt2tbw5tsqq
GET https://markdownregistry.com/api/v1/resolve?ref=leeyudok/agents-scaffold/handoff
GET https://markdownregistry.com/api/v1/blob/21313882c697386871701b1ed3054cba828395ee81703332654fa096607c9389
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
leeyudok/agents-scaffold · .claude/skills/docs-sync/SKILL.md · 코드·설정·프리셋 변경 뒤 문서를 현행화한다. "문서 현행화", "README 갱신", "문서 최신화" 요청 시, 그리고 동작·경로·버전·수치를 바꾼 PR 을 올리기 직전에 사용. 문서의 주장을 실제 코드·명령…
leeyudok/agents-scaffold · .claude/skills/grill-me/SKILL.md · 사용자가 /grill-me 를 호출하거나 아이디어·기능 요청·스펙을 구현 전에 굽고(grill)·압박 검증하고·심문해 달라고 할 때 사용. superpowers:brainstorming 의 opt-in 대체재 —…
leeyudok/agents-scaffold · .claude/skills/memory-factcheck/SKILL.md · 에이전트 영속 메모리를 실제 소스와 대조 — 각 메모리의 핵심 단언을 코드·DB·이슈 트래커·파일시스템에 대조해 stale 을 정정하고 dead 를 아카이브 후보로 리포트. 메모리가 30개를 넘거나, 스택/인프라…
leeyudok/agents-scaffold · .claude/skills/review/SKILL.md · 코드 변경사항 전체 리뷰. code-reviewer 에이전트 + security-audit 에이전트를 순차 실행하는 래퍼 스킬. PR/MR 생성 전 또는 리뷰 요청 시 사용.
leeyudok/agents-scaffold · .claude/skills/search-first/SKILL.md · 코드를 새로 짜기 전에 기존 솔루션(레포 내부 → 사내 미러 → 패키지 레지스트리 → MCP/스킬 → GitHub)을 먼저 검색하는 워크플로. 새 기능/유틸/의존성 추가 직전, "X 기능 넣어줘" 요청에 코드부터…
leeyudok/agents-scaffold · .claude/skills/security-precheck/SKILL.md · 외부 보안팀 코드 검사 전 자체 사전점검. security-audit 에이전트(+ 설정돼 있으면 SonarQube 보안 핫스팟)를 돌려 P0/P1/P2로 정리하고, 발견사항을 이슈로 쪼개 병렬 서브에이전트로…
leeyudok/agents-scaffold · .claude/skills/skill-evolve/SKILL.md · 스킬 실행 후 피드백을 받아 해당 SKILL.md를 자동 개선하는 메타 스킬. 스킬이 틀렸거나 누락이 있을 때, 또는 새로 배운 함정을 기록할 때 사용.
leeyudok/agents-scaffold · presets/lang-en/base/.claude/skills/docs-sync/SKILL.md · Bring documentation back in line with the code after changes to behavior, paths, versions, or generated output. Use on…
leeyudok/agents-scaffold · presets/lang-en/base/.claude/skills/example-skill/SKILL.md · Duplicate this file to create a project skill. Write the trigger condition concretely in the description.
jeremylongshore/tons-of-skills-marketplace · plugins/ai-agency/hyperflow/skills/handoff/SKILL.md · Use when managing a two-session handoff — inspecting, picking up, or reviewing a committed handoff package produced by…
suboss87/fdeops · skills/handoff/SKILL.md · Transfer operation of a customer deployment with ownership, evidence and a tested support path. Use for handoff or an…
dcouple/pane · main/src/services/paneChatBundle/skills/handoff/SKILL.md · Prepare a verified resumption brief when moving work to another agent, device, or session, including local-to-cloud…
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/handoff/SKILL.md · Compact the current conversation into a handoff document for another agent to pick up.
techwolf-ai/ai-first-toolkit · plugins/session-tools/skills/handoff/SKILL.md · Write a session handoff at the end of a session so the next session can start from where this one stopped without…
7xuanlu/wenlan · plugin-codex/skills/handoff/SKILL.md · End a Codex work session. Stores durable captures, writes a narrative session log, and automatically applies typed…
7xuanlu/wenlan · plugin/skills/handoff/SKILL.md · End a work session. Stores durable captures, writes a narrative session log, and automatically applies typed item-level…
oprogramadorreal/optimus-claude · skills/handoff/SKILL.md · Compacts the current conversation into one self-contained, tool-agnostic handoff document at docs/handoffs/<slug>.md so…
