컨텍스추얼 커밋

무엇을 해주나

• 커밋 제목은 기존 Conventional Commits(feat(scope): ...) 규칙을 그대로 유지합니다.
• 커밋 본문에 action-type(scope): 설명 형태의 구조화된 줄을 추가해 코드 diff로는 알 수 없는 '왜'를 남깁니다.
• 사용 가능한 타입: intent(사용자가 원한 것), decision(선택한 접근), rejected(버린 대안 + 이유), constraint(발견한 제약), learned(다음에 시간 아껴줄 발견).
• git diff --cached --stat로 스테이징된 변경을 먼저 확인해 커밋 범위를 정하고, 대화 컨텍스트가 없는 변경에는 추측 대신 diff로 확인되는 내용만 적도록 제한합니다.
• 사소한 수정(오타, 정렬, 의존성 범프)에는 액션 라인을 붙이지 말라는 '노이즈 금지' 규칙도 포함됩니다.

이런 분께 추천

• 몇 달 뒤 "이 코드 왜 이렇게 했지?"를 반복해서 겪는 개발자
• AI 에이전트와 협업하며 세션이 끝나면 맥락이 사라지는 것이 아까운 사람
• 코드리뷰·온보딩 자료를 커밋 히스토리로 대체하고 싶은 팀 리드
• 이미 Conventional Commits를 쓰고 있어 기존 툴링을 깨지 않는 확장을 원하는 팀

활용 예시

1. 다중 통화 결제 마이그레이션 후 커밋 → 본문에 rejected(money-library): accounting.js — 소단위(센트) 연산 미지원처럼 기각 이유를 남겨 다음 세션이 같은 라이브러리를 재제안하지 않게 합니다.
2. OAuth 로그인 기능 구현 후 → intent(auth): 소셜 로그인, 구글부터 시작, learned(passport-google): refresh token에 offline_access 스코프 필요 등을 기록.
3. 다른 사람이 만든 변경이 함께 스테이징된 경우 → 추측성 intent를 쓰지 않고 decision(http-client): axios → native fetch 전환처럼 diff로 확인되는 것만 적습니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/berserkdisruptors/contextual-commits/HEAD/skills/contextual-commit/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 berserkdisruptors/contextual-commits 의 skills/contextual-commit 폴더를 내 ~/.claude/skills/contextual-commit/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.