Communitygithub.com

dubbl-a/house-rules

Configura um repositório para consumir regras house pela primeira vez, propondo um manifesto house.json, regras vendidas e um esqueleto de CLAUDE.md. Por padrão executa em modo de simulação (dry run). Use para "inicializar house" ou "adotar house aqui".

O que é house-rules?

Esta skill transforma um repositório não gerenciado em um consumidor do sistema house. Ela analisa o repositório, propõe um arquivo `house.json` e, mediante confirmação (`--apply`), escreve as regras vendidas, modelos e um esqueleto de CLAUDE.md. Nunca edita um CLAUDE.md existente nem executa duas vezes sobre o mesmo manifesto. A skill é projetada para ser executada apenas quando solicitada, pois tem efeitos colaterais no disco. Ela suporta plataformas como Claude Code e Cursor, onde skills de agente de IA são comuns. O fluxo envolve uma simulação inicial (dry run) que apenas exibe a proposta, aguarda aprovação do usuário, aplica as alterações e, por fim, imprime um bloco de configuração para integração manual. A skill garante que o repositório nunca seja bootstrapado mais de uma vez, redirecionando para `/house-rules:sync` se `house.json` já existir.

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

Perguntar na sua IA favorita

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

Documentação

Inicialização (Bootstrap)

A inicialização transforma um repositório não gerenciado em um consumidor house. Ela analisa o repositório, propõe um house.json e, com --apply, escreve as regras vendidas, modelos e um esqueleto de CLAUDE.md. Nunca edita um CLAUDE.md existente e nunca executa duas vezes sobre o mesmo manifesto. Ela escreve apenas a metade house do CLAUDE.md, como um arquivo esqueleto separado, deixando a metade derivada do código para o comando init do harness, que gera um CLAUDE.md inicial ou sugere melhorias ao já existente.

Esta skill tem efeitos colaterais no disco, portanto nunca é acionada automaticamente. Execute-a apenas quando solicitado.

Caminho padrão

  1. Simulação (dry run): analise o repositório e exiba o house.json proposto. Nada é escrito.
  2. Mostre a proposta para a pessoa executando a skill e aguarde que ela diga para aplicar.
  3. Aplicar: escreva house.json, depois renderize as regras, modelos e esqueleto.
  4. Imprima o bloco de configuração abaixo para que a pessoa possa colá-lo em package.json, CI e terminal.

Não pule a etapa 2. Uma proposta que a pessoa nunca viu não é uma proposta, é uma surpresa.

Recusar quando um manifesto existir

Antes de analisar qualquer coisa, verifique se house.json já existe na raiz do repositório.

Se existir, recuse. Informe que o repositório já tem um manifesto e aponte para /house-rules:sync. Isso vale também no modo de simulação: o bootstrap nunca rascunha uma segunda proposta sobre a primeira, mesmo que ninguém a tenha aplicado ainda. Um repositório recebe exatamente uma inicialização.

Analisar o repositório

Execute a CLI em modo de simulação para coletar o que a proposta precisa:

node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <caminho>

A análise lê, e não escreve:

  • Stack: presença de package.json, seus scripts e qualquer arquivo de configuração de framework na raiz.
  • Branch padrão: git symbolic-ref refs/remotes/origin/HEAD, com fallback para a branch atual.
  • Diretórios de nível superior, para adivinhar quais módulos opcionais se aplicam (db/ sugere database, uma configuração de deploy sugere deployment, e assim por diante).
  • Se .claude/rules/ ou um hook de proteção de branch já existe, para que a proposta possa dizer o que o bootstrap adicionaria versus o que o repositório já tem.
  • Se a varredura de documentos atual do repositório já exclui um nível de arquivo morto, para definir scanArchive com base no comportamento observado, e não em um palpite.
  • Se git check-ignore diz que qualquer destino de escrita do house (.claude/rules/house/, .house/) está ignorado. O verificador percorre git ls-files, então um arquivo de regra ignorado é invisível para ele e a primeira execução imprime um zero que nunca foi conquistado. A análise emite um aviso e nomeia a correção: ignore apenas .claude/settings.local.json, nunca .claude/ ou .house/.

Propor house.json

Cada módulo que a análise não consegue descartar vai para a proposta como "detect", não true ou false. "detect" significa que o repositório decide no momento da renderização, não a skill adivinhando em seu lugar. Módulos principais (docs, engineering, github, claude-code) estão sempre ativos. Imprima o corpo completo do house.json proposto, não um resumo, para que a pessoa revisando possa ler cada campo antes que algo seja escrito.

Aplicar: escrever o manifesto, as regras e o esqueleto

Somente depois que a pessoa disser para aplicar:

node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <caminho> --apply
node ${CLAUDE_PLUGIN_ROOT}/scripts/house render --repo <caminho> --apply

init --apply escreve house.json. render --apply escreve os arquivos de regras vendidos, os modelos, .house/check.mjs, .house/lock.json, .house/INDEX.md e mais um arquivo:

  • Se o repositório tiver um CLAUDE.md, escreva CLAUDE.md.house-skeleton ao lado dele. Não abra o CLAUDE.md existente e não escreva dentro dele.
  • Se o repositório não tiver um CLAUDE.md, ainda assim escreva CLAUDE.md.house-skeleton, não o próprio CLAUDE.md. O bootstrap nunca origina o arquivo raiz do repositório. Uma pessoa mescla o esqueleto manualmente.

De qualquer forma, um CLAUDE.md existente é byte-idêntico antes e depois de cada execução de bootstrap. Esse é o controle ao qual esta skill está vinculada: compare-o antes de aplicar, compare-o novamente depois e, se algo mudou, pare e informe em vez de relatar sucesso.

O esqueleto é oferecido uma vez por repositório: render o registra em .house/lock.json sob scaffolds, então, uma vez mesclado no CLAUDE.md e excluído, nenhuma renderização posterior o escreve de volta. render --apply --scaffold é a maneira de solicitá-lo novamente.

Garanta que o .gitignore do repositório contenha .claude/worktrees/ e .superpowers/, anexando a linha que estiver faltando. Lixo de ferramenta que aparece em git status está a um git add -A de ser commitado.

Imprimir a configuração

Após uma aplicação bem-sucedida, imprima este bloco textualmente para que possa ser copiado e colado em um terminal simples. Não preencha nada; a pessoa o adapta ao seu package.json e arquivo de workflow.

Adicione aos scripts do package.json:
  "check:docs": "node .house/check.mjs --only=drift,todo"
  "check:house": "node .house/check.mjs"

Adicione uma etapa de CI que execute:
  node .house/check.mjs

Instale o plugin uma vez por máquina:
  claude plugin marketplace add dubbl-a/house-rules
  claude plugin install house-rules@house-rules --scope user

Ative os hooks do git uma vez por clone (render --apply e cada início de sessão também fazem isso):
  git config core.hooksPath "$(pwd)/.githooks"

core.hooksPath vive em .git/config, que nenhum clone e nenhum PR carrega, então a árvore .githooks/ vendida fica inerte em um checkout novo até que algo a defina. render --apply e o hook SessionStart do plugin ambos a ativam; a linha acima é para um clone que não tem nenhum dos dois. Nem eles nem a pessoa devem sobrescrever um core.hooksPath que outra ferramenta já possui.

Se o repositório não tiver .claude/settings.local.json, informe isso na saída impressa. Esse arquivo é onde uma desativação por repositório de um módulo ou hook house viveria, e sua ausência significa que o repositório está rodando apenas com os padrões.

Após o bootstrap

Informe à pessoa o que ainda não foi feito: o esqueleto ainda precisa ser mesclado manualmente no CLAUDE.md e depois excluído (não será escrito novamente), o bloco de configuração ainda precisa ser colado, e node .house/check.mjs vale uma execução local antes do primeiro commit para que o repositório comece de um ponto limpo, em vez de uma falha herdada. Prepare os arquivos renderizados por caminho primeiro (house.json .house/ .claude/rules/house/, mais scripts/house/ apenas quando a renderização listou um arquivo lá, já que o git recusa um pathspec que não corresponde a nada): até que estejam preparados, a família de manifesto avisa [untracked] por arquivo, e uma exclusão geral de .claude/ ou .house/ é um achado [gitignored], porque um arquivo que o git não pode ver é um que nenhuma família verifica. Nada disso é trabalho desta skill fazer por eles; o bootstrap para na renderização.

Não faça

  • Não escreva house.json ou qualquer arquivo renderizado durante a simulação. A simulação apenas imprime.
  • Não sobrescreva ou anexe a um CLAUDE.md existente, nunca, sob nenhuma flag.
  • Não reproponha sobre um repositório que já tenha house.json. Envie-o para /house-rules:sync.
  • Não adivinhe um módulo como ativo ou inativo quando a análise for ambígua. Proponha "detect" e deixe o repositório decidir.

Individual skills in this repo

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

Habilidades Relacionadas