Skip to content

SEP-1802 file-based sep workflow#1802

Closed
nickcoai wants to merge 6 commits intomainfrom
nickcoai/file-sep
Closed

SEP-1802 file-based sep workflow#1802
nickcoai wants to merge 6 commits intomainfrom
nickcoai/file-sep

Conversation

@nickcoai
Copy link
Contributor

Adjust primary SEP process to be file-based.

Motivation and Context

We often want SEPs to accompany changes, and an issue is awkward for discussion and loses version history (and makes multiple-contributors difficult). Instead move to a markdown document for the change.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Documentation
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have added or updated documentation as needed

@nickcoai nickcoai changed the title SEP file-based sep workflow SEP-1802 file-based sep workflow Nov 12, 2025
Copy link
Member

@pcarleton pcarleton left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm overall, unsure if the SEP States changes were intentional

### SEP States

SEPs can be one one of the following states
SEPs move through the following states, which are recorded in the SEP header:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

did we mean to change the states?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not this much, took them from the README in the seps folder, will treat this one as canonical and update the latter.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, I'm not sure these make as much sense for granularity given the changelog of the SEP md file

Namely Proposal isn't relevant [the sponsor block records that], and Dormant I think is implied by the PR state?

3. Find a Core Maintainer or Maintainer to sponsor your proposal. Tag potential sponsors from [MAINTAINERS.md](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/MAINTAINERS.md). Once someone agrees, record their handle in the `Sponsor` field.
4. After the pull request number is known, rename the file to `seps/{PR-number}-{slug}.md` and update the title/header to `SEP-{PR-number}` along with `PR: #{PR-number}`.
5. Work with your sponsor to iterate on the proposal. Sponsors move the SEP through `Draft → In-Review → Accepted → Final` by updating the `Status` field in the file and using matching pull request labels.
6. Provide or link to a reference implementation before requesting `Final` status. The pull request containing the SEP should include links to any tracking issues or additional PRs needed to implement the change.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the SEP PR meant to be eventually merged into main? i.e., Will we keep the seps/ directory in git history?

If so, can the SEP PR also contain the necessary changes to the spec and documentation?

(I presume so, since that is what this SEP appears to be doing, but this item makes it sound like the SEP PR should link to an additional PR for the spec.)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. After the pull request number is known, rename the file to seps/{PR-number}-{slug}.md and update the title/header to SEP-{PR-number} along with PR: #{PR-number}.

Isn't the PR: #{PR-number} redundant?

nickcoai and others added 3 commits November 12, 2025 16:48
Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>
Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>
Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>
@dsp-ant
Copy link
Member

dsp-ant commented Nov 20, 2025

closing in favor of #1850

@dsp-ant dsp-ant closed this Nov 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants