1.0 출시 일주일 만에, harness-score 1.1.0이 출시되었습니다.

동일한 성숙도 모델 (maturity model). 동일한 체크 ID (check IDs). 동일한 결정론적 스캐너 (deterministic scanner).

두 가지가 변경되었으며, 두 가지 모두 실제 사용 사례에서 비롯되었습니다:

1. 가이드를 이제 영어 (English), 포르투갈어 (브라질) (Portuguese (Brazil)), 그리고 **라틴 아메리카 스페인어 (Latin American Spanish)**로 이용할 수 있습니다.
2. HKS-05가 더 이상 유효한 Claude Code hook 명령 경로를 잘못된 음성 (false-negatives)으로 판정하지 않습니다.

npx harness-score@1.1.0

요약 (TL;DR)

• 문서 (Docs): 언어 전환기가 포함된 /, /pt-BR/, /es/ 경로의 전체 VitePress 가이드 + 랜딩 페이지
• 스캐너 (Scanner): HKS-05가 중괄호가 없는 $CLAUDE_PROJECT_DIR/... 및 node_modules/.bin/ hook 바이너리를 이해함
• 안정성 (Stability): 체크 이름 변경 없음, 점수 모델 (score-model) 변동 없음 — 안전하게 업그레이드 가능
• 여전히: MIT 라이선스, 런타임 의존성(runtime deps) 없음, LLM 호출 없음, CI 게이트(CI-gateable) 가능

harness 엔지니어링에 다국어 문서가 중요한 이유

harness 엔지니어링은 영어로만 이루어지는 대화가 아닙니다.

브라질, 라틴 아메리카, 스페인의 팀들은 현재 Cursor, Claude Code, 그리고 Windsurf를 프로덕션 저장소(production repos)에 연결하고 있습니다. L0 Unharnessed부터 L4 Self-correcting까지의 성숙도 모델은 사람들이 자신이 생각하는 언어로 교정 레시피 (remediation recipes)를 읽을 수 있을 때만 도움이 됩니다.

따라서 1.1.0은 완전히 번역된 동일한 가이드를 제공합니다:

랜딩 페이지, 가이드 챕터, 체크 카탈로그 앵커 (#ctx-01, …), 용어집 (glossary), 그리고 hreflang SEO가 모두 함께 제공됩니다. 헤더에서 언어를 전환하면 홈페이지가 아닌 해당 언어의 동일한 페이지로 이동합니다.

영어 소스가 기준(contract)으로 유지됩니다. 번역본은 이를 추적하며, CI는 로케일 간의 체크 카탈로그 앵커를 동기화 상태로 유지합니다.

Claude Code 오탐 (HKS-05)

HKS-05는 다음과 같이 질문합니다: 당신의 hook이 호출하는 스크립트가 실제로 저장소에 존재합니까?

Claude Code는 프로젝트 상대적(project-relative) hook 명령에 대해 다음 두 가지 보간(interpolation) 형식을 모두 허용합니다:

${CLAUDE_PROJECT_DIR}/.claude/hooks/setup.sh   # 중괄호 사용 (braced) — 이미 작동함
$CLAUDE_PROJECT_DIR/.claude/hooks/setup.sh     # 중괄호 미사용 (unbraced) — 오탐(false negative) 발생했었음

두 형식 모두 유효합니다. 1.1.0 버전 이전에는 파일 시스템 체크 전에 중괄호를 사용한 형식만 처리되었습니다. 만약 hook에서 $CLAUDE_PROJECT_DIR/... 형식을 사용하고 스크립트가 실제로 커밋되어 있었더라도, 여전히 2점을 감점당하고 "스크립트를 커밋하십시오"라는 안내를 받았습니다.

또한 다음 사항도 수정되었습니다: node_modules/.bin/ 경로 아래의 패키지 매니저 바이너리를 호출하는 hook (예: ${CLAUDE_PROJECT_DIR}/node_modules/.bin/block-no-verify). 이들은 git에 포함되지 않아야 하며, npm install을 통해 생성됩니다. 이제 스캐너는 이를 해결된(resolved) 상태로 처리합니다.

Claude Code hook을 사용하면서 HKS-05 오류 때문에 고민 중이었다면: 업그레이드 후 다시 스캔하세요.

npx harness-score@1.1.0 --diff baseline.json

변경되지 않은 사항

1.1은 문서화 및 정확도 개선을 위한 마이너(minor) 업데이트입니다. 새로운 성숙도 단계(maturity ladder)가 아닙니다.

사용해 보기

npx harness-score@1.1.0

L3 단계에서 Gate CI 적용:

- uses: paladini/harness-score/action@main
  with:
    min-level: '3'

사용자의 언어로 가이드를 읽어보세요:

• English
• Português
• Español

링크

• Release: v1.1.0
• Repo: github.com/paladini/harness-score
• npm: harness-score@1.1.0
• Previous: Harness Score 1.0 announcement

다국어 가이드가 도움이 되었거나 — 혹은 HKS-05 문제로 어려움을 겪고 계셨다면 — 댓글로 여러분의 레벨과 사용 중인 툴 스택 (tool stack)을 남겨주세요.