miketropi/nextora-ecosystem

Ecossistema Nextora — roteador

Coordena cinco habilidades que compartilham uma única fonte de verdade e um conjunto de condições de produção. Este ponto de entrada resolve o tema alvo, determina quais especialistas a solicitação precisa e faz a entrega. Ele não contém as regras de implementação: essas vivem nas habilidades especialistas e nas duas referências desta habilidade.

Habilidades neste conjunto

Habilidade	É responsável por
../nextora-child-themes/SKILL.md	Criar ou inicializar um tema filho Nextora: cabeçalhos, inicialização, pipeline de assets, registrador de blocos.
../nextora-gutenberg-blocks/SKILL.md	Metadados de bloco, interface do editor, renderização dinâmica, repetidores, painéis de configuração, scripts de visualização.
../nextora-design-system/SKILL.md	Predefinições de paleta/tipografia, variações de estilo, o alternador opcional de cores/fontes do visitante, superfícies de tokens e CSS.
../nextora-site-composition/SKILL.md	Modelos, partes de modelo, padrões, composição de consultas/arquivos.

Evidências e condições compartilhadas para cada especialista:

• references/source-map.md — de onde vêm as regras, com proveniência.
• references/quality-gates.md — o que deve ser verdadeiro antes que o trabalho seja aceito.

Fluxo de trabalho ordenado

1. Resolver o tema alvo e seu tema pai

Trabalhe a partir da instalação ativa ou do repositório que foi fornecido. Nunca invente um caminho e nunca codifique um caminho de máquina na saída ou em anotações.

Dentro de uma instalação WordPress, as duas raízes são o diretório de modelos (o tema pai) e o diretório de folhas de estilo (o tema ativado, pai ou filho):

get_template_directory();      // raiz do tema pai
get_stylesheet_directory();    // raiz do tema ativo (filho quando um está ativo)
get_stylesheet_directory_uri();

Fora de uma instalação, localize o tema por um style.css que contenha um cabeçalho Theme Name e, para um tema filho, um cabeçalho Template: nomeando seu pai. Se um caminho fornecido estiver ausente, redescubra o real; nunca fabrique evidências de origem, nunca escolha silenciosamente um tema diferente e nunca afirme compatibilidade com Nextora enquanto a fonte Nextora estiver indisponível — diga que o pré-requisito está faltando e conclua o trabalho que não depende dele.

2. Ler evidências locais antes de propor código

Leia estas do tema alvo, nesta ordem, e prefira seus valores atuais em vez de qualquer coisa citada em uma habilidade:

Arquivo	O que ele estabelece
style.css	Nome do tema, Versão, Template: (pai para um filho), Requer pelo menos, Requer PHP, Testado até, Domínio de Texto, Licença.
functions.php	Ordem de carregamento, o que o tema requer no escopo do arquivo, quais arquivos de funcionalidade ele inclui.
theme.json	Slugs de paleta, gradiente, família de fontes, tamanho de fonte, espaçamento; modelos e partes de modelo personalizados; version.
package.json	Quais comandos de construção/verificação realmente existem e quais bibliotecas já são dependências.
theme.js/.nvmrc, scripts de construção	Versão do Node e os pontos de entrada reais de construção.
AGENTS.md, README.md, docs/, .opencode/	Instruções do projeto. Trate-as como afirmações a serem verificadas, não como autoridade.

Em seguida, descubra o que já existe antes de propor algo novo:

• blocks/*/block.json — blocos registrados, seus nomes, categorias, suportes.
• parts/*.html, templates/*.html — superfícies de composição e sua hierarquia.
• patterns/*.php — marcação de seção reutilizável.
• resources/css/ + assets/css/ — qual folha de estilo realmente é enviada e como é construída.
• resources/ts/editor/ ou equivalente — ajudantes de editor compartilhados para reutilizar em vez de reescrever (shell de visualização, rich text, mídia, repetidor).
• inc/ — ajudantes para consultas, navegação, modelos.

Reutilização vence invenção: um bloco, padrão, ajudante ou token existente que já faz o trabalho é a resposta correta, e um novo bloco só é correto quando o comportamento ou estrutura de edição solicitado não pode ser expresso de outra forma.

3. Despachar por intenção

Solicitação	Especialistas a carregar
Criar, estruturar ou inicializar um tema filho; pipeline de assets do filho; registro de blocos do filho	nextora-child-themes
Adicionar/alterar um bloco: block.json, atributos, interface do editor, render.php, script de visualização, repetidor, painel de configuração	nextora-gutenberg-blocks
Cores, fontes, tokens de espaçamento, variações de estilo, o alternador do visitante, "deve seguir a paleta"	nextora-design-system
Modelos, partes de modelo, padrões, layouts de página, arquivos, consultas de post	nextora-site-composition

Solicitações combinadas carregam todos os especialistas aplicáveis. Duas combinações são obrigatórias:

• Novo filho + qualquer requisito de aparência → nextora-child-themes e nextora-design-system. Um filho que deve seguir predefinições ou alternadores do visitante não pode ser concluído apenas pela habilidade do filho.
• Bloco novo ou com estilo reformulado → nextora-gutenberg-blocks e nextora-design-system. A aparência do bloco é de responsabilidade do sistema de design.

Como os especialistas devem concordar, carregue-os na mesma sessão e deixe a habilidade do sistema de design vencer em qualquer questão de aparência que ela cobrir.

4. Carregar referências progressivamente

Cada especialista é diretamente invocável; executar este roteador não é um pré-requisito. Ao carregar um especialista, abra seu SKILL.md e então leia apenas os arquivos de referência que seu fluxo de trabalho nomeia, por caminho relativo. As duas referências compartilhadas acima estão vinculadas em cada especialista, portanto os links relativos entre habilidades (../nextora-ecosystem/references/...) devem continuar resolvendo — não mova nem renomeie esses arquivos.

5. Entregar

Carregue o(s) especialista(s), siga seu fluxo de trabalho ordenado e aplique references/quality-gates.md antes de declarar qualquer coisa concluída. Se a solicitação for puramente uma pergunta sobre de onde vem uma regra, responda a partir de references/source-map.md e pare.

Verificações de conclusão

• Tema alvo e tema pai identificados a partir de seus próprios style.css/theme.json, não presumidos.
• Apenas arquivos reais e existentes citados; qualquer coisa citada como fonte foi lida nesta sessão.
• Todos os especialistas aplicáveis carregados, incluindo os pares obrigatórios acima.
• Código novo reutiliza blocos, padrões, ajudantes e tokens existentes onde eles existem.
• references/quality-gates.md aplicado ao resultado.
• Nada no trabalho depende do layout de arquivos deste roteador além dos links relativos acima.

Limites

Este conjunto é instrução Markdown e referência baseada em código fonte. Ele não fornece scripts de tempo de execução, geradores, árvores de tema inicial, gerenciador de pacotes ou instalador. Comandos de construção downstream e verificação de navegador pertencem ao tema alvo e estão listados em references/quality-gates.md.