AI와 함께 춤을.. 아니, 코딩을.. (3) - 서버 개발, AI와 함께 넘은 벽

요즘 개발되는 앱의 상당수는 앱 단독으로 동작하지 않고, 서버와 통신하는 구조로 만들어진다. 내가 개발하는 앱도 당연히 백엔드 서버를 이용하고 있다.

서버 개발이라는 벽

지난 포스팅에서도 언급했듯이, 나는 요즘 일반적으로 많이 쓰이는 PHP나 Node.js 같은 기술에 대한 경험이 별로 없다. 그래서 이전에는 작은 기능 하나를 서버에 추가하려 해도 오랜 시간을 소비해야 했다. 결국 가급적이면 서버에 의존하지 않는 기능만 만들곤 했다.

내가 AI를 개발에 이용하기 시작한 주요 이유 중 하나가 바로 이 서버 개발 때문이었다. 처음에는 외주를 통해 개발되어 있던 기존 서버에 Cursor를 이용해 엔드포인트를 하나씩 추가하거나 수정하는 방식으로 진행했다.

응답이 제각각인 문제

그런데 이 과정에서 문제가 생겼다. AI가 새로운 엔드포인트를 만들 때마다 서버의 응답 형태가 조금씩 달라지면서, 클라이언트와 통합하는 데 어려움이 발생한 것이다. REST API에 대한 경험 없이 단순히 AI에게 구현만 시킨 결과였다.

문서화로 인터페이스 통일하기

이러한 비효율을 극복하기 위해 선택한 방법이 바로 지난 포스팅에서 이야기한 문서화였다. 기능 개발의 전반적인 상황을 설명하고, 클라이언트와 서버 간의 인터페이스까지 함께 문서화하도록 했다. 그리고 생성된 문서를 앱과 서버 양쪽 프로젝트에 포함시켜, 이를 기반으로 개발하도록 함으로써 각 구현 단계에서 서로 다른 방식으로 구현되는 것을 방지했다.

AI는 항상 새로운 개발자다

여기서 한 가지 주의할 점이 있다. 이미 한 번 구현된 서버에 새로운 엔드포인트를 추가해야 할 때, 기존과 동일한 방식으로 인터페이스를 구성해야 한다는 것을 반드시 함께 지시해야 했다.

AI는 항상 새로운 개발자라고 보면 된다. 새로운 개발자는 자기 방식으로 개발하려는 경향이 있다. 그래서 이전에 작성한 문서를 함께 제공하고, 이를 기반으로 작성하라고 명확히 지시해야 한다.

요즘은 AI 에이전트들이 프로젝트의 기존 코드를 더 잘 파악하게 되어 이런 문제가 많이 줄었지만, 문서화를 통한 인터페이스 통일은 여전히 유효한 방법이라고 생각한다.

📚 AI와 함께 춤을 시리즈

• (1) 오래된 개발자의 AI 코딩 여정기
• (2) 문서화로 AI와 소통하기
• (3) 서버 개발, AI와 함께 넘은 벽 ← 현재 글

✍️ 이 글은 Claude의 도움을 받아 다듬어졌습니다.