Stepping into the Software 3.0 Era

Software 3.0 시대의 Claude Code 구성 요소가 낯선 개발자를 위해, 글은 이를 익숙한 계층형 아키텍처에 빗대어 설명합니다. 슬래시 명령은 컨트롤러, 서브에이전트는 서비스 계층, 스킬은 SRP를 따르는 도메인 컴포넌트, MCP는 외부 시스템을 연결하는 어댑터로 볼 수 있으며 기존 설계 원칙도 그대로 적용됩니다. 다만 에이전트는 Human-in-the-Loop 방식으로 불확실한 상황에서 멈춰 질문할 수 있고, 토큰을 메모리처럼 관리하며 스킬을 점진적으로 공개해야 한다는 점은 새롭게 고려해야 합니다. 명확하고 반복 가능한 일은 자동화하고 위험하거나 판단이 필요한 일은 사용자에게 묻도록 설계하는 것이 핵심입니다.

• Claude Code의 구성 요소는 기존 계층형 아키텍처에 대응시켜 이해할 수 있습니다: 슬래시 명령은 컨트롤러, 서브에이전트는 서비스 계층, 스킬은 단일 책임 컴포넌트, MCP는 어댑터입니다.
• 삭제·배포처럼 되돌리기 어렵거나 위험한 작업은 에이전트가 실행 전에 사용자에게 확인하도록 설계하세요.
• CLAUDE.md와 스킬 설명도 컨텍스트 토큰을 소비하므로, 지침이 읽게 될 파일 범위를 점검하고 결정론적 작업은 스크립트로 옮기세요.
• 스킬을 지나치게 잘게 나누기보다 하나의 진입점에서 필요한 참고 자료만 불러오는 점진적 공개 구조를 활용하세요.