spyrae/harness-control-plane

harness-control-plane은(는) 무엇을 하나요?

Claude Code 에코시스템(스킬, 에이전트, MCP 서버)을 .claude/ 설정에서 자동으로 발견하여 대화형 시각적 지도로 보여줍니다.

개요

이 스킬은 현재 프로젝트의 .claude/ 디렉토리를 스캔하여 등록된 모든 스킬(skills), 에이전트(agents), MCP 서버(MCP servers) 를 찾아내고, 이들 간의 관계를 시각적인 대화형 지도로 렌더링합니다. 이를 통해 개발자는 복잡한 에코시스템을 단일 뷰에서 이해하고 탐색할 수 있습니다.

사용 방법

1. 스킬 활성화: 프로젝트의 .claude/skills 디렉토리에 이 스킬을 설치하거나 추가합니다.
2. 명령 실행: Claude Code 세션 내에서 다음 명령어를 입력합니다.

/harness map

또는

Claude, 내 에코시스템 지도를 보여줘.

3. 결과 확인: 현재 디렉토리의 .claude/ 설정을 기반으로 생성된 대화형 그래프가 출력됩니다. 각 노드를 클릭하여 상세 정보를 확인할 수 있습니다.

지원 설정 파일

이 스킬은 다음 파일들을 자동으로 읽습니다:

• .claude/skills/ — 설치된 스킬 목록
• .claude/agents/ — 정의된 에이전트 설정
• .claude/mcp_servers/ — MCP 서버 구성

만약 설정이 YAML 또는 JSON 형식으로 되어 있다면, 해당 형식을 파싱하여 지도에 반영합니다.

예시

# .claude/agents/my-agent.yml
name: my-agent
skills:
  - code-review
  - deploy
mcp_servers:
  - github
  - slack

위와 같은 설정이 있을 경우, 지도에는 my-agent 노드가 code-review, deploy 스킬과 github, slack MCP 서버에 연결된 형태로 표시됩니다.

참고 사항

• 이 스킬은 Claude Code 환경에 최적화되어 있지만, 유사한 디렉토리 구조를 가진 다른 AI 에이전트 플랫폼에서도 동작할 수 있습니다.
• 대화형 지도는 텍스트 기반으로 제공되며, Mermaid.js 다이어그램을 사용하여 CLI에서도 시각적으로 표현됩니다.
• 현재 디렉토리에 .claude/ 설정이 없으면 오류 메시지를 출력합니다.

라이선스

MIT