Claude Code용 Notion 본문 템플릿 설계

한 줄 정의

섹션 헤딩 고정 + 체크리스트 완료 조건 + 완료 기록 섹션 — claude-code가 본문만 읽고 작업을 수행할 수 있는 구조.

핵심 내용

5원칙:

1. 섹션 헤딩 고정 → claude-code가 ## 스펙 등으로 정확히 파싱
2. 완료 조건은 반드시 체크리스트 → claude-code가 검증 후 체크/언체크
3. 작업 내용도 체크리스트 → claude-code가 진행하면서 체크
4. 완료 기록 섹션 → 커밋 링크, 완료 시간 자동 append
5. 상위 맥락 명시 → “왜 이걸 하는지” 파악

개발태스크 본문의 핵심:

## 스펙 > 수용 기준
- [ ] 기준 1 — 검증: `커맨드 or 방법`

→ DoD와 1:1 매핑. 검증 커맨드까지 명시 = claude-code 자동 검증 가능.

적용 맥락

LLM이 실행 에이전트로 동작하는 모든 태스크 시스템. “본문만 보고 작업 가능한가?”가 템플릿 품질 기준.