{
  "id": "artifact:how-shareplane-works",
  "slug": "how-shareplane-works",
  "title": "How SharePlane Works",
  "thesis": "Context as code for humans and agents.",
  "abstract": "SharePlane is a static publishing library and a governed context-as-code operating model. This artifact explains how versioned authority, human judgment, bounded agents, deterministic generation, validation, receipts, and exact-head publication turn rough ideas into durable public work.",
  "topics": [
    "ai-governance",
    "architecture",
    "context-as-code",
    "multi-agent-systems",
    "provenance",
    "source-authority",
    "static-publishing"
  ],
  "date": "2026-07-10",
  "dateLabel": "Published",
  "published": true,
  "publicationState": "published",
  "updated": "2026-07-10",
  "sourceDates": {
    "published": "2026-07-10",
    "updated": "2026-07-10"
  },
  "kind": "Work",
  "sourceFamily": "SharePlane Next archive",
  "href": "heritage/next/artifacts/how-shareplane-works/index.html",
  "contextHref": "records/how-shareplane-works/context.txt",
  "recordHref": "records/how-shareplane-works/work.json",
  "receiptHref": "records/how-shareplane-works/receipt.json",
  "packageHref": "downloads/works/how-shareplane-works.zip",
  "canonicalUrl": "https://shareplane.malott.ai/artifacts/how-shareplane-works/",
  "sources": [
    {
      "id": "source:how-shareplane-works:openai-retrieval",
      "type": "official-product-documentation",
      "title": "OpenAI Retrieval documentation",
      "locator": "https://developers.openai.com/api/docs/guides/retrieval",
      "role": "Defines retrieval as semantic search over data and vector stores.",
      "description": "Supports the limited but valuable role assigned to retrieval in the artifact. It does not serve as evidence for SharePlane's unique context-as-code architecture.",
      "publiclyExposed": true
    },
    {
      "id": "source:how-shareplane-works:openai-agent-guide",
      "type": "official-practical-guide",
      "title": "OpenAI, A practical guide to building agents",
      "locator": "https://openai.com/business/guides-and-resources/a-practical-guide-to-building-ai-agents/",
      "role": "Supports the separation of instructions, explicit actions, orchestration, tools, and guardrails.",
      "description": "Supports the claim that useful documents must be converted into clear operating instructions and that reliable agent behavior requires more than retrieval alone.",
      "publiclyExposed": true
    },
    {
      "id": "source:how-shareplane-works:anthropic-context-engineering",
      "type": "expert-engineering-guidance",
      "title": "Anthropic, Effective context engineering for AI agents",
      "locator": "https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents",
      "role": "Supports the broader definition of runtime context and the need to curate high-signal information.",
      "description": "Supports the distinction between prompt wording, runtime context curation, and the broader durable context-as-code operating discipline proposed here.",
      "publiclyExposed": true
    },
    {
      "id": "source:how-shareplane-works:anthropic-effective-agents",
      "type": "expert-engineering-guidance",
      "title": "Anthropic, Building Effective AI Agents",
      "locator": "https://www.anthropic.com/engineering/building-effective-agents",
      "role": "Supports starting with the simplest workable system and adding agentic complexity only when needed.",
      "description": "Supports SharePlane's complexity policy. It does not endorse SharePlane specifically.",
      "publiclyExposed": true
    },
    {
      "id": "source:how-shareplane-works:shareplane-next",
      "type": "public-repository-and-receipts",
      "title": "SharePlane Next repository and public receipts",
      "locator": "https://github.com/pinklon/pinklon-shareplane-next/tree/211f21d8dff2cd69d84b5c7c3a9c8cb06f11c12b",
      "role": "Primary system evidence for how SharePlane currently builds, validates, packages, previews, and publishes artifacts.",
      "description": "Supports repo-derived claims about the current SharePlane implementation. It is not evidence that the architecture is universally optimal.",
      "publiclyExposed": true
    },
    {
      "id": "source:how-shareplane-works:legacy-shareplane",
      "type": "public-historical-operating-materials",
      "title": "Legacy SharePlane public operating materials",
      "locator": "https://shareplane.pages.dev/",
      "role": "Historical source material for the operating thesis and role boundaries.",
      "description": "Reconciled against SharePlane Next. Obsolete implementation claims are not reproduced merely because an older page stated them confidently.",
      "publiclyExposed": true
    }
  ],
  "posture": "owner-origin-architecture-framing-with-public-source-support",
  "media": [],
  "schema": "shareplane.portable-work.v1",
  "author": {
    "name": "Tony Malott",
    "url": "https://malott.ai/"
  },
  "content": {
    "mediaType": "text/plain",
    "path": "records/how-shareplane-works/context.txt",
    "sha256": "5f13d1ff5f3f0506ab1897a48af39dd4ed8389ab419fc6b36c543ecdd3bd817b",
    "complete": true,
    "extraction": "Native presentation reading order; scripts, styles, and platform chrome excluded."
  },
  "relationships": [],
  "representations": {
    "html": "heritage/next/artifacts/how-shareplane-works/index.html",
    "text": "records/how-shareplane-works/context.txt",
    "json": "records/how-shareplane-works/work.json",
    "package": "downloads/works/how-shareplane-works.zip"
  }
}
