도구 업데이트 적응하기
패키지의 핵심 테스트: 도구를 보완하고 개선하며, 의도적으로 선언되고 기본 기능이 명시된 경우가 아니라면 중복되거나 충돌하지 않아야 합니다. 도구 릴리스는 세 가지 방식으로 이 테스트를 위반할 수 있습니다. 규칙이나 메커니즘이 수행하는 기능을 기본적으로 제공하여 규칙이 중복될 수 있습니다. 규칙이 설명하는 동작을 변경하여 규칙이 충돌할 수 있습니다. 또는 규칙이 인용해야 할 기능을 추가할 수 있습니다. 새 모델은 규칙의 모든 사실이 여전히 유효하더라도 규칙의 프롬프트 스타일을 구식으로 만들 수도 있습니다. 이 스킬은 이 네 가지 경우를 모두 찾아 수정합니다.
기본 경로
- 다른 모든 작업보다 먼저
origin/main에서 워크트리(worktree)를 생성하세요. 조사 워크플로는 깨끗한 체크아웃을 읽으므로, 아무도 편집하지 않는 두 번째 워크트리를 가리키도록 하세요. - 기준선을 찾으세요. 마지막으로 조사된 버전과 날짜는
docs/handbook/sources/harness-survey.md의 마지막 날짜 섹션에 있습니다. 최신 재조사 섹션은 연구 기록 디렉토리를 지정합니다. 기록된 모델 사실은docs/handbook/claude-code.md의 "사다리" 단락에 있습니다.npm run check:harness는 해당 기준선과 그 이후의 모든 변경 로그 버전을 출력하며, 예약된harness-watch액션은 목록이 비어 있지 않으면 하나의harness-update이슈를 생성합니다.HARNESS_ROUTINE_URL및HARNESS_ROUTINE_TOKEN시크릿이 설정된 경우, 액션은 클라우드 루틴도 실행합니다. 루틴은 델타 부록 경로를 실행하고claude/harness-addendum-<version>에 대한 초안 PR을 엽니다. 해당 PR이 존재하면, 재분류하는 대신 그 PR부터 시작하세요.claude --version과도 비교하세요. - 무엇을 읽기 전에 새 CLI로 게이트(gate)를 실행하세요: 깨끗한 체크아웃에서
npm run verify를 실행하세요. 플러그인 검증기가--strict플래그로 실행되므로, 릴리스가 추가하는 경고는 게이트를 실패하게 만들고, 변경 로그 분류는 해당 항목을 잡음으로 읽을 수 있습니다. - 델타를 스크래치패드에 수집하세요. 소스당 하나의 에이전트를 할당합니다:
- 기준선 이후의 Claude Code 변경 로그 섹션들 (https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md). 변경 사항에 날짜를 표시하는 유일한 소스입니다.
- 모델 개요 및 모델 구성 페이지. 새 모델, 기본값, 가격, 노력(effort)을 확인합니다.
- 이 리포지토리에 대한 도구 자체의 프롬프트 감사(
/doctor prompt-audit). 오래된 경로, 죽은 명령어, 모순되는 지침, 이전 모델용으로 작성된 프롬프트 패턴을 보고합니다.
- 깊이를 선택하세요. 아래 판단 기준을 사용하세요. 선택한 이유와 함께 어떤 것을 선택했는지 말하세요.
- 분류하고 분류하세요. 모든 후보는 하나의 처분(disposition)을 받습니다: DUPLICATE(중복), CONFLICT(충돌), COMPLEMENT(보완), 또는 UNIQUE(고유) (references/dispositions.md에 정의됨). 규칙 파일,
plugins/house/orchestration/ORCHESTRATION.md, 에이전트, 훅, 스킬, 평가(eval)에서 이전 동작을 주장하는 텍스트를 찾으세요. - 검증하세요. DUPLICATE 또는 CONFLICT는 두 명의 회의론자가 반박에 실패한 후에만 유효합니다. 한 명은 문서 정확성을 읽고 다른 한 명은 시행 현실을 읽으며, 각각 확실하지 않으면 반박된 것으로 간주합니다. 그런 다음 세션은 인용된 줄과 규칙 텍스트 자체를 읽습니다. 실행하여 해결할 수 있는 모든 것(
--help, 실제 페이로드가 있는 훅, 검사기)은 실행하세요. - 처분에 따라 조치를 취하세요. 규칙이나 훅의 충돌을 해결하세요. 중복을 폐기하거나, 기본 기능을 명명하는 선언된 중복으로 유지하세요. 규칙이 기능을 주장하거나 암시하는 경우에만 보완 문구를 수정하고 사실을 인용하세요. 고유한 것은 기록하고 그대로 두세요. 프롬프트 감사 결과는 규칙의 주장을 변경하지 않고 문구만 변경하며, 검사기가 시행하는 규칙 형태에 맞아야 합니다. 에이전트의 이탈, 검토자의 "비차단" 메모 또는 "알려진 제한"을 수락하기 전에 이를 관장하는 하우스 규칙 또는 문서 권장 사항을 명명하고, 그렇지 않은 이유를 설명할 수 없는 한 권장 옵션을 선택하세요.
- 기록하세요. references/recording-and-release.md에 설명된 세 곳에 기록하세요. 그런 다음 거기에 있는 릴리스 흐름을 통해 출시하세요.
깊이 선택하기
델타 부록 (기본값). 기준선 이후의 변경 로그 섹션과 모델 변경 사항만 분류하며, 소스당 한 명의 연구원이 배정됩니다. 규칙 표면에 대한 적중을 분류한 다음, 날짜가 있는 ## 부록 섹션을 작성하세요. 이는 수정 및 소규모 기능의 릴리스 한두 개와 계층 및 노력에 영향을 미치는 모델 변경에 적합합니다.
전체 재조사. 문서에서 모든 도구 영역을 재조사하고, 모든 규칙 제목과 메커니즘을 분류하고, 검증하고, 종합하고, 완전성 비판을 실행하세요. 그런 다음 비판자가 지명한 모든 것에 대한 간극(gap) 패스를 실행하세요. 이와 함께 델타 경로의 변경 로그 분류도 실행하세요: 문서 페이지에는 날짜가 없으므로, 변경 로그 없이 전체 실행은 현재 페이지와 오래된 페이지를 구분할 수 없습니다. 부록만으로는 충분하지 않다는 신호는 다음과 같습니다: - 델타가 여러 영역을 동시에 다룰 때; - 새로운 모델 제품군이나 기본값이 도착할 때; - 프롬프트 감사가 여러 파일에 걸친 패턴을 지적할 때; - 부록에서 과거 사실이 변경 이전의 영역에서 충돌이 발견될 때; - 마지막 재조사의 비판자가 그 이후로 아무도 연구하지 않은 영역을 나열했을 때.
스크립트는 scripts/house-vs-harness-audit.js (메인) 및 scripts/house-vs-harness-gap-audit.js (간극)입니다. 각각 args.repo (깨끗한 워크트리의 절대 경로)와 args.date를 인수로 받습니다. 간극 실행은 또한 비판자의 결과에서 args.areas와 args.targets를 받고, 메인 실행의 결과에 대한 부록 문장인 선택적 args.context를 받습니다. 이들은 워크플로 도구를 통해 실행되며, 사용자의 명시적인 동의가 필요합니다. 요청하기 전에 에이전트 수를 명시하세요: 메인 실행은 영역당 한 명의 연구원, 모듈당 하나의 Opus 분류기와 메커니즘용 하나, 중복 또는 충돌 주장당 두 명의 회의론자, 그리고 두 명의 종합 에이전트입니다.
위험 요소
- 대부분의 결과는 속성(attribution)일 뿐, 실질적인 내용이 아닙니다. 지금까지 가장 큰 재조사에서는 중복이나 충돌을 발견하지 못했지만, 규칙이 문서에 명시되지 않은 기본 기능을 주장하는 27건의 재작성을 발견했습니다. 어떤 규칙이 도구가 어떤 일을 한다고 말하기 전에, 그 사실은 기록되거나 가져온 페이지에 존재해야 합니다.
- 회의론자는 중복과 충돌만 봅니다. 보완 제안의 재작성은 검증되지 않은 상태로 보고서에 도달하며, 이전 텍스트만큼 쉽게 도구를 과장할 수 있습니다. 반박자를 보내 출시 전에 기록된 사실과 각 재작성을 대조 확인하세요.
- 순진한 제목 개수는 규칙을 건너뜁니다. 모든 규칙 파일은
## 하지 마세요로 끝나며, 일부 실제 규칙은 "하지 마세요"로 시작합니다. 제목은 접두사가 아닌 정확한 일치로 계산하세요. - 문서 페이지에는 날짜가 없습니다. 모든 인용 옆에 가져온 날짜를 기록하세요. 변경 로그와 페이지가 불일치하는 경우, 날짜는 변경 로그를, 내용은 페이지를 신뢰하세요.
- 모델 설정은 리포지토리 외부에 있습니다. 하위 에이전트의 기본 기능과 모델별 노력은 사용자 설정입니다. 모델 변경으로 인해 이러한 설정이 이동하는 경우, 사용자에게 무엇을 설정해야 하는지 알려주세요. 여기서 사용자 설정을 편집하지 마십시오. 새로 출시된 모델은 모델별 수준이 적용될 때까지 자체 기본 노력으로 실행됩니다.
- 프롬프트 감사 결과는 하우스 형태와 충돌할 수 있습니다. 금지 목록 또는 고정된 숫자에 대한 감사 플래그는 스타일 신호입니다.
## 하지 마세요섹션과 길이 상한은 검사된 형태와 래칫(ratchet)이므로, 이를 변경하는 것은 ADR에 따른 패키지 결정이지 재작성이 아닙니다. - 브랜치 보호는 명령어 텍스트를 읽습니다. 작성 도구를 사용하여 브랜치 이름 근처에 git 동사를 언급하는 PR 본문과 커밋 메시지를 작성한 다음,
--body-file또는-F플래그와 함께 전달하세요. - 하위 에이전트는 커밋하지 않습니다. 세션이 에이전트가 준비한 내용을 커밋하고 푸시합니다.
여기서의 편집이 적용되는 시기
이 스킬은 리포지토리 내부에서만 작동합니다. 편집 사항은 이름으로 호출하는 다음 세션에 적용되며, 사용자에게 출시되지 않습니다. 사용자에게 도달하는 것은 규칙 및 메커니즘 변경 사항이며, 이는 릴리스와 각 사용자의 render --apply를 통해 전달됩니다.