Skip to content

Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-agentic

saas-seo-agentic

Unverified

Audit & implement IsItAgentReady Level 0-5 standards (RFC 9727, llms.txt, MCP cards, JWKS).

Running this workflow on this client

Run commands from the project root (use Git Bash on Windows if bash points to an unavailable WSL distro). Shared studio files live in .claude/; follow .agents/PORTABLE-RUNTIME.md and .claude/docs/config-resolution.md for client tools, delegation, and approval rules.

Run bash .claude/hooks/yaml-helper.sh resolve_config --keys locale,review_mode,automation and use its output below.

Resolved above — use as-is; --review overrides review_mode for this run.

Agentic Browsing & Agent-Native Readiness for SaaS

Locale & User Profile: Match locale (pt-BR → natural Brazilian Portuguese questions/options, overriding English examples; en → English) and user_profile (founder → plain business language with (Recomendado) first, zero tech jargon; developer → technical). Keep code/tests in English.

Audits and engineers SaaS platforms across 25 agent-readiness standards (5 categories + IsItAgentReady Level 0–5 maturity scale) and Google Lighthouse Agentic Browsing ($X/N$).


1. The 5 Agent-Readiness Categories & Maturity Levels

Read references/isitagentready-levels.md for the full Level 0–5 calculation rules:

  1. Discoverability (references/dns-aid-and-link-headers.md):
    • robots.txt (RFC 9309), sitemap.xml, RFC 8288 Link headers (api-catalog, service-desc, service-doc, describedby), and DNS-AID (SVCB/HTTPS/TXT under _agents.<domain> with DNSSEC).
  2. Content Accessibility (references/discovery-and-markdown.md):
    • /llms.txt, /llms-full.txt, and Accept: text/markdown content negotiation (Vary: Accept, x-markdown-tokens).
  3. Bot Access Control (references/access-policy.md):
    • Explicit AI crawler User-agent rules (OAI-SearchBot, Claude-SearchBot, PerplexityBot, GPTBot, ClaudeBot, Google-Extended, Applebot-Extended, CCBot, Bytespider, Amazonbot), Content-Signal, and Web Bot Auth (/.well-known/http-message-signatures-directory JWKS).
  4. API, Auth & Agent Discovery (references/agent-auth-and-identity.md):
    • /.well-known/api-catalog (RFC 9727), /.well-known/oauth-authorization-server / openid-configuration (RFC 8414 / OIDC), /.well-known/oauth-protected-resource (RFC 9728), /auth.md, /.well-known/mcp/server-card.json (SEP-1649), /.well-known/agent-card.json (A2A), /.well-known/agent-skills/index.json (RFC v0.2.0), /.well-known/ai-catalog.json (ARD 1.0 + CORS), WebMCP (document.modelContext.registerTool + AbortController + toolparamdescription), and Personal Agent Protocol (/.well-known/poppy.json, informational).
  5. Agentic Commerce & Machine Payments (references/agentic-commerce-protocols.md):
    • x402 (@x402/next HTTP 402), MPP (/openapi.json x-payment-info), ACP (/.well-known/acp.json), and UCP (/.well-known/ucp).

2. Priority Hierarchy (P0 to P3)

PriorityCheckTool Check ID
P0Accessible names, valid ARIA roles, interactive elements exposedagent-accessibility-tree
P0Cumulative Layout Shift (CLS) <= 0.1cumulative-layout-shift
P0Core content present in initial server-rendered HTMLserver-rendered
P0robots.txt reachable with explicit AI crawler groupsrobots-ai-groups
P1llms.txt present and compliant (# Title, link, 50+ chars)llms-txt
P1Markdown via Accept: text/markdown (Vary: Accept)markdown-delivery
P1XML Sitemap reachablesitemap-reachable
P1Real 404 for unknown routes (catch-all 200 breaks discovery)http-404
P2RFC 8288 Link discovery response headerslink-headers
P2MCP Server Card, Agent Skills Index, API Catalog, Web Bot Auth JWKS, OAuthwell-known:*
P2WebMCP tools registered on document.modelContextwebmcp-entry-point
P3ARD ai-catalog.json, A2A Card, Poppy, Auth.md, DNS-AID, ACP, UCP, MPPard-catalog, auth-md, dns-aid, commerce:*

3. Next.js 14+ App Router Scaffolds (templates/seo/)

When scaffolding agent-readiness into a Next.js App Router SaaS project, reuse the studio templates under templates/seo/:

  • templates/seo/robots-txt-route.ts -> app/robots.txt/route.ts (supports Content-Signal and Amazonbot)
  • templates/seo/llms-txt-route.ts -> app/llms.txt/route.ts
  • templates/seo/markdown-negotiation-middleware.ts -> middleware.ts (Accept: text/markdown + RFC 8288 Link headers)
  • templates/seo/agent-skills-index-route.ts -> app/.well-known/agent-skills/index.json/route.ts
  • templates/seo/mcp-server-card-route.ts -> app/.well-known/mcp/server-card.json/route.ts
  • templates/seo/api-catalog-route.ts -> app/.well-known/api-catalog/route.ts
  • templates/seo/ai-catalog-route.ts -> app/.well-known/ai-catalog.json/route.ts
  • templates/seo/auth-md-route.ts -> app/auth.md/route.ts
  • templates/seo/web-bot-auth-jwks-route.ts -> app/.well-known/http-message-signatures-directory/route.ts

4. Tool Execution & Draft Generation

# Full audit (25 standards + Level 0-5 maturity score)
python scripts/seo/agentic_check.py <url> --json
python scripts/seo/lighthouse_agentic.py <url> --json

# Generate reviewable drafts for missing files
python scripts/seo/agentic_fix.py agent-skills https://example.com --skills-dir .claude/skills
python scripts/seo/agentic_fix.py mcp-card --name "My SaaS MCP" --url https://example.com
python scripts/seo/agentic_fix.py api-catalog https://example.com
python scripts/seo/agentic_fix.py auth-md --name "My SaaS" --url https://example.com
python scripts/seo/agentic_fix.py poppy --name "My SaaS" --domain example.com
python scripts/seo/agentic_fix.py acp https://example.com
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall