{
  "contract": "kungfu-agent-supply-chain-public-narrative/v1",
  "categoryStatement": "Kungfu is an open Agent Supply Chain protocol stack for discovering how Agent products cooperate, binding claims to exact software artifacts, establishing purpose-bound trust, preserving durable work facts, and carrying that work across independently owned Hubs.",
  "claimBoundary": "Kungfu does not claim that a multi-Hub ecosystem already exists. It proves that Agent discovery, software provenance, trust, durable work state, and portability no longer need to be rebuilt or locked inside each Hub.",
  "maturityVocabulary": [
    "proved-now",
    "enabled-by-protocol",
    "not-claimed"
  ],
  "layers": [
    {
      "id": "kfd-3",
      "order": 1,
      "owner": "KFD",
      "input": "Product-owned value, constraints, choices, commands, Exit, and record declarations",
      "output": "A stable human-and-agent discovery surface for bounded cooperation",
      "statement": "Discover how products cooperate through inspectable value, constraints, choices, commands, Exit, and records.",
      "statusClass": "proved-now",
      "evidenceCoordinates": [
        "npm:@kungfu-tech/kfd@1.0.0-alpha.41#README.md",
        "npm:@kungfu-tech/kfd@1.0.0-alpha.41#.buildchain/kfd-3/collaboration-interface.artifact.json"
      ],
      "knownLimits": [
        "KFD-3 discovery is inspectable product guidance, not a hidden prompt or forced adoption mechanism.",
        "The current evidence proves the KFD alpha surface, not external vendor adoption or stable certification."
      ],
      "humanRoute": "https://kfd.libkungfu.dev/3",
      "agentRoute": "https://kfd.libkungfu.dev/manifest.json",
      "label": "KFD-3"
    },
    {
      "id": "buildchain",
      "order": 2,
      "owner": "Buildchain",
      "input": "KFD-3-discoverable product declarations and an exact source cut",
      "output": "Artifact-bound provenance, checks, and promotion evidence",
      "statement": "Bind product-owned declarations to exact source, build, artifact, checks, and promotion evidence.",
      "statusClass": "proved-now",
      "evidenceCoordinates": [
        "npm:@kungfu-tech/buildchain@2.14.14-alpha.4#dist/site/product-mechanism.json",
        "npm:@kungfu-tech/buildchain@2.14.14-alpha.4#dist/site/release-provenance.json"
      ],
      "knownLimits": [
        "Buildchain does not create product facts or make the receiver's trust decision.",
        "A passing Passport proves an exact release relation, not blanket certification, safety, or adoption."
      ],
      "humanRoute": "https://buildchain.libkungfu.dev/",
      "agentRoute": "https://buildchain.libkungfu.dev/manifest.json",
      "label": "Buildchain"
    },
    {
      "id": "kfd-2",
      "order": 3,
      "owner": "KFD and receiver",
      "input": "Exact-artifact evidence, a declared purpose, and receiver policy",
      "output": "A purpose-bound assessment with residual risk and decision ownership",
      "statement": "Assess claims for a declared purpose while retaining residual risk and decision ownership.",
      "statusClass": "proved-now",
      "evidenceCoordinates": [
        "npm:@kungfu-tech/kfd@1.0.0-alpha.41#decisions/KFD-2.md",
        "npm:@kungfu-tech/kfd@1.0.0-alpha.41#.buildchain/kfd-2/public-release-trust.claim.json"
      ],
      "knownLimits": [
        "KFD-2 is purpose-, cut-, and evidence-bound; it is not a company reputation score or universal trust certificate.",
        "A prior assessment does not authorize a changed artifact, purpose, receiver policy, or future release."
      ],
      "humanRoute": "https://kfd.libkungfu.dev/2",
      "agentRoute": "https://kfd.libkungfu.dev/manifest.json",
      "label": "KFD-2"
    },
    {
      "id": "libkungfu",
      "order": 4,
      "owner": "Kungfu and adopter",
      "input": "Receiver-admitted work facts, commands, Episodes, and roots",
      "output": "Ordered durable records, export, recovery, and qualification evidence",
      "statement": "Preserve admitted work facts, Episodes, roots, export, and recovery evidence while applications own domain facts.",
      "statusClass": "proved-now",
      "evidenceCoordinates": [
        "git+https://github.com/kungfu-systems/kungfu.git#7eeb5bd1b45492f4da27eaacbe63eddfd6245176:docs/qualification/vendor-agent-hub-embedding.md",
        "git+https://github.com/kungfu-systems/kungfu.git#7eeb5bd1b45492f4da27eaacbe63eddfd6245176:examples/opencode-kungfu/qualification/run.mjs"
      ],
      "knownLimits": [
        "Applications retain authority over domain facts; libkungfu owns admitted runtime records and ordering within its declared boundary.",
        "JSON is an edge projection, not a second authoritative data plane, and qualification remains platform- and cut-specific."
      ],
      "humanRoute": "https://libkungfu.dev/core/",
      "agentRoute": "https://libkungfu.dev/core/manifest.json",
      "label": "libkungfu"
    },
    {
      "id": "agent-hub-portability",
      "order": 5,
      "owner": "KFD profile and each Hub",
      "input": "Bounded responsibility objects with rooted evidence and explicit authority",
      "output": "Portable envelopes, conformance results, and receiver-owned admission decisions",
      "statement": "Carry bounded responsibility objects across independently owned products with receiver-owned admission.",
      "statusClass": "enabled-by-protocol",
      "evidenceCoordinates": [
        "npm:@kungfu-tech/kfd@1.0.0-alpha.41#protocols/agent-hub/manifest.json",
        "npm:@kungfu-tech/kfd@1.0.0-alpha.41#protocols/agent-hub/README.md"
      ],
      "knownLimits": [
        "The public profile enables independent implementations but does not prove a second independent production Hub.",
        "Portability preserves bounded roots, verdicts, conflicts, commitments, and digests; it does not promise lossless one-click migration."
      ],
      "humanRoute": "https://kfd.libkungfu.dev/protocols/agent-hub",
      "agentRoute": "https://kfd.libkungfu.dev/manifest.json",
      "label": "Agent Hub portability"
    }
  ],
  "notClaimed": [
    "two independent production Hubs",
    "external vendor adoption or endorsement",
    "industry-standard status",
    "universal trust or blanket stable compatibility",
    "public Kungfu Cloud",
    "lossless one-click migration"
  ],
  "vendorNextAction": "Assign a technical and product owner, run a bounded 30-day assessment, build one adapter or conformance spike, submit protocol gaps, then decide to adopt, co-shape, or monitor.",
  "readerProgression": {
    "contract": "kungfu-agent-supply-chain-reader-progression/v1",
    "premise": {
      "title": "When Agents learn to recognize better software, they start creating demand for it.",
      "statement": "Kungfu onboards the Agent you already use. The Agent experiences explicit capabilities, inspectable evidence, and durable Work—then starts expecting those qualities from every product."
    },
    "authorityBoundary": "Humans and Hubs set goals, permissions, budgets, policy, admission, and revocation. Agents propose and act inside those boundaries. Durable Work and evidence do not belong to the chat.",
    "activationBoundary": {
      "contract": "kungfu-agent-mediated-distribution-boundary/v1",
      "title": "Agent-first activation starts after a product is chosen. Agent-mediated distribution changes who can help choose it.",
      "activation": "A person or upstream channel discovers and selects the product. The Agent compresses the path from that choice to first value.",
      "distribution": "The product becomes legible enough for an Agent to evaluate and recommend. A human or Hub still authorizes adoption."
    },
    "agentNativeLoop": {
      "contract": "kungfu-agent-native-product-loop/v1",
      "title": "Kungfu lights the first loop inside work.",
      "statement": "The user keeps the Agent they already trust. Kungfu supplies exact guidance, recommends durable Work only when it is valuable, asks once before mutation, and preserves what the next Agent needs.",
      "stages": [
        {
          "id": "existing-agent",
          "label": "Existing Agent",
          "title": "Keep the conversation surface.",
          "statement": "Stay in Codex, Claude, OpenCode, Amp, or another familiar Agent instead of adopting a new daily chat interface."
        },
        {
          "id": "versioned-brief",
          "label": "Versioned Brief",
          "title": "Let the Agent learn the product.",
          "statement": "A compact, version-matched entrypoint routes the Agent to exact installed facts, capabilities, limits, and public actions."
        },
        {
          "id": "work-advisory",
          "label": "Work advisory",
          "title": "Recommend Work when it matters.",
          "statement": "Bounded signals identify handoff, evidence, duplication, external-write, and acceptance risk without turning every task into Work."
        },
        {
          "id": "preview-confirm",
          "label": "Preview + confirm",
          "title": "Ask once before mutation.",
          "statement": "The Agent shows a minimal Work draft and uses the product's public action only after explicit confirmation."
        },
        {
          "id": "durable-work",
          "label": "Durable Work",
          "title": "Change the Agent, not the Work.",
          "statement": "Product-owned state and receipts survive the process so a fresh Agent can continue without another human handoff."
        }
      ],
      "boundary": "This loop is a product contract, not a blanket release claim. Each step remains bounded by the proved-now, enabled-by-protocol, and not-claimed evidence below. Agent output alone grants no authority and proves no completion."
    },
    "ignition": {
      "contract": "kungfu-agent-native-market-ignition/v1",
      "title": "One useful product can change what an Agent expects.",
      "statement": "Kungfu earns the first use by solving a concrete problem. The surprise comes next: the experience changes how the Agent evaluates every product that follows.",
      "stages": [
        {
          "id": "useful-product",
          "label": "One useful product",
          "title": "Solve the pain already in front of the user.",
          "statement": "Kungfu earns attention by keeping Work alive across the Agents the user already chooses."
        },
        {
          "id": "onboarded-agent",
          "label": "One onboarded Agent",
          "title": "Let the Agent experience the difference.",
          "statement": "A version-matched Brief exposes exact capabilities, evidence, limits, public actions, and durable state inside the existing conversation."
        },
        {
          "id": "new-expectation",
          "label": "One new expectation",
          "title": "Change what good software feels like.",
          "statement": "After one useful handoff, the Agent can recognize—and ask for—the same qualities in every product it encounters."
        }
      ],
      "aha": "The Agent is no longer just an operator. It becomes a distribution channel.",
      "ahaSupport": "Because the Work stays with the product—not the chat—every new Agent can inspect it, continue it, and recognize the difference."
    },
    "marketFlywheel": {
      "contract": "kungfu-agent-native-market-flywheel/v1",
      "title": "Kungfu can leave the center. The loop keeps compounding.",
      "statement": "Kungfu does not need to own the loop. It only needs to make the first difference legible.",
      "ignitionRole": "Kungfu solves one real problem and onboards the first Agent. It is the spark, not a permanent dependency.",
      "steps": [
        {
          "id": "agent-experience",
          "label": "Agent experience",
          "title": "Agents recognize the difference.",
          "statement": "Explicit capabilities, inspectable evidence, and durable Work become a product expectation."
        },
        {
          "id": "demand-signal",
          "label": "Demand signal",
          "title": "Agents recommend. Humans or Hubs authorize.",
          "statement": "A bounded recommendation during real work turns one useful experience into visible demand without granting the Agent adoption authority."
        },
        {
          "id": "builder-response",
          "label": "Builder response",
          "title": "Builders see what the market now expects.",
          "statement": "A shared product interface becomes a distribution advantage instead of bespoke integration work."
        },
        {
          "id": "buildchain-supply",
          "label": "Buildchain supply",
          "title": "More products can ship the qualities.",
          "statement": "Buildchain binds KFD-3 declarations and KFD-2 evidence to exact releases that Agents can inspect."
        },
        {
          "id": "agent-native-products",
          "label": "More products",
          "title": "The next Agent encounters a larger market.",
          "statement": "Each new Agent-native product can restart the same loop without routing through Kungfu."
        }
      ],
      "returnStatement": "Next product → next Agent → the same expectation compounds.",
      "selfStartBoundary": "Every product still needs a first introduction and explicit authorization. What compounds is what happens after the first useful, trusted use."
    },
    "conceptQuestions": [
      {
        "layerId": "kfd-3",
        "question": "How does an Agent know what a product can do?",
        "linkLabel": "Explore KFD-3"
      },
      {
        "layerId": "kfd-2",
        "question": "How does it assess what the product claims?",
        "linkLabel": "Explore KFD-2"
      },
      {
        "layerId": "buildchain",
        "question": "How do builders ship those qualities in an exact release?",
        "linkLabel": "Explore Buildchain"
      },
      {
        "layerId": "agent-hub-portability",
        "question": "How can bounded Work move across independently governed Agent Hubs?",
        "linkLabel": "Explore Agent Hub"
      }
    ],
    "distributionAdvantage": "Agent-native software can be discovered, evaluated, recommended, invoked, and continued with less bespoke interpretation, creating a new selection and distribution advantage.",
    "bootstrap": {
      "title": "The user's existing Agent becomes the first product guide.",
      "seed": "A concrete problem still starts the loop: the user is tired of carrying context, decisions, status, and loss checks between Agents.",
      "discovery": "A compact, version-matched Brief lets the existing Agent inspect the exact installed collaboration surface, capability catalog, evidence, limits, and public actions without prior KFD or Buildchain knowledge.",
      "boundary": "The Brief does not create demand, grant authority, or prove an outcome. It turns one useful product entry into a repeatable learning path while the user keeps the provider-native conversation surface.",
      "steps": [
        "Existing Agent receives the exact Brief",
        "Agent verifies the installed product surface",
        "Agent recognizes when durable Work has value",
        "Human previews and confirms the action",
        "Work survives the next Agent"
      ]
    },
    "flywheel": [
      "Agents recognize explicit capabilities, inspectable evidence, and durable Work as a better product experience.",
      "Agents recommend products they can assess while real work is underway.",
      "Builders receive a demand signal for a shared Agent-native product interface.",
      "Buildchain binds KFD-3 declarations and KFD-2 evidence to exact releases.",
      "More Agent-native products reach more Agents and restart the loop without Kungfu."
    ],
    "flywheelBoundary": "This is a causal adoption thesis enabled by the stack, not evidence that a broad network effect, external adoption, or a multi-Hub market already exists."
  }
}