Skip to content

Replace legacy metadata guidance with extensions - #1

Closed
jonathanhefner wants to merge 1 commit into
mainfrom
agent/fix-103-extensions-docs
Closed

Replace legacy metadata guidance with extensions#1
jonathanhefner wants to merge 1 commit into
mainfrom
agent/fix-103-extensions-docs

Conversation

@jonathanhefner

@jonathanhefner jonathanhefner commented Aug 26, 2026

Copy link
Copy Markdown
Owner

Draft for review and discussion before submitting an upstream PR.

Addresses Agent-Card#103.

Summary

  • replace the removed native metadata field with extensions in the catalog and trust authoring guides
  • document the official https://ai-catalog.org/extensions/metadata extension as a schemaless generic key/value object without imposing a second namespace convention on its payload
  • omit selective Claude marketplace description and homepage mappings, and remove the obsolete Adspirer marketplace snapshot instead of preserving source-specific data in generic metadata

Validation

  • parsed the revised Claude marketplace worked example as JSON with jq
  • targeted scan for legacy structural metadata forms
  • git diff --check

The strict MkDocs and specification-renderer builds could not run locally because the recreated .venv has no dependencies and the sandbox package-date cutoff forces uv to re-resolve the lockfile. The repository lockfile was not changed.

Rebase notes

Comment thread docs/guides/adding-trust.md Outdated
Comment thread docs/guides/creating-a-catalog.md
Comment thread docs/guides/creating-a-catalog.md
Comment thread docs/guides/creating-a-catalog.md Outdated
Comment thread specification/ai-catalog.md Outdated
Comment thread specification/ai-catalog.md Outdated
ADR-0017 replaced the native `metadata` member before the 1.0 release,
but the authoring guides and Claude marketplace mapping still showed
documents that conflict with the normative CDDL.

Document `extensions` at the catalog, entry, and Trust Manifest scopes,
and describe the official metadata extension without imposing a second
namespace convention on its schemaless payload.

Omit selective Claude description and homepage mappings, and remove the
obsolete Adspirer marketplace snapshot instead of preserving
source-specific data in generic metadata.
@jonathanhefner
jonathanhefner force-pushed the agent/fix-103-extensions-docs branch from 6d4e45d to fdb67b9 Compare August 26, 2026 17:34
@jonathanhefner

Copy link
Copy Markdown
Owner Author

Submitted as Agent-Card#104.

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