코드 읽기·리뷰·변경 범위

개요

변경 diff에서 핵심 동작과 위험을 설명한다.

먼저 AI에게 위임할 작업 정의, Python·노트북·라이브러리 읽기의 핵심 개념을 확인하세요.

핵심 개요

기존 코드 변경은 호출자·상태 소유자·수명·오류 경로를 먼저 읽는 작업입니다. 이름이 비슷한 함수 하나를 찾았다고 전체 동작을 이해한 것은 아닙니다.

리뷰에서는 변경이 요구사항을 해결하는지와 영향 범위가 적절한지를 함께 봅니다. 큰 정리 작업을 버그 수정에 섞으면 원인과 회귀의 연결이 흐려집니다.

필요한 용어

• 호출 경로: 입력 이벤트에서 결과까지 함수가 이어지는 관계
• 변경 표면: 수정으로 영향을 받을 수 있는 API·상태·자료의 범위

작동 과정

1. 입력 이벤트부터 상태·렌더링·저장 경로를 추적합니다.
2. 동일 상태를 바꾸는 다른 호출자와 수명을 확인합니다.
3. 요구와 무관한 변경을 줄이고 차이를 검토합니다.

풀이 예제

아래 입력과 기록은 직접 만든 교육용 가상 자료입니다.

입력·조건

체크 표시 함수는 값만 바꾸지만 편집 명령 경로는 Undo 기록과 협업 메시지도 만듭니다.

판단·결과

UI에서 값 변경 함수만 직접 부르면 화면은 맞아도 편집 계약을 깨뜨릴 수 있습니다.

이렇게 판단한 이유

기존 명령 경로에는 보이지 않는 책임이 있으므로 전체 상태 전환을 확인해야 합니다.

흔한 실패와 복구

그럴듯한 함수 이름과 주석을 실제 계약으로 대신하지 않습니다. 호출자와 테스트·실행을 대조합니다.

확인 문제

참고 자료

1. Anthropic: Agent evaluations  — 과제·시도·실행 결과·평가자 검증.
2. Anthropic: Context engineering  — 지침·도구·검색·기록의 문맥 관리.

자료 확인: 2026-10-21. 사례·문항·실습은 자체 제작했습니다. 외부 서비스 호출과 실제 모델 품질 측정은 학습자가 별도 환경에서 수행합니다.

AI가 버그를 고치면서 공용 컨테이너와 API 이름도 바꿨습니다. 리뷰와 변경 분리 기준을 적으세요.