-
Notifications
You must be signed in to change notification settings - Fork 53
Open
Description
Summary
Add WordPress Playground-based environment configurations to the scaffold so that AI agents and CI pipelines can spin up full WordPress environments inside git worktrees or ephemeral CI runners without needing Docker or external hosting.
Problem
Currently, working with the scaffold in isolated contexts (git worktrees, CI jobs, agent-driven development) requires either a Docker-based local environment or a remote server. This creates friction for:
- AI coding agents operating in git worktrees that need a running WordPress instance to validate changes, run integration tests, or interact with the WP REST API.
- CI pipelines that need lightweight, disposable WordPress environments for end-to-end testing without the overhead of Docker or external infrastructure.
- Contributors who want to quickly preview or test changes without setting up a full local environment.
Proposed Solution
Integrate WordPress Playground (wp-now / Playground CLI) into the scaffold to provide zero-config, ephemeral WordPress environments. This could include:
- A
wp-playgroundconfiguration (e.g.,playground.jsonor similar blueprint) at the project root that defines the environment (PHP version, WP version, plugins, theme mapping). - Scripts or Makefile/Composer targets to start a Playground instance mapped to the scaffold's theme/plugin structure.
- Documentation on how agents and CI runners can leverage these environments.
- Integration with existing CI workflows (GitHub Actions) to spin up Playground for automated testing.
Use Cases
- Agent workflows: An AI agent working in a worktree runs
npx wp-now start(or equivalent) to get a live WordPress instance, then validates theme/plugin changes against the running site. - CI integration tests: GitHub Actions spin up a Playground instance, install the scaffold's theme/plugins, and run integration or E2E tests without Docker.
- Quick contributor previews: New contributors can preview the scaffold with a single command, no environment setup required.
Additional Context
- WordPress Playground
- wp-now CLI
- This would complement (not replace) existing Docker-based setups like 10up-docker.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels