Read Original
#AI

한 명의 개발자가 여러 전문가와 일하는 방법: 역할형 AI 에이전트로 AWS 인프라 포털 만들기

한 명의 개발자가 여러 전문가와 일하는 방법: 역할형 AI 에이전트로 AWS 인프라 포털 만들기
01

Summary

4주 걸릴 AWS 인프라 포털을 단 5시간 만에? 한 명의 개발자가 AI 군단을 이끄는 법

만능 프롬프트 한 줄 대신 '역할형 멀티 에이전트'로 설계부터 검증까지 초고속 빌드하기

본 아티클은 여러 AWS 콘솔을 오가며 인프라를 파악해야 했던 문제를 해결하기 위해 '읽기 전용 스냅샷 기반의 인프라 탐색 포털'을 구축한 여정을 다룹니다. 단일 AI에게 전체 의존하는 구조를 탈피하고 분석, 설계, UI, 구현 등 고유의 책임을 지닌 역할형 AI 에이전트 협업 체계를 설계하여 압도적인 개발 생산성을 달성했습니다. 기획부터 E2E 테스트 자동화까지 완비된 실제 작동 포털을 반나절 만에 빌드해 낸 생생한 노하우를 공유합니다.

  • 01화면 통합을 넘어 관계 신뢰도(Confirmed, Inferred)를 체계화한 단일 판단 기준 정의
  • 02쓰기 권한을 원천 차단하고 수집기와 포털의 경계를 완벽히 분리한 Snapshot-first 안전 아키텍처 설계
  • 03업무 범위, 페르소나, 지식, 도구, 예시, 검증 등 6단계 구성을 통한 고도화된 에이전트 팀 구축
  • 04업무 분석부터 테스트 작성까지 앞 단계의 산출물이 다음의 입력이 되도록 정렬한 흐름 기반 협업 구조
  • 05타입 검사, 단위 및 E2E 테스트 로그 등 명확한 증거 기반의 자동화된 완료 조건 검증 게이트 도입

RECOMMENDATION

코딩 에이전트를 단순한 타이핑 도구가 아니라 비즈니스 로직을 온전히 이해하는 동료로 활용하고 싶은 팀에게 추천합니다. 좋은 프롬프트 작성법에 매달리기보다 작업의 경계를 획정하고, 역할 간의 입력과 출력 계약을 정밀하게 설계하는 아키텍처적 접근의 중요성을 가르쳐 줍니다.

The Problem

여러 AWS 콘솔과 CLI 결과를 번갈아 확인하며 인프라 관계를 파악하는 작업이 번거로웠으며, 화면의 통합을 넘어 일관된 판단 기준에 따라 데이터를 연동하여 시각화하고 분석 및 검증하는 솔루션이 부재했습니다. 아울러 이러한 시스템을 기존 방식으로 설계하고 구현하려면 최소 4주에서 6주 이상의 긴 개발 기간이 소요될 것으로 예상되었습니다.

The Solution

하나의 만능 프롬프트 대신 업무 분석, 아키텍처, UI, 프론트엔드, 테스트 등으로 역할을 분담한 '역할형 AI 에이전트 팀' 구조를 설계하여 개발 프로세스를 자동화했습니다. 또한 보안을 위해 실제 인프라 변경이 불가능하도록 설계된 '읽기 전용 Snapshot 기반 아키텍처'를 채택하고, 에이전트의 산출물을 정적 검증 및 테스트로 자동 필터링하는 검증 게이트를 구축했습니다.

The Result

초기 PoC 구현 결과 기존 예상 기간인 4~6주에서 95% 이상 단축된 약 5시간 만에 개발을 완료했으며, 56개 파일과 5,282줄의 코드 생성 및 단위/E2E 테스트 자동화를 달성했습니다. 이를 통해 검색과 실시간 다이어그램 연동, ECR 보안 취약점 식별, AWS 비용 및 예상 절감액을 단일 흐름에서 조회할 수 있는 가시화 포털을 성공적으로 확보했습니다.

Trade-off

해당 성과는 핵심 범위로 대상을 제한한 초기 PoC 단계의 정량적 지표이며, 실제 프로덕션 수준의 보안 검토, 지속적인 데이터 수집기 운영, 실시간 장애 대응 등을 위해서는 추가적인 유지보수 공수가 수반됩니다. 또한 AI 에이전트 특유의 낙관적 완성 보고 문제를 예방하기 위해 사람이 직접 엄격한 검증 게이트와 정적 분석 파이프라인을 사전에 상세히 정의해야 하는 설계 비용이 요구됩니다.

03

Key Concepts

Concept · 01

역할형 AI 에이전트 (Role-based AI Agent)

하나의 거대한 프롬프트에 모든 책임을 부여하는 대신 분석가, 아키텍트, 개발자, 테스터 등 전문적인 역할과 권한을 지닌 독립된 페르소나들로 구성된 협업 아키텍처입니다.

  • 오케스트레이터가 작업을 해석하고 도메인 마스터가 분석, 설계, 프론트엔드 등의 단위로 태스크를 분해함
  • 각 에이전트마다 업무 범위, 가용 도구, 금지 규칙 및 최종 완료 조건을 명확히 설정하여 오작동 방지
Concept · 02

Snapshot 기반 아키텍처 (Snapshot-first Architecture)

웹 애플리케이션이나 클라이언트 브라우저가 실제 클라우드 환경에 직접 접근하지 않고, 사전 수집된 읽기 전용 스냅샷 파일만을 다루도록 분리하여 보안성과 안전성을 보장하는 설계 패턴입니다.

  • Collector만 제한된 권한으로 AWS 데이터를 조회하여 고정된 시점의 Snapshot을 생성함
  • 웹 포털은 이미 생성된 스냅샷 파일만 탐색하도록 제한하여 클라우드 변경 동작이나 자격 증명 유출을 원천 차단
Concept · 03

증거 기반 개발 게이트 (Evidence-based Development Gate)

AI 에이전트가 생성한 결과물에 대해 단순 구두 보고나 낙관적 요약을 불신하고, 정적 분석 및 자동화된 테스트 실행 로그 등 명확한 동작 증거가 수집되어야 승인하는 품질 검증 구조입니다.

  • 코드 생성 완료 판정을 타입 검사 결과, 단위 테스트 로그, E2E 결과물 제출 여부로 자동 필터링
  • 구현을 담당하는 에이전트와 별개로, 요구사항과 보안 경계를 전문적으로 검증하는 독립된 리뷰 에이전트를 배치