Revisar documentación
El plugin oficial de gestión de archivos de instrucciones incluye un comando revise que captura el aprendizaje de una sesión añadiéndolo al archivo de instrucciones raíz. Ese es exactamente el comportamiento que esta habilidad existe para reemplazar. Un archivo raíz que solo crece deja de leerse hasta el final, y un aprendizaje atornillado a él rara vez es el hecho que una futura sesión necesitaba en el momento en que lo necesitaba. Esta habilidad conserva la mitad útil de ese plugin: auditar una afirmación contra la base de código antes de escribirla, y descarta la mitad de añadir en favor de enrutar. Las notas de memoria local de la máquina del harness ya capturan lo que una sesión aprendió y omiten lo que los archivos de instrucciones ya dicen, así que esta habilidad enruta la mitad compartible y verificada: una regla al archivo de reglas cuyos paths cubren la superficie que toca, un incidente al archivo del repositorio.
Ruta predeterminada
- Nombra lo que esta sesión produjo que vale la pena conservar: una corrección, una convención decidida, un error y su solución, un resultado medido, una decisión entre dos enfoques.
- Clasifícalo como una regla o un incidente.
- Una regla se mantiene cada vez que ocurre una situación similar. Establécelo una vez y debería seguir siendo cierto después del próximo refactor.
- Un incidente ocurrió una vez, en una fecha, con un nombre o un número medido adjunto. Es evidencia de por qué existe una regla, no la regla en sí.
- Enruta una regla a su archivo de reglas correspondiente.
- Busca archivos de reglas existentes por ámbito y encabezado, no solo por nombre de archivo. Abre aquel cuyos
paths:ya cubran la superficie que toca el aprendizaje. - Si uno lo cubre, añade un nuevo encabezado o integra el punto en uno existente. Sigue la forma de la regla: un encabezado imperativo que sea en sí mismo la regla, una cláusula de por qué, una línea
Anchor:que nombre lo que la aplica, una líneaReceipts:que apunte a la entrada del archivo, y mantén el archivo terminando en## Don't. - Verifica antes de escribir. Comprueba que cada token en la línea
Anchor:, cada ruta, cada nombre de script, realmente se resuelva en el repositorio ahora mismo. Este es el hábito de auditoría tomado del plugin anterior: nunca escribas una afirmación que no hayas verificado. - Si nada lo cubre, dilo y propón un nuevo archivo de reglas o un ámbito más amplio para uno existente. No dejes caer el punto en el archivo más cercano solo por su proximidad.
- Busca archivos de reglas existentes por ámbito y encabezado, no solo por nombre de archivo. Abre aquel cuyos
- Enruta un incidente al nivel de archivo del repositorio.
- El archivo es lo que el repositorio llama su documento de evidencia con fecha: un capítulo de manual, un archivo de historial de diseño, un registro postmortem. Escribe la fecha, el nombre, el número medido allí, titulado como una lección de una línea para que la entrada se lea como una afirmación en lugar de un nombre de archivo.
- Apunta el archivo de reglas a la entrada con su encabezado citado. No repitas los detalles específicos del incidente dentro de la prosa de la regla; una fecha o un número en una regla es historia vestida con ropa de regla.
- Si el repositorio aún no tiene archivo, dilo y propón iniciar uno. No incluyas el incidente en un archivo de reglas o en el archivo raíz por falta de un hogar.
- Nunca toques el archivo de instrucciones raíz. Si ni un archivo de reglas ni el archivo encajan, eso es una señal de que el hecho no es lo suficientemente duradero para conservarse, no una razón para incluirlo por defecto en el archivo raíz. Dilo claramente y detente.
- Muestra la edición antes de guardarla. Imprime el encabezado y el párrafo que propones, o un diff contra el archivo existente, y espera confirmación a menos que te hayan dicho claramente que simplemente hagas el cambio.
Cuando la coincidencia es una regla de la casa gestionada
Si el archivo que ya cubre el tema es una regla de la casa proveniente de un proveedor (lleva el encabezado de archivo gestionado, vive bajo .claude/rules/house/**), no lo edites en este repositorio. Una edición local a un archivo gestionado se sobrescribe silenciosamente en la siguiente ejecución de /house-rules:sync, y esa pérdida silenciosa es exactamente lo que house existe para prevenir.
Propón el cambio upstream en su lugar. Redacta el mismo encabezado y párrafo, luego di que se abra como un cambio en el repositorio house en lugar de este. Si el punto es genuinamente específico de este repositorio y no una regla para toda la flota, regístralo como una desviación en house.json en lugar de bifurcar el archivo gestionado. Cualquier camino mantiene el archivo gestionado sincronizado; editarlo en el lugar no.
Válvulas de escape
- El aprendizaje contradice una regla existente. Dilo claramente, cita el encabezado existente y pregunta cuál gana antes de escribir nada. No sobrescribas silenciosamente una regla con otra.
- El aprendizaje es un caso único específico del repositorio sin forma de regla, un workaround para un error del proveedor, una nota que solo importa una vez. Enrútalo al archivo como incidente en lugar de saturar un archivo de reglas con algo que ninguna futura sesión necesita obedecer.
- No estás seguro de si algo es una regla o un incidente. Inclínate hacia el archivo. Una regla archivada incorrectamente es un encabezado que alguien puede promover más tarde; un incidente tratado incorrectamente como regla se convierte en prosa obsoleta que nada señala.
- El repositorio no tiene archivos de reglas ni archivo alguno. Dilo claramente y detente en lugar de originar cualquiera de ellos desde dentro de esta habilidad. Ese es trabajo de
/house-rules:bootstrap, no de esta.
No hacer
- No añadas al archivo de instrucciones raíz. Ese es exactamente el comportamiento que realiza el comando
revisedel plugin oficial de archivos de instrucciones, y la razón por la que esta habilidad existe en su lugar. - No escribas una oración de regla cuyo ancla no hayas verificado contra la base de código.
- No repitas la fecha, nombre o número de un incidente dentro de la prosa de la regla; apunta al archivo.
- No edites un archivo de regla de la casa gestionada en el lugar. Propón el cambio upstream o registra una desviación.
- No guardes una edición que la persona no haya visto, a menos que te haya dicho claramente que simplemente la hagas.
- No inventes un archivo de reglas o un archivo cuando el repositorio no tiene ninguno.
No hacer
- No añadas al archivo de instrucciones raíz.
- No escribas una regla cuyo ancla no hayas verificado.
- No repitas detalles del incidente en la regla.
- No edites una regla gestionada en el lugar.
- No guardes sin mostrar la edición.
- No inventes archivos que no existen.