Request for Comments (RFC) is how we propose and discuss changes to the Aifeels specification.
- New emotional primitives
- Changes to existing primitives
- Breaking changes to state schema
- New normative MCP tools
- Changes to decay semantics
- Changes to action triggers or thresholds
- Major version bumps
- Documentation improvements
- Typo fixes
- Non-normative examples
- Clarifications (use GitHub Issues)
- Reference implementation changes
Draft → Discussion (14+ days) → Decision → Implementation
- Copy
TEMPLATE.md - Fill out all sections
- Submit as PR to
RFC/directory - Naming:
RFC-NNNN-short-title.md(number assigned by maintainers)
- Minimum 14 days for community review
- Author responds to feedback
- Revisions incorporated
- Technical concerns addressed
Maintainers decide:
- Accepted — Merge RFC, implement in spec
- Rejected — Close with rationale
- Deferred — Needs more evidence/work
- Update SPEC.md
- Update schemas if needed
- Add to CHANGELOG.md
- Update version if breaking
RFCs are accepted if they:
- Solve a real, demonstrated problem
- Maintain determinism and auditability
- Don't break existing implementations (unless v2.0+)
- Include implementation evidence
- Have community support (2+ independent voices)
RFCs are rejected if they:
- Add complexity without clear benefit
- Violate core principles (see SPEC.md Section 1)
- Overlap with existing features
- Are implementation-specific
- Advantage specific vendors
- None yet - be the first!
- None yet
- None yet
See GOVERNANCE.md or open a Discussion.