메뉴
커밋 요청 또는 PR 준비 시 실제 diff를 기능, 작업, 검증 단위로 분해하고 stage/commit 계획을 작성할 때 사용합니다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
endpoint 문서를 기준으로 API helper, TanStack Query hook, 타입, 에러/cache 동작을 구현할 때 사용합니다.
apps/client, apps/market-owner, apps/design-system-web, 선택적 apps/admin 내부의 앱 전용 shared 컴포넌트를 생성, 스펙 작성, export, 검증할 때 사용합니다.
GitHub 브라우저 PR 리뷰에서 visible diff, review comment, check status, local verification 여부를 분리해 기록할 때 사용합니다.
packages/design-system 공통 컴포넌트를 Figma/이미지/상태 요구사항 기반으로 생성, 구현, story/spec/export 검증할 때 사용합니다.
필드 검증, submit, mutation, error, disabled/loading/success 상태가 있는 프론트엔드 폼 흐름을 구현할 때 사용합니다.
프론트엔드 구현 또는 리뷰 중 Toss Frontend Fundamentals의 응집도 기준으로 함께 수정되는 component, hook, type, fixture, spec, form 흐름 배치를 점검할 때 사용합니다.
| name | commit-planning-workflow |
| description | 커밋 요청 또는 PR 준비 시 실제 diff를 기능, 작업, 검증 단위로 분해하고 stage/commit 계획을 작성할 때 사용합니다. |
커밋을 만들기 전에 실제 diff를 기준으로 기능/작업 단위를 나눕니다.
커밋 수는 1~2개로 제한하지 않습니다. 독립적으로 리뷰, revert, 검증 가능한 단위라면 필요한 만큼 나눕니다.
Jira key가 없으면 현재 branch, Jira 본문, 가까운 문서에서 먼저 확인합니다. 확인할 수 없으면 커밋 전 사용자에게 묻습니다.
항상 확인합니다.
docs/conventions/git.mdrecipes/commit-plan.mddocs/workflows/pr-checklist.md실제 diff 확인:
git status --short
git diff --name-only
git diff --stat
이미 stage된 파일이 있으면 추가로 확인합니다.
git diff --cached --name-only
git diff --cached --stat
아래 중 하나라도 다르면 별도 커밋을 우선 고려합니다.
프론트엔드 기능:
agent harness 또는 문서 작업:
config 또는 CI가 기능 변경과 함께 있으면 별도 커밋으로 분리합니다.
git status --short와 diff 목록을 확인합니다.Commit Plan을 작성합니다.git diff --cached --name-only와 git diff --cached --check를 확인합니다.docs/conventions/git.md 형식으로 커밋합니다.## Commit Plan
- Commit 1: `prefix(scope): JIRAKEY summary`
- files:
- reason:
- verification:
- Commit 2: `prefix(scope): JIRAKEY summary`
- files:
- reason:
- verification:
커밋 후 요약:
## Commit Summary
- created:
- remaining:
- verification:
- excluded: