공개된 skill을 사용하여 Claude의 하네스(Harness)를 설정해 보기

서론

공개된 skill을 조합하면 하네스(Harness)를 만들 수 있지 않을까? 라는 생각에 내용을 정리해 보았습니다.

본 기사에서 다루는 「공개된 skill」은 다음 3가지를 대상으로 합니다.

• Claude Code에 내장된 것 (/init 등 기본적으로 사용 가능)
• 공식 플러그인에 등록된 것 (anthropics/claude-plugins-official 하위)
• 유명한 서드파티(Third-party) 제품 (Anthropic 외의 개발자가 공개한 플러그인)

전제

• Claude Code CLI

하네스(Harness)란 무엇인가

하네스는 이 기사에서 설명하는 개념을 참고하고 있습니다.

기사에서는 하네스를 두 종류로 나누고 있습니다.

종류	타이밍	역할	구체적인 예시
가이드 (guide)	동작 전	미리 방향을 설정함	CLAUDE.md, skill, MCP, hooks
센서 (sensor)	동작 후	결과를 감지하여 수정함	자동 테스트, lint, 타입 체크, AI 리뷰, hooks

참고로, 이 기사에서 다루는 skill은 거의 모두 가이드 (guide) 측입니다. 센서 측 (자동 테스트, lint, 타입 체크, CI 등)은 기존의 소프트웨어 개발 프랙티스(Practice)를 그대로 유용하면 되므로, 여기서는 특별히 다루지 않습니다. Claude에게 전달할 컨텍스트(Context)나 방향 설정 부분(=가이드)이야말로 AI 코딩 특유의 부분이기 때문에, 그 부분을 중점적으로 다룹니다.

① 초기 설정

/init (내장)

프로젝트를 읽어 들여 CLAUDE.md의 초안을 만들어 줍니다. 빌드나 테스트 명령, 디렉토리 구성, 코딩 규약 등이 작성됩니다. 최근 업데이트로 skill이나 hooks도 추가해 주게 되었습니다.

새로운 프로젝트에 들어갔다면, 우선 이것을 실행하면 된다고 생각합니다. 호출은 명령어를 입력하기만 하면 됩니다.

/init

claude-code-setup (공식 플러그인)

코드베이스를 분석하여, MCP · skill · hooks · subagent · slash command의 5개 카테고리로 「무엇을 넣으면 좋을지」를 제안해 줍니다. /init과 겹치는 부분도 있지만, 더욱 폭넓은 범위에서 설정해 줍니다.

이것도 명령어를 입력하기만 하면 됩니다.

/claude-code-setup:claude-automation-recommender

② 개발

superpowers (플러그인)

AI에게 갑자기 코드를 작성하게 하면, 생각한 구현과 다르거나 수정 작업(rework)이 커지기 쉽습니다.

superpowers는 「대화로 설계를 이끌어냄 → 계획으로 구체화 → 서브 에이전트(subagent)가 TDD로 구현」

이라는 단계적인 워크플로우(Workflow)를 skill로서 제공하는 플러그인입니다.

GitHub 스타 수도 많고 실적도 있으므로, 처음에는 이것을 그대로 사용하는 것을 추천합니다.

익숙해지면 자신의 취향에 맞춰 어레인지(Arrange)해 나가면 됩니다.

호출은 명령어로 해도 되고, 대화로 해도 됩니다.

신기능을 만들 때는 「설계 대화 → 구현 계획 → 실행」의 3단계로 진행합니다.

버그 조사를 할 때는 그것과는 별개의 독립된 skill (systematic-debugging)을 사용합니다.

그 외에도 개발에 도움이 되는 skill들이 들어 있으므로, 그것들도 사용해 보면 재미있을 것입니다.

상황	명령어	하는 일
설계 대화	/superpowers:brainstorming	질문을 통해 요구사항과 방향성을 이끌어냄
구현 계획	/superpowers:writing-plans	TDD로 구현할 수 있는 입도(granularity)의 태스크 목록을 만듦
구현	/superpowers:subagent-driven-development	서브 에이전트가 TDD + 리뷰로 구현
버그 조사	/superpowers:systematic-debugging	재현 → 가설 → 검증 → 근본 원인의 4단계

③ 개선

초기 설정뿐만 아니라, 사용하면서 개선하는 것도 중요합니다. 그것들에 사용할 수 있는 skill도 적어 두겠습니다.

/fewer-permission-prompts (내장)

명령을 실행할 때마다 "이거 실행해도 돼?"라고 물어보는 것이 번거로워지기 시작합니다.

이 스킬은 과거 이력을 보고, 반복적으로 허가해 온 안전한 명령을 허가 목록(allowlist)에 추가하도록 제안해 줍니다.

정기적으로 실행하는 것이 좋습니다.

/fewer-permission-prompts

/insights

(내장)

최근 Claude Code의 사용법을 분석하여 HTML로 리포트를 생성해 줍니다. 어디에서 작업이 되돌아가는(rework) 경우가 많은지, 지시의 습관, 그리고 "CLAUDE.md에 이렇게 추가하면 좋다"라는 제안이 적혀 있습니다.

/insights

리포트를 읽는 것뿐만 아니라, 그 HTML을 그대로 Claude에게 전달하여 개선안을 내게 하는 것도 추천합니다.

이 리포트를 읽고, CLAUDE.md의 개선안을 내줘
(HTML을 붙여넣기 또는 첨부)

claude-md-management (공식 플러그인)

CLAUDE.md를 채점하고 개선안을 제시해 줍니다.

CLAUDE.md는 방치하면 점점 비대해지거나, 실제 코드베이스와 괴리가 생기게 됩니다.

정기적으로 실행하여 정리합니다.

/claude-md-management:claude-md-improver

일상적인 세션 속에서의 막힘이나 발견을 그때마다 학습해 나가는 것도 중요합니다.

세션 마지막에 실행하면, 발견한 명령어나 환경 고유의 정보를 CLAUDE.md에 추가해 줍니다.

/claude-md-management:revise-claude-md

요약

지금까지 살펴본 스킬들은 기본적으로 규칙을 추가해 나가는 방향입니다.

불러오는 규칙 = 컨텍스트 (Context)가 너무 많아지면, 반대로 Claude의 성능이 떨어지는 경우도 있습니다.

따라서 스킬의 제안을 그대로 채택하기보다는, **"이 규칙이 없으면 Claude가 똑같은 실수를 반복할 것인가?"**라는 관점에서 정밀하게 검토하고, 정기적으로 정리(inventory check)하는 것이 중요하다고 생각합니다.

Discussion