Communitygithub.com

dubbl-a/house-rules

Adapta las reglas internas a una nueva versión de Claude Code o modelo Claude, para que el paquete siga complementando el arnés en lugar de duplicarlo o contradecirlo.

¿Qué es house-rules?

Este skill automatiza la tarea de actualizar las reglas internas (house rules) de un proyecto cuando Claude Code o un modelo de Claude lanza una nueva versión que podría romper la compatibilidad. Detecta cuatro tipos de desajustes: reglas duplicadas (cuando el arnés nativo ahora implementa lo que una regla hacía), conflictos (cuando el comportamiento del arnés cambió), reglas desactualizadas por modelo nuevo, y la necesidad de citar nuevas funcionalidades del arnés. Funciona en repositorios locales de Claude Code (no se envía a adopción) y sigue un flujo de trabajo estructurado: entra en un worktree limpio, encuentra la línea base de la última encuesta, recopila el delta de cambios del changelog, las páginas de modelos y una auditoría de prompt, clasifica cada candidato como DUPLICATE, CONFLICT, COMPLEMENT o UNIQUE, verifica cada hallazgo con dos escépticos (uno de documentación y otro de ejecución), aplica modificaciones de redacción o retiro, y registra todo para una liberación. Soporta dos profundidades: "delta addendum" para pequeños cambios, y "full re-survey" para cambios grandes que tocan múltiples áreas o un nuevo modelo. Incluye salvaguardas como verificar que los hallazgos de la auditoría de prompt no colisionen con la forma estructural del paquete, y que cada redacción de complemento se verifique contra hechos documentados.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dubbl-a/house-rules/tree/HEAD/.claude/skills/adapting-to-harness-updates

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Adaptación a actualizaciones del arnés

La prueba permanente del paquete: complementar y mejorar el arnés, y nunca duplicarlo o entrar en conflicto con él a menos que se declare a propósito, nombrando el piso nativo. Una versión del arnés puede romper esa prueba de tres maneras. Puede enviar de forma nativa lo que hace una regla o mecanismo, por lo que la regla se convierte en un duplicado. Puede cambiar el comportamiento que describe una regla, por lo que la regla se convierte en un conflicto. O puede agregar un piso que una regla debería citar. Un nuevo modelo también puede hacer que el estilo de instrucción de una regla quede desactualizado incluso cuando todo hecho en ella sigue siendo válido. Este skill encuentra los cuatro y los corrige.

Ruta predeterminada

  1. Entra en un worktree desde origin/main antes que cualquier otra cosa. Los flujos de trabajo de encuesta leen una copia limpia, así que apúntalos a un segundo worktree que nadie edite.
  2. Encuentra la línea base. La última versión y fecha encuestadas están en la sección fechada final de docs/handbook/sources/harness-survey.md. La última sección de reencuesta allí nombra el directorio del banco de investigación. Los hechos del modelo registrados están en los párrafos "escalera" de docs/handbook/claude-code.md. npm run check:harness imprime esa línea base y cada versión del changelog desde entonces, y la Acción programada harness-watch archiva un issue harness-update cuando la lista no está vacía. Cuando los secretos HARNESS_ROUTINE_URL y HARNESS_ROUTINE_TOKEN están configurados, la Acción también activa una rutina en la nube. La rutina ejecuta la ruta del addendum delta y abre un PR borrador en claude/harness-addendum-<version>. Cuando ese PR existe, comienza desde él en lugar de volver a clasificar. Compara también con claude --version.
  3. Ejecuta la puerta bajo el nuevo CLI antes de leer nada: npm run verify en una copia limpia. El validador de complementos se ejecuta con --strict, por lo que una advertencia que agrega una versión hace fallar la puerta, y una clasificación del changelog puede leer esa entrada como ruido.
  4. Recopila el delta en el bloc de notas, una fuente por agente:
    • las secciones del changelog de Claude Code desde la línea base (https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md), la única fuente que fecha un cambio;
    • las páginas de descripción general de modelos y configuración de modelos, para nuevos modelos, valores predeterminados, precios y esfuerzo;
    • la auditoría de prompt del propio arnés sobre este repositorio (/doctor prompt-audit en una sesión). Informa rutas obsoletas, comandos muertos, instrucciones contradictorias y patrones de instrucción escritos para modelos más antiguos.
  5. Elige la profundidad. Usa el criterio a continuación. Di cuál elegiste y por qué.
  6. Clasifica y categoriza. Cada candidato recibe una disposición: DUPLICATE, CONFLICT, COMPLEMENT, o UNIQUE (definiciones en references/dispositions.md). Busca en los archivos de reglas, plugins/house/orchestration/ORCHESTRATION.md, los agentes, los hooks, los skills y las evaluaciones cualquier texto que afirme el comportamiento anterior.
  7. Verifica. Un DUPLICATE o CONFLICT cuenta solo después de que dos escépticos no logren refutarlo. Uno lee para precisión de documentación y uno para realidad de aplicación, y cada uno por defecto lo refuta cuando no está seguro. La sesión luego lee la línea citada y el texto de la regla en sí. Cualquier cosa que puedas resolver ejecutándolo (--help, un hook con una carga útil real, el verificador), ejecútalo.
  8. Actúa según la disposición. Resuelve un conflicto en la regla o el hook. Retira un duplicado, o mantenlo como un duplicado declarado que nombra el piso nativo. Reformula un complemento solo donde la regla afirma o implica un piso, y cita el hecho. Registra un único y déjalo. Un hallazgo de auditoría de prompt cambia la redacción, nunca la afirmación de una regla, y debe ajustarse a la forma de regla que el verificador aplica. Antes de aceptar la desviación de un agente, una nota de "no bloqueante" de un revisor, o un "límite conocido", nombra la regla interna o recomendación de documentación que lo rige y toma la opción recomendada a menos que puedas decir por qué no.
  9. Registra en los tres lugares descritos en references/recording-and-release.md. Luego envía a través del flujo de liberación allí.

Elegir la profundidad

Addendum delta (el predeterminado). Clasifica solo las secciones del changelog y los cambios de modelo desde la línea base, con un investigador por fuente. Clasifica los aciertos contra la superficie de reglas, luego escribe una sección ## Addendum fechada. Esto se adapta a una o dos versiones de correcciones y características pequeñas, y un cambio de modelo cuyo efecto está en niveles y esfuerzo.

Reencuesta completa. Vuelve a investigar cada área del arnés desde la documentación, clasifica cada encabezado de regla y mecanismo, verifica, sintetiza y ejecuta un crítico de integridad. Luego ejecuta un pase de brechas sobre lo que el crítico nombre. Ejecuta la clasificación del changelog desde la ruta delta junto a él: las páginas de documentación no llevan fechas, por lo que sin el changelog una ejecución completa no puede distinguir una página actual de una obsoleta. Señales de que el addendum no es suficiente:

  • el delta toca varias áreas a la vez;
  • una nueva familia de modelos o valor predeterminado llega;
  • la auditoría de prompt marca patrones en muchos archivos;
  • un addendum descubre un conflicto en un área cuyos hechos bancarizados son anteriores al cambio;
  • el crítico de la última reencuesta enumeró áreas que nadie ha investigado desde entonces.

Los scripts son scripts/house-vs-harness-audit.js (principal) y scripts/house-vs-harness-gap-audit.js (brecha). Cada uno toma args.repo (una ruta absoluta al worktree limpio) y args.date. La ejecución de brecha también toma args.areas y args.targets de los hallazgos del crítico, además de una sentencia args.context opcional que indica el resultado de la ejecución principal para su addendum. Se ejecutan a través de la herramienta Workflow, que necesita la aceptación explícita del usuario. Antes de preguntar, indica el recuento de agentes: la ejecución principal es un investigador por área, un clasificador Opus por módulo más uno para mecanismos, dos escépticos por cada afirmación de duplicado o conflicto, y dos agentes de síntesis.

Peligros

  • La mayoría de los hallazgos son atribución, no sustancia. La reencuesta más grande hasta ahora no encontró duplicados ni conflictos, pero sí encontró 27 reformulaciones donde una regla afirmaba un piso nativo que la documentación no establece. Antes de que cualquier regla diga que el arnés hace algo, el hecho debe existir en el banco o en una página obtenida.
  • Los escépticos solo ven duplicados y conflictos. La reformulación propuesta de un complemento llega al informe sin ser verificada, y puede exagerar el arnés tan fácilmente como el texto anterior. Envía un refutador para verificar cada reformulación contra los hechos bancarizados antes de que se envíe.
  • Un recuento ingenuo de encabezados omite una regla. Cada archivo de reglas termina en ## Don't, y algunas reglas reales comienzan con "Don't". Cuenta los encabezados por coincidencia exacta, no por prefijo.
  • Las páginas de documentación no llevan fechas. Registra la fecha de obtención junto a cada cita. Si el changelog y una página difieren, confía en el changelog sobre el cuándo y en la página sobre el qué.
  • La configuración del modelo vive fuera del repositorio. El piso del subagente y el esfuerzo por modelo son ajustes del usuario. Cuando un cambio de modelo los mueve, dile al usuario qué configurar; nunca edites sus ajustes desde aquí. Un modelo recién lanzado se ejecuta con su esfuerzo predeterminado hasta que se aplique un nivel por modelo.
  • Un hallazgo de auditoría de prompt puede chocar con la forma interna. Una bandera de auditoría sobre una lista de prohibiciones o un número duro es una señal de estilo. La sección ## Don't y los techos de longitud son forma verificada y trinquetes, por lo que cambiarlos es una decisión del paquete bajo las ADR, no una reformulación.
  • El guardia de rama lee el texto del comando. Escribe cuerpos de PR y mensajes de commit que mencionen verbos de git cerca de nombres de rama con la herramienta Write, luego pásalos con --body-file o -F.
  • Los subagentes no hacen commit. La sesión hace commit y push de lo que sea que un agente haya preparado.

Cuándo surte efecto una edición aquí

Este skill es local al repositorio. Una edición llega a la próxima sesión que lo invoque por nombre, y nada se envía a los adoptantes. Lo que llega a los adoptantes son los cambios de reglas y mecanismos que produce, a través de una liberación y el render --apply de cada adoptante.

Individual skills in this repo

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

Skills relacionados