Ir al contenido
CodArchel mapa vivo de la arquitectura
ESEN

Las decisiones

Cada decisión tiene su ADR con su hoja de ruta dentro (## Hoja de ruta). El registro de lo hecho y lo que llega vive en el feed de la guía. Este es el índice: número, título, fecha, estado y fases.

flowchart TD
g["/guia/<br/>el feed: ideas y hechos"] -->|"fase"| r["la hoja de ruta<br/>del ADR"]
a["docs/adr/…<br/>el ADR"] --> r
r --> f["las fases abiertas"]
f --> i["docs/adr/roadmap.md<br/>el índice de fases"]
ADRDecisiónFechaEstadoFases
0001Clean-room, con cc.json como frontera2026-10-20aceptadose aplica en M0
0002Monorepo core-first2026-10-20aceptadose aplica en M0, M1
0003TypeScript primero, Rust cuando un benchmark lo exija2026-10-20aceptadoM1
0004La cuña: PR/CI + MCP2026-10-20aceptadose aplica en M2, M3
00052D primero, 3D como lente2026-10-20aceptadoM0
0006Nodos = ficheros, preparados para símbolos2026-10-20aceptadose aplica en M0
0007El nombre: CodArch2026-10-20aceptadose aplica en M0
0008Diseño del mapa 2D2026-10-20aceptadoM5, M5.1
0009Churn desde git, sin romper el determinismo2026-10-20aceptadose aplica en M2
0010Diff entre snapshots y reporte estable2026-10-20aceptadoM2
0011Reglas de arquitectura en .codarch.yml2026-10-20aceptadose aplica en M2, M9
0012GitHub Action para PRs2026-10-20aceptadose aplica en M2
0013Servidor MCP de solo lectura2026-10-20aceptadose aplica en M3
0014Distribución del CLI como paquete npm único2026-10-20aceptadoM3
0015Acción pública separada2026-10-20aceptadose aplica en M3
0016Lente de migración v12026-10-20aceptadoM4
0017Servidor local codarch serve2026-10-20aceptadose aplica en M5, M5.1
0018Estado de vista en la URL y carga por URL2026-10-21aceptadose aplica en M5, M5.1
0019Nivel de detalle del mapa2026-10-21aceptadose aplica en M5, M5.1
0020Análisis en el navegador con la misma gramática que el CLI2026-10-21aceptadoM6
0021App de escritorio (Electron) con su propia interfaz2026-10-21aceptadoM7 · UI compartida en 0043
0022La migración, donde ya faltaba2026-10-21aceptadoM8
0023Lente de dominio, por pasos2026-10-21aceptadoM9
0024La evolución temporal: el calor y la historia2026-10-21aceptadoM10
0025La lente de símbolos: mirar dentro del fichero2026-10-21aceptadoM11
0026La vida de un símbolo: la cadena que sobrevive al renombrado2026-10-21aceptadoM12
0027Los ajustes: un sitio donde se configura todo2026-10-21aceptadoM13
0028Los plugins: piezas del repo que se activan2026-10-21aceptadoM14, M15
0029Los addons: conocimiento declarativo2026-10-22aceptadoM16
0030Instalar y quitar: plugins y addons2026-10-22aceptadoM17
0031Los documentos: cada decisión con su hoja de ruta2026-10-22aceptadoM18, M19, M20
0032Las versiones y las actualizaciones2026-10-22aceptadoM21
0033Abrir el repo: lo que hay que tener antes2026-10-22aceptadoM22
0034La web del proyecto2026-10-22aceptadoM23
0035La guía se lee como un changelog2026-10-22aceptadoM23.6–M23.9
0036El roadmap vive en el ADR y el changelog al lado2026-10-22aceptado · 0047M23, M24
0037Los ciclos: de ejecución, no de tipos2026-10-23aceptadose aplica en M2, M9
0038El alcance del análisis se declara en .codarch.yml2026-10-23aceptadose aplica en M2, M5
0039La búsqueda de una cadena: símbolos, no nodos2026-10-23aceptadose aplica en M12
0040La complejidad cuenta el cuerpo entero2026-10-23aceptadose aplica en M0, M11
0041Cada versión se declara una vez2026-10-23aceptadose aplica en todo el repo
0042La entrega se automatiza2026-10-23aceptadoM25
0043La UI se comparte por paquete2026-10-23aceptadoM26
0044La app web en un contenedor local2026-10-23aceptadoM27
0045El escritorio se instala y se actualiza mejor2026-10-23aceptadoM28
0046Los documentos se publican con Starlight2026-10-23aceptadoM29
0047El changelog es la guía2026-10-23aceptadoM30
0048El escritorio persiste en .codarch/ del repo2026-10-24aceptadoM32
0049La orquestación se comparte, la plataforma se adapta2026-10-24aceptadoM33
0050El repositorio guarda su estado2026-10-24aceptadoM34
0051La versión se sube con un comando2026-10-24aceptadose aplica en cada release
0052Solo hacia abajo y nunca el sistema2026-10-24aceptadose aplica en el análisis
0053La configuración de la app no se mezcla con la del repo2026-10-24aceptadose aplica en la entrega
0054El lint, por app y por tipo de código2026-10-24aceptadoM35
0055El 3D se dibuja con WebGL2 propio2026-10-24aceptadoM15
0056El live no repite el análisis2026-10-24aceptadoM36
0057La ficha del fichero habla de sus lentes2026-10-25aceptadoM37
0058Las reglas tienen su pestaña2026-10-25aceptadoM38
0059Tres pestañas y adiós al nombre PR2026-10-25aceptadoM39
0060La ficha del fichero se lee en una tabla2026-10-25aceptadoM40
0061El proyecto vive en la cabecera y las secciones se pliegan2026-10-25aceptadoM41
0062Los símbolos también se pliegan2026-10-25aceptadoM42
0063Todos los símbolos del módulo2026-10-25aceptadoM43
0064La ficha no esconde nada2026-10-25aceptadoM44
0065Cada componente lleva su versión2026-10-25aceptadoM45
0066La acción vuelve al monorepo2026-10-25aceptadoM46
0067La ficha enseña el código del símbolo2026-10-25aceptadoM47
0068La ficha abre el editor y sus dependencias2026-10-25aceptadoM48
0069Dos pestañas: el fichero y el cambio2026-10-25aceptadoM50
0070Los ficheros del cambio, en una sola lista2026-10-25aceptadoM51
0071La tabla de Cambios va de base a head2026-10-25aceptadoM52
0072Cambios desde el último commit2026-10-25aceptadoM53
0073Una sola interfaz2026-10-26aceptadoM54
0074Una sola sesión de análisis2026-10-26aceptadoM55
0075Cambios es de git2026-10-26aceptadoM56
0076Las líneas no son código2026-10-26aceptadoM57
0077El diff, al abrir el fichero2026-10-26aceptadoM58
0078El balance de deuda2026-10-26aceptadoM59
0079El inspector con barra de actividad2026-10-26aceptadoM60
0080Usar CodArch y cómo se construye2026-10-26enmendado por 0081—
0081Documentación y Desarrollo, dos zonas2026-10-26aceptado—
0082El marco de la app2026-10-26aceptado—
0083El dock de herramientas2026-10-26aceptado—
0084El tema de la app2026-10-26aceptado—
0085La ruta del mapa navega2026-10-26aceptado—
0086El código de la ficha, con editor2026-10-27aceptado—
0087El fichero entero, en el escenario2026-10-27aceptado—
0088El fichero abierto va en la URL2026-10-27aceptado—
0089Cada alcance lee los de abajo2026-10-27aceptadoM34
0090Más lenguajes que TS y JS2026-10-28aceptadoM61
0091El mapa, en una captura2026-10-29aceptadoM62
0092La carpeta tiene su ficha2026-10-29aceptadoM63
0093El mapa de lo que no es código2026-10-29aceptadoM64
0094El lint, en el mapa2026-10-29aceptadoM65
0095La ficha del proyecto2026-10-30aceptadoM66
0096El lint es del proyecto2026-10-30aceptadoM67
0097La hoja del proyecto como la del fichero2026-10-30aceptadoM66
0098El lint dice qué árbol midió2026-10-31aceptadoM65 · M67
0099El lint se mide al analizar2026-10-31aceptadoM65 · M67
0100Los nombres de los artefactos de .codarch/2026-10-31aceptadoM65 · M67
0101La carpeta es del producto2026-10-31aceptadoM65 · M67
0102La duplicación y la divergencia, medidas2026-10-31aceptadoM68–M71
0103El checksum es del código2026-10-31aceptadoM72–M74
0104El lint se lee por hallazgos; las reglas son de doc y config2026-10-31aceptadoM75
0105Las reglas de doc y config2026-11-01aceptadoM76
0106Las cuentas y las rutas del lint salen de los mensajes2026-11-06aceptadose aplica al leer
0107La cobertura del lint es 1.32026-11-06enmendado por 0110se aplica al leer
0108El lint suma al riesgo, no reescala la base2026-11-06aceptadose aplica al calcular
0109La salud del lint se lee junta2026-11-07aceptadose aplica al leer
0110El lint limpio se llama limpio2026-11-08aceptadose aplica al leer
0111CodArch es también panel de control del lint2026-11-08aceptadose aplica al escribir
0112El gestor de reglas escribe en la config del proyecto2026-11-08aceptadose aplica al escribir
0113El Atlas es un plugin, no la vista 3D2026-11-08aceptadoM77
0114El Atlas sustituye a la vista 3D de barras2026-11-08aceptadoM77
0115El Atlas se mira de frente: contenedores y salas2026-11-08aceptadoM77
0116El visor de fichero lee por la app2026-11-08aceptadoM77
0117Salas recursivas y estanterías frontales2026-11-08enmendado por 0118M77
0118El proyecto también es una sala2026-11-08enmendado por 0119M77
0119Estanterías laterales y archivadores al centro2026-11-08enmendado por 0120M77
0120Estanterías abiertas y ordenadas desde el frente2026-11-08aceptadoM77
0121Cámara cómoda y LOD de geometría2026-11-09aceptadoM77
0122Salas profundas y sin techo2026-11-09aceptadoM77
0123El pasillo central2026-11-09aceptadoM77
0124Cartel de fondo y nombre real del proyecto2026-11-09aceptadoM77
0125Estanterías ligeras y orden interior2026-11-09aceptadoM77
0126La pared de métricas2026-11-09aceptadoM77
0127Paneles enfocables y texto contenido2026-11-09aceptadoM77
0128Un clic selecciona, dos entran2026-11-09aceptadoM77
0129Las esquinas de la sala2026-11-09aceptadoM77
0130Composición interior y foco de selección2026-11-09aceptadoM77
0131Vista interior y mirada vertical2026-11-09aceptadoM77

Van por bloques de diez: el número ya dice cuándo se decidió y el tema lo dice el título.

  • 0001-0010: 0001, 0002, 0003, 0004, 0005, 0006, 0007, 0008, 0009, 0010
  • 0011-0020: 0011, 0012, 0013, 0014, 0015, 0016, 0017, 0018, 0019, 0020
  • 0021-0030: 0021, 0022, 0023, 0024, 0025, 0026, 0027, 0028, 0029, 0030
  • 0031-0040: 0031, 0032, 0033, 0034, 0035, 0036, 0037, 0038, 0039, 0040
  • 0041-0050: 0041, 0042, 0043, 0044, 0045, 0046, 0047, 0048, 0049
  • 0051-0060: 0051, 0052, 0053, 0054, 0055, 0056, 0057, 0058, 0059, 0060
  • 0061-0070: 0061, 0062, 0063, 0064, 0065, 0066, 0067, 0068, 0069, 0070, 0071
  • 0071-0080: 0072, 0073, 0074, 0075, 0076, 0077, 0078, 0079, 0080
  • 0081-0090: 0081, 0082, 0083, 0084, 0085, 0086, 0087, 0088, 0089, 0090
  • 0091-0100: 0091, 0092, 0093, 0094, 0095, 0096, 0097, 0098, 0099, 0100
  • 0101-0110: 0101, 0102, 0103, 0104, 0105, 0106, 0107, 0108, 0109, 0110
  • 0111-0120: 0111, 0112, 0113, 0114, 0115, 0116, 0117, 0118, 0119, 0120
  • 0121-0130: 0121, 0122, 0123, 0124, 0125, 0126, 0127, 0128, 0129, 0130
  • 0131-0140: 0131

El roadmap completo, con una línea por fase, está en roadmap.md.