[기술 해설] 새 도구를 넣기 전에 빼는 법부터 적었다: 도입 판단 네 가지

새 부품을 끼우기 전에 빼내는 방법을 먼저 확인하는 모습을 그린 도식
넣는 방법보다 빼는 방법을 먼저 정해 두면 되돌릴 자리가 남습니다.
먼저 결론

새 도구를 붙이기 전에 이유·비용·위험·제거 방법 네 가지를 먼저 적습니다.

AI에게 기능을 하나 부탁하면 새 도구가 딸려 오는 일이 잦습니다. 그 자체가 잘못된 것은 아닙니다. 문제는 붙일 때는 한 줄인데 뗄 때는 여러 자리를 고쳐야 한다는 점입니다. 게다가 늘어난 도구는 나중에 왜 들어왔는지 아무도 설명하지 못합니다. 그래서 제가 쓰는 개발 운영 규칙에는 새 도구나 외부 서비스를 쓰기 전에 네 가지를 먼저 설명하게 되어 있습니다. 왜 필요한지, 무엇을 치르는지, 어떤 위험이 있는지, 그리고 나중에 어떻게 빼는지입니다. 네 번째가 가장 자주 저를 멈춰 세웠습니다. 빼는 방법을 적을 수 없다면 그 도구는 아직 넣을 준비가 안 된 것입니다.

새 부품을 끼우기 전에 빼내는 방법을 먼저 확인하는 모습을 그린 도식 설명 이미지

도구가 늘어나면 무엇이 문제인가요?

하나 늘어난 것은 티가 나지 않습니다. 문제는 그 도구가 다른 도구를 데려오고, 그 도구가 또 다른 것을 데려온다는 데 있습니다. 어느 순간 무엇 때문에 무엇이 들어와 있는지 설명하기 어려워집니다.

설명하지 못하는 것은 고치지도 못합니다. 무언가 고장 났을 때 어디부터 봐야 할지 정할 수 없기 때문입니다.

비개발자에게는 이 문제가 더 크게 옵니다. 목록에 적힌 이름을 봐도 무엇을 하는 것인지 알 수 없으니, 빼도 되는지 판단할 근거가 없습니다.

넣기 전에 무엇을 적나요?

네 가지를 한 문단씩 적게 합니다. 길게 쓸 필요는 없고, 각 항목에 한두 문장이면 충분합니다. 못 적는 항목이 있으면 그 자체가 답입니다.

적는 사람이 AI여도 상관없습니다. 오히려 AI가 적은 문단을 읽는 편이 빠릅니다. 제가 확인할 것은 문장이 그럴듯한지가 아니라, 네 칸이 모두 채워졌는지와 빼는 방법이 구체적인지입니다.

항목확인하는 것
왜 필요한가지금 있는 것으로 안 되는 이유
무엇을 치르는가돈, 설치 시간, 배우는 시간
어떤 위험이 있는가멈췄을 때 어디까지 영향을 받나
어떻게 빼는가다시 지웠을 때 고쳐야 할 자리

제거 방법을 왜 먼저 정하나요?

빼는 방법을 적어 보면 그 도구가 어디까지 스며드는지 미리 보입니다. 한 파일만 고치면 되는 도구와 여러 자리에 흩어지는 도구는 같은 무게가 아닙니다.

빼는 비용을 알고 나면 선택이 달라지기도 합니다. 편해 보이던 방법이 사실은 되돌리기 어려운 방법이었다는 사실을 넣기 전에 알게 됩니다.

그리고 실제로 뺄 일이 생겼을 때 그 문단이 그대로 안내서가 됩니다. 몇 달 뒤의 저는 왜 넣었는지도 기억하지 못하니, 이 한 문단이 유일한 단서입니다.

  • 닿는 자리 — 이 도구를 부르는 파일이 몇 군데인가
  • 남는 흔적 — 설정과 저장된 값은 어디에 남는가
  • 대체 방법 — 빼면 그 기능은 무엇으로 대신하는가

요청하지 않은 기능이 딸려 오면요?

규칙에는 승인된 범위 밖의 기능을 임의로 추가하지 않는다는 항목이 있습니다. 새 도구는 대개 이 항목과 함께 옵니다. 기능이 늘면 그 기능을 위한 도구도 늘기 때문입니다.

그래서 작업을 맡길 때 이번에 하지 않을 것을 함께 적습니다. 있으면 좋을 것 같아 넣었다는 설명이 나오면, 필요해질 때 다시 판단하자고 돌려보냅니다.

덤으로 늘어난 기능은 대개 쓰이지 않습니다. 그런데 고장은 똑같이 냅니다. 쓰지 않는 기능이 낸 고장을 고치는 시간이 가장 아깝습니다.

필요해 보이는 것을 아예 버리라는 뜻은 아닙니다. 다음에 할 일 목록에 한 줄로 적어 두면 됩니다. 그러면 잊지도 않고, 지금 작업의 범위도 흔들리지 않습니다.

도입 판단 네 가지 정리 이미지

새 도구 대신 무엇을 해 보나요?

먼저 지금 쓰는 것으로 되는지 확인합니다. 많은 경우 이미 있는 기능으로 절반은 됩니다. 절반만 되면 나머지 절반이 정말 필요한지 다시 봅니다.

다음은 작게 시험해 보는 것입니다. 본 작업에 붙이지 않고 따로 떼어 낸 자리에서 돌려 봅니다. 여기서 안 되면 그대로 버리면 되고, 본 작업은 그대로입니다.

마지막으로 하나씩 넣습니다. 두 개를 같이 넣으면 문제가 생겼을 때 어느 쪽 때문인지 알 수 없습니다. 하나 넣고 확인하고, 그다음에 다음 것을 넣습니다.

네 가지를 묻고 무엇이 달라졌나요?

도구가 느리게 늘어납니다. 그리고 늘어난 것마다 왜 들어왔는지가 한 문단씩 남아 있습니다.

고장이 났을 때 찾는 순서도 짧아졌습니다. 최근에 들어온 것부터 보면 되고, 그 문단에 어디까지 닿는지가 적혀 있으니 볼 자리가 좁혀집니다.

무엇보다 넣을지 말지를 고민하는 시간이 줄었습니다. 네 칸 중 하나를 못 채우면 넣지 않는다는 기준이 있으니, 판단이 취향이 아니라 절차가 됐습니다.

묻지 않던 때네 가지를 적은 뒤
필요해 보이면 바로 추가지금 있는 것으로 되는지 먼저 확인
왜 들어왔는지 모름이유가 한 문단으로 남음
빼는 방법을 그때 찾음빼는 절차가 미리 적혀 있음
두 개를 한꺼번에 넣음하나씩 넣고 확인함

자주 묻는 질문

Q. 모든 도구에 네 가지를 다 적어야 하나요?

A. 지우기 쉬운 것은 넘어가도 됩니다. 기준은 나중에 뺄 때 여러 자리를 고쳐야 하는가입니다. 그런 도구만 네 가지를 적습니다.

Q. AI가 이미 넣어 버렸으면 어떻게 하나요?

A. 지금이라도 네 가지를 적게 합니다. 특히 빼는 방법을 적게 하면 지금 상태에서 무엇이 어디에 걸려 있는지 파악할 수 있습니다.

Q. 무료 도구도 비용을 따져야 하나요?

A. 돈이 들지 않아도 설치와 배우는 시간, 문제가 생겼을 때 확인하는 시간은 그대로 듭니다. 무료라는 말은 비용이 없다는 뜻이 아니라 요금이 없다는 뜻입니다.

Q. 어떤 도구가 위험한 편인가요?

A. 여러 자리에서 부르게 되는 도구와, 저장된 값을 자기 형식으로 바꿔 두는 도구입니다. 앞의 것은 뺄 때 고칠 자리가 많고, 뒤의 것은 빼도 자료가 남습니다.

확인 자료

  • AI 개발 운영 규칙 문서 v1.3 — 7장 작은 단위 개발과 승인 범위, 4장 실행 전 보고 (확인 2026-09-09)
  • AI 개발 운영 규칙 현장 부록 v1.3 — 도구 운영 규칙 (확인 2026-09-09)

이 글은 직접 겪은 작업 기록을 정리한 것입니다. 확인하지 못한 항목은 본문에 쓰지 않았습니다. 대표 이미지는 이해를 돕기 위한 참고용 이미지입니다.