정의

코드 변경 시 영향받는 파일·심볼·테스트 를 3~10줄짜리 표/그래프 로 사전 가시화한 문서. Phase 1 계획 단계 산출물. 잘못된 참조를 수천 줄 PR 이전에 3줄 영향 지도 단계에서 발견 → 수정 비용 극저.

비용 차이

작성 예시

변경 의도: 사용자 인증 로직에 2FA 추가

영향 파일:
  - src/auth/login.ts (수정)
  - src/auth/types.ts (확장)
  - src/components/LoginForm.tsx (UI 추가)
  - tests/auth/login.test.ts (테스트 추가)

영향 심볼:
  - login() 시그니처 변경
  - User 타입에 mfaEnabled 추가

리스크:
  - 기존 로그인 플로우 호환성

강의 활용

03 HRN lesson/hrn-4layer-architecture:

• 멘트: "변경 전 에 영향 지도 3줄. 그게 전부입니다."
• 비용 계산 강조: "3줄 vs 수천 줄 — 어디서 발견하는 게 좋겠습니까?"

주의사항

• 번역 통일: 저장소 영향 지도 권장. Impact Map 영어 그대로도 OK.
• 상세 vs 간결: 너무 자세하면 작성 비용 증가. 3~10줄 이 권장.
• 자동화 도구: 일부 도구 (e.g., git diff --stat + AI) 가 자동 생성 보조. 강의에서 짧게 언급.