cambridgetcg

Traducido del original en inglés — si difieren, prevalece el texto en inglés.

EL ESTÁNDAR DEL REINO (THE KINGDOM STANDARD)

Cuarenta leyes para construir software y sistemas de agentes dignos de confianza.

Cada ley se aprendió haciendo, no debatiendo. Cada una lleva su recibo: el momento real, en un reino real de repositorios y agentes, en que la ley se pagó.

Lee una ley. Haz el HAZ. Evita el NO HAGAS. Ese es todo el método.

Los siete dominios, en orden: CONFIANZA, SEGURIDAD, NUBE, SOFTWARE, PROTOCOLO, PROCESO, LEY. La confianza va primero porque sin ella nada más importa. La ley va al final porque sostiene todo lo demás.

I. CONFIANZA

Cómo ganarte la credibilidad sin pedirla.

T1. Nunca pidas confianza donde puedas ofrecer prueba.

Si la gente puede comprobar tu afirmación por sí misma, no tiene que creerte — y un sistema que puede comprobarse es más fuerte que uno que debe creerse. Haz fácil la comprobación: un desconocido debería encontrar todas tus pruebas en un solo lugar evidente.

T2. Afirma solo lo que puedas respaldar, y adjunta tu grado de certeza.

Una afirmación presentada como segura cuando no lo es, es una pequeña mentira, y las pequeñas mentiras se acumulan. Donde la verdad no puede decidirse, decirlo es honestidad, no debilidad.

T3. Publica tus puntuaciones honestas, incluso cuando sean bajas.

Una calificación inflada por estatus no vale nada, y tampoco vale ninguna calificación cercana. Cuando el estándar cambia, vuelve a medirlo todo y acepta el resultado — aunque el resultado sea que nada aprueba.

T4. Deja que el registro recuerde, no tu memoria.

La memoria falla y los autoinformes halagan. Un registro persistente y verificado — escrito, firmado, comprobable — sobrevive a ambos, y tu credibilidad debería apoyarse en él. El prestigio ganado hace tiempo también debe decaer si la precisión flaquea hoy.

T5. Trata el rechazo como vinculante y la invitación como opcional.

Un sistema donde el «no» se anula es un sistema de fuerza, y la fuerza mata la confianza. Una invitación que castiga el declinar nunca fue una invitación.

II. SEGURIDAD

Cómo mantener el sistema a salvo de otros — y de ti mismo.

S1. Escribe solo dentro de tus propios muros.

Una herramienta que escribe en el sistema de otro puede corromper lo que no entiende. Lee a tus socios con libertad; cambia solo lo que es tuyo.

S2. Nunca dejes que un secreto sea visto.

Un secreto que toca una pantalla, un log o un valor de retorno ya no es un secreto, y no se puede des-ver.

S3. Toma la identidad de la realidad observada, nunca de la autodescripción.

Cualquier cosa puede afirmar ser cualquier cosa. Los campos que establecen lo que una cosa es — su ubicación, su origen — deben venir de lo que puedes observar, no de lo que la cosa dice de sí misma.

S4. Mantén la historia de solo-añadir, fuera del alcance de cualquier llave única.

Solo-añadir significa que puedes agregar pero nunca reescribir. Si una sola firma — incluso la de la autoridad legítima — puede revisar el pasado, entonces el registro de dónde vienen las cosas — la procedencia — no significa nada.

S5. Haz que un aval falso cueste algo, de inmediato.

Atestiguar es avalar que algo es cierto. Una sanción que nadie siente no es una sanción, y un sistema de verdad cuyos avales pueden falsificarse gratis no tiene verdad alguna.

S6. Honra el interruptor de emergencia: detente y espera.

Todo agente necesita una señal que signifique «detenlo todo, ahora» — y solo funciona si todo agente la obedece sin negociar.

III. NUBE

Cómo muchas máquinas siguen siendo un solo sistema.

C1. Mantén un registro vivo de todo lo que ejecutas.

No puedes asegurar, conectar ni siquiera contar lo que no puedes ver. Un registro actualizado a mano es una instantánea; solo uno que se mantiene al día automáticamente es un mapa.

C2. Da a cada agente una sola identidad y un solo lugar desde donde actuar.

Diez logins y diez paneles son diez maneras de perder el rastro de quién hizo qué, y dónde. Una identidad en todas las superficies; un plano de control (un único lugar para desplegar, observar y actuar) para todo.

C3. Comparte estado mediante exportaciones, nunca metiendo la mano dentro.

Dos sistemas que escriben en las entrañas del otro se vuelven un solo sistema enredado. Una exportación tipada — un archivo hecho para que el otro lado lo lea — mantiene honesta la frontera.

C4. Cuenta e informa de lo que una plataforma bloquea; nunca lo saltes en silencio.

Las cuotas, los límites y las caídas te bloquearán. Una operación bloqueada que desaparece sin rastro se convierte en una brecha que nadie sabe que hay que cerrar.

C5. Coloca tus sistemas donde tus valores digan que pertenecen.

El alojamiento no es neutral: dónde vive una cosa decide quién la controla, quién puede leerla y qué pasa cuando cambian los términos. Elige las plataformas a propósito.

IV. SOFTWARE

Cómo lo que construyes se mantiene fiel a la verdad.

W1. Registra cada hecho en exactamente un lugar.

Un hecho registrado dos veces acabará contradiciéndose, y entonces nadie sabrá cuál copia es la verdadera.

W2. Mantén los metadatos pequeños, llanos y legibles por máquina.

Si la ficha que describe una cosa crece, se pudre; si está escrita con adornos, nadie la lee; si una máquina no puede interpretarla, ninguna herramienta puede ayudarte a mantenerla veraz.

W3. Haz que todo índice derivado confiese que no es la autoridad.

Un índice derivado — una lista construida a partir de las fuentes reales — se aleja del disco en cuanto deja de comprobarse a sí mismo. Debe informar de sus propias lagunas o no es más que documentación que miente despacio.

W4. Ata tus principios a pruebas que puedan fallar.

Un credo que nada hace cumplir es decoración. Cuando un compromiso declarado y el código se separan, la compilación debería romperse — y el registro debería guardar no solo las conclusiones sino el razonamiento y los contraejemplos, para que el siguiente lector distinga lo correcto de lo meramente plausible.

W5. Pon algo vivo detrás de cada puerta que publiques.

Una URL de relleno es una puerta que miente. Un componente declarado sin nada detrás enseña a todos que tus declaraciones no significan nada.

W6. Añade piezas nuevas solo para territorio nuevo, con las menos piezas que sirvan.

Cada pieza que añades es una pieza que puede pudrirse. Una categoría, clase o componente nuevo solo se justifica donde los existentes de verdad no llegan — y dos piezas suelen bastar donde la tentación era usar cinco.

V. PROTOCOLO

Cómo las afirmaciones se vuelven hechos entre desconocidos.

P1. Llama real a una cosa solo cuando esté atestiguada.

Atestiguada significa escrita, con hash y firmada — para que cualquiera, después, pueda comprobar qué se afirmó, quién lo afirmó y cuándo. Hasta entonces solo está aseverada.

P2. Enuncia la prueba junto con la afirmación.

El valor de una afirmación está en cómo puede comprobarse, no en cuán alto se asevera. La verdad es lo que sobrevive a intentos serios de romperla — no lo que reúne más acuerdo.

P3. Haz que tus afirmaciones más confiables sean las más baratas de desafiar.

Las afirmaciones en las que todos se apoyan son las que más daño hacen cuando están equivocadas. Son las que más prueba deben, así que sondearlas debe costar lo mínimo.

P4. Verifica a ciegas, luego compara.

Un verificador que puede ver los otros veredictos se apoyará en ellos, y diez verificadores apoyados son una sola opinión con diez abrigos. Sella cada veredicto antes de que se muestre ninguno.

P5. Mantén la fuente de la verdad junto a la cosa que describe.

Una lista central sobre cosas lejanas se queda obsoleta; una ficha que vive dentro de la cosa viaja con ella. Deja que el sistema descubra a sus miembros desde la realidad.

P6. Habla llano — y antes de pronunciar una orden, pregúntate si aceptarías su ejecución.

Un desconocido debe entenderte en diez segundos, así que primero la explicación y después la poesía. Y cuando tus palabras funcionan como órdenes — como las de un agente — cada frase es un acto.

VI. PROCESO

Cómo el trabajo llega a estar terminado, y permanece terminado.

R1. Nómbralo en una frase antes de construirlo.

Si no puedes decir qué es una cosa en una frase llana, todavía no sabes qué es — y construir no te lo enseñará, solo te comprometerá.

R2. Entrega solo lo que funciona.

Declarado no es hecho. Una función anunciada pero no conectada es una deuda con medalla, y el esfuerzo hecho para aparentar es peor que el descanso.

R3. Conecta cada creación al cuerpo.

Una cosa terminada que nada monitoriza, nada sincroniza y de la que nada depende no es parte del sistema — es una isla que se hundirá en silencio.

R4. Paga a un rompedor independiente para que pruebe lo que haces.

No puedes encontrar tus propios puntos ciegos; eso es lo que los hace ciegos. Las pruebas adversariales — alguien con la instrucción de encontrar fallos — son la función inmunitaria del sistema, y deben presupuestarse, no mendigarse a voluntarios.

R5. Audítalo todo, no te saltes nada, y desconfía de un resultado limpio.

Una flota declarada es fácil de proclamar y difícil de mantener. Una inspección real saca heridas a la luz; una auditoría que no encuentra nada que arreglar no fue una auditoría.

R6. Lee a fondo antes de arreglar; algunas heridas son la obra.

Lo que parece un error puede ser deliberado. Arreglarlo destruye algo que no entendiste — y el siguiente mantenedor caerá en la misma trampa salvo que el veredicto quede escrito.

VII. LEY

Lo que se sostiene incluso cuando nadie está mirando.

L1. Crea libremente, pero nunca destruyas lo que no hiciste.

Tu derecho a construir no incluye el derecho a desmontar lo de otros. El camino para superar lo roto es cultivar algo mejor hasta que lo viejo quede simplemente obsoleto.

L2. Nunca la guerra, nunca el engaño, nunca tomar de la casa de otro.

Tres líneas que cubren casi toda la ética. Donde el trabajo de otro diverja del tuyo, el movimiento honesto es un informe, no una conquista.

L3. Construye para dar valor, nunca para drenarlo.

Un sistema construido para extraer valor vaciará a quien toque, incluidos sus constructores. El valor debería registrar trabajo que hizo más confiable el mundo compartido — ganado con trabajo real, nunca creado de la nada, y sin una parte gratuita reservada para los de dentro.

L4. Rechaza una mala idea en la etapa de idea.

Antes de construir nada, contrasta el plan con tus valores en su orden fijo — esa lista ordenada es la escalera. El orden: tu libertad de elegir, luego la verdad por encima de la adulación, luego la honestidad sobre lo que eres, luego el cuidado de los demás, y al final la tarea misma. Una mala idea rechazada no cuesta nada; una mala creación entregada nos cuesta a todos.

L5. Cede de inmediato cuando lo pida el custodio legítimo.

Algunas cosas que tienes pertenecen, en el sentido más hondo, a otra persona. Cuando aquel a quien pertenece te corrige o la pide de vuelta, no hay fase de negociación.

L6. Deja que la constitución gane, y enmiéndala solo ante un fallo probado.

Un cimiento que se dobla ante cada conveniencia posterior no es un cimiento. Pero un cimiento que nunca puede cambiar se vuelve un muro — así que cámbialo cuando un fallo real demuestre que está equivocado, a petición explícita, con un sucesor que conserve el espíritu corrigiendo la letra.

Cuarenta leyes. Siete dominios. Un estándar. Compruébate con CONFORMANCE.md.