하네스의 물리적 구조는 오케스트레이터(CLAUDE.md), 전문 에이전트 정의(agents/.md), 스킬 파일(skills//skill.md), 상태 추적(feature-list.json, progress.md)의 네 계층으로 구성된다. 각 파일은 독립적이지 않고 서로 참조·연결되어 하나의 시스템을 이루며, 에이전트가 역할을 나누고, 규칙을 따르고, 일관된 품질을 유지하며 작업할 수 있는 환경을 만든다.
Claude Code의 .claude 디렉토리는 글로벌(~/.claude/)과 프로젝트(.claude/) 두 레벨로 나뉘며, CLAUDE.md(지침), settings.json(설정), commands·agents·skills·hooks·rules(확장), projects·file-history·todos(런타임 데이터)로 구성된다. ~/.claude.json과 .mcp.json은 디렉토리 밖에 별도로 존재하며, 엔터프라이즈 관리형 설정은 OS별 시스템 경로에 배포된다. 설정 우선순위는 엔터프라이즈 > 로컬 > 공유 > 글로벌 순이다.
Claude Code 사용 시 직접 요청과 스킬의 차이를 설명하고, 스킬 구현 방법(MCP, Python, Bash 등)의 선택 기준을 정리한 가이드
AI 자동화 구축에 필요한 핵심 개념(에이전트, MCP, 스킬, 워크플로우)의 관계를 정리하고, 환경별(Claude Code, n8n + Claude, 직접 개발) 개발 전략을 비교한다. 탑다운과 바텀업을 조합한 개발 방법론과 재사용 가능한 MCP/스킬 설계 원칙을 다룬다.