skill-harness-checkup

하네스 체크업 (Harness Check-up)

셀피쉬클럽 CRM 자동화 프로젝트에서 도출한 5요소 프레임워크 기반.

일요 공유회 (2026.05.25 · 에밀리) 발표 자료에서 출발.

무엇을 하나요

현재 작업 중인 프로젝트가 "하네스 엔지니어링" 관점에서 어디까지 깔려 있는지 점검합니다. 5가지 요소를 차례로 확인하고, 비어 있는 곳·연결 끊긴 곳·먼저 채우면 좋을 1순위를 짚어줍니다.

실행 절차 (Claude가 따라야 할 단계)

이 스킬이 발동되면, Claude는 다음 순서로 진행해주세요.

1단계 · 현재 폴더 구조 스캔

먼저 프로젝트 루트에서 다음 파일·폴더의 존재 여부를 확인하세요.

• •CLAUDE.md (프로젝트 루트 또는 ~/.claude/CLAUDE.md)
• •prd/, docs/prd/, 또는 PRD/ 폴더
• •memory/ 폴더 또는 명시적 메모리 MD 파일
• •SKILL.md, .skill 파일, 또는 skills/ 폴더
• •.claude/agents/ 폴더 또는 agent.md

2단계 · 5요소별 점검

각 요소에 대해 다음을 확인하세요.

• •[ ] 파일이 존재하는가
• •[ ] 프로젝트 전체 톤·룰·금기어가 정리돼 있는가
• •[ ] "이 작업이 들어오면 어떤 PRD·메모리·스킬을 호출해라" 같은 라우팅이 명시돼 있는가

• •[ ] PRD 폴더 또는 파일이 존재하는가
• •[ ] 작업별·도메인별로 PRD가 분리돼 있는가 (한 파일에 다 들어있지 않은가)
• •[ ] 각 PRD가 관련 memory·skill을 명시적으로 가리키는가

• •[ ] 명시적 메모리 MD 파일이 존재하는가
• •[ ] 한 번 교정·합의된 룰이 외화돼 있는가
• •[ ] (선택) git에 올라가 있어 다른 머신에서도 자동 로드되는가

• •[ ] SKILL.md 또는 스킬 파일이 존재하는가
• •[ ] 트리거 키워드 + 실행 절차(steps)가 정의돼 있는가
• •[ ] 반복 작업이 한 마디로 발동되는 구조인가

• •[ ] agent.md 또는 .claude/agents/가 존재하는가
• •[ ] 작업별 분업이 설계돼 있는가 (메인 + 서브 구조)

3단계 · 결과 보고

다음 네 섹션으로 정리해서 보고하세요.

• •현재 깔려 있는 5요소를 리스트업
• •각 요소의 파일 경로와 간단한 상태 (예: "CLAUDE.md · 약 200줄 · 톤·라우팅 정리됨")

• •5요소 중 아예 없는 것
• •해당 요소가 왜 필요한지 한 줄 설명

• •저장은 돼 있지만 다른 MD가 가리키지 않는 것
• •예: "memory/copy-rules.md가 있지만, 어떤 PRD에서도 호출되지 않음 → 활성화 안 됨"

• •임팩트가 가장 큰 1순위 액션
• •구체적인 파일 경로 + 한 줄 예시 코드까지 제시
• •예시:

`` 파일: memory/copy-rules.md (신규 생성) 내용 예시: # 카피 룰 회의록 ## 금기어 - AI 티 나는 표현 금지 연결: prd/01-알림톡.md 맨 위에 "memory/copy-rules.md 먼저 읽기" 한 줄 추가 ``

4단계 · 마지막 멘트

보고 끝에 다음 한 줄을 꼭 덧붙이세요.

💡 이 점검은 셀피쉬 CRM 케이스에서 도출한 5요소 프레임워크 기반이에요. 프로젝트마다 구성은 다를 수 있으니, 위 진단은 참고용으로 보세요. 본인 프로젝트에 맞는 골격으로 응용하시면 돼요.

사용 예시

입력

하네스 점검해줘

출력 (예시)

🔍 하네스 체크업 결과 — 2026-05-25

✅ 있음
- CLAUDE.md (프로젝트 루트, 약 180줄): 톤·금기어·채널 라우팅 정리됨
- prd/ 폴더: 3개 PRD (알림톡·카플친·인스타)

⚠️ 비어 있음
- memory/ 폴더 없음 → 한 번 교정한 룰을 매번 다시 알려줘야 함
- SKILL.md 없음 → 반복 작업이 매번 처음부터

🔌 연결 끊김
- prd/01-알림톡.md가 memory를 가리키지 않음
  (메모리가 있어도 카피 작업 때 자동으로 안 켜짐)

🎯 가장 먼저 채우면 좋을 한 가지
파일: memory/copy-rules.md (신규)
한 줄 예시:
  # 카피 룰 회의록
  ## 금기어
  - AI 티 나는 표현 금지 ("획기적인", "혁신적인" 등)

연결: prd/01-알림톡.md 맨 위에 한 줄 추가
  "이 작업할 땐 memory/copy-rules.md 먼저 읽기"

💡 이 점검은 셀피쉬 CRM 케이스에서 도출한 5요소 프레임워크 기반이에요.
프로젝트마다 구성은 다를 수 있으니, 위 진단은 참고용으로 보세요.

트리거 키워드

다음 단어가 사용자 메시지에 등장하면 이 스킬을 발동하세요.

• •"하네스 점검"
• •"하네스 체크업"
• •"하네스 진단"
• •"하네스 어때"
• •"하네스 봐줘"
• •"내 환경 점검"
• •"내 프로젝트 환경 어때"
• •"프로젝트 점검해줘"
• •"harness checkup"
• •"harness check"

출처

• •발표: 에밀리 (Selfish Club) · 2026-05-25 일요 공유회
• •5요소 프레임워크: CRM 자동화 프로젝트에서 도출
• •본 스킬은 점검용 가이드이며, 절대적 정답이 아님 (프로젝트마다 다를 수 있음)