Skip to content

docs: add ADR for filesystem as host-side implementation detail#82

Merged
olaservo merged 4 commits into
mainfrom
formalizing-filesystem-decision
May 3, 2026
Merged

docs: add ADR for filesystem as host-side implementation detail#82
olaservo merged 4 commits into
mainfrom
formalizing-filesystem-decision

Conversation

@olaservo
Copy link
Copy Markdown
Member

@olaservo olaservo commented Apr 19, 2026

Summary

  • Adds a proposed ADR (2026-04-19) recording that the Skills Extension SEP treats the filesystem as a host-side implementation detail.
  • Skills served over MCP MUST function on hosts without a local filesystem; hosts MAY materialize resources as an optimization; relative-path resolution MUST produce the same result either way.
  • Promotes the "Hosts: Unified Treatment" semantic requirement from SHOULD to MUST while keeping materialization a host choice.

Note

The SEP has included the "Hosts: Unified Treatment" section and filesystem-parity relative-path resolution since PR #69's first commit (2026-03-17). This ADR formalizes a stance the draft SEP has carried for ~a month, promoting the semantic requirement from SHOULD to MUST.

Related

Notes

  • Status is Proposed pending WG discussion.

Test plan

  • Verify ADR renders correctly in docs/decisions.md
  • WG review of wording, especially the MUST/MAY boundaries

Record the proposed decision that skills served over MCP MUST function
without a local filesystem, while hosts MAY materialize resources as an
optimization, with unified resolution semantics required either way.
@olaservo olaservo marked this pull request as ready for review April 19, 2026 21:23
@olaservo olaservo requested a review from a team as a code owner April 19, 2026 21:23
@olaservo
Copy link
Copy Markdown
Member Author

Lets leave this one open until 2026-04-29 (following 10-day lazy consensus per working group governance, in case anyone has any late breaking comments).

@olaservo olaservo added the SEP-2640 pull requests related to SEP-2640 label Apr 27, 2026
@olaservo
Copy link
Copy Markdown
Member Author

olaservo commented May 2, 2026

@copilot resolve the merge conflicts in this pull request

Co-authored-by: olaservo <16480113+olaservo@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI commented May 2, 2026

@copilot resolve the merge conflicts in this pull request

Resolved in 4dc12a4. The conflict in docs/decisions.md was between this PR's filesystem ADR and the archives ADR added to main via #83. Both 2026-04-19 ADRs are now present in the file.

@olaservo
Copy link
Copy Markdown
Member Author

olaservo commented May 2, 2026

@modelcontextprotocol/skills-over-mcp-ig I think we're good to merge this one since the feedback so far has been to formalize this detail, just need an approval on it. Thanks!

Copy link
Copy Markdown

@SamMorrowDrums SamMorrowDrums left a comment

Choose a reason for hiding this comment

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

I think this is likely the right call, the limitations are real, but the justification for this embracing these limitations is reasonable, assumption of local code execution is a concerning pattern.

@olaservo olaservo merged commit 0cefd96 into main May 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

SEP-2640 pull requests related to SEP-2640

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants