From 0fe933d63bb0c039d51399fe3b5a01b733e36f48 Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Sun, 16 Aug 2026 11:40:23 -0400 Subject: [PATCH] docs(official-docs): index the Agent Plugins spec and the moved Claude Code pages The upstream source map indexed the Agent Skills specification but not the Agent Plugins specification. They are different documents. Agent Plugins is the packaging contract that compatible clients load; Agent Skills and the Model Context Protocol are two of the component contracts it packages. Reading the Agent Skills spec therefore does not discharge a preflight for a claim that rests on Agent Plugins packaging, which is exactly the conflation this index allowed. Both Claude Code pointers also return 301 to a new host. code.claude.com's own llms.txt lists the new paths and returns no hits for docs.claude.com, so this is a completed move rather than a transitional alias, and AGENTS.md requires the index to follow it. All 29 URLs in the index were fetched live on 2026-08-16: 0 dead, 0 content-drifted, 4 redirected. Two of those redirects are deliberately left alone and are not defects: the Model Context Protocol /specification/latest 307 is the publisher's own rotating alias, which pinning would defeat, and the Cockburn 301 is trailing-slash canonicalization with no content change. No version or status string is recorded in the index. This file states that it is not a cached specification, and embedding one would go stale as the draft advances. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_013HNno6WojPaSF2VQ6Ncjd4 --- docs/OFFICIAL-DOCS.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/OFFICIAL-DOCS.md b/docs/OFFICIAL-DOCS.md index cabdfea..3e0c303 100644 --- a/docs/OFFICIAL-DOCS.md +++ b/docs/OFFICIAL-DOCS.md @@ -35,8 +35,12 @@ as a pointer for compatibility review only unless repository policy changes. ## Normative ecosystem contracts -Use these when a component relies on the corresponding open standard: +Use these when a component relies on the corresponding open standard. Agent +Plugins is the packaging contract that compatible clients load; Agent Skills and +the Model Context Protocol are the separate component contracts it packages, and +reading one does not cover a claim that rests on another: +- [Agent Plugins specification](https://agent-plugins.org/specification) - [Agent Skills specification](https://agentskills.io/specification) - [Model Context Protocol specification](https://modelcontextprotocol.io/specification/latest) @@ -56,8 +60,8 @@ contract. Treat examples as evidence, not templates to copy blindly: Read the current official source-host documentation for every migrated component and record the exact pages in the migration pull request: -- [Claude Code documentation](https://docs.claude.com/en/docs/claude-code/overview) -- [Claude Code plugins](https://docs.claude.com/en/docs/claude-code/plugins) +- [Claude Code documentation](https://code.claude.com/docs/en/overview) +- [Claude Code plugins](https://code.claude.com/docs/en/plugins) - [Cursor documentation](https://cursor.com/docs) - [Cursor plugins](https://cursor.com/docs/plugins)