Communitygithub.com

dubbl-a/regras-da-casa

Roteia o aprendizado de uma sessão para o arquivo de regra correspondente e um incidente datado para o arquivo de archive do repositório, nunca para o arquivo raiz; é acionado por "revise a documentação", "capture este aprendizado", "para onde isso vai".

O que é regras-da-casa?

Esta skill substitui o comportamento padrão do comando `revise` do plugin de gerenciamento de arquivos de instrução, que anexa todo aprendizado ao arquivo raiz — resultando em arquivos que crescem indefinidamente e raramente são lidos por completo, além de aprendizado enterrado em local irrelevante. Em vez disso, a skill audita a afirmação contra a base de código antes de escrever e roteia o aprendizado de forma inteligente: uma regra vai para o arquivo de regra cujos paths cobrem a superfície tocada, e um incidente vai para o arquivo de archive datado do repositório. As notas de memória local da máquina já capturam o que a sessão aprendeu e ignoram o que os arquivos de instrução já dizem, então a skill lida com a metade compartilhável e versionada. A skill funciona em qualquer plataforma que suporte skills (como Claude Code, Cursor) e enfatiza nunca tocar no arquivo raiz, nunca editar regras gerenciadas localmente (que seriam sobrescritas), e sempre mostrar a edição proposta antes de salvar. Ela também lida com casos como quando o aprendizado contradiz uma regra existente, quando é um caso único que não se encaixa como regra, ou quando o repositório não tem nem arquivos de regra nem archive.

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

Perguntar na sua IA favorita

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

Documentação

Revisar documentação

O plugin oficial de gerenciamento de arquivos de instrução inclui um comando revise que captura o aprendizado de uma sessão anexando-o ao arquivo de instrução raiz. Esse é exatamente o comportamento que esta skill existe para substituir. Um arquivo raiz que só cresce deixa de ser lido até o final, e um aprendizado anexado a ele raramente é o fato que uma sessão futura precisava no momento em que precisava. Esta skill mantém a metade útil daquele plugin—auditar uma afirmação contra a base de código antes de escrevê-la—e descarta a metade de anexar em favor do roteamento. As próprias notas de memória local da máquina do harness já capturam o que uma sessão aprendeu e ignoram o que os arquivos de instrução já dizem, então esta skill roteia a metade compartilhável e versionada: uma regra para o arquivo de regra cujos paths cobrem a superfície que ela toca, um incidente para o archive do repositório.

Caminho padrão

  1. Nomeie o que esta sessão produziu que vale a pena manter: uma correção, uma convenção decidida, um bug e sua correção, um resultado medido, uma decisão entre duas abordagens.
  2. Classifique-o como regra ou incidente.
    • Uma regra vale toda vez que uma situação correspondente ocorre. Declare-a uma vez e ela ainda deve ser verdadeira após o próximo refatoramento.
    • Um incidente ocorreu uma vez, em uma data, com um nome ou um número medido associado. É uma evidência do porquê uma regra existe, não a regra em si.
  3. Roteie uma regra para seu arquivo de regra correspondente.
    • Pesquise arquivos de regra existentes por escopo e título, não apenas por nome de arquivo. Abra aquele cujo paths: já cobre a superfície que o aprendizado toca.
    • Se um cobrir, adicione um novo título ou incorpore o ponto em um existente. Siga a forma da regra: um título imperativo que é a própria regra, uma cláusula de porquê, uma linha Anchor: nomeando o que a impõe, uma linha Receipts: apontando para a entrada no archive, e mantenha o arquivo terminando em ## Não faça.
    • Verifique antes de escrever. Confira se cada token na linha Anchor:, cada path, cada nome de script, realmente se resolve no repositório agora. Este é o hábito de auditoria emprestado do plugin acima: nunca escreva uma afirmação que você não verificou.
    • Se nada cobrir, diga isso e proponha um novo arquivo de regra ou um escopo maior para um existente. Não coloque o ponto no arquivo mais próximo só porque está perto.
  4. Roteie um incidente para o nível de archive do repositório.
    • O archive é o que o repositório chama de seu documento de evidências datadas: um capítulo de manual, um arquivo de histórico de design, um log de postmortem. Escreva a data, o nome, o número medido lá, intitulado como uma lição de uma linha para que a entrada seja lida como uma afirmação em vez de um nome de arquivo.
    • Aponte o arquivo de regra para a entrada com seu título entre aspas. Não repita os detalhes do incidente dentro da prosa da regra; uma data ou número em uma regra é história vestindo roupas de regra.
    • Se o repositório ainda não tem archive, diga isso e proponha iniciar um. Não coloque o incidente em um arquivo de regra ou no arquivo raiz por falta de um lar.
  5. Nunca toque no arquivo de instrução raiz. Se nem um arquivo de regra nem o archive servirem, isso é um sinal de que o fato não é durável o suficiente para ser mantido, não uma razão para colocá-lo por padrão no arquivo raiz. Diga isso claramente e pare.
  6. Mostre a edição antes de salvá-la. Imprima o título e o parágrafo que você propõe, ou um diff contra o arquivo existente, e aguarde confirmação a menos que lhe tenham dito claramente para simplesmente fazer a alteração.

Quando a correspondência é uma regra interna gerenciada

Se o arquivo que já cobre o tópico é uma regra interna fornecida (carrega o cabeçalho de arquivo gerenciado, vive em .claude/rules/house/**), não o edite neste repositório. Uma edição local em um arquivo gerenciado é silenciosamente sobrescrita pela próxima execução de /house-rules:sync, e essa perda silenciosa é exatamente o que house existe para prevenir.

Proponha a alteração upstream em vez disso. Esboce o mesmo título e parágrafo, depois diga para abri-la como uma alteração no repositório house em vez deste. Se o ponto for genuinamente específico deste repositório e não uma regra para toda a frota, registre-o como um desvio em house.json em vez de bifurcar o arquivo gerenciado. Qualquer um dos caminhos mantém o arquivo gerenciado sincronizado; editá-lo no local não.

Saídas de emergência

  • O aprendizado contradiz uma regra existente. Diga isso claramente, cite o título existente e pergunte qual vence antes de escrever qualquer coisa. Não sobrescreva silenciosamente uma regra com outra.
  • O aprendizado é algo único e específico do repositório sem formato de regra, uma solução alternativa para um bug de fornecedor, uma nota que só importa uma vez. Roteie-o para o archive como incidente em vez de poluir um arquivo de regra com algo que nenhuma sessão futura precisa obedecer.
  • Você não tem certeza se algo é regra ou incidente. Penda para o archive. Uma regra arquivada erroneamente é um título que alguém pode promover depois; um incidente transformado erroneamente em regra se torna prosa obsoleta que nada sinaliza.
  • O repositório não tem arquivos de regra nem archive algum. Diga isso claramente e pare em vez de originar qualquer um deles de dentro desta skill. Esse é o trabalho de /house-rules:bootstrap, não deste.

Não faça

  • Não anexe ao arquivo de instrução raiz. Esse é exatamente o comportamento que o comando revise do plugin oficial de arquivos de instrução realiza, e a razão pela qual esta skill existe em seu lugar.
  • Não escreva uma frase de regra cuja âncora você não verificou contra a base de código.
  • Não repita a data, nome ou número de um incidente dentro da prosa da regra; aponte para o archive.
  • Não edite um arquivo de regra fornecida no local. Proponha upstream ou registre um desvio.
  • Não salve uma edição que a pessoa não viu, a menos que ela tenha lhe dito claramente para simplesmente fazê-la.
  • Não invente um arquivo de regra ou archive quando o repositório não tem nenhum.

Individual skills in this repo

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

Habilidades Relacionadas