Skip to content

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

Open
olaservo wants to merge 3 commits intomainfrom
formalizing-filesystem-decision
Open

docs: add ADR for filesystem as host-side implementation detail#82
olaservo wants to merge 3 commits intomainfrom
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).

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.

1 participant