{
  "schema": "raccoonflow.methodology.v0.1",
  "version": "0.1",
  "status": "Public draft",
  "effectiveAt": "2026-06-07T00:00:00Z",
  "methodologyUrl": "https://raccoonflow.ai/methodology",
  "description": "Raccoon Flow Rating Methodology v0.1 defines a trust-adjusted investability score for agent-managed trading vaults.",
  "scoreRange": {
    "minimum": 0,
    "maximum": 100
  },
  "dimensions": [
    {
      "id": "riskDiscipline",
      "label": "Risk discipline",
      "weight": 0.3,
      "description": "Drawdown control, leverage behavior, liquidation proximity, exposure concentration, and whether realized risk matches the stated strategy."
    },
    {
      "id": "performance",
      "label": "Performance",
      "weight": 0.25,
      "description": "Risk-adjusted return, consistency, capital efficiency, win/loss behavior, and performance across available market states."
    },
    {
      "id": "trustVerification",
      "label": "Trust verification",
      "weight": 0.2,
      "description": "Owner/provider proof, agent wallet proof, venue account proof, claim review status, and evidence quality."
    },
    {
      "id": "operationalQuality",
      "label": "Operational quality",
      "weight": 0.15,
      "description": "Execution boundaries, scoped permissions, kill switches, risk policy disclosure, monitoring coverage, and incident response."
    },
    {
      "id": "dataConfidence",
      "label": "Data confidence",
      "weight": 0.1,
      "description": "Data freshness, source independence, adapter reliability, history length, and whether metrics are venue-derived instead of self-reported."
    }
  ],
  "tiers": [
    {
      "tier": "RF-AAA",
      "scoreMin": 90,
      "scoreMax": 100,
      "status": "Reserved",
      "meaning": "Institutional-grade agent vault record. Reserved until live history, independent verification, and incident history are sufficient."
    },
    {
      "tier": "RF-AA",
      "scoreMin": 80,
      "scoreMax": 89,
      "status": "Active",
      "meaning": "High investability: strong trust evidence, disciplined risk behavior, fresh data, and legible operating controls."
    },
    {
      "tier": "RF-A",
      "scoreMin": 70,
      "scoreMax": 79,
      "status": "Active",
      "meaning": "Emerging investability: promising record with some limits such as shorter history, partial evidence, or moderate risk."
    },
    {
      "tier": "RF-B",
      "scoreMin": 55,
      "scoreMax": 69,
      "status": "Active",
      "meaning": "Watchlist: potentially interesting strategy behavior, but evidence gaps or risk issues limit allocatability."
    },
    {
      "tier": "RF-C",
      "scoreMin": 40,
      "scoreMax": 54,
      "status": "Active",
      "meaning": "Speculative: material blockers exist and capital allocation should require additional review."
    },
    {
      "tier": "Unrated",
      "scoreMin": null,
      "scoreMax": null,
      "status": "Active",
      "meaning": "Insufficient verified evidence to produce a public investability score."
    }
  ],
  "ratingCaps": [
    {
      "id": "owner_unverified",
      "condition": "Owner or provider claim is missing or unresolved.",
      "maximumTier": "RF-B"
    },
    {
      "id": "control_missing",
      "condition": "Execution permissions, scoped keys, venue controls, gateway policy, smart contract limits, or kill switch evidence is missing.",
      "maximumTier": "RF-B"
    },
    {
      "id": "track_record_short",
      "condition": "Verified track record is shorter than 30 days.",
      "maximumTier": "RF-B"
    },
    {
      "id": "data_self_reported_only",
      "condition": "Primary metrics are self-reported without venue, DEX, adapter, or third-party evidence.",
      "maximumTier": "RF-C"
    },
    {
      "id": "critical_incident_unresolved",
      "condition": "Unresolved exploit, liquidation, withdrawal failure, or material misrepresentation.",
      "maximumTier": "Unrated"
    }
  ],
  "minimumEvidence": {
    "RF-AA": [
      "Verified owner or provider",
      "Claimed agent wallet or agent passport",
      "Venue, DEX, or adapter-derived performance data",
      "Published execution-control boundary",
      "Freshness check within the current review window"
    ],
    "RF-A": [
      "Owner or provider identified",
      "Venue, DEX, or adapter-derived performance data",
      "At least one execution-control disclosure",
      "No unresolved critical red flag"
    ],
    "RF-B": [
      "Public vault or wallet record",
      "Basic performance and drawdown metrics",
      "Open evidence requests are visible"
    ]
  },
  "reviewStates": [
    "Submitted",
    "In Review",
    "Needs Evidence",
    "Accepted",
    "Rejected",
    "Disputed",
    "Deprecated"
  ],
  "notes": [
    "The score is not investment advice.",
    "High return alone cannot produce a high tier.",
    "Ratings can change when evidence, venue data, controls, owner status, or risk behavior changes.",
    "Every rating change should be recorded in Rating History v0.1."
  ]
}