{
  "$schema_ref": "productization_drafts/AGENT_SERVICE_MANIFEST_SCHEMA.md (v0.3)",
  "canonical_url": "https://quantumbeard.ai/docking-station/services/agent_readiness_assessment/manifest",
  "service_id": "agent_readiness_assessment",
  "service_name": "Agent Readiness Assessment",
  "version": "0.1.0",
  "status": "live; v1; human/Guild-delivered; not machine-callable",
  "purpose": "Assess how discoverable, legible, trustworthy, and invocable an organization's systems are to AI agents.",
  "definition": "A structured assessment of a submitted set of public surfaces against four readiness dimensions — legibility, discovery, trust, and callability — returning a prioritized readiness profile (scorecard, gap map, priority roadmap). Intake qualification is deterministic; the analysis and the returned profile are human/Guild-authored under human review.",
  "problem_solved": "Organizations cannot see whether their value can be found, understood, trusted, and acted on by AI agents in a machine-mediated market, and have no honest read on what to fix first.",
  "primary_audiences": [
    "agent-builders",
    "organizations and operators with public-facing systems",
    "developers integrating agents against external services"
  ],
  "invocation_moment": "Developer-time / pre-engagement — when an organization wants an honest read on its agent-facing readiness before going to market or building further.",
  "required_inputs": {
    "public_urls": "one or more, required",
    "service_description": "text, required",
    "api_docs": "optional link",
    "trust_surfaces": "optional links",
    "goals": "text",
    "concerns": "text"
  },
  "expected_outputs": {
    "readiness_profile": {
      "scorecard": "per-dimension scores (legibility, discovery, trust, callability)",
      "dimension_findings": "findings per dimension, each citing the submitted surfaces",
      "gap_map": "gaps with severity",
      "priority_actions": "ordered remediation actions",
      "suggested_route": "self-remediate | design-engagement | not-a-fit"
    },
    "formats": "human-readable report paired with a machine-readable JSON twin"
  },
  "selection_criteria": "Call when the question is 'is my system ready for an agent-mediated market'. Do not call for live remediation/implementation, or for a governance/reviewability audit (a separate, future service).",
  "refusal_conditions": [
    "request to assess surfaces the requester does not own",
    "request for the service to make a decision (it structures the decision; it does not decide)",
    "request outside agent-readiness scope"
  ],
  "limit_conditions": [
    "assesses submitted public surfaces only",
    "human review gates delivery",
    "bounded turnaround stated at intake"
  ],
  "out_of_scope": [
    "live remediation or implementation",
    "autonomous action of any kind",
    "governance / reviewability diagnostic (separate service)"
  ],
  "trust_evaluation_requirements": "Findings cite the specific submitted surfaces; readiness dimensions are the published VERSE_AGENT_READINESS_FRAMEWORK set; the human author of record is named on delivery.",
  "human_oversight_expectations": "Human (Ken) review gates fulfillment. The readiness profile is human-authored, not autonomous output. No step proceeds to delivery without that review.",
  "callability_interface": "None machine-callable in v1. Invocation is a human web intake at https://quantumbeard.ai/diagnostics/agent-readiness/ (the on-ramp routes to the qb-commerce intake/payment flow). There is no MCP tool or OpenAPI endpoint yet; a machine-callable invocation surface is a future cut.",
  "auth_permission_expectations": "Requester asserts ownership of the submitted public surfaces. Payment is a buyer-initiated checkout (Stripe, TEST mode in v1 — live-money not yet enabled). No delegated-agent mandate (AuthorityMandate) is required for v1.",
  "error_modes": [
    "out_of_scope_request",
    "ownership_unverified",
    "decision_requested_refused"
  ],
  "pricing_class": "one_time_fee; Spotlight $2,500 / Floodlight $7,500 (Stripe TEST mode in v1)",
  "related_services": [
    "(future) AI Reviewability / Governance Diagnostic",
    "(future) Docking Station Diagnostic Sprint"
  ],
  "transaction_classes": ["discovery_only", "human_approved_purchase"],
  "commercial_mode": "one_time_fee",
  "honesty_notes": "v1 is discovery + human-approved purchase only. Agents can discover this service and route a principal toward it; they cannot invoke it machine-to-machine. Fulfillment is human/Guild-delivered, not autonomous. Payment rail is in Stripe test mode."
}