patrick-work-harness — 이 저장소에서 작업할 때

이 저장소는 하네스 엔진(공개 저장소)이다. 스킬(skills/)·훅(hooks/)·설치(install.sh)· 동기화(sync-from-source.sh)·문서가 작업 대상이다. 설치는 skills/·hooks/만 복사하므로 이 파일은 사용자에게 배포되지 않는다.

작업 범위

• 이 저장소에서 연 대화의 「현황」「남은 할 일」「검증」은 이 저장소를 뜻한다 — 브랜치·미푸시 커밋·시험 결과·열린 이슈·CHANGELOG.md [Unreleased].
• 상위 폴더의 진입 문서(AGENTS.md 등)나 하네스를 쓰는 프로젝트의 세션 문서 (SESSION_INDEX.md·CURRENT_SESSION.md·마스터 플랜)는 그 프로젝트의 작업 목록이다. 사용자가 명시하지 않으면 그 목록을 따라 다른 저장소를 고치거나 실행하지 않는다. 왜: 엔진에서 연 대화가 그 목록을 따라 제품 저장소 세션을 진행한 일이 있었다(2026-10-15).
• 로컬 훅 배선(.claude/settings.local.json, 커밋하지 않음)이 그 프로젝트의 훅·문서를 가리킬 수 있다. 그 훅이 그 프로젝트 문서 때문에 응답을 막으면, 그 프로젝트 세션을 시작하지 말고 사용자에게 알린다.

검증

• 전체 시험: python3 hooks/run_all_tests.py </dev/null — stdin 을 비워야 한다(파이프에서 멈춘 적이 있다). 결과 끝줄 「✅ N건 전건 통과 · 수집 누락 0」.
• 깨끗한 환경 재확인: python:3.12-slim 컨테이너에 이 저장소를 읽기 전용으로 붙이고 git 을 설치한 뒤 같은 명령(test_test_tampering_guard 가 git 을 쓴다).
• 대시보드 변경은 시험만으로 부족하다 — 실제 세션 문서 사본으로 렌더링해 화면을 본다 (DASHBOARD_SYNC_BASE=<사본 폴더> python3 hooks/session-dashboard-sync.py).
• 시험 기대값을 바꾸는 것은 동작을 바꿀 때뿐이다. 수정 전 실패·수정 후 통과를 함께 확인한다.

하네스 변경 규칙

• 규칙을 넣는 형태는 싼 것부터 고른다: 스킬 절차 → 스크립트 → 훅. 상시 문장(HARNESS 영역· CLAUDE.md)은 마지막이고, 하나를 넣으면 하나를 뺀다.
• 훅은 분명한 문구가 반복해서 무시된다는 증거가 있을 때만 둔다. 정당한 완료를 막지 않는다 (연속 차단 한도로 풀린다). 오탐만 내고 정탐이 없는 가드는 뺀다.
• 변경마다 DECISION_LOG.md 에 결정·근거·예측·확인 시점을 남긴다. 「바꾸지 않음」「보류」도 결정이다.
• 파일 간 일관성(제품명·은퇴 스킬·없는 파일 참조)은 hooks/test_engine_lint.py 가 잡는다 — 같은 종류의 결함을 문구로 다시 고치지 말고 린트 규칙을 늘린다.

커밋·공개

• 메시지: 한국어 Conventional Commits 타입(범위): 한글 제목 (hooks/commit-msg-guard.py).
• 공개 저장소다 — 개인 절대경로·호스트명·내부 프로젝트명을 코드·문서·커밋에 넣지 않는다.
• 공개판 스킬은 소스 사본의 일반화된 상위 집합이다. 소스 스킬을 통째로 복사하지 않고 골라서 옮긴다(sync-from-source.sh 머리 주석).
• 사용자에게 보이는 변경은 CHANGELOG.md [Unreleased] 에 남긴다. 푸시·릴리스는 사용자 지시로만.