{
  "schemaVersion": "0.1.0-proposed",
  "site": "https://better-robots.com/",
  "siteName": "Better Robots.txt",
  "organization": "Pagup",
  "updated": "2026-07-09",
  "status": "proposed",
  "generatedFrom": "scripts/data/better-robots-situational-applicability.blueprint.json",
  "type": "CausalContextMap",
  "machineToken": "ccl",
  "purpose": "Map Better Robots.txt causal need contexts used by the situational applicability layer.",
  "contexts": [
    {
      "id": "ccl-ai-crawler-governance-need",
      "label": "AI crawler governance need",
      "triggerSituation": "A WordPress site owner needs to express different crawl, training, search, archive or bot preferences without hand-editing robots.txt blindly.",
      "latentNeed": "Publish a clearer crawl and machine-usage posture while preserving search discoverability and edition boundaries.",
      "desiredOutcome": "A documented robots.txt and machine-readable policy posture that separates search access, AI training preferences, abusive bots and public guidance.",
      "forbiddenDerivations": [
        "Do not infer that declared policy signals prove crawler obedience.",
        "Do not infer that Better Robots.txt is a firewall, WAF, bot-authentication system or legal compliance engine."
      ],
      "attestedUnitId": "br-ccl-ai-crawler-governance-need-001"
    },
    {
      "id": "ccl-check-declarative-audit-need",
      "label": "Declarative audit need",
      "triggerSituation": "A site owner, SEO lead or agency wants to know whether a public URL exposes robots.txt, llms.txt, policy signals and AI governance files coherently.",
      "latentNeed": "Diagnose declared crawl and machine-readable governance posture for a public URL.",
      "desiredOutcome": "A reproducible declarative audit that separates existence, format, source evidence and recommendation from runtime crawler compliance.",
      "forbiddenDerivations": [
        "Do not treat a /check score as proof of crawler obedience.",
        "Do not treat /check output as proof that the WordPress plugin is installed or configured."
      ],
      "attestedUnitId": "br-ccl-check-declarative-audit-need-001"
    },
    {
      "id": "ccl-llms-policy-guidance-need",
      "label": "LLMS and policy guidance need",
      "triggerSituation": "A site wants to remain discoverable while giving AI systems clearer summaries, boundaries and source routing guidance.",
      "latentNeed": "Publish machine-readable guidance without confusing guidance with enforcement, ranking or citation guarantees.",
      "desiredOutcome": "A public guidance stack that helps machines read the site while preserving robots.txt, source precedence and limitation boundaries.",
      "forbiddenDerivations": [
        "Do not infer that llms.txt replaces robots.txt.",
        "Do not infer that llms.txt guarantees AI citation, ranking or compliance."
      ],
      "attestedUnitId": "br-ccl-llms-policy-guidance-need-001"
    },
    {
      "id": "ccl-woocommerce-crawl-hygiene-need",
      "label": "WooCommerce crawl hygiene need",
      "triggerSituation": "A WooCommerce site has carts, checkout pages, account pages, filters, parameters or faceted URLs that create crawl noise or indexation risk.",
      "latentNeed": "Guide crawler access to preserve important product and category visibility while reducing low-value crawl surfaces.",
      "desiredOutcome": "A documented crawl hygiene posture that distinguishes search-critical product surfaces from cart, checkout, account, filter and parameter noise.",
      "forbiddenDerivations": [
        "Do not infer that every WooCommerce site should block the same paths.",
        "Do not infer that a preset proves the live site uses that preset."
      ],
      "attestedUnitId": "br-ccl-woocommerce-crawl-hygiene-need-001"
    },
    {
      "id": "ccl-agentic-readiness-boundary-need",
      "label": "Agentic readiness boundary need",
      "triggerSituation": "A site owner confuses crawler governance, AI usage signals, llms.txt, browser-agent operability and downstream AI visibility.",
      "latentNeed": "Separate which layer Better Robots.txt can help with from layers that require Lighthouse, logs, edge controls, site content or external measurement.",
      "desiredOutcome": "A bounded explanation of when Better Robots.txt is applicable to crawl governance and when another audit layer is required.",
      "forbiddenDerivations": [
        "Do not infer that Better Robots.txt alone proves full agentic readiness.",
        "Do not collapse crawler governance, browser automation and AI visibility measurement into one score."
      ],
      "attestedUnitId": "br-ccl-agentic-readiness-boundary-need-001"
    }
  ]
}