Harness Map — Development skill for Claude Code

harness-map

Claude Code 하네스를 읽어 한 장의 조립도로 보여 주는 도구이다.

하네스는 모델을 둘러싼 설정 전체를 말한다. 지시 파일(CLAUDE.md), 자동 기억, 도구(MCP, 스킬), 권한, 훅이 여기에 들어간다. 같은 설정을 쓰더라도 어느 폴더에서 Claude Code 를 시작하는지, 새 에이전트를 어떤 방식으로 띄우는지에 따라 모델이 실제로 받는 내용이 달라진다. 이 도구는 그 차이를 폴더별, 띄우는 방식별로 보여 준다.

에이전트에게 맡기기

Claude Code 같은 코딩 에이전트에 아래 문장을 붙여 넣는다. 폴더 경로는 자기가 자주 작업을 시작하는 곳으로 바꾼다.

https://github.com/Dominic-DK/harness-map 의 README 를 읽고 "직접 실행" 순서대로 실행해 줘.
내가 자주 작업을 시작하는 폴더는 ~/work/a 와 ~/work/b 야.
3단계의 에이전트 점검은 안내에 적힌 안전 규칙을 지켜서 직접 수행하고 기록해 줘.
끝나면 만들어진 harness-map.html 을 브라우저로 열고, 결과를 쉬운 문어체로 다섯 문장 안팎으로 요약해 줘.

직접 실행

Python 3 가 필요하다. 추가 패키지는 필요 없다.

git clone https://github.com/Dominic-DK/harness-map.git
cd harness-map

# 1. 하네스를 읽어 harness.json 으로 저장한다. --cwd 는 원하는 만큼 반복할 수 있다.
#    설정 파일 읽기와 대화 기록 집계로 할 수 있는 점검도 이때 함께 수행한다.
python3 harness-map.py --cwd ~/work/a --cwd ~/work/b -o harness.json

# 2. 에이전트가 직접 해야 하는 점검의 절차와 안전 규칙을 출력한다.
python3 harness-map.py --probe-plan

# 3. (에이전트) 2단계의 안내대로 점검을 수행하고 결과를 probes.json 에 기록한다.
#    점검을 건너뛰어도 된다. 수행하지 않은 점검은 "미점검"으로 표시되고 레벨 계산에서 빠진다.

# 4. 점검 결과를 합쳐 다시 계산한다.
python3 harness-map.py --cwd ~/work/a --cwd ~/work/b --probes probes.json -o harness.json

# 5. 화면을 만들고 브라우저로 연다. (Linux 는 xdg-open, Windows 는 start)
python3 build.py harness.json
open harness-map.html

`--cwd` 를 생략하면 현재 폴더 하나만 조사한다. 대화 기록 집계 기간은 기본 30일이며 `--days` 로 바꿀 수 있다.

실행할 때 알아둘 것

• Claude Code 를 쓰는 그 사용자 계정으로 실행한다. 스크립트가 읽을 수 있는 범위는 Claude Code 가 읽는 범위와 같다.
• 관리자 권한(sudo)으로 실행하지 않는다. 관리자 권한으로 실행하면 홈 폴더가 바뀌어 다른 사용자의 설정을 읽게 되므로, 스크립트가 실행을 거부한다.
• 상위 폴더에서 한 번 실행한 결과로는 하위 프로젝트의 설정을 알 수 없다. 설정은 시작 폴더에서 위쪽 방향으로 결정되기 때문이다. 보고 싶은 폴더를 --cwd 로 각각 지정한다.
• 읽을 권한이 없는 파일은 결과의 unreadable 목록에 따로 적힌다. 그 파일은 Claude Code 도 읽지 못한다.

읽는 것과 남기지 않는 것

스크립트는 파일을 읽기만 하고 어떤 설정도 바꾸지 않는다.

대상	결과에 남기는 것	남기지 않는 것
CLAUDE.md, rules	경로, 줄 수, 읽히는 시점	본문
설정 파일	권한 모드, 규칙 개수, 환경변수 이름	환경변수 값, 규칙 내용
훅	이벤트, 출처, 실행 파일 이름	명령 인자, 경로
MCP 서버	이름, 출처	명령, 인자