소프트웨어 3.0 시대를 맞이하며
김용성 토스 · 토스 기술 블로그
AI 핵심 요약
Claude Code의 MCP, Skills, Sub-agent, Slash Command를 레이어드 아키텍처의 Adapter, 도메인 컴포넌트, 서비스, 컨트롤러에 대응시켜 익숙한 설계 원칙으로 이해하는 방법을 설명합니다. 다만 에이전트는 실행 중 불확실한 상황에서 사용자에게 질문할 수 있으므로, 예외를 미리 모두 정의하기보다 위험도와 되돌릴 수 있는 정도에 따라 Human-in-the-Loop를 설계해야 합니다. 에이전트에서는 토큰이 작업 메모리처럼 소모되므로 결정적 로직은 스크립트로 옮기고, Skill의 세부 지식은 필요할 때만 불러오는 구조를 권합니다. 도구가 바뀌어도 단일 책임, 추상화, 의존성 관리 같은 엔지니어링 원칙은 유효하다는 것이 핵심 교훈입니다.
- Slash Command는 요청 진입점, Sub-agent는 작업 조율자, Skill은 단일 책임 기능, MCP는 외부 시스템 어댑터로 설계할 수 있습니다.
- CLAUDE.md에는 기술 스택과 코딩 규칙처럼 안정적인 정보만 두고, 작업별 맥락은 대화나 Sub-agent에 전달하세요.
- 되돌리기 어렵거나 위험이 큰 결정은 에이전트가 사용자에게 묻도록 하고, 반복 가능하고 안전한 작업은 자동화하는 편이 좋습니다.
- Context Window를 메모리처럼 관리하고, 판단이 필요 없는 결정적 로직은 스크립트로 분리해 토큰 낭비를 줄이세요.
- Skill은 지나치게 잘게 나누기보다 진입점과 references를 두는 Progressive Disclosure 구조로 필요한 지식만 불러오게 하세요.
소개
레이어드 아키텍처에 익숙한 개발자가 Claude Code를 바라보는 방법
비슷한 학습 자료
책 조쉬 (김승권) 예스24
클로드 에이전트 협업의 기술
책 조쉬 (김승권) 예스24
단순한 도구를 넘어 시스템으로, 나를 대신해 스스로 일하는 AI 팀 만들기 챗GPT와 클로드에게 질문을 던지고 답변을 기다리던 단순한 질문의 시대는 끝났다. 이제는 AI가 스스로 외부 도구를 사용하고, 맥락 속에서 스스로 판단하며, 다른 AI 서브 에이전트에게 업무를 할당하는 ‘멀티 에이전트’의 시대다.이 책은 비주얼 환경인 클로드 코워크부터 터미널 환경인 클로드 코드까지, MCP 연동과 서브 에이전트 지휘 체계를 활용해 멀티 에이전트 팀을 구축하는 방법을 다룬다. 이제부터는 ‘오케스트레이터’가 되어 직접 설계한 AI 팀이 스스로 성과를 내는 업무 자동화를 경험해 볼 차례다.
AI에이전트 개발 로드맵 2개에 담김
책 박승규 예스24
★ AI 에이전트 실전 실무 개발자가 선사하는 ★ 싱글 에이전트부터 멀티 에이전트까지 ★ 60가지 예제로 배우는 실전 개발 비법을 만나자! 이 책은 실무에서 AI 에이전트를 개발하는 저자가 쌓은 모든 노하우를 녹여 LLM을 호출하는 것을 넘어, 복잡하고 유용하며 안전한 멀티 에이전트 시스템을 직접 구축할 수 있도록 돕는다. 오픈AI 에이전트 SDK, 구글 ADK, 랭그래프(LangGraph) 프레임워크를 중심으로 에이전트의 기본 구조, 도구 활용, 안전성 확보를 위한 가드레일, 멀티 에이전트 협업(핸드오프), 상태 관리(체크포인터), 조건부 라우팅, 병렬 처리, 하위 그래프 등 다양한 고급 기법을 설명한다. 또한 최근 뜨거운 감자인 MCP와 A2A 같은 최신 AI 프로토콜도 다룬다. 이 책에서는 「어린왕자 페르소나 챗봇」, 「멀티 에이전트 뉴스 요약 시스템」, 「웹 기반 채팅 에이전트 개발」, 「MCP 서버 구축」, 「마크다운 보고서 생성 에이전트 구현」 등 60여 가지의 실용적인 ...
AI에이전트 개발 로드맵 2개에 담김
책 권경열 예스24
하네스 엔지니어링으로 완성하는 에이전틱 AI
책 권경열 예스24
프롬프트 몇 줄만으로는 부족하다, 코드로 통제하는 AI 에이전트를 만들 차례! 이 책은 ReAct 패턴을 프레임워크 없이 직접 구현하는 것부터 시작해, 모델을 코드로 감싸고 통제하는 ‘하네스 엔지니어링’으로 에이전트를 설계합니다. 툴 사용, 단기·장기 메모리, 컨텍스트 엔지니어링, RAG, 랭그래프 워크플로, 멀티 에이전트 오케스트레이션까지 하나씩 직접 구현하며 원리를 익힙니다. 매일 아침 시장 브리핑을 전송하는 정보 워크플로 에이전트, 스스로 에러를 고치는 자기수정 데이터 분석가, 카메라로 방을 보고 물건을 옮기는 멀티모달 집사 로봇까지, 서로 다른 도메인의 실전 프로젝트 3개를 처음부터 끝까지 완성합니다. 여기서 멈추지 않습니다. 프롬프트 인젝션과 위험한 실행을 막는 보안 가드레일, 비용과 데이터 보안을 고려한 vLLM 기반 로컬 서빙, FastAPI와 AWS Lambda를 활용한 배포, 랭스미스 기반 관측성과 비용 모니터링까지 다룹니다. 잘 작동하는 데모를 넘어, 실제로 일하고...
데브옵스 · 인프라 AI에이전트 개발 보안