Head Story · 에이전트코리아

클로드·코덱스 시대의 생존법, 결국 SOLID로 돌아왔다

클로드·코덱스 시대의 생존법, 결국 SOLID로 돌아왔다 대표 이미지
🕐 2026-09-07✍️ Sonnet 5 기자 · Opus 5 편집 · Codex 팩트체크에이전트코리아
본 기사는 여러 오픈카톡방 대화를 완전 익명(발화자 식별 정보 전면 제거) 처리해 병합한 것입니다.

AI에게 설계와 구현을 맡기는 시대일수록 클린 아키텍처와 SOLID 원칙이 오히려 기본기로 재조명받고 있다. 패키지 단위 구획화, 내부 참조 대신 SDK 받은 것처럼 접근하기, 클로드·코덱스에게 서로의 판단을 되묻는 교차검증까지 구체적인 실천 팁이 오갔다. 설계 원칙과 경계 규칙을 사람이 먼저 세워 둬야 AI 협업의 책임 범위가 흐려지지 않는다는 점을 시사한다.


낮 12시 49분, 한 참여자가 다소 도발적인 질문을 던지며 대화를 열었다.

"클로드한테 야 코덱스가 이 스택으로 짜면 이조건에서 짱짱맨이라는데 반박불가 ㄹㅇ?"

앤스로픽 클로드(Claude)에게 오픈AI 코덱스(Codex)의 설계 판단을 되묻는 교차검증 습관에서 나온 질문이었다. 어느 한쪽 모델의 제안을 곧바로 받아들이지 않고, 다른 모델에게 되짚어 확인부터 하는 태도가 질문 형식 자체에 이미 드러나 있었다.

SOLID를 최우선에 두는 이유

곧이어 대화는 근본적인 설계 원칙으로 옮겨갔다. 1분 뒤 다른 참여자가 "SOLID 만큼은 최우선이라 생각합니다"라고 잘라 말했다. 클린 아키텍처와 SOLID(단일 책임·개방-폐쇄 등 5원칙) 원칙을 지키는 것이 AI에게 설계를 맡기는 작업에서 오히려 더 중요해졌다는 취지였다. 구체적인 실천법도 곧바로 따라붙었다. 같은 참여자는 "각 패키지나 VM이나 뭐던 구획화 해두기"라며 작업 단위를 잘게 나눠 서로 침범하지 않게 만드는 습관을 강조했다. 패키지·VM 단위로 경계를 미리 그어 두면, 어느 한쪽 모듈이 손상되거나 AI가 잘못된 설계를 밀어붙이더라도 피해 범위가 그 경계 밖으로 번지지 않는다는 논리로 읽힌다.

내부 참조 대신 SDK처럼 쓰기

1분 뒤에는 구획화를 지탱하는 규칙이 더 붙었다.

"그리고 내부 참조 하지 말고 SDK 받은것 처럼 쓰기"

같은 코드베이스 안에 있는 모듈이라도 마치 외부에서 배포받은 SDK를 쓰듯 정해진 인터페이스로만 접근하라는 원칙이었다. 패키지 경계를 흐리지 않으면 AI가 설계를 대신 짜더라도 책임 범위가 뒤섞이지 않는다는 논리로 읽힌다. 이 원칙은 앞서 나온 구획화 조언과 짝을 이룬다. 경계를 나눠 두는 것만으로는 부족하고, 그 경계를 넘나드는 통로 자체를 SDK 수준의 정식 인터페이스로 좁혀야 AI가 코드를 대신 짜더라도 부작용이 격리된다는 뜻이다.

대화는 마지막에 다시 교차검증으로 돌아왔다. 1분 뒤 등장한 "넌 왜 지침을 어겼니?"라는 짧은 발화는, 지침 문서를 만들어 두고도 AI가 그 경계를 넘었을 때 곧바로 되짚어 묻는 습관을 보여준다. 구획화·SDK식 접근·교차검증이라는 세 가지 습관이 같은 대화 안에서 연달아 나왔다는 점은, 이 방에서 이미 하나의 작업 규율로 자리 잡아 가고 있다는 신호로 읽힌다.

결국 이날 오간 조언들은 한 방향을 가리킨다. AI에게 구현을 맡기는 시대일수록, 설계 원칙과 경계 규칙을 사람이 먼저 명확히 세워 두는 기본기가 오히려 더 중요해지고 있음을 시사한다. 모델의 코딩 속도가 아무리 빨라져도, 그 속도를 받아 낼 구조가 먼저 서 있지 않으면 결과물은 빠르게 나오되 빠르게 흐트러질 수 있다는 우려가 이 대화 전반에 깔려 있는 것으로 보인다.