회사 관례 조회
이 스킬은 하나의 질문에 답합니다: 회사가 주제에 대해 뭐라고 말하는지, 그리고 그 내용이 어디에 있는지. 인덱스가 생성 단계에서 만들어낸 .house/INDEX.md 파일만 읽고, 규칙 파일 자체는 절대 열지 않습니다. 이것이 바로 인덱스의 존재 이유입니다. 조회는 하나의 작은 파일만 읽으면 되고, 저장소의 모든 규칙 파일을 읽을 필요가 없습니다.
기본 흐름
- 저장소 루트에 있는
.house/INDEX.md를 읽습니다. 질문에 답하기 위해.claude/rules/**,docs/handbook/**, 또는plugins/house/modules/**/rules/**아래의 어떤 파일도 열지 마십시오. 인덱스는 모든 가져온(vendored) 규칙에 대해 파일 경로, 제목, 그리고 한 줄 요약을 가지고 있으며, 이 정보만으로 대부분의 조회를 처리할 수 있습니다. - 인덱스에서 질문과 일치하는 항목을 파일 경로, 제목, 또는 한 줄 요약 기준으로 검색합니다. 정확한 단어 일치가 아니라 의미와 키워드로 매칭하십시오. 커밋 메시지에 대한 질문은 단어가 다르더라도 커밋에 관한 제목과 매칭되어야 합니다.
- 첫 번째 일치 항목만이 아니라 모든 일치 항목을 나열합니다. 하나의 주제가 여러 규칙 파일에 합법적으로 존재할 수 있으며(문서 규칙과 엔지니어링 규칙이 동일한 질문에 관련될 수 있음), 실제 일치 항목을 누락하면 답변에 오류가 발생합니다.
- 각 일치 항목에 대해 규칙 파일 경로, 제목, 인덱스의 한 줄 요약을 그대로 보고합니다. 인용(
파일경로#슬러그)을 제공하여 사용자가 전체 텍스트를 위해 실제 규칙을 직접 열 수 있도록 합니다. - 여기서 멈춥니다. 기억이나 이전 세션에서 읽은 내용을 바탕으로 규칙 본문을 요약, 확장, 또는 재구성하지 마십시오. 인덱스의 한 줄 요약이 이 스킬이 제공하는 답변이며, 연결된 규칙 파일이 전체 규칙이 있는 곳입니다.
예외 처리
- 저장소에
.house/INDEX.md가 없음. 이 저장소가 회사 규칙(house)을 채택하지 않았거나, 인덱스가 존재하기 전 버전으로 렌더링되었음을 명확히 말합니다. 훈련 지식, CLAUDE.md 훑어보기, 또는 다른 저장소의 규칙에서 답을 추측하지 마십시오. 여기서 멈춥니다. - 인덱스에 질문과 일치하는 항목이 없음. 회사 규칙에 이 주제에 대한 규칙이 없다고 명확히 말합니다. 규칙을 만들어내지 말고, 느슨하게 관련된 항목을 질문에 맞게 확장하지 마십시오.
- 인덱스가 오래된 것으로 보임. 나열된 제목이 더 이상 해당 규칙 파일에 나타나지 않거나, 나열된 규칙 파일이 완전히 누락된 경우입니다. 인덱스가 오래된 것 같다고 말하고, 무엇이 오래되었는지 명시하며,
/house-rules:sync를 제안합니다. 그래도 인덱스가 가진 최선의 일치 항목은 계속 보고합니다. 오래된 인덱스는 답변에 대한 주의 사항일 뿐, 답변을 숨길 이유가 아닙니다. - 사용자가 전체 규칙 텍스트를 원함(위치만이 아니라). 그런 경우에만 인덱스가 가리킨 하나의 규칙 파일을 읽습니다. 이를 위해 전체 규칙 세트를 열지 마십시오. 인덱스 일치 항목을 찾은 후에 단일 파일을 읽고, 그 전에는 읽지 않습니다.
하지 말 것
- 조회에 답하기 위해 모든 규칙 파일을 로드하지 마십시오. 그 비용을 피하기 위해 인덱스가 존재합니다.
- 같은 세션에서 이전에 읽은 규칙 파일로 답변하지 마십시오. 매번 인덱스를 다시 확인하십시오. 동기화가 세션 중간에 인덱스를 변경할 수 있습니다.
- 이 스킬 내에서
.house/INDEX.md,.claude/rules/house/**, 또는 다른 가져온(vendored) 파일을 편집하지 마십시오. 관리되는 파일의 로컬 편집은/house-rules:sync의 거부 흐름에 속하며, 조회에 속하지 않습니다. - 인덱스에 질문과 일치하는 항목이 없을 때 회사 규칙을 조작하지 마십시오.
- 이것을 메뉴로 만들지 마십시오. 질문에 답하십시오. 질문 자체가 여러 모듈에 걸쳐 있을 정도로 광범위한 경우에만 모든 후보 모듈을 나열하십시오.