영문 숏컷 프롬프팅 치트시트
마지막 업데이트 2026-08-20
- 입력: 이 문서는 이렇게 읽으면 됩니다
- 주요 처리 단계: 🧠 코드 분석 추천 리스트
- 결과: 🔍 리뷰·요약 45회
문서 읽는 법 · 활용 가이드식
이 문서는 이렇게 읽으면 됩니다
영문 숏컷 프롬프팅 치트시트 — PPI의 핵심을 활용 가이드식으로 먼저 안내합니다. 기술적 결론과 원문 근거는 아래 본문에 보존되어 있습니다.
핵심 흐름 펼쳐 보기
- 어떤 상황에서 이 문서를 쓰는지 확인합니다.
- 절차와 판단 기준을 순서대로 적용합니다.
- 기대 산출물과 운영 체크리스트로 결과를 확인합니다.
- 빠른 색인
- 🔀 Git 82회 — 최다 빈도
- ▶️ 진행 제어 61회
반복되는 한글 개발 지시를 짧은 영문 숏컷으로 대체하기 위한 매핑표. Claude Code 세션 325개의 실제 요청 860건을 빈도 분석해, 자주 쓰는 요청부터 정리했다. 답변은 입력 언어와 무관하게 항상 한국어로 유지된다(메모리 저장됨). 2026-08-20 갱신에서 코드 분석 / PR·커밋 분석 / 조사·디버깅 군을 보강했다 — 빈도 데이터가 아닌 실사용 추천 패턴이다.
원칙 3가지.
① 2~5단어 명령형이면 충분 — 완전한 문장·문법 불필요.
② 파일명·티켓번호(PPI-*)·아동 이름은 그대로 혼용 (
repro 아동114 2회기).
③ 금지형 조건(no commit, don't report yet)도 영문으로 통하지만, 뉘앙스가 애매하면 한글이 안전.
터미널에서 보기. 이 문서를 그대로 읽어 출력하는 CLI가 저장소에 함께 있다(
scripts/ppicheat).
문서를 수정하면 출력도 자동으로 따라간다 — 별도 동기화 작업이 없다.
ln -sf ~/git-projects/ppi-docs/scripts/ppicheat ~/.local/bin/ppicheat
ppicheat # 섹션 목록
ppicheat pr # 섹션 조회 (git flow review code pr docs debug etc)
ppicheat all # 전체 출력
ppicheat 무음 # 자유 검색 (한글·영문 모두)PPICHEAT_DOC 환경변수로 지정한다.
빠른 색인
🔀 Git 82회 — 최다 빈도
| 기존 한글 요청 | 영문 숏컷 | 비고 |
|---|---|---|
| 수정사항 커밋해줘 | commit | PPI-* 브랜치 단일 커밋 선호는 메모리로 자동 적용 |
| 커밋하고 푸시해줘 | commit and push | |
| 별도/개별 커밋으로 올려줘 | separate commits | |
| 커밋하지 말고 로컬에만 반영해줘 | local only, no commit | 녹음·인프라 작업은 메모리 규칙으로 이미 로컬 적용이 기본 |
| 단일 커밋으로 합쳐줘 | squash to one | |
| PR 올려줘 | /create-pr | 슬래시 커맨드가 가장 확실 |
▶️ 진행 제어 61회
| 기존 한글 요청 | 영문 숏컷 | 비고 |
|---|---|---|
| 진행해줘 | go / proceed | |
| 이어서 작성해줘 | continue | |
| 정상 동작 확인했어. 다음 진행해줘 | verified, next | |
| 거기까지만, 중단해줘 | stop | Esc 키가 더 빠름 |
🔍 리뷰·요약 45회
| 기존 한글 요청 | 영문 숏컷 | 비고 |
|---|---|---|
| 코드 리뷰 진행해줘 | review | 또는 /code-review |
| 코드 리뷰 진행 후 개별 커밋해줘 | review then commit separately | 복합 지시도 한 줄로 처리됨 |
| 리뷰 지적 타당한지 체크해줘 | check if review comments are valid | |
| 현재 브랜치 수정 내용 요약해줘 | summarize branch changes | 또는 /diff-summary |
| 한줄 요약해줘 | tldr | |
| 핵심 원인 3가지 뽑아줘 | top 3 root causes |
🧠 코드 분석 추천 리스트
코드 이해·구조 파악에 효율적인 영문 숏컷. 빈도 데이터가 아닌 추천 패턴이다 — 대상(파일·함수·선택 영역)을 함께 지정하면 정확도가 크게 올라간다. 넓은 질문부터 좁혀 들어가는 순서는 깔때기 탐색 프로세스 참고.
| 기존 한글 요청 | 영문 숏컷 | 비고 |
|---|---|---|
| 이 코드 설명해줘 | explain this | 파일 열어둔 상태 또는 explain foo.ts처럼 대상 지정 |
| 전체 구조/아키텍처 설명해줘 | explain architecture | 레포 전체면 explain the architecture of this repo |
| 이 모듈 어떻게 동작해? | how does [X] work | |
| 사용된 디자인 패턴 알려줘 | show design patterns | what patterns are used here도 동일 |
| 이 함수 호출 흐름 추적해줘 | trace the flow of [X] | 입장 흐름·소켓 이벤트 등 경로 추적에 유용 |
| 이거 어디서 호출돼? | what calls this | 반대는 what does this call |
| [X] 정의/사용처 찾아줘 | find usages of [X] | 정의만 찾을 땐 where is [X] defined |
| 의존 관계 파악해줘 | map dependencies | 특정 모듈이면 map dependencies of [X] |
| 데이터가 어떻게 흘러가? | trace data flow from [A] to [B] | 상태 전파·props 드릴링 추적 |
| 두 구현 차이 비교해줘 | compare [A] vs [B] | |
| 사이드 이펙트 있어? | any side effects? | 수정 전 영향 범위 확인용 |
| 이 코드 엣지 케이스 짚어줘 | list edge cases | |
| 안 쓰는 코드 찾아줘 | find dead code | |
| 이 심볼 영향 범위 알려줘 | blast radius of [X] | codegraph가 호출자·의존을 한 번에 반환 — 수정 착수 전 기본 질문 |
| 이 이벤트 누가 보내고 누가 받아? | who produces / who consumes [event] | 소켓·LiveKit 이벤트의 양끝 특정 |
| 이 영역 전체 훑어줘 | map this area | 모듈·디렉터리 단위 지도. 특정 심볼이 아직 안 잡힐 때 |
| 처음 보는 사람한테 설명하듯 알려줘 | walk me through this like I'm new | 온보딩·인수인계 상황 |
🔎 PR·커밋 분석 추천 리스트
커밋 하나·PR 하나를 읽을 때의 숏컷. "무엇이 바뀌었나"보다 "무엇이 깨질 수 있나"를 묻는 쪽이 산출물 가치가 높다 — diff 나열은 도구가 이미 해준다.
| 기존 한글 요청 | 영문 숏컷 | 비고 |
|---|---|---|
| 이 커밋 뭐 바꾼 거야? | what did this commit change and why | /diff-summary — diff 코드와 목적을 함께 보여줌 |
| 이 PR 요약해줘 | summarize this PR | PR 번호·URL을 그대로 붙여넣으면 됨 |
| 브랜치 고유 변경만 요약해줘 | branch-only changes, exclude merges | develop 대비 three-dot 기준이 기본(메모리) — 머지 유입분 제외 |
| 이번 변경으로 바뀐 계약이 뭐야? | what contract changed here | 훅 시그니처·타입·소켓 이벤트·런타임 상수·인프라 |
| 이 기능 외 다른 경로 깨지나? | any side effects outside this feature | /pr-impact-check — 사용처 역추적까지 |
| 배포해도 되나? | is this safe to deploy | 변경 요약이 아니라 운영 위험 판정을 요구하는 질문 |
| 실기기로 확인해야 할 항목 뽑아줘 | what needs real-device verification | iPad Safari / Android Chrome / 미디어 경로 / 실 AWS |
| 리뷰 관점으로 시각화해줘 | visualize this branch for review | /pr-diff-review — ppi-docs 발행까지 이어짐 |
| 이 커밋이 왜 들어갔어? | why was this commit made | git log·blame 근거를 함께 요구. 의도 확정 불가면 추정 표기 |
| 이거 되돌리면 뭐가 깨져? | what breaks if I revert this | 롤백 판단·핫픽스 선택지 비교 |
| 커밋 단위가 적절해? | is the commit split reasonable | PPI-* 단일 커밋 선호와 충돌하는지 확인 |
📄 문서화 29회
| 기존 한글 요청 | 영문 숏컷 | 비고 |
|---|---|---|
| 이 내용 ppi-docs에 html 문서로 추가해줘 | add to ppidocs | 레포 위치·copy 버튼·배포 30~40초 대기는 메모리로 자동 적용 |
| index에도 반영해줘 | update index too | |
| 문서도 함께 커밋해줘 | commit docs too |
🐛 조사·디버깅 50회
| 기존 한글 요청 | 영문 숏컷 | 비고 |
|---|---|---|
| [아동명] [회기] 이슈 재현 경로 파악해줘 | /repro-path 아동070 1회기 no audio on host | 고유명사는 한글 유지가 정확 |
| LogRocket에서 세션 로그 확인해줘 | check logrocket for this session | 아동 세션→roomId→진행자 세션 교차 워크플로우 자동 적용 |
| 이 에러 원인 확인해줘 | debug this + 에러 붙여넣기 | 로그·스택은 원문 그대로 붙여넣기 |
| 코드 고치지 말고 원인만 찾아줘 | cause only, don't touch code | /probe — 승인 전 수정 금지가 스킬 규약에 포함 |
| A랑 B 어떻게 구분해? | how do I discriminate A from B | 판별법은 재사용 가치가 가장 큰 산출물 — 증상 재신고 때 바로 쓴다 |
| 시간순 인과 정리해줘 | give me the causal timeline | 원인 분석 첫 보고의 필수 형식(메모리로 자동 적용) |
| 어느 계층에서 깨진 거야? | which layer fails — device, app, or server | 기기 캡처 / 앱 체인 / SFU·서버 분리 |
| 그거 무슨 로그로 확정했어? | what log line proves it | 확정과 추정을 강제로 분리시키는 후속 질문 |
| 재현 방법 알려줘 | how to reproduce this | 재현 경로가 없으면 수정 검증도 불가 |
| 왜 이렇게 동작해? (카드뷰/모니터/포커스뷰) | why does [X] work this way | jacob-handover 스킬이 키워드로 트리거됨 |
🧩 기타 확정 패턴
| 기존 한글 요청 | 영문 숏컷 | 비고 |
|---|---|---|
| vscode에서 보여줘 | show in vscode | 수정 위치를 code -g 파일:줄로 열기 (메모리 트리거 동일 작동) |
| 정상 동작 검증해줘 | verify | |
| 수정사항 반영해줘 | apply / fix it | |
| 테스트 돌려줘 | run tests | |
| 짧게 답해줘 | keep it short | 메모리로 기본 적용 — 길어질 때 다시 눌러주는 용도 |
| 최소 변경으로 고쳐줘 | smallest change that fixes it | 리팩터링 동반을 막는다 |
| 추측이면 추측이라고 써줘 | evidence, not assumptions | |
| 뭘 안 한 거야? (건너뛴 항목) | what did you skip | "완료" 보고의 빈틈 확인 |
한글 유지 권장 영역.
기획 의도·도메인 설명(핑퐁이 동작, 수업 흐름), 미묘한 금지 조건("검증 전 보고 금지"), 아동 이름·활동명 같은 고유명사. 언어보다 명확성이 우선 — 애매한 영문은 애매한 한글과 똑같이 되묻게 된다.