An open, structured format for wellness plans.
WPL is a JSON-based language for describing comprehensive wellness programs that include workouts, nutrition, meditation, recovery, and habits. It enables platforms, trainers, and AI systems to create, validate, personalize, and track wellness plans consistently.
A wellness plan isn't a chat reply — if it's wrong, a client gets hurt. WPL lets an AI author plans through a validated grammar with a rule engine that removes exercises contraindicated for the individual client before a human ever sees them. The effect is measured, not asserted: in a public 560-trial benchmark across 7 OpenAI and Anthropic models, raw LLMs put a contraindicated exercise into 32–51% of plans; the same models speaking through WPL drop to 8–17% — a 3–5× reduction, on every corpus and in both single-turn and multi-turn conversations. In multi-turn chats, raw models drift off a contraindication the user already stated 42% of the time; through WPL, 6% (and 0% on the Anthropic set). Full data + methodology: wpl-eval.
This repository is the source of truth for the WPL specification, JSON Schema, and conformance test suite.
- 📖 Specification
- 📐 JSON Schema (canonical URL:
https://wpl.dev/schemas/wpl/v1.schema.json) - 📦 Examples
- 🧪 Conformance suite
- 🌐 wpl.dev — language website + interactive playground
Reference validators (consume the schema and conformance suite from this repo):
| Language | Repo | Package |
|---|---|---|
| TypeScript | gymbile/wpl-validator-ts |
@gymbile/wpl-validator (npm) |
| Elixir | gymbile/wpl-validator-ex |
wpl_validator (hex) |
Both implementations must produce identical results for the conformance suite.
The WPL schema follows semver. The canonical schema URL stays at /v1.schema.json for the entire v1 line — additive changes only. A breaking change becomes /v2.schema.json at a new URL; existing v1 plans keep working.
This repository uses split licensing:
| Path | License |
|---|---|
spec/, examples/ |
CC-BY-4.0 — documentation, free to use with attribution |
schema/, conformance/, .github/ |
Apache-2.0 — code, with patent grant |
"WPL" and "Wellness Plan Language" are trademarks of Gymbile. The spec and reference implementations are open under the licenses above. Implementations may declare conformance ("WPL-compatible" or "WPL v1 compliant") but may not be named "WPL" or imply endorsement by Gymbile. Forks must rename.
An implementation that passes every fixture in conformance/ may declare itself "WPL v1 compliant." See conformance/README.md for details.
See CONTRIBUTING.md.