AI 개발 워크플로우: 계획부터 학습까지 (Plan-Build-Review-Teach)

실용적 조언

자격 증명을 환경 변수 파일에 수동으로 관리하는 대신 UI를 통해 구성할 수 있는 시스템을 구축하여 유지보수성을 높일 것.
AI에게 코딩을 맡기기 전 백엔드, 프런트엔드, DB 모델, 보안 규칙을 별도 폴더에 구조화하여 'Source of Truth'를 만들 것.

섹션별 상세

네트워크 엔지니어로서 업무 자동화를 위해 AI를 도입했으나 보안(AAA, RBAC) 및 설계 지식 부족으로 복잡한 프로젝트에서 한계에 부딪혔다. AI가 생성한 코드를 무비판적으로 수용할 때 발생하는 버그와 보안 팀의 거부감을 해결하기 위해 기존 엔터프라이즈 도구의 구조를 분석하기 시작했다. 이를 통해 단순한 스크립트 작성을 넘어 시스템적인 접근이 필요함을 깨닫고 새로운 워크플로우를 고안했다. 실무에서는 지식 부족이 AI의 잘못이 아닌 사용자의 설계 역량 문제임을 확인했다.

'Plan' 단계에서는 AI를 위한 모든 사양과 제약 조건을 구조화된 파일로 저장하여 프로젝트의 'Source of Truth'로 활용한다. 백엔드, 프런트엔드, API 게이트웨이 등 각 영역별로 프롬프트를 세분화하여 폴더에 관리함으로써 일관성을 유지한다. 이 방식은 채팅창에 직접 프롬프트를 입력할 때 발생하는 문맥 유실 문제를 방지하고 AI가 명확한 가이드라인 내에서 작동하게 한다. 설계 중심의 접근을 통해 코드 수정 시 발생할 수 있는 부작용을 최소화했다.

'Review'와 'Teach' 단계를 도입하여 AI가 작성한 결과물을 검증하고 개발자 본인의 역량을 강화하는 선순환 구조를 만들었다. Review 단계에서 AI는 자신이 구축한 아키텍처를 문서화하고 테스트 케이스를 생성하여 원래 계획과의 일치 여부를 확인한다. Teach 단계에서는 프로젝트에 사용된 알고리즘과 디자인 패턴을 교육 자료로 변환하여 개발자가 코드를 깊이 있게 이해하도록 돕는다. 이는 AI를 단순한 도구가 아닌 기술적 성장을 돕는 멘토로 활용하는 전략이다.

용어 해설

AAA (인증, 권한 부여, 계정 관리)(AAA): — 네트워크 보안에서 사용자 인증(Authentication), 권한 부여(Authorization), 계정 관리(Accounting)를 수행하는 프레임워크이다. AI 개발 시 보안 요구사항을 충족하기 위해 필수적으로 고려해야 하는 요소이다.
역할 기반 액세스 제어(RBAC): — 사용자의 역할에 따라 시스템 리소스에 대한 접근 권한을 차단하거나 허용하는 보안 모델이다. 주니어 개발자가 AI로 복잡한 앱을 만들 때 간과하기 쉬운 핵심 설계 요소이다.
API 게이트웨이(API Gateway): — 클라이언트의 요청을 받아 적절한 서비스로 라우팅하고 인증 및 속도 제한을 관리하는 단일 진입점이다. 시스템의 복잡성을 관리하고 보안을 강화하는 아키텍처 패턴으로 활용된다.
단일 진실 공급원(Source of Truth): — 데이터나 설계 사양을 단 한 곳에서만 관리하여 정보의 일관성을 보장하는 원칙이다. AI 워크플로우에서 구조화된 파일로 계획을 관리함으로써 프롬프트의 혼선을 방지한다.

언급된 도구

Python중립

네트워크 자동화 및 도구 개발 언어

React중립

프런트엔드 UI 개발 라이브러리

Flask중립

백엔드 API 서버 프레임워크