Bootstrap
Bootstrap convierte un repositorio no gestionado en un consumidor de house. Sondea el repositorio, propone un
house.json y, al usar --apply, escribe las reglas empaquetadas, plantillas y un esqueleto de CLAUDE.md.
Nunca edita un CLAUDE.md existente y nunca se ejecuta dos veces sobre el mismo manifiesto.
Escribe solo la parte house de CLAUDE.md, como un archivo esqueleto separado, y deja la parte
derivada del código base al comando init de harness, que genera un CLAUDE.md inicial o
sugiere mejoras al que ya existe.
Este skill tiene efectos secundarios en disco, por lo que nunca se activa por sí solo. Ejecútalo solo cuando se te pida.
Ruta por defecto
- Simulación (dry run): sondea el repositorio e imprime el
house.jsonpropuesto. No escribe nada. - Muestra la propuesta a la persona que ejecuta el skill y espera a que diga aplicar.
- Aplicar: escribe
house.json, luego renderiza las reglas, plantillas y esqueleto. - Imprime el bloque de configuración a continuación para que la persona pueda pegarlo en
package.json, CI y su terminal.
No omitas el paso 2. Una propuesta que la persona nunca vio no es una propuesta, es una sorpresa.
Rechazar cuando existe un manifiesto
Antes de sondear cualquier cosa, verifica si house.json ya existe en la raíz del repositorio.
Si existe, recházalo. Imprime que el repositorio ya tiene un manifiesto y señala a /house-rules:sync
en su lugar. Esto se aplica también en la simulación: bootstrap nunca redacta una segunda propuesta sobre una primera,
incluso una que nadie haya aplicado todavía. Un repositorio recibe exactamente un bootstrap.
Sondear el repositorio
Ejecuta la CLI en modo simulación para recopilar lo que necesita la propuesta:
node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <path>
La sonda lee, y no escribe:
- Stack: presencia de
package.json, sus scripts y cualquier archivo de configuración del framework en la raíz. - Rama por defecto:
git symbolic-ref refs/remotes/origin/HEAD, con fallback a la rama actual. - Directorios de nivel superior, para adivinar qué módulos opcionales aplican (
db/sugieredatabase, una configuración de despliegue sugieredeployment, etc.). - Si ya existe
.claude/rules/o un hook de guardia de rama, para que la propuesta pueda indicar qué añadiría bootstrap versus lo que el repositorio ya tiene. - Si el escaneo de documentación actual del repositorio ya excluye un nivel de archivo, para sembrar
scanArchivea partir del comportamiento observado en lugar de una suposición. - Si
git check-ignoredice que algún destino de escritura de house (.claude/rules/house/,.house/) está ignorado. El verificador recorregit ls-files, por lo que un archivo de regla ignorado es invisible para él y la primera ejecución imprime un cero que nunca se ganó. La sonda advierte y nombra la solución: ignorar solo.claude/settings.local.json, nunca.claude/o.house/.
Proponer house.json
Cada módulo que la sonda no pueda descartar va a la propuesta como "detect", no true o
false. "detect" significa que el repositorio decide en tiempo de renderizado, no que el skill adivine por él.
Los módulos centrales (docs, engineering, github, claude-code) siempre están activos. Imprime el
cuerpo completo del house.json propuesto, no un resumen, para que la persona que lo revise pueda leer cada campo
antes de que se escriba algo.
Aplicar: escribir el manifiesto, las reglas y el esqueleto
Solo después de que la persona diga aplicar:
node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <path> --apply
node ${CLAUDE_PLUGIN_ROOT}/scripts/house render --repo <path> --apply
init --apply escribe house.json. render --apply escribe los archivos de reglas empaquetadas, las
plantillas, .house/check.mjs, .house/lock.json, .house/INDEX.md y un archivo más:
- Si el repositorio tiene un
CLAUDE.md, escribeCLAUDE.md.house-skeletonjunto a él. No abras elCLAUDE.mdexistente ni escribas en él. - Si el repositorio no tiene
CLAUDE.md, escribeCLAUDE.md.house-skeleton, noCLAUDE.md. Bootstrap nunca origina el archivo raíz del repositorio. La persona fusiona el esqueleto manualmente.
De cualquier forma, un CLAUDE.md existente es idéntico byte a byte antes y después de cada ejecución de bootstrap. Ese
es el control que este skill debe cumplir: haz un diff antes de aplicar, haz un diff después, y si
algo cambió, detente y dilo en lugar de reportar éxito.
El esqueleto se ofrece una vez por repositorio: render lo registra en .house/lock.json bajo
scaffolds, por lo que una vez que se ha fusionado en CLAUDE.md y eliminado, ningún render posterior lo escribe de nuevo.
render --apply --scaffold es la forma de solicitarlo de nuevo.
Asegúrate de que el .gitignore del repositorio contenga .claude/worktrees/ y .superpowers/, añadiendo
la línea que falte. El scratch de herramientas que aparece en git status está a un git add -A de ser
confirmado.
Imprimir la configuración
Después de una aplicación exitosa, imprime este bloque textualmente para que se pueda copiar y pegar en una
terminal normal. No rellenes nada; la persona lo adapta a su package.json y archivo de flujo de trabajo.
Añadir a los scripts de package.json:
"check:docs": "node .house/check.mjs --only=drift,todo"
"check:house": "node .house/check.mjs"
Añadir un paso de CI que ejecute:
node .house/check.mjs
Instalar el plugin una vez por máquina:
claude plugin marketplace add dubbl-a/house-rules
claude plugin install house-rules@house-rules --scope user
Armar los hooks de git una vez por clon (render --apply y cada inicio de sesión también hacen esto):
git config core.hooksPath "$(pwd)/.githooks"
core.hooksPath vive en .git/config, que ningún clon ni ninguna PR lleva, por lo que el árbol
.githooks/ empaquetado está inerte en un checkout nuevo hasta que algo lo establezca. render --apply y el
hook SessionStart del plugin lo arman ambos; la línea de arriba es para un clon que no tiene ninguno. Ni ellos
ni la persona deben sobrescribir un core.hooksPath que ya posea otra herramienta.
Si el repositorio no tiene .claude/settings.local.json, dílo en la salida impresa. Ese archivo es
donde viviría la exclusión voluntaria por repositorio de un módulo house o hook, y su ausencia significa que el repositorio
está funcionando solo con valores predeterminados.
Después del bootstrap
Dile a la persona lo que aún no se ha hecho: el esqueleto todavía necesita fusionarse en CLAUDE.md manualmente
y luego eliminarse (no se volverá a escribir),
el bloque de configuración aún debe pegarse y node .house/check.mjs vale la pena ejecutarlo localmente antes de
la primera confirmación para que el repositorio comience desde una compuerta limpia en lugar de un fallo heredado. Prepara los archivos renderizados por ruta primero (house.json .house/ .claude/rules/house/, más scripts/house/
solo cuando render haya listado un archivo allí, ya que git rechaza un pathspec que no coincida con nada): hasta
que estén preparados, la familia de manifiestos advierte [untracked] por archivo, y una ignorancia masiva de .claude/ o
.house/ es un hallazgo [gitignored], porque un archivo que git no puede ver es uno que ninguna familia
verifica. Nada de eso es trabajo de este skill hacer por ellos; bootstrap termina en render.
No hacer
- No escribas
house.jsonni ningún archivo renderizado durante la simulación. La simulación solo imprime. - No sobrescribas ni añadas a un
CLAUDE.mdexistente, nunca, bajo ningún indicador. - No vuelvas a proponer sobre un repositorio que ya tenga
house.json. Envíalo a/house-rules:sync. - No adivines un módulo activado o desactivado cuando la sonda sea ambigua. Propón
"detect"y deja que el repositorio decida.