Communitygithub.com

회사 규칙 조회

`.house/INDEX.md`에서 주제를 검색하여 어떤 회사 규칙이 적용되는지 조회합니다. 규칙 본문 자체는 열지 않으며, 'X에 대한 회사 규칙은 무엇인가요?' 또는 'X에 대한 회사 관례가 있나요?' 같은 질문에 사용합니다.

회사 규칙 조회란 무엇인가요?

이 스킬은 저장소에 정의된 회사 규칙(house rules)을 빠르고 효율적으로 조회하는 방법을 제공합니다. 사용자가 특정 주제에 대해 회사 규칙이 무엇인지 묻거나 해당 주제를 다루는 규칙 파일이 있는지 질문할 때, 스킬은 미리 생성된 인덱스 파일(`.house/INDEX.md`)만 읽어서 답변합니다. 이 인덱스에는 각 규칙 파일의 경로, 제목, 그리고 규칙의 핵심을 한 줄로 요약한 설명이 포함되어 있어, 모든 규칙 파일을 열지 않고도 관련 규칙을 빠르게 찾을 수 있습니다. 여러 규칙 파일이 동일한 주제를 다룰 수 있으므로 일치하는 모든 항목을 결과로 표시하며, 각 결과는 인용(`파일경로#슬러그`)과 함께 제공되어 사용자가 전체 규칙 텍스트를 직접 열어볼 수 있습니다. 인덱스가 없거나 일치하는 항목이 없는 경우, 또는 인덱스가 오래된 경우에 대한 명확한 예외 처리도 포함되어 있어 잘못된 정보를 제공하지 않도록 설계되었습니다. 이는 주로 Claude Code 환경에서 사용되며, `@dubbl-a/house-rules` 플러그인의 조회 기능을 담당합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dubbl-a/house-rules/tree/HEAD/plugins/house/skills/conventions

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

회사 관례 조회

이 스킬은 하나의 질문에 답합니다: 회사가 주제에 대해 뭐라고 말하는지, 그리고 그 내용이 어디에 있는지. 인덱스가 생성 단계에서 만들어낸 .house/INDEX.md 파일만 읽고, 규칙 파일 자체는 절대 열지 않습니다. 이것이 바로 인덱스의 존재 이유입니다. 조회는 하나의 작은 파일만 읽으면 되고, 저장소의 모든 규칙 파일을 읽을 필요가 없습니다.

기본 흐름

  1. 저장소 루트에 있는 .house/INDEX.md를 읽습니다. 질문에 답하기 위해 .claude/rules/**, docs/handbook/**, 또는 plugins/house/modules/**/rules/** 아래의 어떤 파일도 열지 마십시오. 인덱스는 모든 가져온(vendored) 규칙에 대해 파일 경로, 제목, 그리고 한 줄 요약을 가지고 있으며, 이 정보만으로 대부분의 조회를 처리할 수 있습니다.
  2. 인덱스에서 질문과 일치하는 항목을 파일 경로, 제목, 또는 한 줄 요약 기준으로 검색합니다. 정확한 단어 일치가 아니라 의미와 키워드로 매칭하십시오. 커밋 메시지에 대한 질문은 단어가 다르더라도 커밋에 관한 제목과 매칭되어야 합니다.
  3. 첫 번째 일치 항목만이 아니라 모든 일치 항목을 나열합니다. 하나의 주제가 여러 규칙 파일에 합법적으로 존재할 수 있으며(문서 규칙과 엔지니어링 규칙이 동일한 질문에 관련될 수 있음), 실제 일치 항목을 누락하면 답변에 오류가 발생합니다.
  4. 각 일치 항목에 대해 규칙 파일 경로, 제목, 인덱스의 한 줄 요약을 그대로 보고합니다. 인용(파일경로#슬러그)을 제공하여 사용자가 전체 텍스트를 위해 실제 규칙을 직접 열 수 있도록 합니다.
  5. 여기서 멈춥니다. 기억이나 이전 세션에서 읽은 내용을 바탕으로 규칙 본문을 요약, 확장, 또는 재구성하지 마십시오. 인덱스의 한 줄 요약이 이 스킬이 제공하는 답변이며, 연결된 규칙 파일이 전체 규칙이 있는 곳입니다.

예외 처리

  • 저장소에 .house/INDEX.md가 없음. 이 저장소가 회사 규칙(house)을 채택하지 않았거나, 인덱스가 존재하기 전 버전으로 렌더링되었음을 명확히 말합니다. 훈련 지식, CLAUDE.md 훑어보기, 또는 다른 저장소의 규칙에서 답을 추측하지 마십시오. 여기서 멈춥니다.
  • 인덱스에 질문과 일치하는 항목이 없음. 회사 규칙에 이 주제에 대한 규칙이 없다고 명확히 말합니다. 규칙을 만들어내지 말고, 느슨하게 관련된 항목을 질문에 맞게 확장하지 마십시오.
  • 인덱스가 오래된 것으로 보임. 나열된 제목이 더 이상 해당 규칙 파일에 나타나지 않거나, 나열된 규칙 파일이 완전히 누락된 경우입니다. 인덱스가 오래된 것 같다고 말하고, 무엇이 오래되었는지 명시하며, /house-rules:sync를 제안합니다. 그래도 인덱스가 가진 최선의 일치 항목은 계속 보고합니다. 오래된 인덱스는 답변에 대한 주의 사항일 뿐, 답변을 숨길 이유가 아닙니다.
  • 사용자가 전체 규칙 텍스트를 원함(위치만이 아니라). 그런 경우에만 인덱스가 가리킨 하나의 규칙 파일을 읽습니다. 이를 위해 전체 규칙 세트를 열지 마십시오. 인덱스 일치 항목을 찾은 후에 단일 파일을 읽고, 그 전에는 읽지 않습니다.

하지 말 것

  • 조회에 답하기 위해 모든 규칙 파일을 로드하지 마십시오. 그 비용을 피하기 위해 인덱스가 존재합니다.
  • 같은 세션에서 이전에 읽은 규칙 파일로 답변하지 마십시오. 매번 인덱스를 다시 확인하십시오. 동기화가 세션 중간에 인덱스를 변경할 수 있습니다.
  • 이 스킬 내에서 .house/INDEX.md, .claude/rules/house/**, 또는 다른 가져온(vendored) 파일을 편집하지 마십시오. 관리되는 파일의 로컬 편집은 /house-rules:sync의 거부 흐름에 속하며, 조회에 속하지 않습니다.
  • 인덱스에 질문과 일치하는 항목이 없을 때 회사 규칙을 조작하지 마십시오.
  • 이것을 메뉴로 만들지 마십시오. 질문에 답하십시오. 질문 자체가 여러 모듈에 걸쳐 있을 정도로 광범위한 경우에만 모든 후보 모듈을 나열하십시오.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

관련 스킬