소프트웨어 3.0 시대를 맞이하며

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 구조로 필요한 지식만 불러오게 하세요.