Guide

PostSnail Enhancement Proposals

PSEPs document protocol-risk changes before they affect creators, verifiers, trackers, or workspace migrations.

What PSEP Means

PSEP means PostSnail Enhancement Proposal. It is required for changes that alter public proof semantics, workspace schema versions, tracker payloads, verifier behavior, or migration rules.

Required Sections

A PSEP includes title, status, feature name, motivation, files changed, new fields, required versus optional features, migration rules, verifier behavior, compatibility impact, security impact, and tests required.

Default To Optional

New features should be optional extensions unless old software must reject them for safety. Unknown optional fields are ignored; unknown required features fail clearly.

PSEP-0001

PSEP-0001 defines the current compatibility baseline: stable protocol core, optional extensions, deterministic workspace migrations, legacy warnings, and strict failures for broken proof data.