wp-playground

wp-playground 개요

wp-playground는 전체 로컬 WordPress 스택 대신, 일회성이고 재현 가능한 환경이 필요할 때 WordPress Playground 인스턴스를 설정하고 다루는 데 쓰는 스킬입니다. wp-playground 스킬은 플러그인 및 테마 개발자, QA 테스터, 그리고 문제 재현, 버전 테스트, 혹은 브라우저나 @wp-playground/cli로 실행 가능한 설정 공유가 필요한 백엔드 개발자에게 가장 적합합니다.

핵심은 이 스킬이 해결하는 작업입니다. 올바른 코드를 마운트한 상태로, 올바른 WP/PHP 버전을 선택하고, 디버깅하거나 결과물을 패키징할 수 있을 만큼 제어 가능한 WordPress 사이트를 빠르게 띄우는 것입니다. 이 스킬은 범용적인 “WordPress 프롬프트 작성기”가 아니라, 통제된 설정, blueprint, snapshot, 격리 테스트를 위한 실용적인 wp-playground guide입니다.

일회성 WP 워크플로에 가장 잘 맞는 경우

다음이 필요할 때 wp-playground를 사용하세요:

• 플러그인이나 테마 변경 사항을 검증하기 위해 임시 WordPress 사이트를 띄워야 할 때,
• 특정 WordPress 또는 PHP 버전에서 테스트해야 할 때,
• 공유용 blueprint를 실행하거나 snapshot을 생성해야 할 때,
• 프로덕션이나 로컬 데이터베이스에 영향을 주지 않고 동작을 격리해서 디버깅해야 할 때.

무엇이 다른가

가장 큰 차별점은 CLI 워크플로, blueprint 지원, 그리고 예측 가능한 일회성 런타임입니다. wp-playground는 세련된 UI보다 반복 가능성이 더 중요할 때 특히 잘 맞습니다. 또한 이 환경이 SQLite 기반이고 WebAssembly 기반이라는 점도 중요합니다. 전통적인 서버 설치와 비교하면 성능과 제약 조건이 모두 달라지기 때문입니다.

먼저 알아야 할 중요한 제약

이 스킬은 일회성 환경 안에서 작업할 수 있을 때만 적합합니다. 프로덕션 데이터, 오래 유지되는 로컬 상태, 또는 일반적인 MySQL 기반 WordPress 스택이 필요한 워크플로에는 맞지 않습니다. 가장 좋은 결과를 얻으려면, 이를 메인 개발 환경의 대체재가 아니라 통제된 테스트 베드로 보아야 합니다.

wp-playground 스킬 사용 방법

설치하고 원본 파일을 먼저 열기

디렉터리 도구에 맞는 표준 wp-playground install 경로로 시작한 뒤, 작업을 시키기 전에 스킬의 소스 파일을 먼저 읽으세요. 이 저장소에서 중요한 파일은 SKILL.md, references/blueprints.md, references/cli-commands.md, references/debugging.md입니다. 이 파일들을 보면 스킬이 어떤 입력을 기대하는지, 어떤 CLI 플래그가 중요한지 알 수 있습니다.

대충 쓴 목표를 쓸 만한 프롬프트로 바꾸기

약한 프롬프트: “내 플러그인용으로 WordPress Playground를 설정해줘.”
더 강한 프롬프트: “wp-playground를 사용해서 packages/my-plugin의 플러그인을 위한 일회성 로컬 인스턴스를 만들고, 프로젝트를 자동 마운트한 뒤, WP 6.9와 PHP 8.3으로 테스트하고, 정확한 CLI 명령과 필요한 마운트 또는 blueprint 조정 사항까지 알려줘.”

wp-playground usage에는 다음을 포함하세요:

• 프로젝트 경로,
• server, run-blueprint, build-snapshot 중 무엇을 원하는지,
• WordPress와 PHP 버전,
• 코드 자동 마운트 여부,
• Xdebug 또는 blueprint 파일이 필요한지 여부.

먼저 올바른 워크플로를 고르기

실시간 테스트용 대화형 인스턴스가 필요하면 server --auto-mount를 사용하세요. 실행 후 종료되는 스크립트형 설정이 필요하면 run-blueprint를 사용하세요. 나중에 다시 넘기거나 재실행할 수 있는 재사용 가능한 산출물이 필요하면 build-snapshot를 사용하세요. 백엔드 디버깅이 목적이라면, 단순히 시작 명령만 묻지 말고 정확한 실패 양상을 말한 뒤 Xdebug 친화적인 절차를 요청하세요.

저장소는 이 순서로 읽기

좋은 wp-playground guide는 먼저 SKILL.md를 보고, 그다음 명령 형태를 확인하기 위해 references/cli-commands.md를 봅니다. 설정 자동화가 필요하면 references/blueprints.md를 확인하고, 중단점, 마운트, 멈춰 있는 실행이 관련되면 마지막으로 references/debugging.md를 보세요. 이 순서는 추측을 줄이고 --mount-before-install이나 --blueprint-may-read-adjacent-files 같은 플래그를 놓치지 않게 해줍니다.

wp-playground 스킬 FAQ

wp-playground는 프런트엔드 데모 전용인가요?

아닙니다. wp-playground skill은 격리된 WordPress 동작, 재현 가능한 버전, 디버그 세션이 필요한 플러그인, 테마, 백엔드 개발에 특히 유용합니다. 시각적 데모보다 통제된 실행에 더 가깝습니다.

먼저 완전한 로컬 WordPress 설정이 있어야 하나요?

대체로 아닙니다. wp-playground install의 목적은 전통적인 스택을 프로비저닝하지 않아도 빠르게 쓸 수 있는 환경을 제공하는 데 있습니다. 이미 로컬 스택이 있더라도, 깨끗한 비교 대상이 필요하거나 특정 WP/PHP 조합이 필요할 때 wp-playground는 여전히 유용합니다.

언제 사용하지 말아야 하나요?

프로덕션 데이터, 지속되는 콘텐츠 작업, 또는 MySQL에 특화된 동작에 의존하는 워크플로에는 사용하지 마세요. 플러그인이 외부 서비스, 파일시스템의 영속성, 장시간 유지되는 상태에 의존한다면, blueprint 안에서 그 의존성을 명시적으로 모델링할 수 없는 한 wp-playground는 기본 선택이 아닐 수 있습니다.

초보자도 쓰기 쉬운가요?

작업이 단순하고 CLI 예시를 정확히 따라가면 그렇습니다. 가장 흔한 실패 지점은 모호한 입력입니다. 프로젝트 경로, 버전 목표, blueprint 필요 여부를 지정하지 않으면 결과가 덜 유용해집니다. 초보자는 한 번에 하나의 명확한 워크플로만 요청할 때 가장 좋은 결과를 얻습니다.

wp-playground 스킬 개선 방법

정확한 설정 변수를 스킬에 알려주기

가장 큰 품질 향상은 프로젝트 루트, 원하는 WP/PHP 버전, 그리고 코드가 자동 마운트되어야 하는지 아니면 명시적으로 마운트되어야 하는지까지 지정할 때 나옵니다. 예를 들어, “wp-playground를 사용해서 plugins/contact-form을 WP 6.9와 PHP 8.3으로 테스트하고 --auto-mount를 사용해줘”는 “되게 해줘”보다 훨씬 낫습니다.

목표만 말하지 말고 실패 양상도 함께 말하기

디버깅 중이라면 무엇이 깨졌는지 정확히 말하세요. 설치가 실패하는지, 플러그인 훅이 실행되지 않는지, REST 응답이 잘못되는지, 혹은 버전별 회귀가 PHP 8.3에서만 나타나는지 적어야 합니다. 그래야 스킬이 server, run-blueprint, build-snapshot 중 무엇을 선택할지 판단할 수 있고, wp-playground for Backend Development 워크플로의 유용성도 높아집니다.

마운트와 blueprint 실수를 조심하기

자주 생기는 문제는 상대 경로 마운트, 설치 전에 존재해야 하는 파일, 그리고 로컬 인접 파일을 읽어야 하는 blueprint입니다. 첫 실행이 실패했다면 절대 경로를 추가하고, --mount-before-install이 필요한지 확인하고, blueprint가 로컬 자산을 읽는지 명시해서 프롬프트를 개선하세요. 디버깅이 목적이라면 Xdebug 설정 상세와 예상 IDE 매핑도 함께 요청하세요.

한 번에 변수 하나씩만 바꿔가며 반복하기

첫 결과가 거의 맞지만 정확하지 않다면 WP 버전, PHP 버전, 마운트 방식, blueprint 소스 중 하나만 바꾸세요. 그래야 문제가 환경 선택인지, 명령 플래그인지, 아니면 설정 레시피 자체인지 더 쉽게 찾을 수 있습니다.