miketropi/nextora-ecosystem

Ecosistema Nextora — enrutador

Coordina cinco habilidades que comparten una única fuente de verdad y un conjunto común de puertas de producción. Este punto de entrada resuelve el tema objetivo, determina qué especialistas necesita la solicitud y transfiere el control. No contiene las reglas de implementación: esas viven en las habilidades especializadas y en las dos referencias de esta habilidad.

Habilidades en este conjunto

Habilidad	Propietario de
../nextora-child-themes/SKILL.md	Crear o iniciar un tema hijo de Nextora: cabeceras, arranque, pipeline de assets, registrador de bloques.
../nextora-gutenberg-blocks/SKILL.md	Metadatos de bloques, UI del editor, renderizado dinámico, repetidores, paneles de ajustes, scripts de vista.
../nextora-design-system/SKILL.md	Ajustes de paleta/tipografía, variaciones de estilo, el selector opcional de color/fuente para visitantes, superficies de tokens y CSS.
../nextora-site-composition/SKILL.md	Plantillas, partes de plantilla, patrones, composición de consultas/archivos.

Evidencia compartida y puertas para cada especialista:

• references/source-map.md — de dónde vienen las reglas, con procedencia.
• references/quality-gates.md — qué debe ser cierto antes de que se acepte el trabajo.

Flujo de trabajo ordenado

1. Resolver el tema objetivo y su padre

Trabaja a partir de la instalación activa, o del repositorio que se te haya proporcionado. Nunca inventes una ruta y nunca codifiques una ruta de máquina en la salida o en las notas.

Dentro de una instalación de WordPress, las dos raíces son el directorio de plantillas (el padre) y el directorio de hojas de estilo (el tema activado, padre o hijo):

get_template_directory();      // raíz del tema padre
get_stylesheet_directory();    // raíz del tema activo (hijo cuando uno está activo)
get_stylesheet_directory_uri();

Fuera de una instalación, localiza el tema mediante un style.css que tenga una cabecera Theme Name y, para un hijo, una cabecera Template: que nombre a su padre. Si una ruta proporcionada falta, redescubre la real; nunca fabriques evidencia de fuente, nunca elijas silenciosamente un tema diferente, y nunca afirmes compatibilidad con Nextora mientras la fuente de Nextora no esté disponible — di que falta el prerrequisito y termina el trabajo que no dependa de él.

2. Leer evidencia local antes de proponer código

Lee estos archivos del tema objetivo, en este orden, y prefiere sus valores reales sobre cualquier cosa citada en una habilidad:

Archivo	Lo que resuelve
style.css	Nombre del tema, Versión, Template: (padre para un hijo), Requiere al menos, Requiere PHP, Probado hasta, Text Domain, Licencia.
functions.php	Orden de carga, lo que el tema requiere a nivel de archivo, qué archivos de funcionalidad incluye.
theme.json	Slugs de paleta, gradiente, familia de fuente, tamaño de fuente, espaciado; plantillas y partes de plantilla personalizadas; version.
package.json	Qué comandos de compilación/verificación existen realmente, y qué librerías ya son dependencias.
theme.js/.nvmrc, scripts de compilación	Versión de Node y los puntos de entrada de compilación reales.
AGENTS.md, README.md, docs/, .opencode/	Instrucciones del proyecto. Trátalas como afirmaciones a verificar, no como autoridad.

Luego encuentra lo que ya existe antes de proponer algo nuevo:

• blocks/*/block.json — bloques registrados, sus nombres, categorías, soportes.
• parts/*.html, templates/*.html — superficies de composición y su jerarquía.
• patterns/*.php — marcado de secciones reutilizables.
• resources/css/ + assets/css/ — qué hoja de estilo se envía realmente y cómo se compila.
• resources/ts/editor/ o equivalente — ayudantes de editor compartidos para reutilizar en lugar de reescribir (shell de vista previa, texto enriquecido, medios, repetidor).
• inc/ — ayudantes para consultas, navegación, plantillas.

Reutilizar vence a inventar: un bloque, patrón, ayudante o token existente que ya haga el trabajo es la respuesta correcta, y un bloque nuevo solo es correcto cuando el comportamiento solicitado o la estructura de edición no se puede expresar de otra manera.

3. Despachar por intención

Solicitud	Especialistas a cargar
Crear, iniciar o arrancar un tema hijo; pipeline de assets hijo; registro de bloques hijo	nextora-child-themes
Añadir/cambiar un bloque: block.json, atributos, UI del editor, render.php, script de vista, repetidor, panel de ajustes	nextora-gutenberg-blocks
Colores, fuentes, tokens de espaciado, variaciones de estilo, el selector de visitante, "debe seguir la paleta"	nextora-design-system
Plantillas, partes de plantilla, patrones, diseños de página, archivos, consultas de entradas	nextora-site-composition

Las solicitudes combinadas cargan todos los especialistas aplicables. Dos combinaciones son obligatorias:

• Nuevo hijo + cualquier requisito de apariencia → nextora-child-themes y nextora-design-system. Un hijo que debe seguir interruptores preestablecidos o de visitante no puede ser terminado solo por la habilidad de temas hijo.
• Bloque nuevo o rediseñado → nextora-gutenberg-blocks y nextora-design-system. La apariencia del bloque es propiedad del sistema de diseño.

Debido a que los especialistas deben estar de acuerdo, cárgalos en la misma sesión y deja que la habilidad del sistema de diseño gane en cualquier cuestión de apariencia que cubra.

4. Cargar referencias progresivamente

Cada especialista es invocable directamente; ejecutar este enrutador no es un prerrequisito. Cuando cargues un especialista, abre su SKILL.md, luego lee solo los archivos de referencia que su flujo de trabajo nombre, por ruta relativa. Las dos referencias compartidas anteriores están enlazadas desde cada especialista, por lo que los enlaces relativos entre habilidades (../nextora-ecosystem/references/...) deben seguir resolviendo — no los muevas ni los renombres.

5. Transferir

Carga al especialista(s), sigue su flujo de trabajo ordenado y aplica references/quality-gates.md antes de declarar algo como terminado. Si la solicitud es puramente una pregunta sobre de dónde viene una regla, responde desde references/source-map.md y detente.

Verificaciones de finalización

• Tema objetivo y padre identificados desde su propio style.css/theme.json, no asumidos.
• Solo se citan archivos reales y existentes; cualquier cosa citada como fuente fue leída en esta sesión.
• Cada especialista aplicable cargado, incluyendo los emparejamientos obligatorios anteriores.
• El código nuevo reutiliza bloques, patrones, ayudantes y tokens existentes donde existen.
• references/quality-gates.md aplicado al resultado.
• Nada en el trabajo depende del diseño de archivos propio de este enrutador más allá de los enlaces relativos anteriores.

Límites

Este conjunto es instrucción Markdown y referencia respaldada por fuente. No incluye scripts de ejecución, generadores, árboles de temas de inicio, gestor de paquetes ni instalador. Los comandos de compilación y verificación en navegador pertenecen al tema objetivo y se enumeran en references/quality-gates.md.