점검 가이드 · 시연
AI 에게 수정 맡길 때 다른 기능이 안 망가지게 하는 법
2026-10-24 기준
세 줄 요약
- AI 는 "고쳐 줘" 한마디에 관계없는 곳까지 손대는 일이 많습니다. 한 번에 하나만 맡기세요.
- 바꿀 것과 바꾸지 말 것, 다 고친 뒤 무엇으로 확인할지를 요청문에 함께 적으면 사고가 크게 줍니다.
- 고치기 전에 되돌릴 지점을 만들어 두면, 망가져도 몇 초 만에 원래대로 돌아갈 수 있습니다.
왜 다른 기능이 망가지나요
AI 코딩 도구는 문제를 고치면서 "이왕이면" 주변 코드를 정리하거나, 이름을 바꾸거나, 다른 파일까지 손대는 경향이 있습니다. 그 코드를 다른 화면이 쓰고 있으면 거기가 깨집니다.
또 "로그인이 이상해, 고쳐 줘"처럼 넓게 말하면 AI 가 원인을 추측해 여러 곳을 동시에 바꿉니다. 무엇 때문에 고쳐졌는지, 무엇 때문에 다른 게 깨졌는지 알 수 없게 됩니다.
네 가지 원칙
- 작게 나누기: 한 번에 문제 하나만 맡깁니다. 여러 개라면 하나 고치고 확인한 뒤 다음으로 넘어갑니다.
- 바꾸지 말 것 적기: "결제 화면과 로그인 코드는 건드리지 마", "파일 이름과 데이터베이스 구조는 바꾸지 마"처럼 지킬 것을 분명히 적습니다.
- 확인 방법 적기: "고친 뒤 어떤 순서로 눌러서 무엇이 보이면 성공인지"를 적습니다. AI 에게도 그 방법으로 직접 확인하고 결과를 보고하게 합니다.
- 되돌리기 준비: 고치기 전 상태를 저장(GitHub 커밋, 빌더의 버전 기록·체크포인트)해 두고, 이상하면 바로 되돌립니다.
바로 쓰는 요청문
아래 틀의 [ ] 부분만 바꿔서 쓰세요. 고치기 전에 먼저 계획을 보여 달라고 하는 것이 핵심입니다.
내 AI 에게 그대로 붙여 넣기[문제] 휴대폰에서 주문하기 단추를 누르면 아무 일도 안 일어나. PC 에서는 잘 돼. [바라는 결과] 휴대폰에서도 단추를 누르면 결제 화면으로 넘어가야 해. [바꾸지 말 것] 결제 금액 계산, 로그인, 데이터베이스 구조, 다른 화면의 디자인은 건드리지 마. 관계없는 코드 정리나 이름 바꾸기도 하지 마. [진행 방법] 바로 고치지 말고, 먼저 원인과 바꿀 파일·줄을 짧게 설명해 줘. 내가 좋다고 하면 그때 고쳐 줘. [확인 방법] 고친 뒤 휴대폰 크기 화면에서 상품 고르기 → 주문하기 → 결제 화면이 뜨는지 확인하고, PC 에서도 같은 순서가 그대로 되는지 확인해서 결과를 알려 줘. 바꾼 파일 목록도 적어 줘.
고친 뒤 직접 확인하기
- AI 가 알려 준 바꾼 파일 목록을 봅니다. 말한 것보다 많은 파일이 바뀌었다면 이유를 물어봅니다.
- 고친 기능을 직접 눌러 봅니다.
- 자주 쓰는 핵심 흐름(가입·로그인·주문·결제 등) 서너 개를 매번 같은 순서로 눌러 봅니다. 이 목록을 메모해 두면 매번 쉽게 확인할 수 있습니다.
- 이상하면 고치기 전 상태로 되돌리고, 요청문을 더 좁혀서 다시 맡깁니다.
되돌리는 방법
- Lovable·Bolt·v0 같은 빌더: 대부분 대화 기록이나 버전 기록에서 이전 상태로 돌아가는 메뉴가 있습니다.
- Cursor·Claude Code 같은 도구: 고치기 전에 "지금 상태를 커밋해 줘"라고 시키고, 망가지면 "마지막 커밋 상태로 되돌려 줘"라고 하면 됩니다. 도구 자체의 체크포인트(되감기) 기능이 있는 경우도 많습니다.
- 운영 중인 서비스라면 호스팅(Vercel 등)의 이전 배포로 되돌리는 기능도 알아 두세요.
자주 묻는 질문
요청문을 이렇게 길게 써야 하나요?
간단한 글자 수정은 짧아도 됩니다. 다만 결제·로그인·데이터 저장처럼 망가지면 큰일인 곳을 고칠 때는 "바꾸지 말 것"과 "확인 방법"만큼은 꼭 적으세요.
AI 가 계속 같은 실수를 반복해요.
대화가 길어지면 앞의 지시를 잊는 경우가 있습니다. 새 대화를 열고 문제·바라는 결과·바꾸지 말 것을 다시 한 번에 적어 주면 나아지는 경우가 많습니다. 프로젝트 규칙 파일(지켜야 할 것을 적어 두는 파일)을 지원하는 도구라면 거기에 적어 두세요.
점검 보고서에 있는 수정안을 그대로 붙여 넣어도 되나요?
수정안도 틀릴 수 있습니다. 붙여 넣을 때 "먼저 이 수정안이 지금 코드에 맞는지 확인하고 계획을 보여 줘"라고 덧붙여, 바로 고치지 않게 하세요.
내 코드에 이런 문제가 있는지, AI 세 개가 따로 봐 드려요.
삼심은 Claude·GPT·Gemini 가 서로 모르게 점검하고 지적을 교차 확인해, 개발부터 법률까지 8개 분야의 고칠 순서와 수정 지시문을 드립니다.
함께 보면 좋은 글
이 글은 일반적인 정보이며 법률·보안 자문이 아닙니다. 서비스마다 상황이 다르니 고치기 전에 확인하세요.