LLM으로 수만 줄 프로젝트를 유지하는 워크플로우

AI-Mediated Architecture Workflow

1. 소개

최근 AI를 활용한 개발 방식이 빠르게 늘어나고 있다.

그러나 많은 경우 다음과 같은 두 가지 한계가 있다.

• AI에게 대부분의 작업을 맡기면서 프로젝트의 구조와 방향을 통제하기 어려워지는 문제
• AI를 단순 보조 도구 이상으로 활용하지 못해 작은 작업이나 반복 작업에만 머무르는 경우

그래서 결국 많은 프로젝트는 다음 두 극단 중 하나로 흘러간다.

• AI에게 너무 많은 것을 맡겨 프로젝트 구조가 무너지는 경우
• AI를 거의 사용하지 않고 사람이 대부분을 직접 구현하는 경우

이 문서는 이러한 한계를 보완하고 AI의 장점을 적극적으로 활용하여 설계와 구현을 진행하는 협업 방식을 설명한다.

1.1. 핵심 개념

AI를 코드 생성 도구가 아니라, 설계와 구현을 함께 수행하는 협업 파트너로 사용한다.
AI와 사람의 역할을 설계, 구현, 검토 세 가지로 구분한다.
문서를 기반으로 설계 -> 구현 -> 검토 흐름으로 진행하고, 마무리 때 문서를 업데이트한다.
이러한 과정을 구현할 기능 단위로 반복하며 진행한다.

이 방식의 특징은 다음과 같다.

• 사람이 설계의 주도권을 유지한다
• AI를 설계와 구현 과정에서 리뷰어이자 협업 파트너, 동시에 학습 도구로 적극 활용한다
• 작업은 설계 → 문서 → 구현 → 검토 → 문서 업데이트 흐름으로 진행된다
• 문서를 중심으로 협업이 이루어지기 때문에 대규모 프로젝트에서도 안정적으로 작업을 이어갈 수 있다