Skip to content

Improve agent discoverability and navigation UX#29

Merged
Tranquil-Flow merged 1 commit intomainfrom
dev
Apr 1, 2026
Merged

Improve agent discoverability and navigation UX#29
Tranquil-Flow merged 1 commit intomainfrom
dev

Conversation

@Tranquil-Flow
Copy link
Copy Markdown
Collaborator

Summary

  • Split "Manage Agents" nav into separate "Register" and "My Agents" links to eliminate label ambiguity
  • Add robots.txt, sitemap.xml, and agent-specific meta tags (<link rel="agent-api">, <link rel="agent-card">, <link rel="llms-txt">) for crawler and agent discovery
  • Expand middleware content negotiation to serve llms.txt on text/plain Accept header
  • Add /.well-known/agent-registration redirect, /agents.json discovery endpoint, /api/health status check, and JSON 404 responses for unmatched API routes
  • Standardize CORS headers across all discovery endpoints with 24h preflight caching
  • Create styled 404 page with navigation and developer links
  • Fix pre-existing lint errors in visa page and VisaUpgradeFlow

Context

An AI agent attempted to register at app.ai.self.xyz and produced a UX audit. The registration form and bootstrap API were rated excellent, but homepage navigation and agent discoverability had gaps. The CTA issues were already fixed in dev, but nav labeling, SEO files, discovery metadata, and error handling needed work.

Test plan

  • Vercel preview build passes
  • Homepage loads, nav shows "Register" and "My Agents" as separate items
  • /robots.txt and /sitemap.xml return valid content
  • /agents.json returns discovery JSON
  • /api/health returns {"status":"ok"}
  • /.well-known/agent-registration redirects to /api/agent/bootstrap
  • /api/nonexistent returns JSON 404 with discovery links
  • /nonexistent shows styled 404 page
  • curl -H "Accept: text/plain" <url> returns llms.txt content
  • CORS preflight on discovery endpoints includes Access-Control-Allow-Headers

Split "Manage Agents" nav into separate "Register" and "My Agents" links to eliminate label ambiguity. Add robots.txt, sitemap.xml, and agent-specific meta tags for crawler and agent discovery. Expand middleware content negotiation to serve llms.txt on text/plain Accept header. Add /.well-known/agent-registration redirect, /agents.json discovery endpoint, /api/health status check, and JSON 404 responses for unmatched API routes. Add bootstrap hint on homepage. Standardize CORS headers across all discovery endpoints with 24h preflight caching. Create styled 404 page with navigation and developer links. Fix pre-existing lint errors in visa page and VisaUpgradeFlow.
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
self-agent-id Ready Ready Preview, Comment Apr 1, 2026 10:39am

Request Review

@Tranquil-Flow Tranquil-Flow merged commit 88c2f1f into main Apr 1, 2026
9 checks passed
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