Las decisiones
Desarrollo
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"]| ADR | Decisión | Fecha | Estado | Fases |
|---|---|---|---|---|
| 0001 | Clean-room, con cc.json como frontera | 2026-10-20 | aceptado | se aplica en M0 |
| 0002 | Monorepo core-first | 2026-10-20 | aceptado | se aplica en M0, M1 |
| 0003 | TypeScript primero, Rust cuando un benchmark lo exija | 2026-10-20 | aceptado | M1 |
| 0004 | La cuña: PR/CI + MCP | 2026-10-20 | aceptado | se aplica en M2, M3 |
| 0005 | 2D primero, 3D como lente | 2026-10-20 | aceptado | M0 |
| 0006 | Nodos = ficheros, preparados para símbolos | 2026-10-20 | aceptado | se aplica en M0 |
| 0007 | El nombre: CodArch | 2026-10-20 | aceptado | se aplica en M0 |
| 0008 | Diseño del mapa 2D | 2026-10-20 | aceptado | M5, M5.1 |
| 0009 | Churn desde git, sin romper el determinismo | 2026-10-20 | aceptado | se aplica en M2 |
| 0010 | Diff entre snapshots y reporte estable | 2026-10-20 | aceptado | M2 |
| 0011 | Reglas de arquitectura en .codarch.yml | 2026-10-20 | aceptado | se aplica en M2, M9 |
| 0012 | GitHub Action para PRs | 2026-10-20 | aceptado | se aplica en M2 |
| 0013 | Servidor MCP de solo lectura | 2026-10-20 | aceptado | se aplica en M3 |
| 0014 | Distribución del CLI como paquete npm único | 2026-10-20 | aceptado | M3 |
| 0015 | Acción pública separada | 2026-10-20 | aceptado | se aplica en M3 |
| 0016 | Lente de migración v1 | 2026-10-20 | aceptado | M4 |
| 0017 | Servidor local codarch serve | 2026-10-20 | aceptado | se aplica en M5, M5.1 |
| 0018 | Estado de vista en la URL y carga por URL | 2026-10-21 | aceptado | se aplica en M5, M5.1 |
| 0019 | Nivel de detalle del mapa | 2026-10-21 | aceptado | se aplica en M5, M5.1 |
| 0020 | Análisis en el navegador con la misma gramática que el CLI | 2026-10-21 | aceptado | M6 |
| 0021 | App de escritorio (Electron) con su propia interfaz | 2026-10-21 | aceptado | M7 · UI compartida en 0043 |
| 0022 | La migración, donde ya faltaba | 2026-10-21 | aceptado | M8 |
| 0023 | Lente de dominio, por pasos | 2026-10-21 | aceptado | M9 |
| 0024 | La evolución temporal: el calor y la historia | 2026-10-21 | aceptado | M10 |
| 0025 | La lente de símbolos: mirar dentro del fichero | 2026-10-21 | aceptado | M11 |
| 0026 | La vida de un símbolo: la cadena que sobrevive al renombrado | 2026-10-21 | aceptado | M12 |
| 0027 | Los ajustes: un sitio donde se configura todo | 2026-10-21 | aceptado | M13 |
| 0028 | Los plugins: piezas del repo que se activan | 2026-10-21 | aceptado | M14, M15 |
| 0029 | Los addons: conocimiento declarativo | 2026-10-22 | aceptado | M16 |
| 0030 | Instalar y quitar: plugins y addons | 2026-10-22 | aceptado | M17 |
| 0031 | Los documentos: cada decisión con su hoja de ruta | 2026-10-22 | aceptado | M18, M19, M20 |
| 0032 | Las versiones y las actualizaciones | 2026-10-22 | aceptado | M21 |
| 0033 | Abrir el repo: lo que hay que tener antes | 2026-10-22 | aceptado | M22 |
| 0034 | La web del proyecto | 2026-10-22 | aceptado | M23 |
| 0035 | La guía se lee como un changelog | 2026-10-22 | aceptado | M23.6–M23.9 |
| 0036 | El roadmap vive en el ADR y el changelog al lado | 2026-10-22 | aceptado · 0047 | M23, M24 |
| 0037 | Los ciclos: de ejecución, no de tipos | 2026-10-23 | aceptado | se aplica en M2, M9 |
| 0038 | El alcance del análisis se declara en .codarch.yml | 2026-10-23 | aceptado | se aplica en M2, M5 |
| 0039 | La búsqueda de una cadena: símbolos, no nodos | 2026-10-23 | aceptado | se aplica en M12 |
| 0040 | La complejidad cuenta el cuerpo entero | 2026-10-23 | aceptado | se aplica en M0, M11 |
| 0041 | Cada versión se declara una vez | 2026-10-23 | aceptado | se aplica en todo el repo |
| 0042 | La entrega se automatiza | 2026-10-23 | aceptado | M25 |
| 0043 | La UI se comparte por paquete | 2026-10-23 | aceptado | M26 |
| 0044 | La app web en un contenedor local | 2026-10-23 | aceptado | M27 |
| 0045 | El escritorio se instala y se actualiza mejor | 2026-10-23 | aceptado | M28 |
| 0046 | Los documentos se publican con Starlight | 2026-10-23 | aceptado | M29 |
| 0047 | El changelog es la guía | 2026-10-23 | aceptado | M30 |
| 0048 | El escritorio persiste en .codarch/ del repo | 2026-10-24 | aceptado | M32 |
| 0049 | La orquestación se comparte, la plataforma se adapta | 2026-10-24 | aceptado | M33 |
| 0050 | El repositorio guarda su estado | 2026-10-24 | aceptado | M34 |
| 0051 | La versión se sube con un comando | 2026-10-24 | aceptado | se aplica en cada release |
| 0052 | Solo hacia abajo y nunca el sistema | 2026-10-24 | aceptado | se aplica en el análisis |
| 0053 | La configuración de la app no se mezcla con la del repo | 2026-10-24 | aceptado | se aplica en la entrega |
| 0054 | El lint, por app y por tipo de código | 2026-10-24 | aceptado | M35 |
| 0055 | El 3D se dibuja con WebGL2 propio | 2026-10-24 | aceptado | M15 |
| 0056 | El live no repite el análisis | 2026-10-24 | aceptado | M36 |
| 0057 | La ficha del fichero habla de sus lentes | 2026-10-25 | aceptado | M37 |
| 0058 | Las reglas tienen su pestaña | 2026-10-25 | aceptado | M38 |
| 0059 | Tres pestañas y adiós al nombre PR | 2026-10-25 | aceptado | M39 |
| 0060 | La ficha del fichero se lee en una tabla | 2026-10-25 | aceptado | M40 |
| 0061 | El proyecto vive en la cabecera y las secciones se pliegan | 2026-10-25 | aceptado | M41 |
| 0062 | Los símbolos también se pliegan | 2026-10-25 | aceptado | M42 |
| 0063 | Todos los símbolos del módulo | 2026-10-25 | aceptado | M43 |
| 0064 | La ficha no esconde nada | 2026-10-25 | aceptado | M44 |
| 0065 | Cada componente lleva su versión | 2026-10-25 | aceptado | M45 |
| 0066 | La acción vuelve al monorepo | 2026-10-25 | aceptado | M46 |
| 0067 | La ficha enseña el código del símbolo | 2026-10-25 | aceptado | M47 |
| 0068 | La ficha abre el editor y sus dependencias | 2026-10-25 | aceptado | M48 |
| 0069 | Dos pestañas: el fichero y el cambio | 2026-10-25 | aceptado | M50 |
| 0070 | Los ficheros del cambio, en una sola lista | 2026-10-25 | aceptado | M51 |
| 0071 | La tabla de Cambios va de base a head | 2026-10-25 | aceptado | M52 |
| 0072 | Cambios desde el último commit | 2026-10-25 | aceptado | M53 |
| 0073 | Una sola interfaz | 2026-10-26 | aceptado | M54 |
| 0074 | Una sola sesión de análisis | 2026-10-26 | aceptado | M55 |
| 0075 | Cambios es de git | 2026-10-26 | aceptado | M56 |
| 0076 | Las líneas no son código | 2026-10-26 | aceptado | M57 |
| 0077 | El diff, al abrir el fichero | 2026-10-26 | aceptado | M58 |
| 0078 | El balance de deuda | 2026-10-26 | aceptado | M59 |
| 0079 | El inspector con barra de actividad | 2026-10-26 | aceptado | M60 |
| 0080 | Usar CodArch y cómo se construye | 2026-10-26 | enmendado por 0081 | — |
| 0081 | Documentación y Desarrollo, dos zonas | 2026-10-26 | aceptado | — |
| 0082 | El marco de la app | 2026-10-26 | aceptado | — |
| 0083 | El dock de herramientas | 2026-10-26 | aceptado | — |
| 0084 | El tema de la app | 2026-10-26 | aceptado | — |
| 0085 | La ruta del mapa navega | 2026-10-26 | aceptado | — |
| 0086 | El código de la ficha, con editor | 2026-10-27 | aceptado | — |
| 0087 | El fichero entero, en el escenario | 2026-10-27 | aceptado | — |
| 0088 | El fichero abierto va en la URL | 2026-10-27 | aceptado | — |
| 0089 | Cada alcance lee los de abajo | 2026-10-27 | aceptado | M34 |
| 0090 | Más lenguajes que TS y JS | 2026-10-28 | aceptado | M61 |
| 0091 | El mapa, en una captura | 2026-10-29 | aceptado | M62 |
| 0092 | La carpeta tiene su ficha | 2026-10-29 | aceptado | M63 |
| 0093 | El mapa de lo que no es código | 2026-10-29 | aceptado | M64 |
| 0094 | El lint, en el mapa | 2026-10-29 | aceptado | M65 |
| 0095 | La ficha del proyecto | 2026-10-30 | aceptado | M66 |
| 0096 | El lint es del proyecto | 2026-10-30 | aceptado | M67 |
| 0097 | La hoja del proyecto como la del fichero | 2026-10-30 | aceptado | M66 |
| 0098 | El lint dice qué árbol midió | 2026-10-31 | aceptado | M65 · M67 |
| 0099 | El lint se mide al analizar | 2026-10-31 | aceptado | M65 · M67 |
| 0100 | Los nombres de los artefactos de .codarch/ | 2026-10-31 | aceptado | M65 · M67 |
| 0101 | La carpeta es del producto | 2026-10-31 | aceptado | M65 · M67 |
| 0102 | La duplicación y la divergencia, medidas | 2026-10-31 | aceptado | M68–M71 |
| 0103 | El checksum es del código | 2026-10-31 | aceptado | M72–M74 |
| 0104 | El lint se lee por hallazgos; las reglas son de doc y config | 2026-10-31 | aceptado | M75 |
| 0105 | Las reglas de doc y config | 2026-11-01 | aceptado | M76 |
| 0106 | Las cuentas y las rutas del lint salen de los mensajes | 2026-11-06 | aceptado | se aplica al leer |
| 0107 | La cobertura del lint es 1.3 | 2026-11-06 | enmendado por 0110 | se aplica al leer |
| 0108 | El lint suma al riesgo, no reescala la base | 2026-11-06 | aceptado | se aplica al calcular |
| 0109 | La salud del lint se lee junta | 2026-11-07 | aceptado | se aplica al leer |
| 0110 | El lint limpio se llama limpio | 2026-11-08 | aceptado | se aplica al leer |
| 0111 | CodArch es también panel de control del lint | 2026-11-08 | aceptado | se aplica al escribir |
| 0112 | El gestor de reglas escribe en la config del proyecto | 2026-11-08 | aceptado | se aplica al escribir |
| 0113 | El Atlas es un plugin, no la vista 3D | 2026-11-08 | aceptado | M77 |
| 0114 | El Atlas sustituye a la vista 3D de barras | 2026-11-08 | aceptado | M77 |
| 0115 | El Atlas se mira de frente: contenedores y salas | 2026-11-08 | aceptado | M77 |
| 0116 | El visor de fichero lee por la app | 2026-11-08 | aceptado | M77 |
| 0117 | Salas recursivas y estanterías frontales | 2026-11-08 | enmendado por 0118 | M77 |
| 0118 | El proyecto también es una sala | 2026-11-08 | enmendado por 0119 | M77 |
| 0119 | Estanterías laterales y archivadores al centro | 2026-11-08 | enmendado por 0120 | M77 |
| 0120 | Estanterías abiertas y ordenadas desde el frente | 2026-11-08 | aceptado | M77 |
| 0121 | Cámara cómoda y LOD de geometría | 2026-11-09 | aceptado | M77 |
| 0122 | Salas profundas y sin techo | 2026-11-09 | aceptado | M77 |
| 0123 | El pasillo central | 2026-11-09 | aceptado | M77 |
| 0124 | Cartel de fondo y nombre real del proyecto | 2026-11-09 | aceptado | M77 |
| 0125 | Estanterías ligeras y orden interior | 2026-11-09 | aceptado | M77 |
| 0126 | La pared de métricas | 2026-11-09 | aceptado | M77 |
| 0127 | Paneles enfocables y texto contenido | 2026-11-09 | aceptado | M77 |
| 0128 | Un clic selecciona, dos entran | 2026-11-09 | aceptado | M77 |
| 0129 | Las esquinas de la sala | 2026-11-09 | aceptado | M77 |
| 0130 | Composición interior y foco de selección | 2026-11-09 | aceptado | M77 |
| 0131 | Vista interior y mirada vertical | 2026-11-09 | aceptado | M77 |
Las carpetas
Sección titulada «Las carpetas»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.