Add {AGENTS,CLAUDE}.md with documentation structure overview

Documents the non-obvious patterns in this repo: Mintlify vs Hugo
systems, date-based specification versioning, and schema generation
workflow.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: jonathanhefner

AGENTS.md

@@ -0,0 +1,37 @@
+# Model Context Protocol (MCP)
+
+This repository contains the MCP specification, documentation, and blog.
+
+## Documentation Structure
+
+- `docs/` - Mintlify site (`npm run serve:docs`)
+  - `docs/docs/` - guides and tutorials
+  - `docs/specification/` - MCP specification (more formal, versioned)
+- `blog/` - Hugo blog (`npm run serve:blog`)
+
+## Specification Versioning
+
+Specifications use **date-based versioning** (YYYY-MM-DD), not semantic versioning:
+
+- `schema/[YYYY-MM-DD]/` and `docs/specification/[YYYY-MM-DD]/` - released versions
+- `schema/draft/` and `docs/specification/draft/` - in-progress work
+
+## Schema Generation
+
+TypeScript files are the **source of truth** for the protocol schema:
+
+- Edit: `schema/[version]/schema.ts`
+- Generate JSON + docs: `npm run generate:schema`
+- This creates both `schema/[version]/schema.json` and the Schema Reference document in `docs/specification/[version]/schema.mdx`
+
+Always regenerate after editing schema files.
+
+## Useful Commands
+
+```bash
+npm run serve:docs       # Local Mintlify docs server
+npm run serve:blog       # Local Hugo blog server
+npm run generate:schema  # Generate JSON schemas + MDX from TypeScript
+npm run check:docs       # Check formatting and links
+npm run check            # Run all checks
+```

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md