{
  "schema": "libkungfu.skills-architecture/v1",
  "headline": "A current source loop, with future accountability kept visibly outside it.",
  "summary": "Protected source defines the instruction and context path. Site synthesis explains when that path is useful. Future provenance and distribution remain labelled design, not current capability.",
  "sourceRefs": [
    "skills-contract",
    "skills-architecture",
    "skills-adr",
    "skills-known-limits"
  ],
  "nodes": [
    {
      "id": "delegated-work",
      "label": "Repeatable delegated work",
      "kind": "reader-intent",
      "horizon": "site-synthesis",
      "claimClass": "site-synthesis",
      "maturity": "reader-guidance",
      "summary": "A bounded recurring job whose intent, checks, evidence, and recovery deserve a reusable form.",
      "sourceRefs": [
        "skills-architecture",
        "skills-adr"
      ]
    },
    {
      "id": "skill-source",
      "label": "SKILL.md source",
      "kind": "current-source",
      "horizon": "current-source",
      "claimClass": "upstream-fact",
      "maturity": "protected-source-alpha",
      "summary": "The minimum instruction-only source, optionally enhanced with structured metadata.",
      "sourceRefs": [
        "skills-contract",
        "skills-architecture"
      ]
    },
    {
      "id": "skill-catalog",
      "label": "Compact catalog",
      "kind": "current-source",
      "horizon": "current-source",
      "claimClass": "upstream-fact",
      "maturity": "protected-source-alpha",
      "summary": "A small index intended to help an Agent discover relevant instructions without loading every source in full.",
      "sourceRefs": [
        "skills-contract",
        "skills-architecture"
      ]
    },
    {
      "id": "context-envelope",
      "label": "Context envelope",
      "kind": "current-source",
      "horizon": "current-source",
      "claimClass": "upstream-fact",
      "maturity": "protected-source-alpha",
      "summary": "The source-defined catalog, on-demand read declaration, and audit identifiers for a managed Agent context.",
      "sourceRefs": [
        "skills-contract",
        "skills-architecture"
      ]
    },
    {
      "id": "agent-consumer",
      "label": "Agent consumer",
      "kind": "current-source",
      "horizon": "current-source",
      "claimClass": "upstream-fact",
      "maturity": "source-contract-only",
      "summary": "Consumes advertised metadata and may request full instructions; this page does not claim a released runtime path.",
      "sourceRefs": [
        "skills-architecture",
        "skills-known-limits"
      ]
    },
    {
      "id": "kfx-trust-gate",
      "label": "KFX trust and capability gate",
      "kind": "authority-boundary",
      "horizon": "current-source",
      "claimClass": "upstream-fact",
      "maturity": "accepted-architecture",
      "summary": "Retains runtime admission and capability authority below the Skill instruction layer.",
      "sourceRefs": [
        "skills-architecture",
        "skills-adr"
      ]
    },
    {
      "id": "accountability-history",
      "label": "Durable provenance and work history",
      "kind": "future-picture",
      "horizon": "future-picture",
      "claimClass": "future-picture",
      "maturity": "future-picture-only",
      "summary": "A future view could connect Skill influence to retained work evidence without making the Skill itself authority.",
      "sourceRefs": [
        "skills-architecture",
        "skills-adr"
      ]
    },
    {
      "id": "governed-distribution",
      "label": "Governed discovery and distribution",
      "kind": "future-picture",
      "horizon": "future-picture",
      "claimClass": "future-picture",
      "maturity": "future-picture-only",
      "summary": "Discovery, remote publishing, and dependency acquisition remain future product work with separate trust and release gates.",
      "sourceRefs": [
        "skills-known-limits"
      ]
    }
  ],
  "relationships": [
    {
      "id": "recognize",
      "from": "delegated-work",
      "to": "skill-source",
      "label": "may justify authoring",
      "horizon": "site-synthesis",
      "claimClass": "site-synthesis",
      "sourceRefs": [
        "skills-architecture",
        "skills-adr"
      ]
    },
    {
      "id": "derive",
      "from": "skill-source",
      "to": "skill-catalog",
      "label": "derives",
      "horizon": "current-source",
      "claimClass": "upstream-fact",
      "sourceRefs": [
        "skills-contract",
        "skills-architecture"
      ]
    },
    {
      "id": "wrap",
      "from": "skill-catalog",
      "to": "context-envelope",
      "label": "is wrapped by",
      "horizon": "current-source",
      "claimClass": "upstream-fact",
      "sourceRefs": [
        "skills-contract",
        "skills-architecture"
      ]
    },
    {
      "id": "advertise",
      "from": "context-envelope",
      "to": "agent-consumer",
      "label": "advertises bounded context to",
      "horizon": "current-source",
      "claimClass": "upstream-fact",
      "sourceRefs": [
        "skills-architecture"
      ]
    },
    {
      "id": "constrain",
      "from": "kfx-trust-gate",
      "to": "agent-consumer",
      "label": "keeps runtime authority outside",
      "horizon": "current-source",
      "claimClass": "upstream-fact",
      "sourceRefs": [
        "skills-architecture",
        "skills-adr"
      ]
    },
    {
      "id": "retain",
      "from": "agent-consumer",
      "to": "accountability-history",
      "label": "could retain influence in",
      "horizon": "future-picture",
      "claimClass": "future-picture",
      "sourceRefs": [
        "skills-architecture",
        "skills-adr"
      ]
    },
    {
      "id": "distribute",
      "from": "skill-source",
      "to": "governed-distribution",
      "label": "could enter",
      "horizon": "future-picture",
      "claimClass": "future-picture",
      "sourceRefs": [
        "skills-known-limits"
      ]
    }
  ],
  "canonicalUrl": "https://libkungfu.dev/skills/architecture.json",
  "humanEntry": "https://libkungfu.dev/skills/",
  "sources": [
    {
      "id": "skills-contract",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "b4a10ea2a165f0d8eb1010b6d913069b1f17f39f",
      "path": "framework/skill/kungfu-skill.contract.json",
      "sha256": "9687a533493aa1e6ca2407f633f4ec6039eb0b857afb1db324fefb3c64f3ed01",
      "maturity": "protected-source-contract",
      "role": "Content-rooted definition, authority boundary, lifecycle vocabulary, and compatibility contract"
    },
    {
      "id": "skills-architecture",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "b4a10ea2a165f0d8eb1010b6d913069b1f17f39f",
      "path": "docs/architecture/skills.md",
      "sha256": "4bae5194be6374830fec387be61010e4a8e132330739d13dcf7940a040651663",
      "maturity": "protected-source-architecture",
      "role": "Skill source, compact context loop, Work boundary, KFX separation, audit, and staged adoption architecture"
    },
    {
      "id": "skills-adr",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "b4a10ea2a165f0d8eb1010b6d913069b1f17f39f",
      "path": "docs/adr/KF-ADR-019fee22-e71d-7da9-8a44-9403c21a5d62.md",
      "sha256": "b439ed0b749c6e1b6f4527356454f0d5aa2024f46a8fe2d5369171ca30a159ce",
      "maturity": "accepted-partial-decision",
      "role": "Accepted content-rooted, Work-scoped orchestration decision with staged runtime adoption"
    },
    {
      "id": "skills-known-limits",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "b4a10ea2a165f0d8eb1010b6d913069b1f17f39f",
      "path": "docs/qualification/known-limits.md",
      "sha256": "b8a913ad020d089842b6d8550025665e307bfd92eb5f5bbb1049d18d7a7b0c47",
      "maturity": "protected-source-known-limits",
      "role": "Explicit boundaries on marketplace, elevation, dependency acquisition, and runtime execution claims"
    }
  ],
  "sourceBoundary": "This page is a Site-owned synthesis of exact files on Kungfu's protected development line. Kungfu owns the Skill contract, implementation status, commands, trust boundary, and qualification claims. The Site owns only reader guidance, composition, and routing.",
  "futureBoundary": "Future-picture nodes describe a useful direction for accountable authoring, provenance, and distribution. They are not present-tense product or release claims."
}