Nextora 생태계 — 라우터
하나의 진실 공급원과 한 세트의 프로덕션 게이트를 공유하는 다섯 개 스킬을 조정합니다. 이 진입점은 대상 테마를 확인하고, 요청에 필요한 전문가를 식별하며, 작업을 인계합니다. 구현 규칙은 포함하지 않습니다. 해당 규칙은 각 전문가 스킬과 이 스킬의 두 참조 파일에 있습니다.
이 모음의 스킬들
| 스킬 | 담당 영역 |
|---|---|
../nextora-child-themes/SKILL.md | Nextora 자식 테마 생성 또는 부트스트래핑: 헤더, 부트스트랩, 에셋 파이프라인, 블록 등록기. |
../nextora-gutenberg-blocks/SKILL.md | 블록 메타데이터, 편집기 UI, 동적 렌더, 리피터, 설정 패널, 뷰 스크립트. |
../nextora-design-system/SKILL.md | 팔레트/타이포그래피 프리셋, 스타일 변형, 선택적 방문자 색상/글꼴 전환기, 토큰 및 CSS 표면. |
../nextora-site-composition/SKILL.md | 템플릿, 템플릿 부분, 패턴, 쿼리/아카이브 구성. |
모든 전문가가 공유하는 증거 및 게이트:
references/source-map.md— 규칙의 출처와 그 연원.references/quality-gates.md— 작업이 승인되기 전에 충족되어야 하는 조건.
순서 있는 워크플로
1. 대상 테마와 그 부모 테마 확인
실제 설치 환경 또는 제공된 저장소를 기준으로 작업합니다. 경로를 임의로 만들지 말고, 출력이나 메모에 시스템 경로를 하드코딩하지 마십시오.
WordPress 설치 내에서 두 루트는 템플릿 디렉터리(부모 테마)와 스타일시트 디렉터리(활성화된 테마, 부모 또는 자식)입니다:
get_template_directory(); // 부모 테마 루트
get_stylesheet_directory(); // 활성 테마 루트 (자식 테마가 활성화된 경우 자식)
get_stylesheet_directory_uri();
설치 외부에서는 Theme Name 헤더가 있는 style.css와, 자식 테마의 경우 부모를 지정하는 Template: 헤더를 통해 테마를 찾습니다. 제공된 경로가 없으면 실제 경로를 다시 찾고, 소스 증거를 조작하지 말며, 다른 테마를 조용히 선택하지 말고, Nextora 소스를 사용할 수 없는데 Nextora 호환성을 주장하지 마십시오. 전제 조건이 누락되었음을 알리고 그에 의존하지 않는 작업을 완료하십시오.
2. 코드 제안 전 로컬 증거 읽기
대상 테마에서 다음 파일을 이 순서대로 읽고, 스킬에 인용된 값보다 실제 값을 우선시하십시오:
| 파일 | 확인 사항 |
|---|---|
style.css | 테마 이름, 버전, Template:(자식인 경우 부모), Requires at least, Requires PHP, Tested up to, Text Domain, 라이선스. |
functions.php | 로드 순서, 파일 범위에서 테마가 요구하는 사항, 포함하는 기능 파일. |
theme.json | 팔레트, 그라데이션, font-family, font-size, 간격 슬러그; 사용자 정의 템플릿 및 템플릿 부분; version. |
package.json | 실제 존재하는 빌드/검증 명령어와 이미 의존성인 라이브러리. |
theme.js/.nvmrc, 빌드 스크립트 | Node 버전과 실제 빌드 진입점. |
AGENTS.md, README.md, docs/, .opencode/ | 프로젝트 지침. 권위 있는 것으로 간주하지 말고 검증해야 할 주장으로 취급. |
그런 다음 새 것을 제안하기 전에 이미 존재하는 것을 찾으십시오:
blocks/*/block.json— 등록된 블록, 이름, 카테고리, 지원 속성.parts/*.html,templates/*.html— 구성 표면과 계층 구조.patterns/*.php— 재사용 가능한 섹션 마크업.resources/css/+assets/css/— 실제로 제공되는 스타일시트와 빌드 방식.resources/ts/editor/또는 동등한 위치 — 재작성 대신 재사용할 공유 편집기 도우미(미리보기 셸, 리치 텍스트, 미디어, 리피터).inc/— 쿼리, 탐색, 템플릿을 위한 도우미.
재사용이 발명보다 우선합니다: 이미 작업을 수행하는 기존 블록, 패턴, 도우미 또는 토큰이 올바른 답이며, 요청된 동작이나 편집 구조를 달리 표현할 수 없는 경우에만 새 블록이 올바릅니다.
3. 의도에 따라 디스패치
| 요청 | 로드할 전문가 |
|---|---|
| 자식 테마 생성, 스캐폴딩 또는 부트스트래핑; 자식 에셋 파이프라인; 자식 블록 등록 | nextora-child-themes |
블록 추가/변경: block.json, 속성, 편집기 UI, render.php, 뷰 스크립트, 리피터, 설정 패널 | nextora-gutenberg-blocks |
| 색상, 글꼴, 간격 토큰, 스타일 변형, 방문자 전환기, "팔레트를 따라야 함" | nextora-design-system |
| 템플릿, 템플릿 부분, 패턴, 페이지 레이아웃, 아카이브, 포스트 쿼리 | nextora-site-composition |
복합 요청은 해당되는 모든 전문가를 로드합니다. 다음 두 조합은 필수입니다:
- 새 자식 테마 + 외관 요구 사항 →
nextora-child-themes및nextora-design-system. 프리셋 또는 방문자 전환기를 따라야 하는 자식 테마는 자식 스킬만으로 완료할 수 없습니다. - 새 블록 또는 스타일이 변경된 블록 →
nextora-gutenberg-blocks및nextora-design-system. 블록 외관은 디자인 시스템이 담당합니다.
전문가들이 일관성을 유지해야 하므로 동일한 세션에서 로드하고, 외관 관련 질문에 대해 디자인 시스템 스킬이 우선하도록 하십시오.
4. 참조 파일을 점진적으로 로드
각 전문가는 직접 호출 가능합니다. 이 라우터를 실행하는 것은 필수 사전 조건이 아닙니다. 전문가를 로드할 때는 해당 SKILL.md를 열고, 그 워크플로가 명명한 참조 파일만 상대 경로로 읽으십시오. 위의 두 공유 참조 파일은 모든 전문가에서 연결되므로, 스킬 간 상대 링크(../nextora-ecosystem/references/...)가 계속 작동해야 합니다. 이동하거나 이름을 변경하지 마십시오.
5. 인계
전문가를 로드하고, 그들의 순서 있는 워크플로를 따르며, 작업을 완료했다고 선언하기 전에 references/quality-gates.md를 적용하십시오. 요청이 순수하게 규칙의 출처에 대한 질문인 경우 references/source-map.md에서 답변하고 중단하십시오.
완료 확인
- 대상 테마와 부모 테마가 자체
style.css/theme.json에서 식별되었으며, 가정되지 않았습니다. - 실제 존재하는 파일만 인용되었습니다. 소스로 인용된 모든 것은 이 세션에서 읽은 것입니다.
- 해당되는 모든 전문가가 로드되었으며, 위의 필수 쌍을 포함합니다.
- 새 코드는 기존 블록, 패턴, 도우미 및 토큰을 재사용합니다.
references/quality-gates.md가 결과에 적용되었습니다.- 작업 중 이 라우터의 자체 파일 레이아웃에 의존하는 것은 위의 상대 링크 외에 없습니다.
경계
이 모음은 마크다운 지침과 소스 기반 참조입니다. 런타임 스크립트, 생성기, 스타터 테마 트리, 패키지 관리자 또는 설치 프로그램을 제공하지 않습니다. 다운스트림 빌드 및 브라우저 검증 명령어는 대상 테마에 속하며 references/quality-gates.md에 나열됩니다.