wordpress-router

wordpress-router 개요

wordpress-router는 에이전트가 리포지토리를 빠르게 분류하고, 변경 작업에 들어가기 전에 적절한 후속 워크플로를 고르게 도와주는 WordPress 트리아지 skill입니다. 사용자의 요청이 넓게 열려 있거나, 코드베이스가 plugin, classic theme, block theme, Gutenberg package, WordPress core checkout, full site repo 중 무엇인지 먼저 가려야 할 때 특히 유용합니다.

이 skill의 용도

wordpress-router는 편집용이 아니라 라우팅용입니다. 리포지토리 유형, 사용 가능한 도구, 예상되는 테스트, 그리고 다음에 연결할 가장 관련성 높은 domain skill을 식별해 초반의 추측을 줄이는 것이 이 skill의 역할입니다.

누가 설치하면 좋은가

WordPress 코드베이스를 자주 다루고, 에이전트가 리포지토리를 blocks, theme.json, REST, WP-CLI, security, testing, release packaging 중 어떤 흐름으로 처리해야 하는지 판단해 주길 원한다면 wordpress-router를 설치하세요. 특히 여러 유형이 섞인 WordPress 리포지토리에서 에이전트 오케스트레이션을 할 때 유용합니다.

왜 중요한가

router가 없으면 에이전트가 잘못된 mental model로 바로 들어가 버리는 일이 흔합니다. block theme인데 classic theme 로직으로 접근하거나, site repo인데 plugin 전제를 깔거나, WordPress 워크플로 대신 일반적인 수정만 하는 식입니다. 이 skill은 실용적인 분류 단계를 추가해 downstream prompt의 품질을 높이고, 불필요한 변경 가능성을 낮춥니다.

wordpress-router skill 사용 방법

설치한 뒤 결정 경로를 찾기

wordpress-router skill에 문서화된 install path를 사용한 다음, SKILL.md부터 시작하세요. 이 리포지토리에는 references/decision-tree.md도 함께 안내되는데, 라우팅 결정을 위해 가장 먼저 이어서 읽을 만한 파일입니다.

skill에 맞는 입력을 주기

wordpress-router skill은 다음 정보를 제공할 때 가장 잘 작동합니다.

• 리포지토리 루트 또는 현재 작업 디렉터리,
• 사용자의 실제 의도,
• WordPress 대상 버전이나 WP.com 요구사항 같은 버전 제약,
• tooling, release process, testing에 대한 하드 제한.

“이 WordPress repo 좀 고쳐줘”처럼 뭉뚱그린 요청은 라우팅하기 어렵습니다. 더 좋은 예시는 이런 식입니다. “이건 wp-content repo입니다. block theme 워크플로로 봐야 하는지 plugin 워크플로로 봐야 하는지 판단한 뒤, 기존 테스트가 있는 상태에서 template 변경을 가장 안전하게 진행할 경로를 계획해 주세요.”

처음 사용할 때의 권장 워크플로

1. SKILL.md에 설명된 project triage 단계를 실행합니다.
2. triage 결과를 읽고 프로젝트 유형, tooling, test coverage를 파악합니다.
3. references/decision-tree.md를 열어 의도를 다음 workflow에 매핑합니다.
4. 편집 전에 리포지토리 관례를 적용합니다. 특히 기존 build 및 test command를 먼저 확인하세요.

리포지토리에서 먼저 확인할 것

wordpress-router 가이드를 볼 때는 다음 순서가 중요합니다.

• 라우팅 절차와 guardrail을 위한 SKILL.md,
• 의도 기반 라우팅을 위한 references/decision-tree.md,
• 프로젝트 유형을 파악한 뒤에만 확인할 리포지토리별 문서.

이 순서가 중요한 이유는, 이 skill이 다른 모든 것을 보기 전에 경로를 좁히도록 설계되었기 때문입니다.

wordpress-router skill FAQ

wordpress-router가 domain skill을 대체하나요?

아니요. 이건 Agent Orchestration을 위한 프론트엔드 decision skill입니다. 올바른 WordPress 워크플로를 고르는 데는 도움을 주지만, 리포지토리 분류가 끝난 뒤에는 block, theme, plugin, testing skill을 대체하지 못합니다.

언제 wordpress-router를 쓰지 않아도 되나요?

단일 파일의 수정처럼 작업 범위가 이미 좁고, 어떤 workflow를 따라야 할지도 명확할 때는 건너뛰어도 됩니다. routing ambiguity가 없을수록 이 skill의 가치는 낮아집니다.

초보자에게도 wordpress-router 설치가 가치 있나요?

여러 WordPress repo 유형을 오가며 일할 가능성이 있다면 그렇습니다. 일반적인 prompt보다 더 안전한 출발점을 제공하지만, 여전히 사용자가 의도와 제약을 분명하게 줘야 합니다.

일반 prompt보다 왜 더 낫나요?

일반 prompt는 변경만 요청할 수 있지만, wordpress-router는 먼저 이것이 어떤 WordPress system인지, 그리고 어떤 workflow가 그 변경을 지배해야 하는지 묻습니다. 이 추가 분류 단계가 wordpress-router skill의 핵심 장점입니다.

wordpress-router skill 개선 방법

작업만 말하지 말고 의도를 더 분명히 주기

가장 좋은 입력은 원하는 결과와 리포지토리 맥락을 함께 적습니다. 예를 들어 “속도를 올려 주세요” 대신 “이건 WordPress plugin repo입니다. 성능 작업을 plugin, REST, block workflow 중 무엇으로 진행해야 하는지 판단하고, 가장 안전한 시작 경로를 제안해 주세요”처럼 쓰는 편이 좋습니다.

라우팅에 영향을 주는 제약을 추가하기

WordPress version target, release requirement, tooling limit을 포함하면 skill의 성능이 좋아집니다. 이런 정보는 리포지토리를 core, site, theme, plugin, Gutenberg 중심 작업 중 어디로 볼지 판단하는 데 도움이 됩니다.

흔한 실패 모드를 주의하기

가장 흔한 문제는 컨텍스트가 너무 부족한 경우입니다. 에이전트가 block theme인지 classic theme인지, plugin인지 site repo인지 구분하지 못하면 다음 workflow가 엉킬 수 있습니다. 또 다른 실패는 decision tree를 건너뛰고 곧바로 편집에 들어가는 것입니다.

첫 분류 뒤에는 다시 한 번 정리하게 하기

첫 번째 판별이 끝나면 에이전트에게 다음을 다시 말하게 하세요.

• 리포지토리 유형,
• 이어질 가능성이 큰 downstream skill,
• 판단에 사용한 파일,
• 아직 남아 있는 핵심 불확실성.

이렇게 하면 코드 변경 전에 경로를 바로잡을 수 있어 Agent Orchestration에서 wordpress-router를 더 유용하게 쓸 수 있습니다.