Skip to main content

RFC Process

PTI normative requirements are published as numbered Request for Comments (RFC) documents. The RFC process ensures public review, architectural coherence, and predictable implementation impact.

Normative keywords in RFC bodies follow RFC 2119. Process rules in this document also use RFC 2119 where stated.

RFC lifecycle states

Draft

Purpose: Author working copy visible to the community.

  • Breaking changes MAY occur without deprecation notice
  • MUST NOT be cited in conformance certificates
  • Authors SHOULD solicit early feedback before requesting Review

Entry: Pull request or publication to RFC repository with complete required fields.

Review

Purpose: Structured community review before provisional commitment.

  • Minimum public comment period: 28 days for architectural RFCs; 14 days for narrow extensions
  • Maintainers MUST summarize substantive objections
  • Authors SHOULD respond to each objection or defer with rationale

Exit criteria: No unresolved must-fix issues identified by Maintainers, ARB, or SRG (where applicable).

Candidate

Purpose: Provisional normative text suitable for pilot implementations.

  • At least one independent implementation SHOULD exist or be actively committed
  • Conformance test stubs SHOULD be drafted
  • Breaking changes SHOULD trigger return to Review

Exit criteria: Working Group rough consensus; board sign-offs complete.

Accepted

Purpose: Normative specification for new development.

  • MUST include backward-compatibility analysis per RFC-010
  • MUST update conformance tests for affected profiles
  • Implementers targeting certification SHOULD implement Accepted RFCs for their profile

Stable

Purpose: Binding baseline for certification and long-term integration.

  • At least two independent implementations SHOULD demonstrate interoperable behavior for protocol RFCs
  • Test suite coverage MUST be complete for profile-required sections
  • Changes limited to errata, security fixes, and non-semantic clarifications unless Breaking Changes Policy applies

Deprecated

Purpose: Signal supersession while allowing transition.

  • MUST reference replacement RFC or bundle version
  • MUST publish migration guide and minimum transition period (≥12 months for Stable RFCs unless SRG expedites for security)
  • New certifications MUST NOT rely solely on Deprecated RFCs

Retired

Purpose: Remove from active governance.

  • Historical reference only
  • Conformance Program MUST NOT issue new certificates referencing Retired RFCs
  • Archives MUST remain publicly accessible

Required RFC fields

Every RFC MUST include the following header table and sections:

Header metadata

FieldRequiredDescription
RFCYesNumber (e.g., 013) — assigned by Maintainers
TitleYesConcise descriptive title
StatusYesDraft, Review, Candidate, Accepted, Stable, Deprecated, Retired
VersionYesSemantic version of this RFC document
AuthorsYesNames and affiliations
CreatedYesISO 8601 date
UpdatedYesLast substantive change date
Depends onYesPrerequisite RFCs (or "None")
UpdatesIf applicableRFCs this document modifies
ObsoletesIf applicableRFCs this document replaces
Obsoleted byIf applicableSuccessor RFC
CategoryYesArchitecture, Protocol, Policy, Process
ConformanceYesProfiles affected (Core, Enterprise, Government, Edge)

Required sections

SectionContent
Abstract≤200 words summarizing scope
MotivationProblem statement and stakeholder impact
BackgroundContext, prior art, non-goals
TerminologyDefinitions; reference RFC 2119
SpecificationNormative requirements
Security considerationsThreats and mitigations (SRG input)
Privacy considerationsData handling impact
CompatibilityAnalysis vs prior RFC versions
ConformanceTestable assertions linked to test IDs
ReferencesNormative and informative
Change logPer-version summary

Optional sections MAY include: Examples, Appendix (test vectors), Implementation status.

Example header

| Field | Value |
|-------|-------|
| **RFC** | 004 |
| **Title** | Trust Lookup API |
| **Status** | Stable |
| **Version** | 1.0.0 |
| **Authors** | PTI Working Group |
| **Created** | 2025-06-01 |
| **Updated** | 2026-01-15 |
| **Depends on** | RFC-001, RFC-002 |
| **Updates** ||
| **Category** | Protocol |
| **Conformance** | Core, Enterprise, Government, Edge |

Numbering and allocation

  • RFC numbers are monotonic and never reused
  • Gap numbers MAY be reserved for planned series (e.g., 020–029 for context extensions)
  • Process documents MAY use RFC-0xx reserved range or live only in governance docs — Working Group decision required

Expedited paths

SituationProcess
Security vulnerabilitySRG-led patch; minimum 72-hour implementer notice when active exploitation known
ErrataMaintainer fast-track; no status promotion
EditorialDirect merge with reviewer

Security expedite MUST NOT introduce breaking wire-format changes without Working Group notification.

Relationship to Specification v1.0

The Specification v1.0 bundle integrates RFCs for readability. RFCs are authoritative on conflict; bundle integration SHOULD be updated within one patch release of RFC promotion.

Submitting an RFC

See Contribution Process. New RFCs SHOULD begin as Draft with an issue describing scope before large pull requests.