개발 업무에
AI 적용하기

1. 사용법 1 — 모르는 코드 이해하기

인수인계받은 프로젝트, 처음 보는 오픈소스에서 가장 효과가 큽니다.

이 프로젝트 전체 구조를 파악해서 설명해줘.
- 주요 폴더별 역할
- 실행 흐름 (진입점부터)
- 핵심 파일 5개와 각각의 역할

결제 처리가 어디서 이뤄지는지 찾아서,
관련 함수들의 호출 관계를 설명해줘.

사람이 하면 며칠 걸리는 코드 파악이 크게 단축됩니다. 설명을 받은 뒤에는 핵심 부분을 직접 열어 확인하세요.

2. 사용법 2 — 코드 리뷰

방금 수정한 내용(git diff 기준)을 리뷰해줘.
- 버그 가능성
- 예외 처리 누락
- 더 단순하게 쓸 수 있는 부분
심각한 것부터 순서대로.

커밋 전에 돌리는 셀프 리뷰 용도로 적합합니다. 동료 리뷰를 대체하는 것이 아니라, 동료에게 보내기 전에 기본기를 잡는 단계로 쓰는 것이 맞습니다.

3. 사용법 3 — 테스트 만들기

utils/parser.py의 함수들에 대한 단위 테스트를 만들어줘.
- 정상 케이스와 경계 케이스(빈 값, 잘못된 형식) 포함
- 테스트 실행해서 통과하는 것까지 확인해줘

마지막 줄이 중요합니다. Claude Code는 테스트를 만들고 직접 실행해서 결과까지 확인할 수 있습니다. 실패하면 원인을 찾아 고치는 것까지 이어서 시킬 수 있습니다.

4. 사용법 4 — 문서화

이 프로젝트의 README를 작성해줘.
- 프로젝트 소개, 설치 방법, 사용 예시, 폴더 구조
- 실제 코드를 읽고 사실에 맞게 쓸 것

주석 없는 함수에 주석 달기, 변경 이력 정리, API 명세 초안도 같은 방식으로 시킬 수 있습니다. 미루기 쉬운 문서화를 비용 없이 해결하는 것이 체감 효과가 가장 큰 부분입니다.

5. 잘 쓰는 원칙

1. 작게 시키고 확인한다 — "전체 리팩토링해줘"보다 파일·기능 단위로 시키고 diff를 확인합니다.
2. 실행으로 검증한다 — 코드 수정 후에는 테스트나 실행 확인까지 시킵니다. "고쳤다"는 말이 아니라 통과한 테스트가 근거입니다.
3. 모든 변경은 git 위에서 — 커밋해 두고 작업시키면 언제든 되돌릴 수 있습니다.
4. 이해 없이 머지하지 않는다 — AI가 쓴 코드도 본인이 설명할 수 있어야 합니다. 이해 안 되는 부분은 "이 부분 왜 이렇게 했는지 설명해줘"라고 물어보세요.

6. 시리즈를 마치며

9편 요약입니다.

각 편에 대한 질문과 "이런 것도 다뤄달라"는 요청은 댓글로 남겨주세요. 반응을 보고 보충편을 이어가겠습니다.