커밋 키

커밋 키란?

커밋 메시지에 이슈 키를 적으면 QA Note가 push 웹훅에서 이를 감지해 수정 제출을 자동으로 기록하는 기능입니다. 개발자가 어차피 하는 행위(커밋)에 편승하므로, 기록을 위해 대시보드를 열 필요가 없습니다. AI 코딩 도구 없이도 작동합니다.

git commit -m "fix: 로그인 세션 만료 처리 (QANOTE-42)"

동작 방식

1. 프로젝트 설정에서 이슈 키 프리픽스(예: QANOTE)를 확인합니다. 이슈마다 QANOTE-42 같은 고유 키가 부여됩니다.
2. 수정 커밋 메시지에 이슈 키를 포함해 push합니다.
3. GitHub App의 push 웹훅이 키를 감지해 해당 이슈를 수정 제출(fix_submitted) 로 전환하고, 커밋을 이슈에 연결합니다.
4. 이슈 상세와 유지보수 리포트에 커밋 링크가 표시됩니다.

배포 확인 → 검수 가능

커밋이 기록됐다고 바로 검수할 수 있는 것은 아닙니다. QA Note는 배포 이벤트(Vercel, GitHub deployment)와 커밋을 상관시켜, 수정 커밋이 실제로 배포된 뒤에만 이슈에 '검수 가능' 표시를 붙입니다. 검수자는 스테이징에서 헛걸음하지 않습니다.

준비물

• GitHub 연동 (GitHub App 설치)
• 배포 상관까지 쓰려면 Vercel 연동 또는 GitHub deployment 이벤트

팁

• 하나의 커밋에 여러 이슈 키를 적으면 모두 연결됩니다.
• MCP로 작업하는 에이전트에게는 커밋 메시지에 이슈 키를 포함하도록 지시가 자동 전달됩니다 — 두 경로(MCP·커밋 키) 중 하나만 살아도 기록이 남습니다.