Governance
Rfc Process
RFC Process
Significant changes should go through an RFC issue before implementation.
When an RFC is required
Required (from current contributor policy):
- breaking changes to core types (
@loop-engine/core)
Strongly recommended:
- breaking event schema changes (
@loop-engine/events) - DSL format changes
- governance model changes
- new top-level packages with cross-cutting impact
Not usually required:
- bug fixes
- new built-in guards or signal rules
- loop definition additions in
loops/ - documentation changes
Why event schema changes require extra care
Repository guidance currently states: breaking event schema changes require a 6-month deprecation notice.
RFC submission flow
- Open GitHub issue with
[RFC]in title - Describe:
- problem
- proposal
- alternatives considered
- Collect maintainer/community feedback
- Land implementation PR linked to the RFC issue
Deprecation policy
Current documented rule in CONTRIBUTING.md:
- breaking event schema changes require 6-month deprecation notice
See the repository governance docs for the current maintainer model and decision process: