기존 프로젝트에 AI 코딩 에이전트를 적용하는 방법
기존 코드에 AI 코딩 에이전트를 적용할 때 작업 모듈을 고르고, 개발 문서와 재현 조건을 준비하며, 코드 변경과 테스트 결과를 검토하는 절차를 소개합니다.
기존 프로젝트에 AI 코딩 에이전트를 적용할 때는 작은 모듈과 명확한 변경 요청으로 시작하는 편이 좋습니다. 프로젝트 전체를 이해하고 고치라는 요청보다, 재현 가능한 오류나 범위가 좁은 기능을 선택하면 읽어야 할 파일과 완료 조건을 정하기 쉽습니다.
첫 작업의 목표는 많은 코드를 바꾸는 것이 아니라, 파일 이해부터 수정·실행·검토까지 팀이 반복할 수 있는 절차를 만드는 것입니다.
첫 작업을 고르는 기준
다음 세 조건을 만족하는 일을 먼저 고르세요.
- 관련 파일과 기능의 경계를 설명할 수 있습니다.
- 수정 전 문제 또는 기대 동작을 재현할 수 있습니다.
- 사람이 결과를 확인할 방법이 있습니다.
예시로 날짜 입력 검증 오류, CSV 열 처리, 작은 화면의 표시 문제, 반복된 함수 정리 등을 생각할 수 있습니다. 인증 체계 전체 변경이나 여러 서비스에 걸친 수정은 첫 시험에서 범위를 통제하기 어렵습니다.
프로젝트 형식과 크기를 먼저 확인하세요
Wissly Code 베타는 UTF-8 텍스트 파일을 읽으며, EUC-KR 파일과 200KB가 넘는 파일은 건너뜁니다. 프로젝트당 파일 1,000개, 합계 5MB까지 다룹니다. 이 조건은 기존 코드를 읽는 범위에 관한 조건이므로 저장소 전체를 그대로 가져오기보다 필요한 모듈을 준비하세요.
의존성 폴더, 빌드 출력, 큰 생성 파일은 작업 대상에서 제외하고, 소스 코드와 설정 파일, 개발 문서, 테스트를 중심으로 구성합니다. 파일을 제외할 때는 빌드나 테스트에 필요한 정보가 빠지지 않았는지 확인합니다. 원본 저장소를 변경하기보다 별도 작업 사본을 준비하면 검토와 되돌리기가 쉽습니다.
코드와 함께 짧은 개발 문서를 넣으세요
| 문서 항목 | 적을 내용 |
|---|---|
| 모듈 역할 | 무엇을 입력받아 무엇을 출력하는지 |
| 실행 방법 | 사용하는 언어·버전·실행 명령 |
| 테스트 방법 | 확인 명령과 필요한 테스트 데이터 |
| 변경 요청 | 고칠 문제와 기대 동작 |
| 경계 | 수정할 파일 범위와 유지할 인터페이스 |
| 알려진 제약 | 접근 불가 시스템, 준비하지 않은 패키지 |
예시로 “CSV의 날짜가 비어 있으면 해당 행을 오류 목록에 넣고 나머지 행 처리는 계속한다”처럼 동작을 적습니다. “안정적으로 개선”처럼 추상적인 표현은 결과를 확인하기 어렵습니다.
수정 전에 현재 동작을 기록하세요
기존 테스트와 실행 방법을 먼저 확인합니다. 이미 실패하는 테스트가 있으면 변경과 관련된 문제인지 구분하세요. 오류를 고치는 작업에서는 입력과 오류 메시지, 재현 절차를 남깁니다.
Node.js 프로젝트라면 npm ci의 설치 조건처럼 잠금 파일과 실행 환경에 맞는 설치 절차를 확인할 수 있습니다. 폐쇄망에서는 명령 자체가 맞아도 필요한 패키지를 가져올 수 있는지 별도로 준비해야 합니다.
요청을 분석·수정·검토로 나누세요
먼저 관련 파일의 역할과 흐름을 설명하도록 요청합니다. 다음에는 변경 범위와 완료 조건을 확인한 뒤 수정하도록 합니다. 작업이 끝나면 변경된 파일과 테스트 결과를 사람이 검토합니다.
예시 요청은 다음과 같습니다.
CSV 처리 모듈에서 날짜가 빈 행을 오류 목록으로 분리해 주세요. 기존 출력 열 이름은 유지하고, 날짜가 비어 있는 경우와 정상인 경우를 각각 확인해 주세요. 변경할 파일과 실행 결과를 보여 주세요.
Wissly Code에서는 파일별 변경과 앱 미리보기를 확인할 수 있습니다. 미리보기에서 화면이 열리는 것과 업무 규칙이 맞는 것은 따로 검사하세요. 수정한 기능의 정상·오류 입력을 실행하고 관련 기존 기능도 확인합니다.
검토한 변경을 원본 프로젝트에 반영하세요
파일 차이를 확인하면서 요청 밖의 설정 변경, 불필요한 패키지 추가, 하드코딩된 값, 비밀정보가 포함되지 않았는지 살펴봅니다. 변경 의도와 테스트 결과를 팀의 코드 리뷰 절차에 맞춰 기록하세요.
Wissly Code는 CI/CD 설정, Dockerfile, 배포·롤백 스크립트를 작성하고 프로젝트 빌드와 테스트를 도울 수 있습니다. 실제 이미지 빌드와 운영 배포·롤백은 검토 후 사내 CI/CD에서 진행합니다.
다음 작업에는 첫 작업에서 확인한 실행 방법과 검토 기준을 재사용합니다. 필요한 준비 사항은 폐쇄망 도입 가이드에서, 제품의 작업 흐름과 베타 이용은 Wissly Code에서 살펴볼 수 있습니다.