Rename workspace file references

Author: qmarcelle

examples/examples.mdx

@@ -1,13 +1,13 @@
 ---
 title: Examples
-description: Real and synthesized workspace.json files from public repositories showing the spec in practice.
+description: Real and synthesized agents.workspace.json files from public repositories showing the spec in practice.
 tableOfContents: false
 sidebar:
   order: 3
   label: Examples
 ---
 
-Three workspace.json examples: a TypeScript monorepo, a Python single-package
+Three agents.workspace.json examples: a TypeScript monorepo, a Python single-package
 project, and a polyglot repository. Each is synthesized from real open-source
 repository structures and labeled as such.
 

examples/minimal.json

@@ -4,6 +4,6 @@
     "generatedAt": "2026-05-06T00:00:00.000Z"
   },
   "manual": {
-    "description": "Minimal sample workspace.json demonstrating the required generated.version field."
+    "description": "Minimal sample agents.workspace.json demonstrating the required generated.version field."
   }
 }

spec.mdx

@@ -1,17 +1,17 @@
 ---
-title: workspace.json Specification v0.1
+title: agents.workspace.json Specification v0.1
 description: "The open specification for AI agent workspace context files: RFC-style prose with schema, stability annotations, and security considerations."
 tableOfContents: true
 sidebar:
   order: 1
   label: Spec v0.1
 ---
 
-The document specifies workspace.json v0.1, a JSON file format
+The document specifies agents.workspace.json v0.1, a JSON file format
 for structured codebase intelligence consumed by AI coding agents.
 It is proposed as a complement to the AGENTS.md convention, which
 specifies prose instructions for agents. Where AGENTS.md addresses
-the prescriptive layer (what agents should do), workspace.json
+the prescriptive layer (what agents should do), agents.workspace.json
 addresses the descriptive layer (what is true about the codebase).
 
 This repository contains the canonical spec and a JSON Schema. Use the
@@ -23,4 +23,4 @@ for community guidelines.
 
 ## 9. Contributing
 
-The specification is developed in public at
+The specification is developed in public at