← 프로젝트 목록
Notion 개발 일지 자동화
Claude Code 하네스 · Hooks · Agent Skills · Notion MCP
git commit만 하면 Claude Code가 커밋 내용을 분석해 Notion 개발 일지를 자동으로 쓰는 파이프라인입니다. 작업 당시의 판단 근거를 따로 정리하지 않아도 남도록 만들었습니다.
Claude CodeHooksAgent SkillsCLAUDE.mdNotion MCPjqBash
0회커밋당 수동 일지 작성
20 → 3줄상시 로드 규칙
20 → 1줄훅 주입 내용
1곳규칙 변경 지점
프로젝트 목적
작업할 때 고른 설정과 그 이유는 시간이 지나면 다시 찾기 어렵습니다. 기록을 작업의 마지막 단계로 고정하되, 사람이 따로 시간을 쓰지 않도록 커밋만으로 일지가 남게 하는 것이 목표였습니다.
| 기간 | 2026.04 — 2026.05 |
|---|---|
| 인원 | 개인 |
| 링크 | GitHub ↗ |
담당 역할
- 훅·스킬·지시문의 역할을 나눈 4계층(등록·필터·주입·로직) 설계
- PostToolUse 훅과 jq 기반 커밋 감지 필터 작성
- 커밋 분석과 Notion 기록을 맡는 Agent Skill 작성
- 권한 설정으로 위험 명령 차단
시스템 구조
이렇게 설계한 이유Git 훅에서는 Notion MCP를 직접 부를 수 없습니다. 그래서 "언제 기록할지"는 반드시 실행되는 Claude Code 훅이 정하고, "어떻게 기록할지"는 필요할 때만 불러오는 스킬이 맡게 나눴습니다. 훅은 짧은 지시 한 줄만 주입하고, 실제 기록 규칙은 스킬 파일 한 곳에 둡니다.
주요 구현
1. 등록→2. 필터→3. 주입→4. 로직
| 계층 | 위치 | 하는 일 |
|---|---|---|
| 등록 | settings.json | Bash 도구 실행 뒤 PostToolUse 훅이 발동하도록 등록 |
| 필터 | 훅 스크립트 | jq로 도구 입력 JSON을 읽어 git commit이 있을 때만 통과, 나머지는 바로 종료 |
| 주입 | additionalContext | "개발 일지 스킬을 실행하라"는 한 줄만 에이전트에 전달 |
| 로직 | SKILL.md | git show HEAD로 변경 내용을 분석하고 Notion MCP로 일지 페이지 생성 |
- 스킬 설명을 다듬어, 훅이 자동으로 부르는 경로와
/notion-devlog로 지난 커밋을 골라 다시 기록하는 수동 경로를 함께 지원했습니다. - settings.json 권한 설정으로
rm -rf,git push --force,.env접근을 막은 상태에서만 자동화가 돌게 했습니다.
해결 과제
1. 관련 없는 작업에도 매번 읽히던 기록 규칙
- 과제
- Notion 기록 규칙이 CLAUDE.md에 들어 있어, Notion과 상관없는 모든 작업에서 규칙을 읽느라 토큰이 낭비됐습니다. 같은 규칙을 여러 곳에서 고쳐야 하는 문제도 있었습니다.
- 원인
- 항상 읽히는 지시문(CLAUDE.md)과 필요할 때만 읽히는 스킬의 역할이 나뉘어 있지 않았습니다.
- 접근
- 상세 규칙을 SKILL.md로 옮기고 CLAUDE.md에는 3줄 안내만 남겼습니다. 훅이 주입하는 내용도 규칙 전체 대신 실행 지시 한 줄로 줄였습니다.
| 항목 | 이전 | 이후 |
|---|---|---|
| CLAUDE.md 상시 규칙 | 약 20줄 | 3줄 |
| 훅 주입 내용 | 약 20줄 | 1줄 |
| 규칙을 고쳐야 하는 곳 | 3곳 | 1곳 (SKILL.md) |
2. 모든 Bash 실행마다 발동하는 훅
- 과제
- PostToolUse 훅은 Bash 도구를 쓸 때마다 발동해, 일반 명령에도 일지 작성이 끼어들 수 있었습니다.
- 접근
- 훅 스크립트 맨 앞에서 jq로 실행된 명령을 읽어 git commit이 없으면 아무것도 주입하지 않고 바로 끝나게 했습니다.
일반 작업 흐름은 그대로 두고, 커밋할 때만 일지가 자동으로 남음
남은 한계
- Claude Code 안에서 실행한 커밋만 감지합니다. 터미널에서 직접 한 커밋은 /notion-devlog로 따로 기록해야 합니다.