간단한 반숙: AI가 생성한 코드를 유지보수 가능하게 만드는 건축적 제약 조건

저자는 "AI 90/10 문제"를 논합니다. 이는 AI가 생성한 코드가 90%는 완료되었지만 검토하고 유지보수하기에는 불가능한 상황을 의미합니다. 그 이유는 AI 에이전트가 유지보수 용이성보다 생성 속도에 최적화되어 있기 때문입니다. Rich Hickey의 강연 "Simple Made Easy"에서 얻은 원칙들이 저자가 AI가 생성한 코드를 쉽게 검토하고 유지보수할 수 있도록 아키텍처를 제약하는 데 영감을 주었습니다. Hickey의 원칙은 단순성의 중요성, 상태와 값의 분리, 데이터를 데이터로 사용, 메서드보다 함수 선호, 상속보다 합성을 강조합니다. 이러한 원칙을 적용함으로써 저자의 팀은 기능을 구현하는 명확한 방법이 단 하나만 남도록 시스템을 설계하여 AI가 생성한 코드를 유지보수 가능하게 만들었습니다. 팀의 아키텍처 제약 조건에는 불변 데이터, 명시적 오류 컨텍스트, 순수 함수, 그리고 상속보다 합성이 포함되었습니다. 이러한 제약 조건들은 코드 검토 시간을 단축시켰을 뿐만 아니라 AI 에이전트에게 더 나은 코드를 생성하도록 가르쳤습니다. 저자는 AI 90/10 문제가 AI 에이전트의 한계가 아니라 아키텍처 설계의 실패이며, 설계를 통해 AI 행동을 제약하는 것이 AI를 유지보수 가능한 소프트웨어 구축의 파트너로 만든다고 결론짓습니다.