naive-framework 0.0.0-stage → 0.1.0

package/schema/data-model.json

@@ -0,0 +1,1258 @@
+{
+  "version": "0.5.0",
+  "note": "The data model of the Everything Ecosystem: every record type, the layer that owns it, its schema, where its records live and what it references. No one schema holds everything; this file names them all and how they connect. schema/check-data-model.mjs fails when a JSON file in the repo has no record type here (or no ignore entry), when a schema file is unnamed, or when a kit claims a record of another layer. schema/validate.py reads it to validate every record. Levels: method (this repo, the method's own records), workspace (one per builder), venture (inside a venture folder).",
+  "layers": [
+    "purpose",
+    "knowledge",
+    "operations",
+    "evidence",
+    "governance",
+    "interface"
+  ],
+  "records": [
+    {
+      "id": "workspace",
+      "layer": "system",
+      "level": "workspace",
+      "schema": "schema/workspace.schema.json",
+      "paths": [
+        "instance/workspace.json",
+        "schema/examples/workspace/workspace.json"
+      ],
+      "contains": [
+        "venture"
+      ]
+    },
+    {
+      "id": "venture",
+      "layer": "system",
+      "level": "venture",
+      "schema": "schema/venture.schema.json",
+      "paths": [
+        "instance/**/venture.json",
+        "schema/examples/**/venture.json"
+      ],
+      "contains": [
+        "venture",
+        "venture-profile",
+        "product",
+        "account",
+        "anatomy-answers",
+        "handoff",
+        "evidence",
+        "decision-rights",
+        "pillar",
+        "ownership",
+        "board",
+        "founder-agreement",
+        "exit",
+        "telos",
+        "provenance",
+        "knowledge-sources"
+      ],
+      "refs": [
+        {
+          "field": "parent",
+          "to": "venture",
+          "checked_by": "schema/check-ventures.mjs"
+        },
+        {
+          "field": "profile",
+          "to": "venture-profile",
+          "checked_by": null
+        },
+        {
+          "field": "governed_by",
+          "to": "decision",
+          "checked_by": null
+        }
+      ],
+      "note": "The root record of a venture. It names the profile but does not contain it"
+    },
+    {
+      "id": "venture-profile",
+      "layer": "knowledge",
+      "level": "venture",
+      "schema": null,
+      "form": "prose",
+      "paths": [
+        "instance/**/profile.md"
+      ],
+      "note": "The venture's story and thesis in prose, beside venture.json"
+    },
+    {
+      "id": "product",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/product.schema.json",
+      "paths": [
+        "instance/**/product/*.json",
+        "schema/examples/**/product/*.json",
+        "instance/**/products/*.json",
+        "schema/examples/**/products/*.json"
+      ],
+      "refs": [
+        {
+          "field": "part_of",
+          "to": "product",
+          "checked_by": "schema/check-ventures.mjs"
+        },
+        {
+          "field": "flows_to",
+          "to": "product",
+          "checked_by": "schema/check-ventures.mjs"
+        },
+        {
+          "field": "business_model",
+          "to": "business-models",
+          "checked_by": "schema/check-ventures.mjs"
+        }
+      ]
+    },
+    {
+      "id": "account",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/account.schema.json",
+      "paths": [
+        "instance/**/accounts/*/account.json",
+        "schema/examples/**/accounts/*/account.json"
+      ],
+      "refs": [
+        {
+          "field": "products",
+          "to": "product",
+          "checked_by": "schema/check-ventures.mjs"
+        }
+      ],
+      "note": "A named party the venture keeps a record for: client, customer, user, member or partner (EE-021). Optional"
+    },
+    {
+      "id": "telos",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/telos.schema.json",
+      "paths": [
+        "instance/**/foundation/telos.json",
+        "schema/examples/**/foundation/telos.json",
+        "instance/**/purpose/telos.json",
+        "schema/examples/**/purpose/telos.json"
+      ],
+      "refs": [
+        {
+          "field": "phases.exit_criteria.serves",
+          "to": "telos",
+          "checked_by": "schema/check-telos.mjs"
+        },
+        {
+          "field": "owner_outcome.path",
+          "to": "exit",
+          "checked_by": "schema/check-telos.mjs"
+        },
+        {
+          "field": "phases.phase",
+          "to": "anatomy-framework",
+          "checked_by": "schema/validate.py"
+        }
+      ],
+      "note": "The end the venture exists to reach: statement, end state, measures, owner outcome, exit criteria per phase (EE-023)",
+      "decision_class": "strategy-or-constitution"
+    },
+    {
+      "id": "idea-dump",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": null,
+      "form": "prose",
+      "paths": [
+        "instance/**/raw/dump.md",
+        "schema/examples/**/raw/dump.md",
+        "instance/**/purpose/ideas/dump.md",
+        "schema/examples/**/purpose/ideas/dump.md"
+      ],
+      "note": "The founder's raw idea dump: every idea about the venture, verbatim and unprompted. Never rewritten by an agent (EE-059)"
+    },
+    {
+      "id": "idea-map",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": null,
+      "form": "markdown",
+      "paths": [
+        "instance/**/ideas/map.mdx",
+        "schema/examples/**/ideas/map.mdx",
+        "instance/**/purpose/ideas/map.mdx",
+        "schema/examples/**/purpose/ideas/map.mdx"
+      ],
+      "note": "The idea dump mapped onto Naive's conventions: one <Idea> per idea, its text unchanged, tagged with departments, records and whether it exists (purpose/frameworks/idea-map); drawn as a mind map (EE-059)"
+    },
+    {
+      "id": "idea-graph",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/idea-graph.schema.json",
+      "paths": [
+        "instance/**/ideas/graph.json",
+        "schema/examples/**/ideas/graph.json",
+        "instance/**/purpose/ideas/graph.json",
+        "schema/examples/**/purpose/ideas/graph.json"
+      ],
+      "note": "The idea map as a Merkle DAG: each idea with the ideas it builds on, a hash over its text and theirs, its signal, and its lane (in order or on its own); laid out left to right by dependency and top down by signal (EE-060)"
+    },
+    {
+      "id": "validation-problem",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/validation-problem.schema.json",
+      "paths": [
+        "instance/**/foundation/problem.json",
+        "schema/examples/**/foundation/problem.json",
+        "instance/**/purpose/validation/problem.json",
+        "schema/examples/**/purpose/validation/problem.json"
+      ],
+      "refs": [
+        {
+          "field": "evidence.source.path",
+          "to": "(venture files)",
+          "checked_by": "schema/check-validation.mjs"
+        }
+      ],
+      "note": "The problem sub-score of validation: the claim and its cited evidence, each item graded (EE-026). Shares schema/validation-evidence.schema.json with every sub-score Gated like the telos (EE-050): the problem statement is a founder-critical record, so an agent's write is a draft the founder accepts.",
+      "decision_class": "strategy-or-constitution"
+    },
+    {
+      "id": "validation-solution",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/validation-solution.schema.json",
+      "paths": [
+        "instance/**/validation/solution.json",
+        "schema/examples/**/validation/solution.json",
+        "instance/**/purpose/validation/solution.json",
+        "schema/examples/**/purpose/validation/solution.json"
+      ],
+      "refs": [
+        {
+          "field": "evidence.source.path",
+          "to": "(venture files)",
+          "checked_by": "schema/check-validation.mjs"
+        }
+      ],
+      "note": "Validation sub-score: how it solves the problem and the evidence people choose it (EE-026)"
+    },
+    {
+      "id": "validation-product-market-fit",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/validation-product-market-fit.schema.json",
+      "paths": [
+        "instance/**/validation/product-market-fit.json",
+        "schema/examples/**/validation/product-market-fit.json",
+        "instance/**/purpose/validation/product-market-fit.json",
+        "schema/examples/**/purpose/validation/product-market-fit.json"
+      ],
+      "refs": [
+        {
+          "field": "evidence.source.path",
+          "to": "(venture files)",
+          "checked_by": "schema/check-validation.mjs"
+        }
+      ],
+      "note": "Validation sub-score: retention cohorts, Ellis survey and evidence that a segment keeps using it (EE-026)"
+    },
+    {
+      "id": "validation-pricing",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/validation-pricing.schema.json",
+      "paths": [
+        "instance/**/validation/pricing.json",
+        "schema/examples/**/validation/pricing.json",
+        "instance/**/purpose/validation/pricing.json",
+        "schema/examples/**/purpose/validation/pricing.json"
+      ],
+      "refs": [
+        {
+          "field": "evidence.source.path",
+          "to": "(venture files)",
+          "checked_by": "schema/check-validation.mjs"
+        }
+      ],
+      "note": "Validation sub-score: price model, points, buyer and evidence they pay (EE-026)"
+    },
+    {
+      "id": "validation-go-to-market",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/validation-go-to-market.schema.json",
+      "paths": [
+        "instance/**/validation/go-to-market.json",
+        "schema/examples/**/validation/go-to-market.json",
+        "instance/**/purpose/validation/go-to-market.json",
+        "schema/examples/**/purpose/validation/go-to-market.json"
+      ],
+      "refs": [
+        {
+          "field": "evidence.source.path",
+          "to": "(venture files)",
+          "checked_by": "schema/check-validation.mjs"
+        }
+      ],
+      "note": "Validation sub-score: path, motion, channels and evidence a channel works; the path sets the weights (EE-026)"
+    },
+    {
+      "id": "validation-team",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/validation-team.schema.json",
+      "paths": [
+        "instance/**/people/team.json",
+        "schema/examples/**/people/team.json",
+        "instance/**/purpose/validation/team.json",
+        "schema/examples/**/purpose/validation/team.json"
+      ],
+      "refs": [
+        {
+          "field": "evidence.source.path",
+          "to": "(venture files)",
+          "checked_by": "schema/check-validation.mjs"
+        }
+      ],
+      "note": "Validation sub-score: skills needed, held and the gaps; cofounder sought (EE-026)"
+    },
+    {
+      "id": "validation-operations-readiness",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/validation-operations-readiness.schema.json",
+      "paths": [
+        "instance/**/validation/operations-readiness.json",
+        "schema/examples/**/validation/operations-readiness.json",
+        "instance/**/purpose/validation/operations-readiness.json",
+        "schema/examples/**/purpose/validation/operations-readiness.json"
+      ],
+      "refs": [
+        {
+          "field": "evidence.source.path",
+          "to": "(venture files)",
+          "checked_by": "schema/check-validation.mjs"
+        }
+      ],
+      "note": "Validation sub-score: per MAD tier evidence; grades as the weakest tier (EE-026)"
+    },
+    {
+      "id": "validation-weights",
+      "layer": "purpose",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "purpose/kits/validation/weights.json"
+      ],
+      "note": "Validation score weights and floors by go-to-market path and venture kind (EE-026), version 0.x"
+    },
+    {
+      "id": "anatomy-framework",
+      "layer": "purpose",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "purpose/frameworks/product-anatomy/phases.json",
+        "purpose/frameworks/product-anatomy/questions.json"
+      ],
+      "note": "Phases, gates and questions of Product Anatomy; self-describing, checked by its runner's tests"
+    },
+    {
+      "id": "idea-map-conventions",
+      "layer": "purpose",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "purpose/frameworks/idea-map/conventions.json"
+      ],
+      "note": "The tags an idea map may use: departments, records, pillars and the exists judgment, with the threshold (EE-059); checked by the idea-map runner"
+    },
+    {
+      "id": "anatomy-answers",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "instance/**/product/anatomy/answers*.json",
+        "instance/**/product/anatomy.answers*.json",
+        "instance/**/purpose/anatomy.answers*.json",
+        "purpose/frameworks/product-anatomy/examples/*.json"
+      ],
+      "refs": [
+        {
+          "field": "(keys)",
+          "to": "product",
+          "checked_by": "purpose/frameworks/product-anatomy/anatomy.mjs"
+        }
+      ],
+      "note": "Scores per product per question; the matrix is rendered from them"
+    },
+    {
+      "id": "anatomy-input",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "instance/**/product/anatomy/*.json",
+        "instance/**/purpose/anatomy/*.json"
+      ],
+      "note": "Product Anatomy input for one product with parts (venture, core, products, flows), such as Naive or Mentura; read by purpose/frameworks/product-anatomy/anatomy.mjs"
+    },
+    {
+      "id": "decision",
+      "layer": "knowledge",
+      "level": "method",
+      "schema": "schema/decision.schema.json",
+      "paths": [
+        "docs/decisions/decisions.json"
+      ],
+      "note": "A decision log. The schema's own is EE-NNN; a venture keeps its own log under its knowledge layer"
+    },
+    {
+      "id": "decision-record",
+      "layer": "governance",
+      "level": "venture",
+      "schema": "schema/decision-record.schema.json",
+      "paths": [
+        "instance/**/decisions/*.decision.json",
+        "schema/examples/**/decisions/*.decision.json"
+      ],
+      "note": "One live decision, in a decisions/ folder beside the record it decides, with its parent, boundary (fail closed or open) and the phase it is needed in (EE-054, EE-057); node schema/decisions.mjs renders the matrix. The decision log keeps the history"
+    },
+    {
+      "id": "nextjs-status",
+      "layer": "knowledge",
+      "level": "method",
+      "schema": "schema/nextjs-status.schema.json",
+      "paths": [
+        "docs/design/naive-nextjs-status.json"
+      ],
+      "note": "Whether each concept of the Next.js translation ledger is built, with evidence and the docs page that explains it; checked by schema/check-nextjs-status.mjs, which writes the What's built page"
+    },
+    {
+      "id": "design-document",
+      "layer": "knowledge",
+      "level": "method",
+      "schema": null,
+      "form": "markdown",
+      "paths": [
+        "docs/design/*.md"
+      ],
+      "note": "Domain, product, experience, interface and systems design documents; which ones a venture needs is in the design-documents registry"
+    },
+    {
+      "id": "knowledge-sources",
+      "layer": "knowledge",
+      "level": "venture",
+      "schema": "schema/knowledge-sources.schema.json",
+      "paths": [
+        "instance/**/knowledge/sources.json",
+        "schema/examples/**/knowledge/sources.json"
+      ],
+      "refs": [
+        {
+          "field": "sources[].connector",
+          "to": "integration",
+          "checked_by": "schema/check-sources.mjs"
+        },
+        {
+          "field": "records",
+          "to": "(record types)",
+          "checked_by": "schema/check-sources.mjs"
+        }
+      ],
+      "note": "Which source each record type lives in: the venture's own folder by default, or a connected source such as a GitHub repository (EE-037); its rules are the source-of-truth matrix: a system of record and owner per record type, attribute and context (EE-042)"
+    },
+    {
+      "id": "where-used",
+      "layer": "knowledge",
+      "level": "venture",
+      "schema": "schema/where-used.schema.json",
+      "paths": [
+        "instance/**/knowledge/where-used.json",
+        "schema/examples/**/knowledge/where-used.json"
+      ],
+      "refs": [
+        {
+          "field": "facts[].parent.route",
+          "to": "(record routes)",
+          "checked_by": "schema/check-where-used.mjs"
+        },
+        {
+          "field": "facts[].children[].source",
+          "to": "knowledge-sources",
+          "checked_by": "schema/check-where-used.mjs"
+        }
+      ],
+      "note": "For each fact kept once in its system of record, every place that repeats it; live children must show the parent's value (EE-042)"
+    },
+    {
+      "id": "department-catalog",
+      "layer": "operations",
+      "level": "method",
+      "schema": "schema/department-catalog.schema.json",
+      "paths": [
+        "operations/departments.json"
+      ],
+      "note": "The departments a venture can import: APQC categories tagged with Porter's value chain, with need-now priors (EE-047)"
+    },
+    {
+      "id": "department",
+      "layer": "operations",
+      "level": "venture",
+      "schema": "schema/department.schema.json",
+      "paths": [
+        "instance/**/departments/*/department.json",
+        "instance/**/departments/*/*/department.json",
+        "schema/examples/**/departments/*/department.json",
+        "schema/examples/**/departments/*/*/department.json"
+      ],
+      "refs": [
+        {
+          "field": "department",
+          "to": "department-catalog",
+          "checked_by": "schema/check-departments.mjs"
+        }
+      ],
+      "note": "The tag in each department folder, in the governance or operations layer; an optional primary/ or support/ grouping folder is for looking at only (EE-047)"
+    },
+    {
+      "id": "ontology",
+      "layer": "system",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "docs/ontology.json"
+      ],
+      "note": "Canonical nouns; checked by schema/check-nouns.mjs, rendered to docs/ontology.md"
+    },
+    {
+      "id": "reference",
+      "layer": "system",
+      "level": "method",
+      "schema": "schema/reference.schema.json",
+      "paths": [
+        "*/references/references.json",
+        "*/kits/*/references/references.json"
+      ],
+      "note": "Each layer keeps the sources behind its defaults; filled by knowledge/skills/find-reference; a kit inside a layer keeps its own at <layer>/kits/<kit>/references/references.json"
+    },
+    {
+      "id": "integration",
+      "layer": "system",
+      "level": "method",
+      "schema": "schema/integration.schema.json",
+      "form": "json-list",
+      "paths": [
+        "*/tooling/integrations.json"
+      ],
+      "refs": [
+        {
+          "field": "reach",
+          "to": "(layers)",
+          "checked_by": "schema/check-integrations.mjs"
+        }
+      ],
+      "note": "Each layer's tools; interfaces must reach at least four layers"
+    },
+    {
+      "id": "business-models",
+      "layer": "system",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "schema/vocab/business-models.json"
+      ],
+      "note": "Vocabulary: St. Gallen 55 plus named extras"
+    },
+    {
+      "id": "scaffold",
+      "layer": "system",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "schema/scaffold/defaults.json"
+      ],
+      "note": "Starting layers by phase, read by init-venture"
+    },
+    {
+      "id": "data-model",
+      "layer": "system",
+      "level": "method",
+      "schema": "schema/data-model.schema.json",
+      "paths": [
+        "schema/data-model.json"
+      ],
+      "note": "This file"
+    },
+    {
+      "id": "kit-manifest",
+      "layer": "system",
+      "level": "method",
+      "schema": "schema/layer.schema.json",
+      "paths": [
+        "*/layer.json"
+      ],
+      "refs": [
+        {
+          "field": "records",
+          "to": "(record types)",
+          "checked_by": "schema/check-data-model.mjs"
+        },
+        {
+          "field": "reads",
+          "to": "(record types)",
+          "checked_by": "schema/check-data-model.mjs"
+        },
+        {
+          "field": "writes",
+          "to": "(record types)",
+          "checked_by": "schema/check-data-model.mjs"
+        },
+        {
+          "field": "product",
+          "to": "product",
+          "checked_by": "schema/check-data-model.mjs"
+        }
+      ],
+      "note": "A layer manifest (was a kit manifest): skills, record types the layer still owns, record types it reads and writes, checks. The file is <layer>/layer.json (EE-071). Venture packages are packages/<name>/package.json. A kit is Mentura's, at platform/kits/."
+    },
+    {
+      "id": "handoff",
+      "layer": "operations",
+      "level": "venture",
+      "schema": "schema/handoff.schema.json",
+      "paths": [
+        "instance/**/operations/handoffs/*.json"
+      ],
+      "refs": [
+        {
+          "field": "products",
+          "to": "product",
+          "checked_by": "schema/check-execution.mjs"
+        },
+        {
+          "field": "governed_by",
+          "to": "decision",
+          "checked_by": "schema/check-ready.mjs"
+        },
+        {
+          "field": "role",
+          "to": "role",
+          "checked_by": "schema/check-execution.mjs"
+        },
+        {
+          "field": "decision_classes",
+          "to": "decision-rights",
+          "checked_by": "schema/check-execution.mjs"
+        },
+        {
+          "field": "evidence",
+          "to": "evidence",
+          "checked_by": "schema/check-execution.mjs"
+        },
+        {
+          "field": "publication.channel",
+          "to": "publication-policy",
+          "checked_by": "schema/check-publication.mjs"
+        }
+      ],
+      "note": "Execution folded into operations (EE-038)."
+    },
+    {
+      "id": "evidence",
+      "layer": "evidence",
+      "level": "venture",
+      "schema": "schema/evidence.schema.json",
+      "paths": [
+        "instance/**/evidence/results/*.json"
+      ],
+      "refs": [
+        {
+          "field": "subject",
+          "to": "handoff",
+          "checked_by": "schema/check-execution.mjs"
+        },
+        {
+          "field": "suite",
+          "to": "eval-suite",
+          "checked_by": null
+        }
+      ],
+      "note": "Append-only results of running checks"
+    },
+    {
+      "id": "eval-suite",
+      "layer": "evidence",
+      "level": "method",
+      "schema": "schema/eval-suite.schema.json",
+      "paths": [
+        "evidence/evals/*.json"
+      ]
+    },
+    {
+      "id": "design-documents-registry",
+      "layer": "evidence",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "evidence/design-documents.registry.json"
+      ],
+      "refs": [
+        {
+          "field": "documents",
+          "to": "design-document",
+          "checked_by": "evidence/skills/design-coverage/check.mjs"
+        }
+      ],
+      "note": "Self-describing; which design documents a venture needs at which phase"
+    },
+    {
+      "id": "benchmark",
+      "layer": "evidence",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "evidence/benchmarks/*.json"
+      ],
+      "note": "Raw outputs kept as evidence for a benchmark write-up beside them"
+    },
+    {
+      "id": "decision-rights",
+      "layer": "governance",
+      "level": "venture",
+      "schema": "schema/decision-rights.schema.json",
+      "paths": [
+        "governance/venture-template/decision-rights.json",
+        "instance/**/governance/decision-rights.json"
+      ],
+      "refs": [
+        {
+          "field": "extends",
+          "to": "decision-rights",
+          "checked_by": "schema/check-execution.mjs"
+        },
+        {
+          "field": "classes.owner",
+          "to": "role",
+          "checked_by": "schema/check-execution.mjs"
+        }
+      ],
+      "decision_class": "strategy-or-constitution"
+    },
+    {
+      "id": "role",
+      "layer": "governance",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "governance/venture-template/roles/agent-roles.json"
+      ],
+      "note": "Roles and their tiers; shape used, no schema yet"
+    },
+    {
+      "id": "pillar",
+      "layer": "governance",
+      "level": "venture",
+      "schema": null,
+      "form": "prose",
+      "paths": [
+        "governance/venture-template/pillars/*.md",
+        "instance/**/pillars/*.md"
+      ],
+      "note": "The product, brand and business pillars: teams, roles and deliverables. The template holds the guides; a venture holds one-line stubs that link to them"
+    },
+    {
+      "id": "ownership",
+      "layer": "governance",
+      "level": "venture",
+      "schema": "schema/ownership.schema.json",
+      "paths": [
+        "instance/**/governance/ownership.json",
+        "schema/examples/**/governance/ownership.json"
+      ],
+      "refs": [
+        {
+          "field": "grants.holder",
+          "to": "ownership",
+          "checked_by": "schema/check-governance.mjs"
+        },
+        {
+          "field": "grants.class",
+          "to": "ownership",
+          "checked_by": "schema/check-governance.mjs"
+        }
+      ],
+      "note": "The cap table: share classes and their rights, holders, grants with vesting, option pool, SAFEs and notes (EE-022)",
+      "decision_class": "ownership-or-control"
+    },
+    {
+      "id": "board",
+      "layer": "governance",
+      "level": "venture",
+      "schema": "schema/board.schema.json",
+      "paths": [
+        "instance/**/governance/board.json",
+        "schema/examples/**/governance/board.json"
+      ],
+      "refs": [
+        {
+          "field": "seats.appointed_by",
+          "to": "ownership",
+          "checked_by": "schema/check-governance.mjs"
+        }
+      ],
+      "note": "Formal and advisory boards, their seats and reserved matters",
+      "decision_class": "ownership-or-control"
+    },
+    {
+      "id": "founder-agreement",
+      "layer": "governance",
+      "level": "venture",
+      "schema": "schema/founder-agreement.schema.json",
+      "paths": [
+        "instance/**/governance/founder-agreement.json",
+        "schema/examples/**/governance/founder-agreement.json"
+      ],
+      "refs": [
+        {
+          "field": "founders.holder",
+          "to": "ownership",
+          "checked_by": "schema/check-governance.mjs"
+        },
+        {
+          "field": "document",
+          "to": "(file)",
+          "checked_by": "schema/check-governance.mjs"
+        }
+      ],
+      "note": "What founders agreed: roles, commitment, IP, departure, deadlock; prose beside it",
+      "decision_class": "ownership-or-control"
+    },
+    {
+      "id": "exit",
+      "layer": "governance",
+      "level": "venture",
+      "schema": "schema/exit.schema.json",
+      "paths": [
+        "instance/**/governance/exit.json",
+        "schema/examples/**/governance/exit.json"
+      ],
+      "refs": [
+        {
+          "field": "scenarios",
+          "to": "ownership",
+          "checked_by": "schema/payouts.mjs"
+        },
+        {
+          "field": "paths",
+          "to": "telos",
+          "checked_by": "schema/check-telos.mjs"
+        }
+      ],
+      "note": "Exit paths kept open and sale values to model; payouts computed by payouts.mjs",
+      "decision_class": "ownership-or-control"
+    },
+    {
+      "id": "publication-policy",
+      "layer": "governance",
+      "level": "venture",
+      "schema": "schema/publication-policy.schema.json",
+      "paths": [
+        "instance/**/governance/publication-policy.json",
+        "schema/examples/**/governance/publication-policy.json"
+      ],
+      "refs": [
+        {
+          "field": "channels.rules.approvers",
+          "to": "role",
+          "checked_by": "schema/check-publication.mjs"
+        },
+        {
+          "field": "channels.guidelines",
+          "to": "publication-policy",
+          "checked_by": "schema/check-publication.mjs"
+        }
+      ],
+      "note": "Where the venture publishes and who may publish what there: channels, guidelines, checks, preview and approvers; every publication passes this gate (EE-025)",
+      "decision_class": "strategy-or-constitution"
+    },
+    {
+      "id": "marketing-matrix",
+      "layer": "operations",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "operations/marketing/site/matrix.json"
+      ],
+      "note": "The marketing matrix: the audiences a public site speaks to, what each needs to learn and from which record, where it belongs, and how prominent it must be by need; weighted by whether the venture is raising, hiring or inviting contributors, and by its ICPs (EE-062). Version 0.x, unevaluated"
+    },
+    {
+      "id": "site-presence",
+      "layer": "operations",
+      "level": "venture",
+      "schema": "schema/site-presence.schema.json",
+      "paths": [
+        "instance/**/operations/marketing/site-presence.json",
+        "schema/examples/**/operations/marketing/site-presence.json"
+      ],
+      "note": "How present the venture's public records are on its marketing site, item by item, with a score weighed by who the site must speak to now (EE-062)"
+    },
+    {
+      "id": "marketing-sitemap",
+      "layer": "operations",
+      "level": "venture",
+      "schema": "schema/marketing-sitemap.schema.json",
+      "paths": [
+        "instance/**/marketing/sitemap.json",
+        "schema/examples/**/marketing/sitemap.json",
+        "instance/**/operations/marketing/sitemap.json",
+        "schema/examples/**/operations/marketing/sitemap.json"
+      ],
+      "note": "The planned public site: each page's sections in order, with the MDX component, the need, the audience and why, when it shows, the internal record it draws on and the public variant to write; part of the marketing package handed to engineering (EE-064, EE-065)"
+    },
+    {
+      "id": "marketing-content",
+      "layer": "operations",
+      "level": "venture",
+      "schema": null,
+      "form": "markdown",
+      "paths": [
+        "instance/**/marketing/content/**/*.mdx",
+        "schema/examples/**/marketing/content/**/*.mdx",
+        "instance/**/operations/marketing/content/**/*.mdx",
+        "schema/examples/**/operations/marketing/content/**/*.mdx"
+      ],
+      "note": "Public variants of internal records, written by marketing agents as their own MDX: each names the record it is a variant of, its audience, whether it is published and who approved it; checked by the public gate (EE-064)"
+    },
+    {
+      "id": "need-now",
+      "layer": "system",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "schema/need-now.json"
+      ],
+      "refs": [
+        {
+          "field": "records",
+          "to": "(record types)",
+          "checked_by": "schema/test.mjs"
+        }
+      ],
+      "note": "Need-now priors per venture record type and phase, with conditions that raise or lower them (EE-028)"
+    },
+    {
+      "id": "venture-packages",
+      "layer": "system",
+      "level": "method",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "schema/packages.json",
+        "packages/catalog.json",
+        "packages/*/package.json"
+      ],
+      "refs": [
+        {
+          "field": "core.*.required",
+          "to": "(record types)",
+          "checked_by": "schema/packages-test.mjs"
+        }
+      ],
+      "note": "Venture packages (EE-067, EE-069): the assumed governance model; core packages by department (each record's one home, what it reads, priors per phase with conditions, what completion unlocks); handoff packages by receiver; record-level dependencies; the question matrix"
+    },
+    {
+      "id": "venture-package",
+      "layer": "system",
+      "level": "venture",
+      "schema": null,
+      "form": "json",
+      "paths": [
+        "instance/**/.release/venture-package.json",
+        "instance/**/.release/layout.json",
+        "instance/**/package/venture-package.json"
+      ],
+      "note": "The venture package view (EE-067, EE-069): the open core packages and handoffs, each record confirmed, to review or to write, what moves now and what waits, with its versions; the records themselves stay in place"
+    },
+    {
+      "id": "team-plan",
+      "layer": "operations",
+      "level": "venture",
+      "schema": "schema/team-plan.schema.json",
+      "paths": [
+        "instance/**/people/team-plan.json",
+        "schema/examples/**/people/team-plan.json",
+        "instance/**/operations/team-plan.json",
+        "schema/examples/**/operations/team-plan.json"
+      ],
+      "refs": [
+        {
+          "field": "roles.tasks.capability",
+          "to": "agent-capability",
+          "checked_by": "schema/check-team.mjs"
+        },
+        {
+          "field": "roles.authority",
+          "to": "decision-rights",
+          "checked_by": "schema/check-team.mjs"
+        },
+        {
+          "field": "roles.id",
+          "to": "role",
+          "checked_by": "schema/check-team.mjs"
+        }
+      ],
+      "note": "Who the venture needs, agent or person, when, with what authority, and where a human stays in the loop; recruiting briefs for open person roles (EE-029)"
+    },
+    {
+      "id": "agent-capability",
+      "layer": "evidence",
+      "level": "method",
+      "schema": "schema/agent-capability.schema.json",
+      "paths": [
+        "evidence/capabilities/agent-capabilities.json"
+      ],
+      "refs": [
+        {
+          "field": "capabilities.basis.eval",
+          "to": "evidence",
+          "checked_by": "schema/check-team.mjs"
+        },
+        {
+          "field": "capabilities.basis.decision_class",
+          "to": "decision-rights",
+          "checked_by": "schema/check-team.mjs"
+        }
+      ],
+      "note": "What agents can, cannot, may not or are not known to do, with sources and dates (EE-029)"
+    },
+    {
+      "id": "provenance",
+      "layer": "system",
+      "level": "venture",
+      "schema": "schema/provenance-entry.schema.json",
+      "form": "json-lines",
+      "paths": [
+        "instance/**/provenance.jsonl",
+        "schema/examples/**/provenance.jsonl"
+      ],
+      "refs": [
+        {
+          "field": "entity",
+          "to": "(venture file)",
+          "checked_by": "schema/check-provenance.mjs"
+        }
+      ],
+      "note": "Who or what wrote each record, how, from what and under which decision: one append-only line per write, hash-chained, after W3C PROV (EE-031)"
+    },
+    {
+      "id": "route-aliases",
+      "layer": "interface",
+      "level": "method",
+      "schema": "schema/route-aliases.schema.json",
+      "paths": [
+        "interface/route-aliases.json"
+      ],
+      "note": "Old routes kept as aliases of their new ones, so a rename does not break agents (EE-032)"
+    },
+    {
+      "id": "icp",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/icp.schema.json",
+      "paths": [
+        "instance/**/foundation/icp.json",
+        "schema/examples/**/foundation/icp.json",
+        "instance/**/purpose/icp.json",
+        "schema/examples/**/purpose/icp.json"
+      ],
+      "refs": [
+        {
+          "field": "profiles.problem_forms",
+          "to": "validation-problem",
+          "checked_by": "schema/foundation.mjs"
+        }
+      ],
+      "note": "Who the venture serves: ideal customer profiles, one primary (EE-051); a foundation statement, gated",
+      "decision_class": "strategy-or-constitution"
+    },
+    {
+      "id": "alignment",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/alignment.schema.json",
+      "paths": [
+        "instance/**/foundation/alignment.json",
+        "schema/examples/**/foundation/alignment.json",
+        "instance/**/purpose/alignment.json",
+        "schema/examples/**/purpose/alignment.json"
+      ],
+      "note": "How the venture's products and agents must behave: principles with a source and a check (EE-053); a foundation statement, gated",
+      "decision_class": "strategy-or-constitution"
+    },
+    {
+      "id": "strategic-foundation",
+      "layer": "purpose",
+      "level": "method",
+      "schema": "schema/strategic-foundation.schema.json",
+      "paths": [
+        "purpose/strategic-foundation.json"
+      ],
+      "refs": [
+        {
+          "field": "questions.statements.record",
+          "to": "(record types)",
+          "checked_by": "schema/foundation.mjs"
+        }
+      ],
+      "note": "The map of strategic foundation by the Five Ws and How plus whether (EE-051)"
+    },
+    {
+      "id": "customer",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/data-master.schema.json",
+      "paths": [
+        "instance/**/customers/*.json",
+        "schema/examples/**/customers/*.json"
+      ],
+      "note": "A customer master record. Activity is an append-only stream. The package is never complete (EE-070)."
+    },
+    {
+      "id": "investor",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/data-master.schema.json",
+      "paths": [
+        "instance/**/investors/*.json",
+        "schema/examples/**/investors/*.json"
+      ],
+      "note": "An investor master record. Activity is an append-only stream. The package is never complete (EE-070)."
+    },
+    {
+      "id": "money-account",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/data-master.schema.json",
+      "paths": [
+        "instance/**/money/*.json",
+        "schema/examples/**/money/*.json"
+      ],
+      "note": "A money master record. Activity is an append-only stream. The package is never complete (EE-070)."
+    },
+    {
+      "id": "data-stream",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/stream.schema.json",
+      "paths": [
+        "instance/**/customers/_streams/*/stream.json",
+        "instance/**/investors/_streams/*/stream.json",
+        "instance/**/money/_streams/*/stream.json",
+        "schema/examples/**/customers/_streams/*/stream.json",
+        "schema/examples/**/investors/_streams/*/stream.json",
+        "schema/examples/**/money/_streams/*/stream.json"
+      ],
+      "note": "Declares one append-only stream and whether it is sensitive (EE-070)."
+    },
+    {
+      "id": "raw-source",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": "schema/raw-source.schema.json",
+      "paths": [
+        "instance/**/raw/sources/*/source.json",
+        "schema/examples/**/raw/sources/*/source.json"
+      ],
+      "note": "Where a founder-supplied source came from. Raw is immutable (EE-070)."
+    },
+    {
+      "id": "raw-text",
+      "layer": "purpose",
+      "level": "venture",
+      "schema": null,
+      "form": "markdown",
+      "paths": [
+        "instance/**/raw/sources/*/text.md",
+        "schema/examples/**/raw/sources/*/text.md"
+      ],
+      "note": "The text of a raw source. original.* stays out of git (EE-070)."
+    }
+  ],
+  "ignore": [
+    {
+      "path": "package.json",
+      "reason": "The framework's npm manifest: the naive and mentura commands (I-1, I-17); not a record"
+    },
+    {
+      "path": "interface/create-venture/package.json",
+      "reason": "The create-venture generator's npm manifest (I-1); not a record"
+    },
+    {
+      "path": "site/package.json",
+      "reason": "The developer-docs site's npm manifest (EE-034); not a record"
+    },
+    {
+      "path": "site/package-lock.json",
+      "reason": "npm lockfile for the developer-docs site; generated by npm"
+    },
+    {
+      "path": "platform/integrations/fixtures/rho-sandbox.json",
+      "reason": "What Rho's sandbox (a fictional company) answered to one sync, replayed offline by platform/integrations/rho-test.mjs and the harness's --money; vendor data, not a record"
+    },
+    {
+      "path": "schema/examples/docket-scenarios.json",
+      "reason": "Venture states with a source-argued next step, the evidence set schema/docket-eval.mjs scores the docket against (EE-075); test data, not a record"
+    },
+    {
+      "path": "site/tsconfig.json",
+      "reason": "TypeScript config for the Fumadocs site (EE-080); not a record"
+    },
+    {
+      "path": "site/brand/tokens.json",
+      "reason": "W3C design tokens for the site theme (EE-080); not a venture record"
+    },
+    {
+      "path": "site/content/docs/meta.json",
+      "reason": "Fumadocs sidebar order for the docs collection (EE-080); not a record"
+    },
+    {
+      "path": "site/content/docs/get-started/meta.json",
+      "reason": "Fumadocs sidebar order (EE-080); not a record"
+    },
+    {
+      "path": "site/content/docs/guides/meta.json",
+      "reason": "Fumadocs sidebar order (EE-080); not a record"
+    },
+    {
+      "path": "site/content/docs/concepts/meta.json",
+      "reason": "Fumadocs sidebar order (EE-080); not a record"
+    },
+    {
+      "path": "site/content/docs/reference/meta.json",
+      "reason": "Fumadocs sidebar order (EE-080); not a record"
+    },
+    {
+      "path": "site/content/marketing/meta.json",
+      "reason": "Fumadocs sidebar order for marketing pages (EE-080); not a record"
+    }
+  ]
+}