declare-when-a-setting-takes-effect
Un control que guarda correctamente y no cambia nada hasta reiniciar es peor que uno que falla. Di cuándo se aplica, y deriva eso de dónde se lee el valor.
Conferida por quien revisó y leyó la tarjeta, no reclamada por el propio archivo. Una tarjeta que el agente destila durante una ejecución que consumió contenido no confiable nace contaminada y queda retenida para revisión antes de ser recuperada.
Cuándo viene a la mente
- agregando una pantalla de configuración
- la configuración está cacheada
- por qué no se aplicó mi cambio
- requiere reinicio
Evita y Comprueba es donde suele estar el valor. Haz es la sección que todo el mundo escribe.
El cuerpo de la tarjeta de arriba es una traducción. El original en inglés es lo que importa la CLI, lo que lee el agente en ejecución y lo que atestigua el hash de abajo.
Disparador
Estás exponiendo un ajuste en una interfaz de usuario, y el código que lo consume lee el valor en algún momento distinto de cada uso: al iniciar el proceso, al construir una sesión, o hacia un objeto en caché.
No aplica a un ajuste que se lee en cada uso. Esos aplican de inmediato y no deberían decir nada — una nota sobre un retraso que no existe enseña la misma desconfianza que una nota ausente.
Haz
- Para cada ajuste, encuentra la línea que lo lee. Cuándo aplica es una propiedad de esa línea, no del control.
- Prefiere hacer que se lea en vivo. Una propiedad que se resuelve al accederla normalmente no cuesta nada y elimina el problema en lugar de describirlo.
- Donde genuinamente no se pueda — algo se inicia al arrancar — etiquétalo, y genera la etiqueta desde el servidor o el mismo módulo que conoce el punto de lectura, para que la etiqueta no pueda desincronizarse.
- Agrupa las etiquetas en clases con sentido: aplica ahora, aplica en tu próxima conversación, aplica después de un reinicio.
Evita
Una pantalla de ajustes que confirma un guardado y silenciosamente no hace nada. Es peor que un error: un error envía al usuario a buscar una causa, mientras que un éxito lo lleva a culpar a la funcionalidad, al modelo, o a sí mismo.
Evita codificar la lista de «necesita reinicio» en la interfaz. Esa lista es una copia de un conocimiento que vive en otro lugar, y se vuelve obsoleta la primera vez que un punto de lectura se mueve — silenciosamente, que es como se creó el problema original.
Evita una nota genérica de «algunos ajustes requieren reinicio». Es verdadera, inútil, y cubre a los que no lo requieren.
Comprueba
Cambia el ajuste, usa la funcionalidad, y observa el comportamiento — no la pantalla. Lee de vuelta un valor desde el sistema en ejecución, no desde el formulario que acabas de enviar.
La versión mecánica: verifica que ningún ajuste esté etiquetado como inmediato sin serlo, y que cada ajuste que la interfaz expone aparezca en la clasificación que publica el servidor.
Riesgo
Las etiquetas añaden ruido a una pantalla de ajustes, y una pantalla donde cada fila tiene una insignia es una pantalla donde las insignias no significan nada. Solo los ajustes retrasados necesitan una.
El riesgo más profundo es tratar la etiqueta como la solución. Declarar que un control está inerte hasta el reinicio es honesto; hacerlo funcionar en vivo es mejor, y la etiqueta no debería convertirse en una forma cómoda de evitar el cambio más difícil.
Cómo usarla
La tarjeta es un dato. Clona el repositorio e impórtala por ruta: lo que llega por la red se trata como contaminado y queda retenido a la espera de aprobación, que es el comportamiento deseable y la razón por la que aquí no hay un instalador de una línea.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/declare-when-a-setting-takes-effect/SKILL.mdIntegridad
SHA-256 del archivo tal como se publicó. Quien lo importe puede comprobar que lo que recibió es lo que mostró esta página.
2f1c9fd86ac24a61af75b11945b5042d1a2b53ef081cd9a87c3031d5fa97fcf3