Saltar al contenido principal
Hacer el diagnóstico

Arquitectar · Criterio KATA

Arquitectura antes de código

·

No es una preferencia estética. Es que cambiar algunas decisiones después de construir puede exigir rehacer páginas, redirecciones, plantillas o datos, como muestra la tabla de esta guía.

Cómo se ha elaborado esta guía
Criterio operativo KATA

Qué estás leyendo

Es el criterio de KATA sobre qué decidir antes. Hay equipos que trabajan al revés con buenos resultados; esto es lo que hacemos nosotros y por qué.

Naturaleza
Criterio operativo KATA
Organización responsable
KATA WEB SYSTEMS
Propietario y aprobador editorial
Ramón Carmona
Versión del método
Método KATA v1.0 · congelado el 2026-08-26
Revisado
2026-08-30

Qué es criterio propio y qué es estándar externo

  • Criterio propio: La forma de decidir, los umbrales y el orden son decisiones metodológicas de KATA.
  • Experiencia observada: Lo aprendido en proyectos propios. No se cuantifica ni se presenta como dato del sector.
  • Estándar externo: Si se cita un hecho de un tercero, se identifica su fuente oficial con entidad y fecha.

Respuesta directa

Se decide antes lo que es caro de cambiar después: la estructura de URLs, qué páginas existen, qué separa el contenido de la presentación y dónde vive cada dato.

Se deja para después lo barato: textos, imágenes, colores, orden de secciones dentro de una página.

Coste de corregir según cuándo se decide

Coste de corregir según cuándo se decide
DecisiónSi se toma antesSi se corrige después
Estructura de URLsUn rato de conversación.Redirecciones, señales repartidas y meses de recuperación.
Qué páginas existenUna lista.Contenido escrito que hay que fusionar o tirar.
Separación contenido/presentaciónUna convención.Reescribir plantillas y migrar contenido.
Dónde vive cada datoUn esquema.Datos duplicados que divergen.
Idiomas y ámbitoUn prefijo.Rehacer la arquitectura entera.
Colores y tipografíaSe elige.Se cambia un archivo.
TextosSe escriben.Se editan.

La señal de que se está construyendo sin arquitectura

  • Aparecen páginas «provisionales» que nadie retira.
  • Dos páginas dicen lo mismo y nadie sabe cuál es la buena.
  • Se discute dónde poner algo cada vez que hay contenido nuevo.
  • La estructura de URLs refleja el orden en que se fue creando, no una lógica.
  • Cada sección nueva exige una plantilla nueva.

Arquitectura no significa documento largo

En KATA la arquitectura de un sitio pequeño cabe en una página: la lista de rutas con su pregunta única y su decisión de indexación, y una nota sobre qué se separa del diseño.

Lo que la hace útil no es la extensión: es que existe antes y que se puede señalar cuando alguien propone añadir algo.

Dónde este criterio NO aplica

  • Prototipos desechables cuyo objetivo declarado es aprender y tirar.
  • Equipos con práctica madura de refactorización continua y coste real de cambio bajo.
  • Sitios de una sola página, donde la arquitectura se reduce a una decisión.

Preguntas frecuentes

¿No retrasa el arranque?

Retrasa la primera línea de código y adelanta la fecha en que el proyecto deja de rehacerse. Nuestra experiencia es que las horas de arquitectura se recuperan la primera vez que alguien pregunta dónde va algo y hay respuesta.

¿Y si la arquitectura resulta equivocada?

Se cambia, y se dice qué queda invalidado. Tener una arquitectura equivocada y explícita es mejor que no tener ninguna: al menos se sabe qué se está cambiando.

Siguiente decisión

Continúa con una pregunta concreta

Ilustraciones conceptuales; no son fotografías de clientes.