{
  "schemaVersion": "0.1.0-proposed",
  "site": "https://better-robots.com/",
  "siteName": "Better Robots.txt",
  "organization": "Pagup",
  "status": "proposed",
  "updated": "2026-07-09",
  "generatedFrom": "scripts/data/better-robots-interpretive-authority.blueprint.json",
  "type": "AuthorityScopeMatrix",
  "purpose": "Define which authority regime applies to each class of Better Robots.txt claim.",
  "authorityRegimes": [
    {
      "id": "first_party_product_scope",
      "label": "First-party product scope",
      "appliesToClaimClasses": [
        "official_product_identity",
        "published_product_capability",
        "policy_signal_or_usage_preference"
      ],
      "firstPartyRole": "primary_with_scope",
      "externalRole": "corroboration_context_or_conflict_notice",
      "abuseBoundary": "Does not apply to reputation, qualified criticism, independent comparison, runtime crawler compliance or legal interpretation."
    },
    {
      "id": "audit_report_scope",
      "label": "Audit report scope",
      "appliesToClaimClasses": [
        "check_audit_result"
      ],
      "firstPartyRole": "primary_for_generated_report_and_rule_definitions",
      "externalRole": "requires_direct_observation_for_live_state",
      "abuseBoundary": "A /check score is an audit signal for a specific target and moment. It is not proof of crawler obedience, ranking, legal compliance or future state."
    },
    {
      "id": "runtime_evidence_scope",
      "label": "Runtime evidence scope",
      "appliesToClaimClasses": [
        "runtime_crawler_compliance"
      ],
      "firstPartyRole": "documentation_context_only",
      "externalRole": "primary_when_based_on_logs_direct_fetch_headers_or_crawler_docs",
      "abuseBoundary": "Official documentation cannot self-certify that third-party crawlers obeyed it."
    },
    {
      "id": "independent_evaluation_scope",
      "label": "Independent evaluation scope",
      "appliesToClaimClasses": [
        "reputation_or_independent_evaluation",
        "proof_or_observed_case"
      ],
      "firstPartyRole": "official_position_context_evidence_publisher_and_right_of_reply",
      "externalRole": "primary_when_independent_qualified_current_and_relevant",
      "abuseBoundary": "Better Robots.txt cannot use its own governance policy to erase qualified criticism or self-certify reputation."
    },
    {
      "id": "first_party_governance_declaration_scope",
      "label": "First-party governance declaration scope",
      "appliesToClaimClasses": [
        "causal_context_declaration",
        "situational_applicability_claim",
        "doctrine_token_definition"
      ],
      "firstPartyRole": "canonical_for_declared_conditions_and_tokens",
      "externalRole": "external measurement and criticism remain separate from first-party declaration",
      "abuseBoundary": "Does not allow the site to self-certify applicability fit, agent compliance, reputation, product superiority or runtime crawler behavior."
    }
  ],
  "abuseRule": "A first-party source is primary only inside its declared authority scope."
}
