Communitygithub.com

dubbl-a/house-rules

Consulta qual regra da casa cobre um tópico pesquisando em .house/INDEX.md, nunca nos corpos das regras; use para "qual é a regra da casa para X" e "existe uma convenção da casa para X".

O que é house-rules?

Esta skill permite consultar rapidamente qual regra da casa (house rule) se aplica a um determinado tópico, sem precisar ler todos os arquivos de regras do repositório. Ela lê apenas o índice gerado em `.house/INDEX.md`, que contém o caminho do arquivo, o título e uma descrição de uma linha para cada regra importada. A skill retorna todas as correspondências encontradas, não apenas a primeira, e fornece a citação exata (`arquivo#slug`) para que o usuário possa abrir a regra completa. É especialmente útil em ambientes de desenvolvimento colaborativo onde múltiplas regras (de documentação, engenharia, etc.) podem se aplicar à mesma pergunta, evitando respostas incompletas ou inventadas. Suporta qualquer repositório que adote o sistema "house" e gera o arquivo de índice.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Consulta de convenções da casa

Esta skill responde a uma pergunta: o que a casa diz sobre um tópico e onde isso está localizado. Ela lê o índice que a etapa de renderização produz, nunca os próprios arquivos de regras. Esse é o objetivo principal do índice: uma consulta deve custar um arquivo pequeno, não todos os arquivos de regras do repositório.

Caminho padrão

  1. Leia .house/INDEX.md na raiz do repositório. Não abra nenhum arquivo em .claude/rules/**, docs/handbook/** ou plugins/house/modules/**/rules/** para responder à pergunta. O índice contém o arquivo, o título e uma descrição de uma linha do "porquê" para cada regra importada, e isso é suficiente para responder à maioria das consultas por si só.
  2. Pesquise no índice por entradas cujo arquivo, título ou descrição de uma linha corresponda à pergunta. A correspondência deve ser baseada em significado e palavras-chave, não na redação exata. Uma pergunta sobre mensagens de commit deve corresponder a um título sobre commits mesmo quando as palavras são diferentes.
  3. Liste todas as correspondências, não apenas a primeira. Um tópico pode legitimamente estar em mais de um arquivo de regras (uma regra de documentação e uma regra de engenharia podem ambas tratar da mesma pergunta), e omitir uma correspondência real torna a resposta incorreta por omissão.
  4. Para cada correspondência, informe o caminho do arquivo de regras, o título e a descrição de uma linha do índice, textualmente. Aponte para a citação (arquivo#slug) para que o usuário possa abrir a regra real e ver o texto completo.
  5. Pare por aí. Não parafraseie, expanda ou reconstrua o corpo da regra a partir da memória ou de algo lido anteriormente na sessão. A descrição de uma linha do índice é a resposta que esta skill fornece; o arquivo de regras vinculado é onde a regra completa está.

Saídas de emergência

  • Nenhum .house/INDEX.md no repositório. Diga claramente que este repositório não adotou o sistema "house" ou está em uma versão renderizada antes da existência do índice. Não adivinhe uma resposta a partir do conhecimento de treinamento, de uma leitura superficial de CLAUDE.md ou de regras de outro repositório. Pare por aí.
  • Nada no índice corresponde à pergunta. Diga claramente que a casa não tem regra para este tópico. Não invente uma e não estique uma entrada vagamente relacionada para cobrir uma pergunta que ela não responde.
  • O índice parece desatualizado. Um título listado não aparece mais em seu arquivo de regras, ou um arquivo de regras listado está completamente ausente. Diga que o índice parece desatualizado, nomeie o que está desatualizado e sugira /house-rules:sync. Ainda assim, informe a melhor correspondência que o índice tem; um índice desatualizado é uma ressalva na resposta, não um motivo para retê-la.
  • O usuário quer o texto completo da regra, não apenas onde ela está. Só então, leia o único arquivo de regras para o qual o índice apontou. Nunca abra o conjunto completo de regras para isso. Leia o arquivo individual após a correspondência do índice já ter sido encontrada, não antes.

Não faça

  • Não carregue todos os arquivos de regras para responder a uma consulta. Esse é exatamente o custo que o índice existe para evitar.
  • Não responda a partir de um arquivo de regras lido anteriormente na mesma sessão. Verifique o índice novamente a cada vez; uma sincronização pode alterar o que ele diz no meio da sessão.
  • Não edite .house/INDEX.md, .claude/rules/house/** ou qualquer outro arquivo importado de dentro desta skill. Uma edição local em um arquivo gerenciado pertence ao fluxo de recusa de /house-rules:sync, não a uma consulta.
  • Não invente uma regra da casa quando o índice não tiver correspondência para a pergunta feita.
  • Não transforme isso em um menu. Responda à pergunta que foi feita; só liste todos os módulos candidatos quando a pergunta for ampla o suficiente para abranger mais de um.

Individual skills in this repo

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

Habilidades Relacionadas