100% AI 도입 1년 후, 아무도 우리 코드를 이해하지 못하게 되었다

코드를 직접 짜는 거랑 AI가 짜게 하는 건 서로 대체 가능해야 함. 즉, 코드가 좋기만 하면 누가 짰는지는 아무도 신경 안 써야 한다는 거지. 코드를 직접 만져보는 게 코드 이해하는 데 가장 좋은 방법 중 하나라는 생각 안 해봤음? 그리고 언제부터 코드를 직접 짜는 건 '수작업'이고 프롬프트 쓰는 건 아니게 된 거임? 뭐, 내가 짜면 망가뜨리기라도 할까 봐? 우리가 벌써 그 정도로 맛이 간 건가?

그게 바로 네가 거기 있는 이유지.

코드 리뷰도 해야 하지만 주기적으로 코드베이스 전체를 검토해야 함.

난 정기적으로 코드베이스 전체를 훑는 에이전트를 돌려서 리팩토링 기회나 기능 중복, 포트 및 인터페이스 생성 가능성, 그 외 여러 패턴들을 찾아냄. 특정 모듈에 집중할 때도 있고, 그냥 무작위로 탐색을 시킬 때도 있음.

내가 하는 모든 작업에 대해 C4 모델이나 프로세스 다이어그램을 생성해서 변경 전후로 검토함. 에이전트 기반 코딩이라고 해서 올바른 엔지니어링을 못 하는 건 아님.

솔직히 '코드베이스를 모르겠다'는 건 좀 핑계임. 대규모 팀에서 큰 시스템을 다룰 때 코드베이스 전체를 깊이 아는 사람은 아무도 없음. 그럴 때 시스템을 이해하는 방식이 바로 아키텍처 문서화인 거임.

코드베이스가 엉망이면, 결과물도 엉망이겠지. 내 경험상 코드베이스가 깔끔하고 스타일이 일관적이면, Claude(적어도)는 대부분의 인간보다 훨씬 유능하게 그 스타일을 맞춰줘.

맞아, 지시를 완벽하게 따를 수 있는 도구가 기대한 대로 작동하지 않는다고 불평하는 사람들을 이해할 수가 없어.

저장소 자체에 명세서나 비즈니스 요구사항을 유지하지 않는 거야? 코드 50만 줄 정도 되는 저장소를 관리하려면 그 방법밖에 없던데.

맞는 말인데, AI한테는 인간한테 요구하는 것보다 훨씬 더 뛰어난 명세가 필요함. Claude는 컨텍스트 내의 모순을 처리하는 걸 엄청나게 못 하거든.