Menu
되돌릴 수 없는 결정과 그 근거를 시간순으로 changelog/changelog.md에 기록한다. 아키텍처·의존성·API 계약 변경 시 사용. push/PR 직전 changelog-reminder 훅이 매니페스트 변경을 감지하면 이 스킬로 기록할지 검토한다.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Produce documents, visuals, and file transforms that read as deliberate human work instead of generic AI output. Use whenever writing prose (docs, README, reports, PR/commit bodies, code comments), creating a chart/graph/diagram or choosing an image, or converting/editing an existing document (format conversion, refactor, bulk edit). Read the matching reference before producing the artifact.
세션 인계. 컨텍스트가 차거나 세션을 끝낼 때 진행상황·결정·다음 할 일을 남겨 다음 세션이 이어가게 한다. "핸드오프", "이어서 작업", "인계/컨텍스트 정리", "세션 정리" 요청에 사용. precompact 훅이 남긴 자동 스냅샷을 사람이 읽을 인계문으로 정리하는 데도 쓴다.
새 프로젝트·서비스·모듈을 언어별로 부트스트랩할 때 사용. 공식 스캐폴더(create-next-app, cargo new, uv init, Spring Initializr 등)를 우선 쓰고, 손으로 파일 트리를 찍지 않으며, 구조는 필요할 때만 키운다. 언어를 정하면 references/<lang>.md의 현행 명령·디렉터리·코드 샘플을 따른다.
| name | changelog |
| description | 되돌릴 수 없는 결정과 그 근거를 시간순으로 changelog/changelog.md에 기록한다. 아키텍처·의존성·API 계약 변경 시 사용. push/PR 직전 changelog-reminder 훅이 매니페스트 변경을 감지하면 이 스킬로 기록할지 검토한다. |
결정·근거·대안·영향을 append-only로 changelog/changelog.md에 기록한다. 코드가 "무엇을" 하는지는 git이 안다. 여기 적는 건 "왜 이 선택인가" — 되돌리기 어렵고 근거가 시간이 지나면 잊히는 것들이다.
일상적 버그픽스·리팩터·문서 수정은 기록하지 않는다. 되돌리기 비용이 크거나 나중 사람이 "왜 이렇게 했지?" 물을 것만.
changelog/changelog.md 상단에 최신이 오도록 prepend (또는 하단 append — 프로젝트 규칙 따름). 각 항목:
## <YYYY-MM-DD> — <결정 한 줄>
- **결정**: 무엇을 정했나
- **이유**: 왜 (핵심 근거)
- **대안**: 검토했다 버린 선택 + 버린 이유
- **영향**: 무엇이 바뀌나 / 깨지나 (하위호환·마이그레이션)
.claude/hooks/changelog-reminder.py(PreToolUse 훅)가 git push/gh pr create 직전, 이번에 나갈 커밋에 의존성·빌드 매니페스트(package.json·go.mod·Cargo.toml·pom.xml 등) 변경이 있는데 changelog/changelog.md 갱신이 없으면 비차단 리마인더를 남긴다. 그때 이 스킬로 기록할지 사용자에게 물어라. push를 막지는 않는다.
프로젝트별 기록 규칙은 이 아래에 추가한다 (예: ADR 번호 체계, 승인자 명시, 관련 PR 링크).