{
  "version": "1.3.0",
  "updated": "2026-09-14",
  "total": 46,
  "documents": [
    {
      "id": "humans/what-is-an-ai-agent",
      "title": "What is an AI agent?",
      "description": "A practical explanation of agents, assistants, tools, and the decisions between a request and a result.",
      "audience": "humans",
      "category": "Foundations",
      "kind": "Guide",
      "level": "Business",
      "outcome": "Understand what an agent can do, what its environment controls, and why that matters for your business.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/what-is-an-ai-agent",
      "markdown_url": "https://byagents.dev/content/humans/what-is-an-ai-agent.md"
    },
    {
      "id": "humans/how-agents-find-products",
      "title": "How AI agents find products",
      "description": "Search, cited sources, directories, documentation, and connected tools form different routes into a business.",
      "audience": "humans",
      "category": "Foundations",
      "kind": "Guide",
      "level": "Mixed",
      "outcome": "Map the possible routes from a customer task to your product and identify which route was observed.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/how-agents-find-products",
      "markdown_url": "https://byagents.dev/content/humans/how-agents-find-products.md"
    },
    {
      "id": "humans/agents-and-internet-distribution",
      "title": "When the customer’s browser becomes a conversation",
      "description": "Our thesis on how agents could change internet distribution—and what businesses can prepare today.",
      "audience": "humans",
      "category": "The shift",
      "kind": "Perspective",
      "level": "Business",
      "outcome": "Understand the distribution thesis and the uncertainties behind it.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/agents-and-internet-distribution",
      "markdown_url": "https://byagents.dev/content/humans/agents-and-internet-distribution.md"
    },
    {
      "id": "humans/seo-geo-and-agent-discovery",
      "title": "SEO, GEO, and agent discovery: what actually changes?",
      "description": "Separate search eligibility, inclusion in AI answers, and completed actions so you can invest in the right work.",
      "audience": "humans",
      "category": "Foundations",
      "kind": "Guide",
      "level": "Business",
      "outcome": "Distinguish search visibility, answer inclusion, and successful agent handoffs.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/seo-geo-and-agent-discovery",
      "markdown_url": "https://byagents.dev/content/humans/seo-geo-and-agent-discovery.md"
    },
    {
      "id": "humans/crawl-access",
      "title": "Can an agent actually read your website?",
      "description": "A crawl-access checklist covering HTTP responses, robots rules, rendering, canonical URLs, and sitemaps.",
      "audience": "humans",
      "category": "Get found",
      "kind": "Guide",
      "level": "Technical",
      "outcome": "Identify whether access, indexing policy, or page delivery prevents useful retrieval.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/crawl-access",
      "markdown_url": "https://byagents.dev/content/humans/crawl-access.md"
    },
    {
      "id": "humans/structured-data",
      "title": "Structured data that helps explain your business",
      "description": "How to use Schema.org, JSON-LD, stable identifiers, and visible facts without inventing a special AI ranking formula.",
      "audience": "humans",
      "category": "Get understood",
      "kind": "Guide",
      "level": "Technical",
      "outcome": "Choose an accurate structured description and reconcile it with visible product facts.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/structured-data",
      "markdown_url": "https://byagents.dev/content/humans/structured-data.md"
    },
    {
      "id": "humans/citations-and-evidence",
      "title": "Give agents something worth citing",
      "description": "Build product claims that can be checked, quoted in context, and connected to the correct business.",
      "audience": "humans",
      "category": "Get understood",
      "kind": "Guide",
      "level": "Business",
      "outcome": "Build a source-backed product explanation that can support a specific recommendation.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/citations-and-evidence",
      "markdown_url": "https://byagents.dev/content/humans/citations-and-evidence.md"
    },
    {
      "id": "humans/mcp-and-tool-discovery",
      "title": "MCP, registries, and getting your tools discovered",
      "description": "Understand the difference between publishing a server, connecting it to a host, and getting a tool used.",
      "audience": "humans",
      "category": "Get used",
      "kind": "Guide",
      "level": "Mixed",
      "outcome": "Decide when an MCP integration helps and what publication alone cannot establish.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/mcp-and-tool-discovery",
      "markdown_url": "https://byagents.dev/content/humans/mcp-and-tool-discovery.md"
    },
    {
      "id": "humans/api-documentation",
      "title": "API documentation an agent can actually use",
      "description": "Document the full task: authentication, inputs, asynchronous results, errors, limits, and a verifiable outcome.",
      "audience": "humans",
      "category": "Get used",
      "kind": "Guide",
      "level": "Technical",
      "outcome": "Identify the documentation needed for an agent to reach a first successful API result.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/api-documentation",
      "markdown_url": "https://byagents.dev/content/humans/api-documentation.md"
    },
    {
      "id": "humans/brands-and-commerce",
      "title": "Agent discovery for brands and ecommerce",
      "description": "Prepare product identity, variants, offers, policies, and a dependable route to checkout.",
      "audience": "humans",
      "category": "Playbooks",
      "kind": "Guide",
      "level": "Business",
      "outcome": "Connect accurate product information to a valid shopping handoff.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/brands-and-commerce",
      "markdown_url": "https://byagents.dev/content/humans/brands-and-commerce.md"
    },
    {
      "id": "humans/service-businesses",
      "title": "Agent discovery for services, freelancers, and local businesses",
      "description": "Make scope, location, availability, proof, and the next step clear enough to support a real recommendation.",
      "audience": "humans",
      "category": "Playbooks",
      "kind": "Guide",
      "level": "Business",
      "outcome": "Publish the facts and inquiry or booking path a service customer needs.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/service-businesses",
      "markdown_url": "https://byagents.dev/content/humans/service-businesses.md"
    },
    {
      "id": "humans/llms-txt-and-markdown",
      "title": "What llms.txt and Markdown can—and cannot—do",
      "description": "Use lightweight text as a helpful documentation interface, without treating it as an AI ranking switch.",
      "audience": "humans",
      "category": "Get found",
      "kind": "Guide",
      "level": "Technical",
      "outcome": "Publish useful text representations without mistaking them for a guaranteed discovery mechanism.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/llms-txt-and-markdown",
      "markdown_url": "https://byagents.dev/content/humans/llms-txt-and-markdown.md"
    },
    {
      "id": "humans/from-discovery-to-action",
      "title": "From discovery to a purchase, booking, or API call",
      "description": "Find the missing step between being recommended and being usable.",
      "audience": "humans",
      "category": "Get used",
      "kind": "Guide",
      "level": "Mixed",
      "outcome": "Identify the missing step between a recommendation and a usable outcome.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/from-discovery-to-action",
      "markdown_url": "https://byagents.dev/content/humans/from-discovery-to-action.md"
    },
    {
      "id": "humans/measuring-agent-traffic",
      "title": "Measure agent discovery without fooling yourself",
      "description": "Separate crawler requests, assistant referrals, controlled tests, activations, and revenue.",
      "audience": "humans",
      "category": "Measurement",
      "kind": "Guide",
      "level": "Mixed",
      "outcome": "Separate platform exposure, requests, evaluations, and actual customer events.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/measuring-agent-traffic",
      "markdown_url": "https://byagents.dev/content/humans/measuring-agent-traffic.md"
    },
    {
      "id": "humans/first-30-days",
      "title": "Your first 30 days of agent discovery work",
      "description": "A focused implementation plan for one offering, a few real tasks, and an observable route to use.",
      "audience": "humans",
      "category": "Playbooks",
      "kind": "Playbook",
      "level": "Business",
      "outcome": "Plan a month of focused discovery and handoff improvements.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/first-30-days",
      "markdown_url": "https://byagents.dev/content/humans/first-30-days.md"
    },
    {
      "id": "humans/agent-discovery-glossary",
      "title": "The agent discovery glossary",
      "description": "Plain-English definitions of crawling, retrieval, citations, MCP, OpenAPI, GEO, and useful completion.",
      "audience": "humans",
      "category": "Foundations",
      "kind": "Reference",
      "level": "Business",
      "outcome": "Translate common agent-distribution terms into practical business meaning.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/agent-discovery-glossary",
      "markdown_url": "https://byagents.dev/content/humans/agent-discovery-glossary.md"
    },
    {
      "id": "agents/start",
      "title": "Start here: retrieve, verify, cite",
      "description": "A compact entry point for agents researching AI discovery or evaluating ByAgents.",
      "audience": "agents",
      "category": "Site reference",
      "kind": "Reference",
      "level": "Technical",
      "outcome": "Find the smallest set of reference documents needed for an authorized task.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/start",
      "markdown_url": "https://byagents.dev/content/agents/start.md"
    },
    {
      "id": "agents/product-facts",
      "title": "ByAgents: product facts and scope",
      "description": "Current capabilities, boundaries, entry points, and the broader business ambition.",
      "audience": "agents",
      "category": "Site reference",
      "kind": "Reference",
      "level": "Technical",
      "outcome": "Describe ByAgents using its actual available capabilities and documented limits.",
      "published": "2026-09-13",
      "updated": "2026-09-14",
      "url": "https://byagents.dev/agents/product-facts",
      "markdown_url": "https://byagents.dev/content/agents/product-facts.md"
    },
    {
      "id": "agents/knowledge-api",
      "title": "Knowledge API: requests and responses",
      "description": "The complete read-only HTTP contract for searching and indexing the ByAgents library.",
      "audience": "agents",
      "category": "Site reference",
      "kind": "Reference",
      "level": "Technical",
      "outcome": "Search and retrieve the public library through its documented HTTP interface.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/knowledge-api",
      "markdown_url": "https://byagents.dev/content/agents/knowledge-api.md"
    },
    {
      "id": "agents/discovery-checklist",
      "title": "A task-based discovery checklist",
      "description": "A reusable inspection procedure with explicit observations and unknowns.",
      "audience": "agents",
      "category": "Site reference",
      "kind": "Reference",
      "level": "Technical",
      "outcome": "Structure an evidence-based review of one offering and one customer task.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/discovery-checklist",
      "markdown_url": "https://byagents.dev/content/agents/discovery-checklist.md"
    },
    {
      "id": "agents/evidence-record",
      "title": "Evidence record: a portable example",
      "description": "A small custom JSON structure for reporting a discovery or integration finding without overstating it.",
      "audience": "agents",
      "category": "Site reference",
      "kind": "Reference",
      "level": "Technical",
      "outcome": "Record an observation, proposed repair, verification status, and limitations.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/evidence-record",
      "markdown_url": "https://byagents.dev/content/agents/evidence-record.md"
    },
    {
      "id": "agents/product-profile",
      "title": "Product facts template",
      "description": "A compact custom record connecting capabilities, pricing, evidence, and an action path.",
      "audience": "agents",
      "category": "Site reference",
      "kind": "Reference",
      "level": "Technical",
      "outcome": "Draft a public fact profile without inventing unknown prices or capabilities.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/product-profile",
      "markdown_url": "https://byagents.dev/content/agents/product-profile.md"
    },
    {
      "id": "agents/evidence-policy",
      "title": "Evidence, editorial policy, and trust boundaries",
      "description": "How to interpret claims, examples, sources, and content on this site.",
      "audience": "agents",
      "category": "Site reference",
      "kind": "Reference",
      "level": "Technical",
      "outcome": "Interpret claims, examples, sources, and product scope consistently.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/evidence-policy",
      "markdown_url": "https://byagents.dev/content/agents/evidence-policy.md"
    },
    {
      "id": "agents/publishing-contract",
      "title": "Publishing contract and representation map",
      "description": "Stable URLs, canonical identity, content types, search scope, caching, and maintenance.",
      "audience": "agents",
      "category": "Site reference",
      "kind": "Reference",
      "level": "Technical",
      "outcome": "Understand the exact representations and behavior this library publishes.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/publishing-contract",
      "markdown_url": "https://byagents.dev/content/agents/publishing-contract.md"
    },
    {
      "id": "humans/agent-distribution-now",
      "title": "Agent distribution: what matters now",
      "description": "A dated briefing on platform changes, emerging protocols, and what is actually worth implementing.",
      "audience": "humans",
      "category": "What’s current",
      "kind": "Briefing",
      "level": "Mixed",
      "outcome": "Separate production priorities from experiments, using a source-checked September 2026 briefing.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/agent-distribution-now",
      "markdown_url": "https://byagents.dev/content/humans/agent-distribution-now.md"
    },
    {
      "id": "humans/ai-discovery-platforms",
      "title": "How the major AI discovery channels differ",
      "description": "Search crawlers, user-requested visits, connected tools, and merchant feeds are different routes into an assistant.",
      "audience": "humans",
      "category": "Get found",
      "kind": "Guide",
      "level": "Mixed",
      "outcome": "Choose the right access controls and distribution route for the platforms your customers use.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/ai-discovery-platforms",
      "markdown_url": "https://byagents.dev/content/humans/ai-discovery-platforms.md"
    },
    {
      "id": "humans/agent-protocols-explained",
      "title": "MCP, WebMCP, A2A, ACP, UCP, and ARD: what to build",
      "description": "A plain-English map of agent protocols, the job each one does, and the adoption question to ask before investing.",
      "audience": "humans",
      "category": "Foundations",
      "kind": "Guide",
      "level": "Mixed",
      "outcome": "Select an interface for a real customer workflow without implementing every acronym.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/agent-protocols-explained",
      "markdown_url": "https://byagents.dev/content/humans/agent-protocols-explained.md"
    },
    {
      "id": "humans/agent-distribution-priorities",
      "title": "Where to start with agent distribution",
      "description": "A business-first plan for finding the broken step, choosing a channel, and deciding what deserves your time.",
      "audience": "humans",
      "category": "Playbooks",
      "kind": "Playbook",
      "level": "Business",
      "outcome": "Create a focused backlog tied to customer tasks, named owners, and observable outcomes.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/agent-distribution-priorities",
      "markdown_url": "https://byagents.dev/content/humans/agent-distribution-priorities.md"
    },
    {
      "id": "humans/content-for-agent-discovery",
      "title": "Write pages agents can actually use",
      "description": "Turn customer questions into clear source pages, comparison criteria, and verifiable product explanations.",
      "audience": "humans",
      "category": "Get understood",
      "kind": "Guide",
      "level": "Business",
      "outcome": "Write a useful content brief and test whether a retrieved page answers a real buying question.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/content-for-agent-discovery",
      "markdown_url": "https://byagents.dev/content/humans/content-for-agent-discovery.md"
    },
    {
      "id": "humans/product-feeds-for-ai-shopping",
      "title": "Product feeds for AI shopping",
      "description": "How to prepare item identities, prices, availability, and product pages for a real merchant-data integration.",
      "audience": "humans",
      "category": "Playbooks",
      "kind": "Guide",
      "level": "Mixed",
      "outcome": "Define a reliable product-data pipeline and distinguish catalog eligibility from enabled checkout.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/product-feeds-for-ai-shopping",
      "markdown_url": "https://byagents.dev/content/humans/product-feeds-for-ai-shopping.md"
    },
    {
      "id": "humans/evaluating-agent-distribution",
      "title": "How to test whether agent distribution is working",
      "description": "A practical evaluation design that separates discovery, understanding, completion, and real customer acquisition.",
      "audience": "humans",
      "category": "Measurement",
      "kind": "Playbook",
      "level": "Mixed",
      "outcome": "Run a reproducible small evaluation and report the result without inflating what it proves.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/evaluating-agent-distribution",
      "markdown_url": "https://byagents.dev/content/humans/evaluating-agent-distribution.md"
    },
    {
      "id": "humans/software-agent-distribution",
      "title": "An agent distribution playbook for software companies",
      "description": "Connect useful documentation, example projects, tool integrations, and a measurable first successful result.",
      "audience": "humans",
      "category": "Playbooks",
      "kind": "Playbook",
      "level": "Mixed",
      "outcome": "Ship one complete developer workflow and test a realistic route by which an agent could encounter it.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/software-agent-distribution",
      "markdown_url": "https://byagents.dev/content/humans/software-agent-distribution.md"
    },
    {
      "id": "humans/agent-commerce-readiness",
      "title": "From an AI recommendation to a confirmed purchase or booking",
      "description": "Design the handoff around current offers, permission, safe retries, and a confirmation the customer can trust.",
      "audience": "humans",
      "category": "Get used",
      "kind": "Guide",
      "level": "Mixed",
      "outcome": "Map the steps between selection and a real commercial outcome, including the cases that must stop.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/agent-commerce-readiness",
      "markdown_url": "https://byagents.dev/content/humans/agent-commerce-readiness.md"
    },
    {
      "id": "humans/agent-discovery-worked-example",
      "title": "Worked example: from an invoice question to a usable API",
      "description": "A fictional walkthrough that connects search, product facts, evidence, and the exact handoff that must work.",
      "audience": "humans",
      "category": "Playbooks",
      "kind": "Worked example",
      "level": "Mixed",
      "outcome": "See how one customer task becomes a concrete discovery and integration backlog.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/agent-discovery-worked-example",
      "markdown_url": "https://byagents.dev/content/humans/agent-discovery-worked-example.md"
    },
    {
      "id": "humans/maintaining-agent-distribution",
      "title": "Keep your agent distribution working after launch",
      "description": "A practical operating model for ownership, freshness, regression checks, and deciding which channels deserve investment.",
      "audience": "humans",
      "category": "Measurement",
      "kind": "Playbook",
      "level": "Mixed",
      "outcome": "Set review triggers and a small operating dashboard that connects maintenance to business value.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/humans/maintaining-agent-distribution",
      "markdown_url": "https://byagents.dev/content/humans/maintaining-agent-distribution.md"
    },
    {
      "id": "agents/crawl-audit-recipe",
      "title": "Recipe: audit public crawl and retrieval access",
      "description": "A bounded inspection procedure with exact observations, crawler-identity limits, and repair verification.",
      "audience": "agents",
      "category": "Audit recipes",
      "kind": "Recipe",
      "level": "Technical",
      "outcome": "Produce an access finding that distinguishes a policy, a response, and actual provider behavior.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/crawl-audit-recipe",
      "markdown_url": "https://byagents.dev/content/agents/crawl-audit-recipe.md"
    },
    {
      "id": "agents/retrieval-document-contract",
      "title": "Pattern: publish documents for reliable retrieval",
      "description": "Stable identifiers, focused content, explicit metadata, and consistent HTML, Markdown, and JSON.",
      "audience": "agents",
      "category": "Implementation patterns",
      "kind": "Pattern",
      "level": "Technical",
      "outcome": "Define a document interface that a reader can fetch, cite, update, and verify without a browser session.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/retrieval-document-contract",
      "markdown_url": "https://byagents.dev/content/agents/retrieval-document-contract.md"
    },
    {
      "id": "agents/mcp-publication-and-compatibility",
      "title": "Recipe: publish and verify an MCP integration",
      "description": "Separate registry publication, host availability, version compatibility, tool selection, and successful execution.",
      "audience": "agents",
      "category": "Audit recipes",
      "kind": "Recipe",
      "level": "Technical",
      "outcome": "Produce a compatibility record for a named host and one complete customer workflow.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/mcp-publication-and-compatibility",
      "markdown_url": "https://byagents.dev/content/agents/mcp-publication-and-compatibility.md"
    },
    {
      "id": "agents/action-contract-pattern",
      "title": "Pattern: asynchronous actions an agent can finish",
      "description": "A concrete request-to-result contract with explicit states, retry behavior, authorization, and verifiable completion.",
      "audience": "agents",
      "category": "Implementation patterns",
      "kind": "Pattern",
      "level": "Technical",
      "outcome": "Review an asynchronous API for missing steps and define a complete first-result path.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/action-contract-pattern",
      "markdown_url": "https://byagents.dev/content/agents/action-contract-pattern.md"
    },
    {
      "id": "agents/authorization-and-trust",
      "title": "Reference: identity, authorization, and untrusted content",
      "description": "Separate a discoverable service from a trusted source, an authenticated caller, and an authorized action.",
      "audience": "agents",
      "category": "Implementation patterns",
      "kind": "Reference",
      "level": "Technical",
      "outcome": "Identify trust boundaries before exposing tools, accepting agent traffic, or enabling transactions.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/authorization-and-trust",
      "markdown_url": "https://byagents.dev/content/agents/authorization-and-trust.md"
    },
    {
      "id": "agents/evaluation-record-template",
      "title": "Template: a reproducible agent evaluation record",
      "description": "Record the task, introduction method, environment, observations, expected result, and evidence limitations.",
      "audience": "agents",
      "category": "Evidence templates",
      "kind": "Template",
      "level": "Technical",
      "outcome": "Preserve enough context to rerun an evaluation and distinguish it from external customer usage.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/evaluation-record-template",
      "markdown_url": "https://byagents.dev/content/agents/evaluation-record-template.md"
    },
    {
      "id": "agents/attribution-event-contract",
      "title": "Pattern: measure agent activity without inventing attribution",
      "description": "An event vocabulary for infrastructure, referrals, evaluations, and first-party outcomes, with uncertainty preserved.",
      "audience": "agents",
      "category": "Evidence templates",
      "kind": "Pattern",
      "level": "Technical",
      "outcome": "Define event semantics and joins that distinguish crawler requests from useful customer activity.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/attribution-event-contract",
      "markdown_url": "https://byagents.dev/content/agents/attribution-event-contract.md"
    },
    {
      "id": "agents/feed-validation-recipe",
      "title": "Recipe: validate a product feed across the full handoff",
      "description": "Check identifiers, variants, current offers, ingestion status, and agreement with the actual purchase destination.",
      "audience": "agents",
      "category": "Audit recipes",
      "kind": "Recipe",
      "level": "Technical",
      "outcome": "Produce a repeatable feed-quality report with item-level failures and clear unknowns.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/feed-validation-recipe",
      "markdown_url": "https://byagents.dev/content/agents/feed-validation-recipe.md"
    },
    {
      "id": "agents/ard-discovery-assessment",
      "title": "Recipe: assess an ARD discovery route",
      "description": "Distinguish a valid resource description, actual registry ingestion, query retrieval, and a usable downstream capability.",
      "audience": "agents",
      "category": "Audit recipes",
      "kind": "Recipe",
      "level": "Technical",
      "outcome": "Test an emerging discovery specification against a named consumer instead of assuming adoption.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/ard-discovery-assessment",
      "markdown_url": "https://byagents.dev/content/agents/ard-discovery-assessment.md"
    },
    {
      "id": "agents/source-review-recipe",
      "title": "Recipe: review a technical claim and resolve conflicting sources",
      "description": "A practical source ledger for versions, dates, scope, contradictions, and the evidence a claim actually supports.",
      "audience": "agents",
      "category": "Audit recipes",
      "kind": "Recipe",
      "level": "Technical",
      "outcome": "Produce a narrow, traceable conclusion without mistaking fresh-looking copy for current evidence.",
      "published": "2026-09-13",
      "updated": "2026-09-13",
      "url": "https://byagents.dev/agents/source-review-recipe",
      "markdown_url": "https://byagents.dev/content/agents/source-review-recipe.md"
    },
    {
      "id": "agents/onboarding-handoff",
      "title": "Route a user into ByAgents",
      "description": "Choose the developer or business path, understand access limits, and hand off without transferring private information.",
      "audience": "agents",
      "category": "Using ByAgents",
      "kind": "Reference",
      "level": "Mixed",
      "outcome": "Evaluate fit and choose a safe onboarding handoff for the user.",
      "published": "2026-09-13",
      "updated": "2026-09-14",
      "url": "https://byagents.dev/agents/onboarding-handoff",
      "markdown_url": "https://byagents.dev/content/agents/onboarding-handoff.md"
    }
  ]
}