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
- 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.
- 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.
- 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 linhaReceipts: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.
- Pesquise arquivos de regra existentes por escopo e título, não apenas por nome de arquivo. Abra aquele cujo
- 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.
- 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.
- 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
revisedo 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.