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
- Simulação (dry run): analise o repositório e exiba o
house.jsonproposto. Nada é escrito. - Mostre a proposta para a pessoa executando a skill e aguarde que ela diga para aplicar.
- Aplicar: escreva
house.json, depois renderize as regras, modelos e esqueleto. - 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/sugeredatabase, uma configuração de deploy sugeredeployment, 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
scanArchivecom base no comportamento observado, e não em um palpite. - Se
git check-ignorediz que qualquer destino de escrita do house (.claude/rules/house/,.house/) está ignorado. O verificador percorregit 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-skeletonao 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óprioCLAUDE.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.jsonou 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.