서론

마지막 번에는,

"동작은 하지만 내부 작동 원리가 불분명한 코드为何危险的"

에 대해 썼습니다.

이번에는 그 연장선으로,

실제로 어떻게 내부 작동 원리를 이해하고 있는지 정리합니다.

특별한 것은 없습니다.

방식을 조금만 바꾼 것뿐입니다.

AI 에게 설명을 요청하다

AI 가 작성한 코드는,

바로 읽으면 이해해 버리는 경향이 있습니다.

하지만 실제로는,

중요한 부분을 놓치는 경우가 많습니다.

따라서 먼저 해야 할 일은,

코드를 "설명받기" 입니다.

단, 질문하는 방식은 조금만 고쳐야 합니다.

"이 코드는 무엇을 하는가?"라고 하면,

간략한 설명만 돌아옵니다.

더 깊게 들어갑니다.

• 이 함수의 역할을 한 문장으로 설명해달라
• 어떤 입력이 어떤 처리에 영향을 미치는지 알려달라
• 부수적 효과 (side effects) 가 있는 모든 처리를 나열해달라
• 고장 날 수 있는 패턴을 알려달라

이렇게 물어보면,

코드의 중요한 포인트가 드러납니다.

바로 수정하지 않다

또 다른 흔한 실수는,

문제가 발생했을 때 즉시 수정하는 것입니다.

이는 잘 되지 않습니다.

원인을 이해하지 않은 채 수정하려고 하면,

다른 부분이 고장 날 수 있습니다.

일단 멈추고,

이렇게 물어보는 방식을 취합니다.

"이 코드를 안전하게 수정하려면, 어디가 위험할까?"

이 하나만으로도,

수정의 정확도가 크게 달라집니다.

문서 남기기

이해한 내용은,

바로 두면 잊어버립니다.

특히 AI 코드라면,

"이해해 버린 상태"로 끝나는 경향이 있습니다.

따라서 문서를 남깁니다.

할 일은 간단합니다.

AI 에게 바로 작성하게 합니다.

• 각 함수마다 설명을 적어달라
• 인자와 반환 값을 명시해달라
• 이 파일의 역할을 요약해달라

이렇게 하면,

후에 만졌을 때 난이도가 크게 줄어듭니다.

파일을 분리하다

AI 에게 코드를 작성하게 하면,

한 개의 파일에 처리가 모이는 경향이 있습니다.

초기에는 괜찮지만,

그대로 두면 곧 관리하기 어려워집니다.

무엇을 수정해야 할지 알 수 없게 되는 것입니다.

따라서 분리합니다.

하지만 모든 것을 스스로 생각할 필요는 없습니다.

AI 에게 바로 물어봅니다.

"이 코드를 책임별로 분할해달라"

이 하나만으로도,

적절하게 정리된 구조가 나옵니다.

더 나아가,

• 각 파일의 역할을 설명해달라
• 의존 관계를 정리해달라

를 추가하면,

더 이해하기 쉬워집니다.

맺음말

블랙박스를 파괴한다고 하지만,

특별한 기술은 필요하지 않습니다.

질문 방식을 조금만 바꾸고,

조금만 정리하면 됩니다.

이렇게 쌓아 올리면,

"알 수 없는 코드"가 줄어듭니다.

다음에는,

데이터나 보안에 대해 다룰 예정입니다.

이를 의식하지 않으면,

후에 어려움을 겪게 됩니다.