Arneses por arquitectura
Una serie de arneses base para arquitecturas de software. Todos rodean la misma app pequeña: solo cambian la arquitectura y el arnés.
La idea clave: el arnés es el protagonista; la arquitectura es el contexto. Cada página explica la arquitectura en breve y dedica el resto al arnés.
La serie está completa: cuatro arneses base, tres piezas reutilizables, el punto de partida con el que se comparan y una guía. Si no sabes por dónde empezar, leeCómo elegir un arnés.
Qué es un arnés base
En esta serie llamo arnés al harness del que habla el resto de la web. Un arnés base es el kit de partida que le das a un agente para trabajar en un proyecto con una arquitectura concreta. Cada arnés de la serie trae un AGENTS.md que explica dónde va cada cosa, permisos, hooks y, cuando ayuda, una Skill para las tareas frecuentes. Uno de los hooks comprueba la regla principal de la arquitectura. Si el agente rompe esa regla, el hook lo detecta y el agente no puede dar la tarea por terminada.
Los arneses no dependen de un agente concreto. Las instrucciones van enAGENTS.md, y los hooks, las skills y los permisos, en una carpeta.agents/. Cada página explica cómo conectarlos a algunos agentes, como Claude Code o Codex.
Algunas partes sirven para cualquier arquitectura: seguridad, calidad y clean code. Se sacan del primer arnés y se reutilizan en los siguientes como piezas.
La mini app
Todos los arneses rodean la misma app: una API REST pequeña de una biblioteca, con libros, socios y préstamos. Tiene dos reglas de negocio: un libro prestado no se puede volver a prestar, y un socio tiene como máximo tres préstamos activos. Los datos están en memoria, sin base de datos.
Todos los arneses usan el mismo lenguaje, TypeScript con Node, y pasan las mismas once pruebas de aceptación. Como solo cambia la arquitectura, se pueden comparar con honestidad.
Cómo leer el explorador
Cada página tiene un explorador de archivos como el de VS Code. A la izquierda (arriba en el móvil) están las carpetas; elige un archivo para ver su contenido. Las carpetas se abren y se cierran con un clic o con Enter. También se muestran las carpetas ocultas como.agents/, porque ahí viven los hooks, las skills y los permisos. Las dependencias y los lockfiles no se muestran.
Los archivos están en inglés, como el código. Sin JavaScript, el explorador muestra todos los archivos uno detrás de otro.