Skip to content

Update spec URLs for the /spec/web/ restructure - #109

Merged
dacharyc merged 1 commit into
mainfrom
spec-web-urls
Sep 13, 2026
Merged

dacharyc merged 1 commit into
mainfrom
spec-web-urls

Conversation

@dacharyc

Copy link
Copy Markdown
Member

Updates every spec link for the new site structure shipping in agent-ecosystem/agent-docs-spec#33: the spec moved from a single page at /spec/ to per-category pages under /spec/web/.

  • SPEC_BASE_URLhttps://agentdocsspec.com/spec/web/
  • New specCheckUrl(category, checkId) builds per-check links as /spec/web/<category>/#<check-id> — category ids here already match the spec site's page slugs, so the CLI's "Learn more" links land on the right category page
  • Docs (docs/checks/*, README, SCORING.md) rewritten to the per-category anchors; the progressive-disclosure anchor now points into /spec/web/content-discoverability/
  • Test fixtures updated; 1350 tests pass, tsc clean

Merge order: merge after agent-docs-spec#33 is merged and deployed; until then the new URLs 404. After deploy, old-style /spec/#anchor links from released afdocs versions resolve to the spec-family landing page (minus the anchor), so existing releases degrade softly rather than break.

Not in scope: implementing the five new v0.6.0 checks or bumping SPEC_VERSION (still v0.5.0); that's follow-up implementation work.

🤖 Generated with Claude Code

The Agent-Friendly Documentation Spec site now serves the spec as
per-category pages under /spec/web/ (agent-docs-spec#33). Check
definitions live at /spec/web/<category>/#<check-id>; category ids in
this codebase already match the site's page slugs, so specCheckUrl()
derives the page from the result's category.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@dacharyc
dacharyc marked this pull request as ready for review September 13, 2026 22:47
@dacharyc
dacharyc merged commit adf6ccc into main Sep 13, 2026
2 checks passed
@dacharyc
dacharyc deleted the spec-web-urls branch September 13, 2026 22:48
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