안녕하세요,
프론트엔드 개발자 김현수입니다.

AI 워크플로우

AI 페어 프로그래밍 기반으로 팀 프로젝트를 수행하며, 코드를 '작성하는' 시간이 '검증하는' 시간으로 이동하는 변화를 겪었습니다. 도구를 도입하는 데서 그치지 않고, 그 변화에 맞춰 팀의 문서 체계와 코드 구조 기준을 다시 설계했습니다.

정보의 수명에 따른 문서 분리

AI와 협업할 때 발생하는 컨텍스트 유실과 토큰 비용 문제를 해결하기 위해 문서를 성격별로 나눴습니다. 진행 상황만 담는 문서를 따로 두어, 세션을 새로 시작해도 그 문서 하나만 읽으면 이어서 작업할 수 있도록 했습니다. 완료된 기록은 주기적으로 삭제해 낡은 정보가 다음 판단을 흐리지 않게 유지합니다. 반대로 문제 해결 과정의 판단과 결정처럼 수명이 긴 정보는 아키텍처 문서로 분리해 보관합니다.

문서를 저장소 안에 두기

문서를 코드와 같은 저장소에 포함시켜 팀원이 동일한 컨텍스트를 공유하도록 하고, 문서의 변경 이력이 코드 변경과 함께 남도록 구성했습니다.

AI 협업을 고려한 파일 분리 기준

AI와 함께 개발할 때 한 파일이 비대해지는 경향을 인지하고 분리 기준을 다시 검토했습니다. 수정 범위가 국소적으로 유지되면 읽어들이는 컨텍스트가 줄어 비용이 절감될 뿐 아니라, 모델이 추적해야 할 범위가 좁아져 수정 정확도도 함께 올라간다는 점을 고려했습니다.

역할별 서브에이전트 작업 환경 설계

설계·리뷰 등 역할별 서브에이전트를 정의하고, 매번 명시적으로 지정하지 않아도 작업 성격에 따라 자동으로 위임되도록 트리거 조건을 설계했습니다.