Serie AI-Native · Superrepositorios
Conecté 17 Repositorios en una Sola Puerta de Entrada. Nada se Pone en Verde Sin Correr su Compuerta.
La idea en un minuto — con qué te vas a quedar
Conecté 17 repositorios en un solo superrepositorio en un día, inspirado en una app de lápiz y lienzo que legalmente no puedo copiar. La regla que hizo que funcionara: ningún satélite se pone en verde sin correr su propia compuerta. Cadena 01: un boceto a mano termina como un plano arquitectónico que pasa cinco verificaciones de construcción, exit 0.
Un superrepositorio que nace en verde en un solo día, inspirado en una app de lápiz y lienzo que legalmente no puedo copiar. Todo el diseño cabe en una sola regla: sin insignia sin evidencia. ~6 min.
El problema: 24 repositorios y ninguna puerta de entrada
Construyo en repositorios como otros toman notas: compulsivamente. Herramientas de diseño, herramientas de investigación, un OS de dinero, un OS de carrera, un OS de estrategia. Cada una funciona. Juntas eran un cajón de trastos: ni siquiera I podía recordar siempre cuál respondía a qué pregunta. Si tus propias herramientas necesitan un índice humano para ser útiles, no tienes una familia de productos. Tienes un montón.
La solución fue una construcción de un día llamada allin-anything: un superrepositorio cuyo único producto es un alcance verificado — un registro de 17 repositorios satélite, cada uno etiquetado según lo que puede hacer y, más importante aún, según cuánto de esa afirmación ha verificado realmente una máquina.
La inspiración fue una pluma estilográfica
El detonante fue penecho — un lienzo de código abierto donde le escribes a mano a una IA: ecuaciones, diagramas, bocetos espaciales. Entra tinta, sale un borrador estructurado, y ese borrador queda separado de tu trabajo confirmado hasta que lo aceptas. Gesto físico entra, inteligencia digital sale, y en medio, una compuerta humana. Esa es toda la tesis de mi familia de repositorios, condensada en una app que construyó otra persona.
Ojo con la trampa: penecho tiene licencia AGPL. Copiar su código en mi repo habría sido tanto legalmente radiactivo como arquitectónicamente perezoso. Así que, en cambio, se convirtió en la prueba fundacional del diseño: un satélite es un puntero, un SHA de commit fijado y un resumen de hechos confirmados — nunca una copia vendorizada. Tomo el patrón, doy crédito a la fuente, y dejo que su código corra donde vive: upstream.
El modelo mental que hasta un chico de 15 años puede aplicar
Piénsalo como un club con un guardián estricto. Cada repositorio que quiere entrar recibe una pulsera con tres colores posibles:
- ⚪ Candidato — estás en la lista. Con nombre y rol asignado, nada verificado. Eso es todo.
- 🟡 Digerido — alguien de verdad revisó tu identificación: existe un archivo de resumen con hechos fijados a un commit específico, y lo no confirmado está etiquetado como sin confirmar.
- 🟢 Integrado — actuaste, en vivo: tu propia compuerta de pruebas corrió en esta máquina y salió con código 0, y la puerta principal te redirige el tráfico.
El guardián es código, no intuición. Una regla de validación rechaza cualquier ascenso de estatus cuyo archivo de evidencia no exista en disco. La tabla del README se genera a partir del registro, y el CI falla si se desalinean. El primer día, 7 de 9 satélites eran honestamente blancos — y el README lo dice así, porque una tabla que adula es una tabla en la que no puedes confiar.
Cadena 01: un boceto termina como plano de planta que pasa la inspección
La promesa de todo esto es "interacción total con el mundo digital y físico", así que el hito 3 tenía que ser una cadena que cruzara esa frontera. La intención: "dibujar a mano el plano de una habitación y luego verificar que sea construible."
Un enrutador determinista —cada afirmación de ruteo es un pytest, incluida la que exige que rechace tratar a penecho como un componente de terceros a empaquetar— declara la cadena: penecho para la tinta, design-anything para la física. Luego la mitad física corrió de verdad:
$ python3 pipeline/construction_gate.py studio.json
PASS C1_topology: 4 rooms, 4 openings, all resolve
PASS C2_clearances: all openings meet table minima
PASS C3_habitability: areas, dimensions, daylight, ceiling OK
PASS C4_egress: all rooms reachable; entry door present
PASS C5_module_grid: 100% of coordinates on the 100mm module
READY: studio-flat (design-sanity gate, not a permit or PE stamp)Código de salida 0. Un plano de 4 habitaciones y 28.5 m² pasó las verificaciones de topología, holguras, habitabilidad, salidas de emergencia y cuadrícula —la misma compuerta que ese repo usa para llamar a algo "listo". Esa corrida fue lo que promovió a design-anything a 🟢. penecho se quedó en 🟡, a propósito: el paso del boceto es humano y de upstream, y fingir que una máquina lo verificó envenenaría lo único que esta tabla vende: confianza.
El repositorio se audita a sí mismo — y a mí
La disciplina del registro se echaría a perder en una semana si dependiera de mi estado de ánimo, así que el repositorio califica su propia operación: nueve principios (spec-as-data, no-evidence-means-no, maker-is-not-checker, satellites-never-vendored…), cada uno respaldado por una verificación ejecutable, exigidos en CI con un umbral de 90/100. Un principio sin medir no cuenta como aprobado: bloquea la compuerta. En este momento corre en 100/100, y el día que un atajo haga retroceder un principio, la compilación fallará por mi culpa.
La honestidad jugó en ambas direcciones. Durante la construcción, la cola de CI de GitHub tuvo un mal día: los jobs morían sin logs, sin pasos, sin anotaciones. Yo justo había subido de versión dos actions, así que la evidencia no podía separar "su infraestructura" de "mi cambio". La solución fue la aburrida y honesta: revertir a la última configuración verde exacta y dejar que la siguiente corrida decidiera —registrado en el changelog como un rollback, no un diagnóstico. Escribir "todavía no lo sé" es una característica.
Por qué molestarse con un superrepositorio
Porque la alternativa es lo que la industria da por sentado: una landing page que afirma integraciones. Un registro con un guardia estricto invierte eso. Agregar una capacidad cuesta una entrada YAML, y la escalera le dice a cada usuario —incluido mi yo futuro— exactamente cuánto confiar en cada fila. La tabla hoy es pequeña: 2 en verde, 10 en amarillo, 5 en blanco —y al día siguiente de publicar, la propia compuerta del estatuto del repositorio me atrapó sobrecontando los verdes en este mismo párrafo. La compuerta gana; la prosa se corrige. Pero cada color en la tabla fue ganado por una corrida real, y ese es el único tipo de tabla que se acumula con el tiempo.
La regla que se generaliza: si tu sistema agrega otros sistemas, no agregues sus afirmaciones — agrega sus códigos de salida.
Más en la serie AI-Native
Todo esto vive en la sección Writing de la página principal.
Parte de la serie AI-Native. Construido con el ciclo goal-10x: investigar → absorber → entrenar → empujar a verde → automejorarse. Confía en el artefacto, no en la etiqueta. El botón de Publish es tuyo.