miketropi/nextora-ecosystem

Nextora-Ökosystem — Router

Koordiniert fünf Skills, die eine gemeinsame Quellenwahrheit und einen gemeinsamen Satz von Produktionsqualitätstoren teilen. Dieser Einstiegspunkt ermittelt das Ziel-Theme, stellt fest, welche Spezialisten die Anfrage benötigt, und übergibt. Er enthält nicht die Implementierungsregeln: Diese leben in den Spezialisten-Skills und in den beiden Referenzen dieses Skills.

Skills in dieser Suite

Skill	Besitzt
../nextora-child-themes/SKILL.md	Erstellen oder Bootstrappen eines Nextora-Child-Themes: Header, Bootstrap, Asset-Pipeline, Block-Registrar.
../nextora-gutenberg-blocks/SKILL.md	Block-Metadaten, Editor-UI, dynamisches Rendering, Wiederholungsfelder, Einstellungsbereiche, View-Skripte.
../nextora-design-system/SKILL.md	Paletten-/Typografie-Presets, Stilvarianten, der optionale Besucher-Farb-/Schriftwechsler, Token- und CSS-Oberflächen.
../nextora-site-composition/SKILL.md	Templates, Template-Teile, Patterns, Query-/Archiv-Komposition.

Geteilte Beweise und Qualitätstore für jeden Spezialisten:

• references/source-map.md — woher die Regeln kommen, mit Herkunft.
• references/quality-gates.md — was wahr sein muss, bevor Arbeit akzeptiert wird.

Geordneter Workflow

1. Ziel-Theme und sein übergeordnetes Theme ermitteln

Von der Live-Installation oder vom bereitgestellten Repository aus arbeiten. Niemals einen Pfad erfinden und niemals einen Maschinenpfad in Ausgabe oder Notizen hartcodieren.

Innerhalb einer WordPress-Installation sind die beiden Wurzeln das Template-Verzeichnis (das übergeordnete) und das Stylesheet-Verzeichnis (das aktivierte Theme, übergeordnet oder Child):

get_template_directory();      // Root des übergeordneten Themes
get_stylesheet_directory();    // Root des aktiven Themes (Child, wenn eines aktiv ist)
get_stylesheet_directory_uri();

Außerhalb einer Installation das Theme anhand einer style.css mit einem Theme Name-Header und, für ein Child, einem Template:-Header, der sein übergeordnetes Theme benennt, lokalisieren. Wenn ein angegebener Pfad fehlt, den echten Pfad wiederentdecken; niemals Quellenbeweise erfinden, niemals stillschweigend ein anderes Theme auswählen und niemals Nextora-Kompatibilität behaupten, während die Nextora-Quelle nicht verfügbar ist — sagen, dass die Voraussetzung fehlt, und die Arbeit beenden, die nicht davon abhängt.

2. Lokale Beweise lesen, bevor Code vorgeschlagen wird

Diese aus dem Ziel-Theme in dieser Reihenfolge lesen und ihre Live-Werte über alles bevorzugen, was in einem Skill zitiert wird:

Datei	Was sie festlegt
style.css	Theme-Name, Version, Template: (übergeordnet für ein Child), Erfordert mindestens, Erfordert PHP, Getestet bis, Text-Domain, Lizenz.
functions.php	Lade-Reihenfolge, was das Theme auf Datei-Ebene benötigt, welche Feature-Dateien es einbindet.
theme.json	Palette, Verlauf, Schriftart, Schriftgröße, Abstands-Slugs; benutzerdefinierte Templates und Template-Teile; version.
package.json	Welche Build-/Verify-Befehle tatsächlich existieren und welche Bibliotheken bereits Abhängigkeiten sind.
theme.js/.nvmrc, Build-Skripte	Node-Version und die tatsächlichen Build-Einstiegspunkte.
AGENTS.md, README.md, docs/, .opencode/	Projektanweisungen. Als Behauptungen behandeln, die zu überprüfen sind, nicht als Autorität.

Dann herausfinden, was bereits existiert, bevor etwas Neues vorgeschlagen wird:

• blocks/*/block.json — registrierte Blöcke, ihre Namen, Kategorien, Supports.
• parts/*.html, templates/*.html — Kompositionsoberflächen und ihre Hierarchie.
• patterns/*.php — wiederverwendbares Abschnitts-Markup.
• resources/css/ + assets/css/ — welches Stylesheet tatsächlich ausgeliefert wird und wie es gebaut wird.
• resources/ts/editor/ oder Äquivalent — gemeinsame Editor-Helfer zur Wiederverwendung anstatt zum Neuschreiben (Vorschau-Shell, Rich Text, Medien, Wiederholungsfeld).
• inc/ — Helfer für Abfragen, Navigation, Templates.

Wiederverwendung schlägt Neuerstellung: Ein existierender Block, ein Pattern, ein Helfer oder ein Token, der die Aufgabe bereits erfüllt, ist die richtige Antwort, und ein neuer Block ist nur korrekt, wenn das angeforderte Verhalten oder die Bearbeitungsstruktur nicht anders ausgedrückt werden kann.

3. Nach Absicht weiterleiten

Anfrage	Zu ladende Spezialisten
Child-Theme erstellen, bereitstellen oder bootstrappen; Child-Asset-Pipeline; Child-Block-Registrierung	nextora-child-themes
Block hinzufügen/ändern: block.json, Attribute, Editor-UI, render.php, View-Skript, Wiederholungsfeld, Einstellungsbereich	nextora-gutenberg-blocks
Farben, Schriftarten, Abstands-Token, Stilvarianten, der Besucherwechsler, „muss der Palette folgen“	nextora-design-system
Templates, Template-Teile, Patterns, Seitenlayouts, Archive, Beitragsabfragen	nextora-site-composition

Kombinierte Anfragen laden jeden anwendbaren Spezialisten. Zwei Kombinationen sind obligatorisch:

• Neues Child + jede Designanforderung → nextora-child-themes und nextora-design-system. Ein Child, das Presets oder Besucherwechseln folgen muss, kann nicht allein vom Child-Skill abgeschlossen werden.
• Neuer oder umgestalteter Block → nextora-gutenberg-blocks und nextora-design-system. Das Erscheinungsbild von Blöcken gehört zum Design-System.

Da die Spezialisten übereinstimmen müssen, sie in derselben Sitzung laden und dem Design-System-Skill bei jeder von ihm abgedeckten Erscheinungsbildfrage den Vorrang geben.

4. Referenzen progressiv laden

Jeder Spezialist ist direkt aufrufbar; das Ausführen dieses Routers ist keine Voraussetzung. Wenn Sie einen Spezialisten laden, seine SKILL.md öffnen, dann nur die Referenzdateien lesen, die sein Workflow benennt, und zwar relativ zum Pfad. Die beiden gemeinsamen Referenzen oben sind von jedem Spezialisten verlinkt, daher müssen die relativen Cross-Skill-Links (../nextora-ecosystem/references/...) weiterhin auflösbar sein — sie nicht verschieben oder umbenennen.

5. Übergeben

Den/die Spezialisten laden, deren geordneten Workflow befolgen und references/quality-gates.md anwenden, bevor etwas für erledigt erklärt wird. Wenn die Anfrage rein eine Frage dazu ist, woher eine Regel stammt, aus references/source-map.md antworten und aufhören.

Abschlussprüfungen

• Ziel-Theme und übergeordnetes Theme aus ihrer eigenen style.css/theme.json identifiziert, nicht angenommen.
• Nur echte, existierende Dateien zitiert; alles als Quelle Zitierte wurde in dieser Sitzung gelesen.
• Jeder anwendbare Spezialist geladen, einschließlich der obligatorischen Paarungen oben.
• Neuer Code verwendet existierende Blöcke, Patterns, Helfer und Token, wo sie vorhanden sind.
• references/quality-gates.md auf das Ergebnis angewendet.
• Nichts in der Arbeit hängt von der eigenen Dateistruktur dieses Routers ab, abgesehen von den relativen Links oben.

Grenzen

Diese Suite besteht aus Markdown-Anweisungen und quellgestützten Referenzen. Sie liefert keine Laufzeitskripte, Generatoren, Starter-Theme-Bäume, Paketmanager oder Installationsprogramme. Nachgelagerte Build- und Browser-Verifizierungsbefehle gehören zum Ziel-Theme und sind in references/quality-gates.md aufgelistet.