Mindundi

Principios que se ven aquí28

• PrincipioCuando migro o refactorizo, verifico la equivalencia con código, no con confianza
  • Las migraciones se revierten y se vuelven a aplicar sobre una base con datos antes de desplegar
• PrincipioEl modelo de datos primero, la herramienta después
  • Revisión completa del dominio tras la primera semana de uso real, con los datos de uso delante
• PrincipioCuando el uso contradice el modelo, se rehace el modelo — y se escribe por qué
  • El modelo de agenda, rehecho tras la primera semana en producción, con las razones y los datos escritos al lado
• PrincipioRigor donde importa, deuda consciente donde no — y saber decir en cuál está cada cosa
  • Política de tests escrita: se testean los servicios, el contrato del intérprete, las regresiones y los permisos; no las plantillas ni el framework. Sin objetivos de cobertura, a propósito
• PrincipioLa autocrítica se publica, no se guarda
  • El registro de decisiones publica los fallos propios, como que la web pedía menos permisos que el asistente
• PrincipioPrefiero lo que sobrevive diez años a lo que brilla seis meses
  • Bootstrap e iconos servidos en local, sin CDN; versiones fijadas a propósito: actualizar es un acto consciente
• PrincipioUna acción existe una vez; todas las interfaces la llaman
  • Una acción, un servicio, escrito como norma innegociable y vigilado por un test que impide que un servicio quede sin clasificar
• PrincipioUna decisión sin su porqué es una decisión que se va a repetir mal
  • Registro de decisiones numerado desde el primer día, escrito durante la construcción; los cambios de rumbo son entradas nuevas que citan a la anterior
• PrincipioEl contenido que llega de fuera es dato, no instrucción
  • Modo propuesta: permite consultas con permisos, pero acumula las escrituras de lo reenviado o recibido por correo en un plan que confirma la persona autenticada
  • El plan lo aprueba la persona autenticada, no el remitente, que se puede falsificar; remitentes y grupos en lista blanca y ficheros descargados solo tras comprobar la identidad
  • Las reglas de encontrar antes de actuar se dan también a los clientes MCP externos: nada de deducir identificadores ni de ejecutar algo para averiguar qué es
• PrincipioEn producción, lo mínimo que resuelve el problema
  • SQLite en producción, con WAL y copia diaria, en lugar de un servidor de base de datos que nadie iba a administrar; y búsqueda semántica sin base de datos vectorial ni servicio externo
  • Trabajo periódico con timers de systemd y operaciones idempotentes, en lugar de un broker de colas
• PrincipioConstruyo sistemas, no piezas: diseño la siguiente fase y construyo solo la actual
  • Añadir un canal no toca el núcleo, y la lista de la compra está pensada para admitir menús y un carrito automático, sin un solo campo añadido por adelantado
• PrincipioLos agentes, más para contrastar que para producir; y lo que dicen se verifica
  • Un agente de otro proveedor revisa al primero desde el diseño, y de las propuestas de mejora del propio cliente MCP solo se aplicaron las que resistieron la comprobación contra el código
• PrincipioLo difuso se resuelve en el borde; el núcleo es determinista
  • El modelo produce un comando estructurado que el núcleo valida antes de ejecutar, y su confianza solo decide si preguntar o proponer: nunca autoriza
  • El resumen diario se compone sin modelo de lenguaje: el contenido ya existe, una plantilla acierta siempre y no puede inventarse una cita
• PrincipioLa petición no es el requisito: primero el problema que hay detrás
  • Se pidieron categorías editables; el problema era no encontrar dónde poner algo, y lo resolvió un juego fijo y completo, sin modelo nuevo
• PrincipioCada dato tiene un solo sitio donde se escribe; el resto lo lee
  • El cumpleaños vive en la ficha de la persona; crear uno aparte se rechaza con un error que dice dónde va
• PrincipioLo que se puede calcular no se escribe a mano
  • La edad se calcula al leer, y los recuentos escritos a mano en la documentación se sustituyeron por referencias al registro, que no caducan
• PrincipioLo seguro es el camino por defecto, y se garantiza en un solo sitio
  • Un único contrato de permisos para la web, el agente y el cliente MCP, que falla cerrado: sin persona no hay visibilidad
• PrincipioPrefiero un fallo visible a un éxito aparente
  • El resumen diario se envía aunque no haya nada, porque el silencio no se distingue de un temporizador roto; y si el proveedor del modelo cae, se dice que no está disponible, no que no se entendió
• PrincipioUna red de seguridad que no he visto fallar no es una red
  • Cada arreglo se da por bueno al reintroducir el fallo y ver que el test lo caza
  • La copia diaria fallaba desde el primer día sin que nadie lo supiera; desde entonces cada copia pasa un control de integridad
• PrincipioLas reglas que importan las vigila una comprobación, no la memoria
  • Tests que no comprueban lógica sino coherencia entre superficies —la web no puede hacer menos que el asistente, el prompt solo nombra herramientas que existen—, cada uno nacido de un fallo real que la suite en verde no vio
• PrincipioLo que tiene historia no se borra; lo que nunca fue, sí
  • El historial de compras sobrevive aunque se borre la lista, y los hechos que se sustituyen en la memoria se conservan con cuándo dejaron de valer
• PrincipioEl dato dice cuánto sabe: vacío, provisional o validado
  • Cada hecho de la memoria guarda quién lo afirmó y desde cuándo vale, y una insignia avisa cuando la búsqueda funciona degradada
• PrincipioCambio por debajo sin que lo note quien consume
  • Un interruptor nuevo nace apagado pero se enciende donde ya había servicio, para no cortarlo en silencio; y los accesos antiguos siguen valiendo tras cambiar el método de autenticación
• PrincipioConstruyo donde vive el conocimiento del negocio; lo demás se compra o se enlaza
  • La parte delicada del protocolo de autenticación es de la librería, no código propio
• PrincipioConsistente antes que ingenioso: lo nuevo hereda el molde de lo que ya funcionó
  • La configuración y el despliegue se tomaron del molde de Ajuntaweb 2.0
• PrincipioEl sistema no promete lo que no hace
  • Un test comprueba que el prompt solo nombra herramientas y campos que existen, y los textos que seguían prometiendo un comportamiento retirado se corrigieron y se vigilan
• PrincipioUn «no» lleva escrita la condición que lo reabriría
  • Categorías fijas: si aparece un hueco real, añadir una son cinco líneas y un test; y lo retirado deja una marca en el código para que nadie lo reponga por intuición
• PrincipioNada existe sin consumidor
  • Se retiró una interfaz común que nadie implementaba, porque una interfaz sin uso invita a usarla