build-the-gate-before-the-content
Una comprobación añadida después de lo que protege es una comprobación que alguien apaga para poder entregar. Déjala cerrada mientras no hay nada que bloquear.
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
- planeando una migración
- empezando una superficie nueva
- el lint lo agregamos después
- ordenando el trabajo
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 a punto de construir algo que necesitará una regla aplicada en todo su alcance — una restricción de estilo, una verificación de vigencia, un esquema, un validador de enlaces, un presupuesto. El orden natural es construir la cosa y añadir la verificación una vez que haya algo que verificar.
No aplica a una verificación que estás añadiendo a código que ya existe; ese es un trabajo diferente y más difícil, y la respuesta ahí es un trinquete, no un muro.
Haz
- Añade la verificación en el primer commit, antes de que exista contenido sobre el cual pueda fallar. Pasa trivialmente, que es justo el punto: empieza su vida en verde.
- Dale un mensaje de fallo que diga qué ejecutar. Una compuerta cuya salida es
assert Falsetermina siendo borrada por la próxima persona que la encuentre a las 2 de la madrugada. - Escribe la verificación para que falle en la primera violación, no en la centésima. Los trinquetes son para código heredado; lo nuevo empieza en cero.
- Cuando la verificación se dispare, corrige el contenido. Cada vez que cambies la verificación en su lugar, anota en el mensaje del commit qué caso la forzó.
Evita
«La activaremos cuando las páginas estén escritas.» Para entonces la verificación tiene un backlog, activarla significa un día de correcciones no relacionadas, y el camino más barato es una lista skip que nunca se reduce.
Evita también relajar una compuerta en el mismo commit que la funcionalidad que la disparó. El relajamiento es invisible en un diff grande, y es exactamente el momento en que una compuerta deja de serlo — así que pertenece a su propio commit con su propia explicación.
Comprueba
Introduce una violación a propósito y confirma que el build se pone en rojo — luego elimínala. Haz esto el mismo día en que escribes la compuerta, no después.
Una compuerta a la que nadie ha visto fallar no es una compuerta; es un archivo que afirma serlo.
Riesgo
Una compuerta escrita antes que el contenido codifica una suposición sobre contenido que aún no existe, y algunas de esas suposiciones resultan equivocadas. Espera tener que estrecharla una o dos veces al principio.
Ese estrechamiento es el momento peligroso. Cada uno debilita la regla, y una regla estrechada tres veces sin que nadie lo note es una regla que ya no cubre el caso para el que fue escrita. Fija cada estrechamiento con el ejemplo que falló y lo provocó.
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/build-the-gate-before-the-content/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.
58c3de3bf7323fb3be38d084394e45ff97e408c20c45db31749cde2b8a13fc81