MODULE 15 · 개발 실전·운영

잘 굴러가게,
그리고 안전하게

깃으로 되돌릴 길을 깔고, 에러를 추적하고, 코드를 검수하고, 비밀을 지키고, 일에 맞는 모델을 고른다 — 5개 레슨

AI 에이전트 실무 교재 · Module 15

Lesson 63 · 깃과 버전관리

커밋은 코드의 세이브 지점

01상태 보기지금 무엇이 바뀌었는지부터 확인한다 — 모든 일의 출발
02담기이번 도장에 넣을 변경만 고른다 — 관련 없는 건 섞지 않기
03도장 찍기“무엇을 왜 바꿨는지” 한 줄을 붙여 커밋으로 박제
04되돌리기길을 잘못 들면 안전하게 직전 커밋으로 돌아간다

Lesson 63 · 한눈에

Lesson 64 · 디버깅·에러 해결

고치기 전에, 왜 났는지부터

01증상 전달실행 명령·기대 결과·실제 에러 메시지를 토씨 그대로
02가설 먼저곧장 고치지 말고 원인 후보를 가능성 순으로 나열
03최소 재현문제를 일으키는 최소 조건으로 좁히면 원인이 드러난다
04못 박기같은 버그 재발을 막을 검증을 하나 남긴다

Lesson 65 · 코드리뷰·검증 자동화

만드는 눈과 보는 눈을 나눈다

A

리뷰 — 눈

의도가 맞는지, 빠뜨린 경우가 없는지 ‘판단’한다. 리뷰어 모드로 결함만 트집 잡게 한다.

B

검증 — 손

테스트·형식 점검·금지 패턴 차단을 훅으로 자동화. 사람의 피로에 기대지 않는다.

“

만드는 눈과 보는 눈을 나누면,
품질이 올라간다.

“이 코드 좋아?”라고 물으면 칭찬이 돌아온다. “리뷰어로서 결함만 찾아라”라고 역할을 못 박아야 비판의 눈이 켜진다.

Lesson 66 · 보안 점검

가장 자주 새는 네 구멍

01비밀 노출키·비밀번호를 코드에 직접 적음 — 환경변수로 빼고 즉시 재발급
02입력 미검증외부가 준 값을 그대로 믿음 — 빈 값·이상값·악의값을 거른다
03과한 권한필요 이상의 접근 — 권한 사다리대로 ‘딱 필요한 만큼만’
04의존성 위험가져다 쓴 라이브러리의 알려진 취약점 — 정기 점검·갱신

“

비밀은
코드에 넣지 않는다.

화려한 공격보다 흔한 실수가 더 위험하다. 비밀을 코드 밖으로 빼고, 외부 입력을 의심하고, 권한을 좁히면 사고 대부분이 막힌다.

Lesson 67 · 모델 선택 전략

일의 무게에 모델의 무게를

A

Opus

가장 깊이 생각하는 두뇌. 어려운 설계·복잡한 디버깅·틀리면 비싼 판단에.

B

Sonnet

균형. 일상 코딩·리뷰 등 대부분의 실무 작업은 여기서 시작한다.

C

Haiku

빠르고 가볍다. 분류·요약·간단 변환을 많고 빠르게 돌릴 때.

Lesson 67 · 한눈에

모델 선택 매트릭스 — Opus·Sonnet·Haiku를 일의 무게에 따라 고른다

“

잘 굴러가게,
그리고 안전하게.

되돌릴 길을 깔고(63), 에러를 추적하고(64), 코드를 검수하고(65), 비밀을 지키고(66), 일에 맞는 모델을 골랐다(67). 다음 모듈에서 이 기술들을 하나로 묶는다.

Module 15

출처 · 더 읽을거리