{
  "schemaVersion": "1.0.0",
  "system": {
    "name": "SharePlane",
    "runtime": "static public site",
    "owner": "Tony Malott"
  },
  "purpose": "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.",
  "thesis": "RAG helps an agent find documents. Context as code helps a system know what those documents mean, which authority governs, what action is permitted, how work moves, what must be validated, and where human judgment remains mandatory.",
  "principles": [
    "Static-first",
    "Human-governed",
    "Agent-assisted",
    "Versioned authority",
    "Deterministic build",
    "Receipt-backed",
    "Portable pattern",
    "Probability explores. Judgment decides. Determinism preserves."
  ],
  "roles": [
    {
      "portableRole": "Owner / Judge",
      "currentImplementation": "Tony Malott",
      "responsibilities": [
        "intent",
        "thesis",
        "source authority",
        "claim posture",
        "personal disclosure",
        "public-safe boundaries",
        "design acceptance",
        "rendered UAT",
        "merge authorization"
      ]
    },
    {
      "portableRole": "Interpreter / Architect",
      "currentImplementation": "ChatGPT",
      "responsibilities": [
        "research and source comparison",
        "public copy",
        "design intent",
        "Creative Lock",
        "bounded implementation tickets",
        "precise corrections"
      ]
    },
    {
      "portableRole": "Executor / Implementer",
      "currentImplementation": "Codex",
      "responsibilities": [
        "scoped file edits",
        "deterministic regeneration",
        "validation",
        "receipts",
        "draft pull requests"
      ]
    },
    {
      "portableRole": "Validator / Verifier",
      "currentImplementation": "generic validators",
      "responsibilities": [
        "reject missing files",
        "reject malformed metadata",
        "reject changed hashes",
        "reject broken links",
        "reject unknown copy",
        "reject invalid relationships",
        "reject package drift"
      ]
    }
  ],
  "authorities": [
    {
      "order": 1,
      "label": "Human judgment",
      "includes": [
        "intent",
        "thesis",
        "disclosure",
        "design selection",
        "approval"
      ]
    },
    {
      "order": 2,
      "label": "Locked versioned authority",
      "includes": [
        "canonical page source",
        "artifact metadata",
        "source posture",
        "schemas and configuration",
        "implementation boundaries"
      ]
    },
    {
      "order": 3,
      "label": "Deterministic compiler",
      "includes": [
        "normalize",
        "validate",
        "generate",
        "hash"
      ]
    },
    {
      "order": 4,
      "label": "Public projections",
      "includes": [
        "human page",
        "catalog and Explore",
        "graph and discovery",
        "context and packages",
        "receipts"
      ]
    },
    {
      "order": 5,
      "label": "Readers and downstream agents",
      "includes": [
        "read",
        "inspect",
        "reuse",
        "challenge"
      ]
    }
  ],
  "components": [
    "Versioned authority",
    "Python standard-library compiler",
    "Generic validators",
    "GitHub draft pull request",
    "Cloudflare exact-head preview",
    "Static public site",
    "Context projection",
    "Agent package",
    "Public receipt"
  ],
  "lifecycle": [
    "Intent",
    "Source / Candidate",
    "Creative Lock",
    "Implementation Ticket",
    "Branch + Draft PR",
    "Deterministic Validation",
    "Rendered Exact-Head UAT",
    "Human Acceptance",
    "Protected Merge",
    "Receipt + Learning"
  ],
  "generatedSurfaces": [
    "Human artifact page",
    "Complete catalog",
    "Explore views",
    "Topic pages",
    "Author pages",
    "Graph JSON",
    "JSON-LD",
    "llms.txt",
    "Sitemap",
    "Feed",
    "Context projection",
    "Public receipt",
    "Package manifest",
    "Agent ZIP"
  ],
  "validationGates": [
    "canonical selected HTML SHA-256",
    "architecture artifact exists",
    "/architecture/ exists",
    "/architecture.json parses",
    "architecture JSON agrees with the visible roles, authorities, lifecycle, surfaces, and gates",
    "all five diagrams exist",
    "diagrams contain visible labels and text equivalents",
    "all nine claim cards exist",
    "required evidence links exist",
    "attached and canonical source bytes are identical",
    "wrapper suppression does not remove article content",
    "shell isolation is effective",
    "About, Data, Explore, footer, llms.txt, sitemap, and graph contain required routes",
    "no general-thesis dead link exists",
    "no private paths or credentials are exposed",
    "internal anchors resolve",
    "no page-level horizontal overflow",
    "zero console errors",
    "JavaScript-disabled reading is complete",
    "print output remains readable",
    "light and dark presentation work",
    "generated packages are deterministic",
    "two clean builds produce byte-identical complete output trees"
  ],
  "publicationGates": [
    "Creative Lock",
    "Rendered UAT",
    "Exact-head merge authorization"
  ],
  "publicSafeBoundary": {
    "mayExplain": [
      "public repository structure",
      "public routes",
      "public build behavior",
      "public metadata",
      "public validators",
      "public receipts",
      "public role boundaries"
    ],
    "mustNotExpose": [
      "raw private source packets",
      "private staging paths",
      "hidden system prompts",
      "account information",
      "credentials or tokens",
      "employer-specific architecture",
      "client information",
      "regulated records",
      "security-sensitive implementation details",
      "private conversations",
      "local machine paths"
    ]
  },
  "limitations": [
    "Context as code does not make bad sources correct.",
    "It does not prevent an owner from making a poor decision.",
    "It does not turn a validator into a truth machine. Validators prove the rules they were written to prove.",
    "It does not make every model reliable. Missing boundaries still invite hallucination and drift.",
    "It does not eliminate maintenance. Stale authority becomes governed stale authority, which is more inspectable but still stale.",
    "It does not reward stuffing every available token into context. More material can reduce focus. Good context remains curated context.",
    "It does not justify agentic complexity for simple work. Search, a clear document, or a small deterministic script may be the better answer.",
    "It does not replace the runtime architecture required for a production agent that handles identity, live data, memory, permissions, security, and operational state.",
    "SharePlane is a publishing and operating-model demonstration. It is not a claim that every problem belongs in a static site or repository."
  ],
  "relatedSurfaces": [
    {
      "label": "Architecture",
      "route": "/architecture/"
    },
    {
      "label": "How SharePlane Works",
      "route": "/artifacts/how-shareplane-works/"
    },
    {
      "label": "Architecture JSON",
      "route": "/architecture.json"
    },
    {
      "label": "Data and provenance",
      "route": "/data/"
    },
    {
      "label": "Graph JSON",
      "route": "/graph.json"
    },
    {
      "label": "Agent index",
      "route": "/llms.txt"
    },
    {
      "label": "Build manifest",
      "route": "/build-manifest.json"
    },
    {
      "label": "Build receipt",
      "route": "/build-receipt.json"
    }
  ],
  "$schema": "https://next.shareplane.malott.ai/schemas/architecture.schema.json",
  "projectionProvenance": {
    "schemaVersion": "1.0.0",
    "canonical": false,
    "derivedFrom": [
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/architecture-and-intent/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/architecture-review-plane-interactive-concepts/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/clear-thinking-is-the-control-plane/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/demo-debt/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/do-not-outsource-the-brain/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/how-shareplane-works/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/i-was-summoning-ghosts-until-i-learned-to-build-the-machine/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/indispensable-is-not-a-compliment/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/jadorable-bichons-six-website-concepts/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/nine-complete-enterprise-sites-one-ai-prototyping-lab/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/rebuild-contract/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/share-the-prototype-not-every-mutation/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/smud-powerwall-roi-2026/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/software-has-entered-its-re-image-era/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/source-before-agent/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/stop-prompting-agents-start-managing-workers/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/the-agents-are-not-the-bottleneck-you-are/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/the-ai-underclass-will-be-built-with-access-controls/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/the-country-where-movement-became-homework/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/the-hands-i-never-had/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/the-lost-discipline-of-fault-isolation/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/the-repository-that-wakes-up/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/the-world-got-bigger-and-so-did-the-self/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/the-worm-is-in-the-workflow/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/when-execution-gets-cheap-advantage-moves/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/your-second-brain-is-not-a-production-architecture/artifact.json",
      "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/content/artifacts/your-work-is-evaporating/artifact.json"
    ],
    "canonicalRecord": "https://github.com/pinklon/pinklon-shareplane-next/tree/33d227f6000da2491f19209edde916d8846f287f/config/architecture.json",
    "canonicalRecordSha256": "e23bfa1e3bfa8fd7db861c386ed1970c9b9e6fd2e94c1705364c134dfe9324a8",
    "sourceContentSha256": "e23bfa1e3bfa8fd7db861c386ed1970c9b9e6fd2e94c1705364c134dfe9324a8",
    "generationReceipt": "https://next.shareplane.malott.ai/build-receipt.json",
    "authorityReceipt": "https://next.shareplane.malott.ai/build-receipt.json",
    "generatedAt": "2026-07-23T12:37:06-07:00",
    "conflictAction": "stop-and-escalate"
  }
}