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)

Publication constraints

• Raw conversations are prohibited.
• Only canonical artifacts may be published.

Canonical URL pattern

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

Examples:

• https://jellylabs.ai/specs/didp/v1
• https://jellylabs.ai/specs/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.

Repo layout (recommended)

/specs/<name>/v1/index.md
/specs/<name>/v2/index.md
/docs/...
/schemas/...
/prompts/...

Publication steps (minimum)

1. Draft in git under /specs/<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.

Protocol creation prompt (non-normative)

To migrate a conversation into a public protocol/spec, use the canonical conversion prompt:

• prompts/conversation_to_docs_prompt.md

Implementation note (non-normative)

• Prefer Astro templates for /specs/* pages when publishing.

Cloudflare rewrite (concept)

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