Stepping into the Software 3.0 Era
김용성 토스 · 토스 기술 블로그
AI 핵심 요약
Software 3.0 시대의 Claude Code 구성 요소가 낯선 개발자를 위해, 글은 이를 익숙한 계층형 아키텍처에 빗대어 설명합니다. 슬래시 명령은 컨트롤러, 서브에이전트는 서비스 계층, 스킬은 SRP를 따르는 도메인 컴포넌트, MCP는 외부 시스템을 연결하는 어댑터로 볼 수 있으며 기존 설계 원칙도 그대로 적용됩니다. 다만 에이전트는 Human-in-the-Loop 방식으로 불확실한 상황에서 멈춰 질문할 수 있고, 토큰을 메모리처럼 관리하며 스킬을 점진적으로 공개해야 한다는 점은 새롭게 고려해야 합니다. 명확하고 반복 가능한 일은 자동화하고 위험하거나 판단이 필요한 일은 사용자에게 묻도록 설계하는 것이 핵심입니다.
- Claude Code의 구성 요소는 기존 계층형 아키텍처에 대응시켜 이해할 수 있습니다: 슬래시 명령은 컨트롤러, 서브에이전트는 서비스 계층, 스킬은 단일 책임 컴포넌트, MCP는 어댑터입니다.
- 삭제·배포처럼 되돌리기 어렵거나 위험한 작업은 에이전트가 실행 전에 사용자에게 확인하도록 설계하세요.
- CLAUDE.md와 스킬 설명도 컨텍스트 토큰을 소비하므로, 지침이 읽게 될 파일 범위를 점검하고 결정론적 작업은 스크립트로 옮기세요.
- 스킬을 지나치게 잘게 나누기보다 하나의 진입점에서 필요한 참고 자료만 불러오는 점진적 공개 구조를 활용하세요.
소개
How a developer fluent in layered architecture makes sense of Claude Code
비슷한 학습 자료
컨퍼런스 SLASH
토스ㅣSLASH 21 - 실무에서 바로 쓰는 Frontend Clean Code
컨퍼런스 SLASH
실무에서 클린 코드의 의의는 유지보수 시간의 단축입니다. 동료 혹은 과거의 스스로 짠 코드를 빠르게 이해할 수 있다면 유지보수할 때 드는 개발 시간이 짧아집니다. 실제 예시와 함께 1. 응집도 2. 단일 책임 3. 추상화 총 세 가지 관점으로 클린코드 방법론을 공유합니다. 진유림 / 토스 Frontend Developer 토스 개발자 컨퍼런스 SLASH에 대한 자세한 정보는 👉🏻 https://toss.im/slash-21 컨퍼런스 및 세션에 대한 문의는 👉🏻 slash@toss.im #토스 #개발자컨퍼런스 #SLASH
프론트엔드
문서 한주연
The Toss Frontend team no longer has to dig through documents to find what they need. We’re building an environment where developers can get immediate answers to their questions through docs and AI. Here’s how we built a new documentation system that lets developers focus entirely on development.
프론트엔드 AI에이전트 개발
문서 김용성
소프트웨어 3.0 시대를 맞이하며
문서 한경훈