AI 엔지니어링 스킬 맵: 코딩 에이전트 마스터하기

핵심 AI 엔지니어링 스킬 중 하나는 코딩 에이전트를 활용하는 것입니다. 코드를 작성하고, 데이터 분석이나 시스템 운영 관리와 같은 비코드 작업을 수행하도록 에이전트를 능숙하게 이끄는 능력은 훨씬 더 많은 성과를 가능하게 합니다.

코딩 에이전트의 빠른 진화 속도는 이 스킬 역시 다른 최상위 AI 엔지니어링 스킬보다 더 빠르게 진화하고 있음을 의미합니다. 독점 에이전트(예: Claude Code, Codex, Cursor)와 오픈 에이전트(예: OpenCode, Pi)는 하네스와 모델 개선을 통해 비약적으로 발전하고 있습니다. 따라서 코딩 에이전트 사용법을 따라잡으려면 지속적인 실험, 구축, 학습 과정이 필요합니다.

수십 명의 최고 AI 엔지니어를 인터뷰하고 자체 팀의 코딩 에이전트 사용을 되돌아본 결과, 에이전트를 활용한 소프트웨어 구축을 위한 일관된 고수준 워크플로우를 발견했습니다. 주요 단계는 다음과 같습니다.

계획(Planning). 여기에는 (i) 연구, 실험, 기존 코드베이스(있는 경우) 이해를 포함할 수 있는 브레인스토밍과 (ii) 요구사항, 기술 설계, 아키텍처를 담은 명세서(spec) 작성 후 실행 계획 수립이 포함됩니다. 또한 계획을 검토하여 주요 가정을 분석하고 보안, 과도한 엔지니어링, 기타 문제점을 확인할 수도 있습니다.
실행(Execution). 에이전트의 자율성과 사람의 감독 사이에서 적절한 균형을 유지하며 구축, 테스트, 검증을 수행합니다. 여기에는 (i) 적절한 수준의 에이전트 자율성으로 소프트웨어를 구축하도록 하고 (ii) 자동화 및/또는 사람의 확인을 통해 그 결과물을 검증하는 것이 포함됩니다.
배포 및 모니터링(Deployment and monitoring). 여기서는 (i) CI/CD 파이프라인이나 추가적인 사람의 승인 단계를 통해 배포하고 (ii) 에이전트를 사용하여 로그를 감시하고, 문제를 표면화하며, 개선 사항을 제안하고 실행합니다.

이 고수준 워크플로우는 코딩 에이전트 이전에 소프트웨어를 구축할 때 일반적으로 사용되던 방식과 유사합니다. 이제는 코드 자체에 훨씬 덜 집중하고, 대신 무엇을 구축할지 결정하고, 아키텍처를 설계하며, 명세서를 작성하고, 결과물을 검증하는 데 초점을 맞춥니다.

각 단계의 소요 시간은 프로젝트에 따라 크게 달라질 수 있으며, 일부 단계는 생략될 수도 있습니다. 예를 들어, 그린필드(처음부터 새로 구축) 프로토타입의 명세서는 빠르게 작성된 프롬프트에 느슨하게 설명될 수 있는 반면, 사용자가 많은 브라운필드(기존) 프로젝트의 명세서는 작성하고 검증하는 데 훨씬 더 많은 노력이 필요할 수 있습니다. 또한 워크플로우는 매우 반복적이며, 숙련된 개발자는 이후 단계의 피드백이 이전 단계로 되돌아가야 하는 시점을 알고 있습니다. 예를 들어, 검증에 실패하면 에이전트를 안내하여 재구축하고 오류를 수정하는 방법을 알거나, 모니터링에서 문제가 발견되면 에이전트가 시스템을 업데이트하고 재배포하도록 하는 방법을 알고 있습니다.

이 워크플로우에서 코딩 에이전트를 효과적으로 사용하기 위한 핵심 스킬은 다음과 같습니다.

워크플로우 지시하기
에이전트 자율성 활성화하기
작업 검토하기
에이전트 및 환경 사용자 정의하기
코딩 에이전트 기초

워크플로우 지시하기. 위 워크플로우의 각 단계를 탐색하는 방법을 알고 있습니다. 여기에는 각 단계에 얼마나 많은 사람의 노력과 에이전트의 노력을 투입할지, 그리고 언제 이전 단계로 돌아가 반복할지 결정하는 것이 포함됩니다. 속도, 비용, 기술적 위험, 인적 노력 간의 트레이드오프를 깊이 이해하여 사전에 얼마나 많은 연구와 계획을 할지, 중요한 작업에 대해 언제 사람의 소유권을 유지할지, 아키텍처를 선택하는 방법, 계획 산출물(예: 명세서)에 얼마나 많은 세부 사항을 작성할지, 그리고 작업을 검증 가능한 단계로 분해하는 방법을 결정할 수 있어야 합니다.

에이전트 자율성 활성화하기. 워크플로우의 단계에 코딩 에이전트를 적용할 때 자율성 수준을 선택합니다. 에이전트를 지켜보며 대화형으로 반복할 것인지, 아니면 더 큰 작업 덩어리를 위임할 것인지 결정합니다. 그리고 언제 명확한 목표를 설정하고 성공할 때까지 반복하도록 할지도 결정합니다. 또한 에이전트를 위해 컨텍스트를 신중하게 관리해야 합니다. 빌드가 여러 단계를 거치면서 주요 학습 내용, 사용자 피드백, 가정(빌드 도중 변경된 가정 포함)이 에이전트가 이후에 사용할 수 있도록 캡처되도록 보정합니다. 또한 작업을 분해하여 여러 에이전트를 병렬로 실행하도록 설정할 시점(사람이나 상위 에이전트가 이러한 다른 에이전트를 조정하도록 하거나)과 동시 에이전트 세션 전반에 걸쳐 사람의 주의를 관리하는 방법을 결정합니다. 또한 권한을 설정하고 작업을 적절히 제한하여 개발을 빠르게 진행하면서도 유출, 데이터 손실 또는 기타 손상의 위험을 제한하는 등 에이전트를 안전하게 실행하는 방법을 알고 있습니다.

작업 검토하기. 코딩 에이전트의 결과물은 불확실합니다. 에이전트가 어떤 좋은 아이디어를 떠올릴지, 어떤 버그를 구현할지 미리 알 수 없습니다. 결과물을 검토하고 검증하는 것은 원하는 결과를 얻고 있는지 확인하고, 그렇지 않을 경우 에이전트의 방향을 전환하기 위한 핵심 단계입니다. 작업에 맞는 테스트 및 검증을 설계하고 필요에 따라 행동 검증과 기능 검증을 모두 적용합니다. 또한 사용자 흐름을 테스트하고, 에이전트가 성공 또는 실패의 증거로 스크린샷을 제공하도록 할 수도 있습니다. 정성적/행동적 평가를 위해 LLM-as-a-judge와 같은 평가 세트를 사용할 수 있습니다.

또한 이러한 테스트 중 얼마나 많은 부분을 자동화할지 결정해야 합니다. 일부 워크플로우는 모든 테스트와 검증이 완전히 자동화되어 에이전트가 자신의 작업을 확인하고 작업 완료 시점을 알 수 있습니다. 테스트가 목표와 일치하는지 평가하고, 그렇지 않으면 발전시켜야 합니다. 또한 에이전트 코드 리뷰를 사용하고 AI 기반 보안 및 아키텍처 감사를 실행합니다. AI 리뷰만으로 충분하지 않은 경우, 이 리뷰를 더 자동화하는 방법을 모색하면서 코드 동작(드물게 코드 자체도)에 대한 사람의 리뷰를 신중하게 삽입합니다. 마지막으로 배포를 검증하고 에이전트를 통해 모니터링 및 인시던트 관리를 운영화할 수 있습니다.

에이전트 및 환경 사용자 정의하기. 에이전트와 에이전트가 작업하는 환경을 모두 업데이트하는 능력을 통해 에이전트가 필요한 컨텍스트를 효율적으로 얻고, 도구에 액세스하며, 정확하고 효율적으로 구축할 수 있습니다. 에이전트 스킬, 플러그인, MCP 서버를 통합하는 방법을 알고 있습니다. 필요하지 않게 되면(예: 새 모델이 이전 스킬을 불필요하게 만들 때) 이를 정리하기도 합니다. 자동화된 코드 리뷰나 CI/CD 파이프라인 트리거와 같은 개발 프로세스의 반복 가능한 부분을 자동화하기 위해 훅을 사용할 수 있습니다. 또한 에이전트가 작업하는 환경을 유지 관리할 수 있습니다. 즉, 코드베이스, 주요 아키텍처 가정, 코드 스타일, 데이터 액세스 패턴에 대한 정보로 상시 컨텍스트(예: AGENTS.md 또는 CLAUDE.md)를 업데이트합니다. 여러 세션과 병렬 에이전트에 걸쳐 상태를 보존하고, 시간이 지남에 따라 에이전트 학습 내용을 축적하는 방법(예: 실행 후 회고를 통해 효과적이었던 점과 그렇지 않았던 점을 파악)을 알고 있습니다. 또한 코드베이스를 에이전트가 탐색하기 쉽게 만들기 위해 일관된 규칙과 구조를 설정하고, 때때로 에이전트가 생성한 기술 부채를 정리하는 방법을 알고 있습니다. 팀에서 작업할 때는 여러 개발자의 에이전트 간에 컨텍스트를 조정하는 방법을 고려합니다.

코딩 에이전트 기초. 마지막으로, 전반적으로 좋은 결정을 내리기 위해 코딩 에이전트가 어떻게 작동하는지 잘 이해하고 있습니다. 즉, 코드베이스 검색/검색을 수행하는 방법, 컨텍스트 창을 관리하는 방법, 다양한 작업(예: 도구 호출, MCP 서버 추가 등)이 컨텍스트에 어떤 영향을 미치는지, 에이전트와 하위 에이전트가 상호 작용하는 방법, 그리고 LLM 주변에 하네스를 감싸서 에이전트가 어떻게 구축되는지 이해하고 있습니다. 이는 에이전트를 덜 블랙박스처럼 만들고, 간단한 솔루션을 과도하게 엔지니어링하거나, 명시적인 검증 프로세스 부족으로 인해 엄격함을 잃거나, 목표에 미치지 못하거나, 파일이나 프로덕션 데이터를 손상시킬 위험이 있는 에이전트 행동과 같은 실패 모드를 인식하는 데 도움이 됩니다. 또한 에이전트의 상태를 추론하고 올바른 지시나 컨텍스트를 제공하여 에이전트를 안내하는 데 도움이 됩니다. 그리고 실행을 모니터링할 때 이러한 이해는 에이전트가 올바른 궤도에서 벗어나 개입이 필요할 때를 더 잘 포착할 수 있게 해줍니다.

소셜 미디어에서는 코딩 에이전트 사용법에 대해 지나치게 단순화된 설명이 자주 나온다고 생각합니다. 예를 들어, 에이전트를 몇 시간 동안 자율적으로 실행하여 수백만 또는 수천만 개의 토큰을 소모하는 것이 때로는 유용할 수 있습니다. 하지만 현재로서는 매우 장기적인 작업의 실용적 유용성, 특히 비용 대비 효용이 현실보다 과장되어 있습니다. 대신, 가장 효과적인 코딩 에이전트 사용은 복잡하고 고도로 반복적인 과정이며, 높은 수준의 판단력으로 개입할 수 있을 때 훨씬 더 나은 결과를 얻을 수 있습니다.

코딩 에이전트를 사용하는 능력은 당신을 효과적인 빌더로 만들어 줄 것입니다. 이는 전체 빌드 과정을 주도할 수 있는 위치에 서게 함을 의미합니다. 이에 대해서는 향후 기사에서 더 자세히 다루겠습니다.