My Brother Doesn't Code. Now He Ships Features.

개요

개발자가 아닌 사람이 자연어로 요청하면, AI 에이전트가 코드를 수정하고 기능을 배포하는 시스템이 개발되었습니다. 이 시스템은 Telegram 봇과 Claude Agent SDK를 활용하여 코드 수정 과정을 자동화합니다.

주요 내용

• 문제점: 개발자와 현장 작업자 간의 의사소통 단절로 인해 코드 변경 요청 처리에 시간이 소요되고 오류 발생 가능성이 높았습니다.
• 해결 방안: 개발자를 제외하고 사용자가 자연어로 요청하면 AI 에이전트가 코드를 직접 수정하고 배포하는 시스템을 구축했습니다.
• Telegram 봇 활용: 현장에서 사용하기 쉬운 간단한 채팅 인터페이스를 위해 Telegram Bot API를 사용하여 봇을 개발했습니다.
• 시스템 아키텍처: 사용자가 Telegram으로 메시지를 보내면 API Gateway, Lambda 함수를 거쳐 AgentCore 런타임에서 Claude 모델이 코드를 수정하고, S3/CloudFront에 미리보기(preview)를 배포합니다. 사용자의 승인 후 메인 브랜치에 병합(merge)됩니다.
• Claude Agent SDK: Claude 모델이 파일 읽기, 코드 작성, 쉘 명령어 실행, 오류 반복 수정 등의 기능을 이미 갖추고 있어 개발 부담을 줄였습니다.
• 안정성 확보 (Guardrails): 시스템 프롬프트에 코드 수정 가능 디렉토리, 필수 검증 절차, 배포 전 승인 요구 등 명확한 제약 조건을 설정하여 AI 에이전트의 위험성을 통제했습니다.
• AgentCore: AI 에이전트의 느린 처리 속도를 고려하여, 요청 시 컨테이너를 생성하고 일정 시간 동안 유지하며, 사용자별 세션 유지를 통해 상태를 보존하는 ephemeral compute 환경을 사용했습니다.
• 비동기 처리: Telegram의 빠른 응답 요구사항을 충족시키기 위해 비동기 엔트리포인트를 사용하여 에이전트 작업이 백그라운드에서 실행되도록 했습니다.
• CDK를 통한 인프라 구축: API Gateway, Lambda, AgentCore 런타임, S3/CloudFront, Secrets Manager 등 필요한 모든 인프라를 단일 CDK 스택으로 배포했습니다.

시사점

AI 에이전트는 명확한 제약 조건과 워크플로우를 부여받았을 때, 전문 지식이 없는 사용자도 코드 수정 및 기능 배포 과정을 직접 제어할 수 있도록 지원하는 강력한 도구가 될 수 있습니다.