Skip to content

How to Contribute

How to Contribute

We welcome contributions to the SpecForge specification format.

RFC Process

Changes to the format follow an RFC process:

  1. Open a GitHub Issue with the rfc tag
  2. Community discussion period (2 weeks for minor, 4 weeks for major changes)
  3. Maintainer reviews and accepts or rejects
  4. Accepted RFCs are implemented via PR

What You Can Contribute

  • Schema improvements — new fields, corrected types, better descriptions
  • Examples — additional spec files demonstrating patterns
  • Documentation — improvements to these docs
  • Tooling — validators, editors, converters

What Does NOT Belong

  • Engine-specific fields (workflow states, scoring, session tracking)
  • SaaS-specific concepts (billing, permissions, team management)
  • Features that only make sense for a single implementation

See CONTRIBUTING.md for full details.