---
name: code-handoff
description: "코드 인계 스킬. 대화에서 코드 구현이 필요한 시점에 클로드 코드로 넘길지 판단하고, 넘긴다면 설계서를 작성하고, 대화↔클로드 코드 간 타임라인을 제시한다. 트리거: '코드 구현', '자동화 구현', '클로드 코드로 넘겨', '코드 작성해줘', '이거 구현해야 해', '스크립트 만들어줘', '코드 짜줘'. 사용자가 명시적으로 요청하지 않아도 대화 중 코드 구현이 필요하다고 판단되면 능동적으로 이 스킬을 트리거하여 제안한다. 코드 설계·로직 논의 자체는 대화에서 처리하되, 실제 파일 생성·실행·배포가 필요한 시점에 이 스킬이 개입한다."
---

# 코드 인계 (Code Handoff)

## 이 스킬의 목적
프로젝트 대화에서 코드 구현이 필요한 시점에, 클로드 코드로 넘길지 판단 → 설계서 작성 → 타임라인 제시까지 일관된 절차로 처리한다.

## 1단계: 인계 판단
대화 중 코드 관련 작업이 발생하면 아래 기준으로 판단한다.

### 대화에서 계속 처리하는 경우
- 결과물이 판단·텍스트 (로직 설계, 요구사항 정리, 구조 논의)
- 짧은 코드 스니펫 설명이나 문법 안내
- 어떤 방식으로 구현할지 선택지 비교

### 클로드 코드로 넘기는 경우
- 실제 동작하는 코드 파일을 생성·수정해야 할 때
- clasp push 등 외부 시스템에 코드를 배포해야 할 때
- 에러 확인 → 수정 → 재실행 반복이 예상될 때
- 로컬 파일 처리, 스크립트 실행이 필요할 때

### 판단 결과 전달 방식
- 대화에서 계속 → 판단 근거 1줄 언급 후 작업 진행
- 클로드 코드로 넘김 → "이 작업은 클로드 코드에서 진행하는 게 낫습니다" + 이유 1줄 → 2단계로 진입

## 2단계: 설계서 작성
클로드 코드로 넘기기로 판단했으면, 대화에서 아래 항목을 확정한 뒤 설계서(md 파일)를 작성한다.

### 필수 확인 항목
사용자 입력에서 아래 정보가 충분한지 판단한다. 부족한 항목만 질문한다. 모두 충분하면 바로 설계서 작성에 착수한다.

| 항목 | 확인할 것 | 부족할 때 예시 |
|------|----------|---------------|
| 작업 목적 | 뭘 자동화/구현하려는가 | "이 코드가 최종적으로 뭘 해야 하나요?" |
| 실행 환경 | Apps Script / Python / Node.js 등 | "어디서 실행되는 코드인가요?" |
| 입출력 | 어떤 데이터를 받아서 어떤 결과를 내는가 | "입력은 뭐고, 출력은 어떤 형태여야 하나요?" |
| 제약조건 | API 인증, 호출 제한, 권한 등 | "사용하는 API의 인증 방식이나 제한이 있나요?" |
| 트리거/스케줄 | 언제, 어떻게 실행되는가 (수동/자동/시간 기반) | "이 코드가 언제 실행되어야 하나요?" |
| 검증 기준 | 성공을 어떻게 확인하는가 | "뭐가 나오면 성공인가요?" |

### 설계서 구조
# [작업명] 구현 설계서
## 작업 개요 (목적, 실행 환경, 프로젝트 경로)
## 입출력 정의
## 제약조건 (API 인증 방식, 호출 제한, 토큰 정책 등)
## 구현 요구사항 (단계별 동작, 분기 조건, 예외 처리)
## 트리거/스케줄
## 검증 기준
## 작업 흐름 ([대화] 설계서 확정 → [클코] 구현+테스트 → [브라우저] 권한/트리거 → [대화] 확인)

### 복잡도 판단
설계서 작성 중 아래 조건에 해당하면, references/agent-design-guide.md를 읽고 에이전트 구조를 적용한다:
- 독립적인 작업 블록이 3개 이상이고 각각 다른 도메인 지식이 필요
- 워크플로우에 LLM 판단이 포함되는 단계가 있음
- 단일 스크립트로는 컨텍스트가 너무 길어지는 경우

해당하지 않으면 단순 스크립트 구조로 충분하다.

## 3단계: 타임라인 제시
설계서에 항상 "작업 흐름" 섹션을 포함한다. 각 단계에서:
- 어디서 작업하는지 (대화 / 클로드 코드 / 브라우저)
- 뭘 하는지
- 완료 조건이 뭔지 (다음 단계로 넘어가는 기준
…[TRUNCATED]