القائمة
커밋 요청 또는 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: