Skip to content

RFCs — Overview

Spec-level decisions go through the RFC process. Six RFCs are ratified and shipped in v0.3:

RFCTitleStatus
RFC-000Design rationaleratified
RFC-001Relation kind enforcementratified
RFC-002Rule expression grammarratified
RFC-003Events on ui_viewratified
RFC-004field reference resolutionratified
RFC-005Profile systemratified

Authoritative sources live at atomprd/specs/rfcs/. The pages here are summaries with links back to the full text.

Spec changes follow Bullet RFC-style:

  1. Open a discussion issue at github.com/atomprd/atomprd-format-spec (planned post-launch).
  2. Once direction is rough-agreed, file an RFC PR adding specs/rfcs/RFC-NNN-<slug>.md with sections: Motivation, Detailed design, Drawbacks, Alternatives, Unresolved questions.
  3. Merge requires two approvers from the spec maintainers + a 5-day comment window.
  4. After merge, the RFC is ratified. Implementation lands in @atomprd/spec as part of the next minor.
  • RFC-000 is the foundational design rationale; subsequent RFCs build on it.
  • Numbers are assigned at PR merge time, not draft time.
  • Withdrawn / superseded RFCs are marked but not deleted.

The SenLang spec also has its own RFC stream. AtomPRD RFCs that touch the bridge reference the corresponding SenLang RFC by number — e.g. AtomPRD’s criterion.behavior.before_after lowering ties into SenLang RFC-0010 Scenario fixtures.