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
- Entra en un worktree desde
origin/mainantes 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. - 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" dedocs/handbook/claude-code.md.npm run check:harnessimprime esa línea base y cada versión del changelog desde entonces, y la Acción programadaharness-watcharchiva un issueharness-updatecuando la lista no está vacía. Cuando los secretosHARNESS_ROUTINE_URLyHARNESS_ROUTINE_TOKENestá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 enclaude/harness-addendum-<version>. Cuando ese PR existe, comienza desde él en lugar de volver a clasificar. Compara también conclaude --version. - Ejecuta la puerta bajo el nuevo CLI antes de leer nada:
npm run verifyen 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. - 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-auditen una sesión). Informa rutas obsoletas, comandos muertos, instrucciones contradictorias y patrones de instrucción escritos para modelos más antiguos.
- Elige la profundidad. Usa el criterio a continuación. Di cuál elegiste y por qué.
- 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. - 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. - 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.
- 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'ty 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-fileo-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.