migration

docs/contracts/uris.md

@@ -4,7 +4,7 @@ icon: lucide/link
 
 # URI Contract
 
-This page defines the public resource URI contract for native skills, registry-backed prompts, and general authored documentation.
+This page defines the public resource URI contract for native skills and general authored documentation.
 
 ## Native Skill URIs
 
@@ -44,17 +44,11 @@ skill://pytesting/references/pytest-docs.md
 
 FastMCP confines reads to the selected skill directory. Absolute paths, traversal outside the directory, missing files, directories, and symlinks that resolve outside the skill root are rejected.
 
-## Prompt And Docs URIs
+## General Docs URI
 
-Prompts and general documentation retain the existing registry-backed resource surface:
+General authored documentation is exposed through `resource://docs/{path*}`. The wildcard accepts normalized relative POSIX Markdown paths beneath `docs/`, excludes the provider-owned `skills/` subtree, and rejects absolute paths, traversal segments, backslashes, and non-Markdown targets.
 
-1. `resource://catalog/prompts_index`
-2. `resource://catalog/prompts_index{?q,tag,cursor,limit}`
-3. `resource://catalog/prompts/{prompt_id}`
-4. `resource://prompts/{prompt_id}/document`
-5. `resource://docs/{path*}`
-
-Prompt ids remain lowercase kebab-case. The docs wildcard accepts normalized relative POSIX Markdown paths beneath `docs/` and rejects absolute paths, traversal segments, backslashes, and non-Markdown targets.
+Prompts are MCP prompt components rather than resources. Clients discover them with the protocol `prompts/list` operation and render them with `prompts/get`.
 
 ## Discovery Order
 
@@ -66,11 +60,11 @@ For skills:
 4. read `_manifest` when supporting material may be needed
 5. fetch only the supporting paths relevant to the task
 
-For prompts, use the prompt catalog or MCP prompt-object APIs.
+For prompts, use the native MCP prompt APIs or their generic tool projection.
 
-## Compatibility Policy
+## Stability Policy
 
-The native `skill://` family directly replaces the repository's former custom skill URI and catalog surfaces. No compatibility aliases or dual registrations are maintained. Prompt and general-doc URIs are unaffected.
+The provider and protocol surfaces documented here are the complete public contract. Contract changes replace the affected surface directly.
 
 Skill renames are breaking because the directory name is part of every native skill URI. Supporting-file renames change the corresponding manifest path and URI.
 
@@ -80,3 +74,4 @@ Skill renames are breaking because the directory name is part of every native sk
 2. [MCP resources](https://modelcontextprotocol.io/specification/latest/server/resources)
 3. [RFC 3986 URI syntax](https://www.rfc-editor.org/rfc/rfc3986)
 4. [RFC 6570 URI templates](https://www.rfc-editor.org/rfc/rfc6570)
+5. [FastMCP prompts](https://gofastmcp.com/servers/prompts)