Protocol for Publishing Protocols (PPP) v1

1.0 Foundation JellyLabs LLC (A Virginia Limited Liability Company) 2025-12-21

PPP v1

PPP is JellyLabs’ protocol for publishing protocols in a consistent, discoverable, versioned way.

Goals

  • predictable URLs
  • immutable versions
  • human-readable + SEO-friendly
  • git-backed provenance
  • easy mirroring (e.g., specs.jellylabs.ai)

Canonical URL pattern

https://jellylabs.ai/spec/<name>/v<major>

Examples:

  • https://jellylabs.ai/spec/didp/v1
  • https://jellylabs.ai/spec/ppp/v1

Version immutability

  • v1, v2, v3 are immutable once published.
  • Fixes must be published as:
    • errata page, or
    • v1.1 if you decide to support minors (optional), but keep a stable v1 landing.
/spec/<name>/v1/index.md
/spec/<name>/v2/index.md
/docs/...
/schemas/...
/prompts/...

Publication steps (minimum)

  1. Draft in git under /spec/<name>/vX/.
  2. Add frontmatter: title, version, status, owner, published date.
  3. Validate links + build.
  4. Publish to jellylabs.ai (Astro).
  5. Optionally mirror to specs.jellylabs.ai via Cloudflare rewrite.

Cloudflare rewrite (concept)

  • specs.jellylabs.ai/* → jellylabs.ai/spec/* (or equivalent origin path)