naive-framework 0.1.0 → 0.2.0

package/schema/examples/workspace/ventures/northstar/people/people.json

@@ -0,0 +1,27 @@
+{
+  "venture": "northstar",
+  "mode": "team",
+  "people": [
+    {
+      "id": "ana-ruiz",
+      "name": "Ana Ruiz",
+      "role": "general-partner",
+      "hats": [
+        "strategy",
+        "finance",
+        "external-relationships",
+        "risk-and-compliance",
+        "human-capital"
+      ],
+      "founder_file": "people/founders/ana-ruiz.json"
+    },
+    {
+      "id": "ben-okafor",
+      "name": "Ben Okafor",
+      "role": "general-partner",
+      "hats": [],
+      "founder_file": "people/founders/ben-okafor.json"
+    }
+  ],
+  "updated": "2026-10-29"
+}

package/schema/examples/workspace/ventures/northstar/pillars/brand.md

@@ -0,0 +1,5 @@
+# Brand pillar
+
+How the venture is known: its name, voice, promise wording and visual identity.
+
+Guide: [brand pillar](../../../../../../governance/venture-template/pillars/brand.md)

package/schema/examples/workspace/ventures/northstar/pillars/business.md

@@ -0,0 +1,5 @@
+# Business pillar
+
+How the venture sustains itself: business models, pricing, costs, legal form and funding.
+
+Guide: [business pillar](../../../../../../governance/venture-template/pillars/business.md)

package/schema/examples/workspace/ventures/northstar/pillars/product.md

@@ -0,0 +1,5 @@
+# Product pillar
+
+What the venture makes: its core product (in venture.json), its products (in products/), and what each needs to be specified, built, shipped and operated.
+
+Guide: [product pillar](../../../../../../governance/venture-template/pillars/product.md)

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/AGENTS.md

@@ -0,0 +1,17 @@
+# AGENTS.md: kilnworks
+
+The map of this venture for agents. Read it, then a route's layout, before writing anything here.
+
+## How to work here
+
+- List the routes with `mentura routes`. Read a route's `layout` and `template` before you write to it.
+- Write through the router (the CLI or the MCP server), not by editing files. Every write is checked against its schema and recorded in provenance.jsonl.
+- A write that fails closed comes back as a draft in `_drafts/`. A person accepts it with `mentura accept`.
+- Never read or send anything under `_private/` to a model.
+- A deeper AGENTS.md (for example `marketing/AGENTS.md`) adds to this one for the routes under it; the nearer one wins.
+
+## Instructions
+
+phase: discovery
+voice: plain words, in the founder's own terms
+private: _private/

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/decisions/venture.team.decision.json

@@ -0,0 +1,31 @@
+{
+  "id": "founding-team",
+  "question": "Who is founding this venture: you alone, you with cofounders, or you looking for cofounders?",
+  "decides": {
+    "record": "founder-agreement",
+    "path": "governance/founder-agreement.json"
+  },
+  "layer": "governance",
+  "boundary": "fail-open",
+  "needed_in": "discovery",
+  "status": "open",
+  "options": [
+    "Solo: I am founding it alone",
+    "Cofounders: we are founding it together",
+    "Looking: I want cofounders"
+  ],
+  "unlocks": [
+    {
+      "activity": "Draft the founder agreement with the founding-agreement kit",
+      "routes": [
+        "governance/founder-agreement"
+      ]
+    }
+  ],
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    }
+  }
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/knowledge/README.md

@@ -0,0 +1,3 @@
+# knowledge
+
+Memory: every record the venture keeps, including notes, specs, decisions and references.

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/customer-service/README.md

@@ -0,0 +1,5 @@
+# Customer service: operations
+
+Holds: Support channels, help content, customer feedback.
+
+APQC 6.0 Manage Customer Service; value chain: primary (service).

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/customer-service/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "customer-service",
+  "value_chain": "primary",
+  "apqc": "6.0"
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/finance/README.md

@@ -0,0 +1,5 @@
+# Finance and accounting: operations
+
+Holds: Books, invoices, budgets and tax.
+
+APQC 9.0 Manage Financial Resources; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/finance/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "finance",
+  "value_chain": "support",
+  "apqc": "9.0"
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/human-capital/README.md

@@ -0,0 +1,5 @@
+# Human capital (HR): operations
+
+Holds: Recruiting, onboarding, payroll runs.
+
+APQC 7.0 Develop and Manage Human Capital; value chain: support (human resource management).

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/human-capital/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "human-capital",
+  "value_chain": "support",
+  "apqc": "7.0"
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/it/README.md

@@ -0,0 +1,5 @@
+# Information technology: operations
+
+Holds: Accounts, integrations, devices and access.
+
+APQC 8.0 Manage Information Technology (IT); value chain: support (technology development).

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/it/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "it",
+  "value_chain": "support",
+  "apqc": "8.0"
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/marketing-and-sales/README.md

@@ -0,0 +1,5 @@
+# Marketing and sales: operations
+
+Holds: The marketing website (EE-044), campaigns, marketing assets, the sales pipeline.
+
+APQC 3.0 Market and Sell Products and Services; value chain: primary (marketing and sales).

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/marketing-and-sales/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "marketing-and-sales",
+  "value_chain": "primary",
+  "apqc": "3.0"
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/products/README.md

@@ -0,0 +1,5 @@
+# Products and services: operations
+
+Holds: Specs, roadmaps and the work of building (MAD, for software).
+
+APQC 2.0 Develop and Manage Products and Services; value chain: primary (technology development).

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/products/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "products",
+  "value_chain": "primary",
+  "apqc": "2.0"
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/strategy/README.md

@@ -0,0 +1,5 @@
+# Strategy: operations
+
+Holds: Planning cadence, market research.
+
+APQC 1.0 Develop Vision and Strategy; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/strategy/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "strategy",
+  "value_chain": "support",
+  "apqc": "1.0"
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/brand.md

@@ -0,0 +1,5 @@
+# Brand pillar
+
+How the venture is known: its name, voice, promise wording and visual identity.
+
+Guide: [brand pillar](../../../../../../../../governance/venture-template/pillars/brand.md)

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/business.md

@@ -0,0 +1,5 @@
+# Business pillar
+
+How the venture sustains itself: business models, pricing, costs, legal form and funding.
+
+Guide: [business pillar](../../../../../../../../governance/venture-template/pillars/business.md)

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/product.md

@@ -0,0 +1,5 @@
+# Product pillar
+
+What the venture makes: its core product (in venture.json), its products (in products/), and what each needs to be specified, built, shipped and operated.
+
+Guide: [product pillar](../../../../../../../../governance/venture-template/pillars/product.md)

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.core-product.decision.json

@@ -0,0 +1,28 @@
+{
+  "id": "core-product",
+  "parent": "product-exists",
+  "question": "What is the core product: what anyone can claim from this venture, who it is promised to, what it must never deliver, and the competence that makes it deliverable?",
+  "decides": {
+    "record": "venture",
+    "path": "venture.json"
+  },
+  "unlocks": [
+    {
+      "activity": "Judge the products against the core (Product Anatomy)",
+      "routes": [
+        "purpose/anatomy-input/*",
+        "purpose/anatomy-answers"
+      ]
+    }
+  ],
+  "layer": "purpose",
+  "boundary": "fail-closed",
+  "needed_in": "discovery",
+  "status": "open",
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    }
+  }
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.exists.decision.json

@@ -0,0 +1,32 @@
+{
+  "id": "product-exists",
+  "question": "Does a product already exist (in use, for sale, a prototype or a pilot), or is the venture still an idea?",
+  "decides": {
+    "record": "product",
+    "path": "products/"
+  },
+  "statement": "products",
+  "options": [
+    "Yes: one or more products exist",
+    "Partly: a prototype or pilot exists",
+    "No: it is still an idea"
+  ],
+  "unlocks": [
+    {
+      "activity": "Write product cards for what exists or is planned",
+      "routes": [
+        "purpose/product/*"
+      ]
+    }
+  ],
+  "layer": "purpose",
+  "boundary": "fail-closed",
+  "needed_in": "discovery",
+  "status": "open",
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    }
+  }
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.flagship.decision.json

@@ -0,0 +1,27 @@
+{
+  "id": "flagship",
+  "parent": "core-product",
+  "question": "Which product is the flagship now: the one that best delivers the core promise?",
+  "decides": {
+    "record": "product",
+    "path": "products/"
+  },
+  "unlocks": [
+    {
+      "activity": "Plan how to validate the flagship",
+      "routes": [
+        "purpose/validation/solution"
+      ]
+    }
+  ],
+  "layer": "purpose",
+  "boundary": "fail-closed",
+  "needed_in": "discovery",
+  "status": "open",
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    }
+  }
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/profile.md

@@ -0,0 +1,5 @@
+# kilnworks
+
+What this venture is, in a few sentences. Its machine fields are in venture.json (EE-011).
+
+## Changelog

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/venture.json

@@ -0,0 +1,27 @@
+{
+  "id": "kilnworks",
+  "name": "kilnworks",
+  "type": "software-startup",
+  "parent": "northstar",
+  "phase": "discovery",
+  "owner": "self",
+  "status": "active",
+  "profile": "profile.md",
+  "layers": {
+    "purpose": false,
+    "knowledge": {
+      "location": "knowledge/"
+    },
+    "operations": false,
+    "evidence": false
+  },
+  "departments": [
+    "strategy",
+    "products",
+    "marketing-and-sales",
+    "customer-service",
+    "human-capital",
+    "it",
+    "finance"
+  ]
+}

package/schema/examples/workspace/ventures/northstar/profile.md

@@ -0,0 +1,5 @@
+# northstar
+
+What this venture is, in a few sentences. Its machine fields are in venture.json (EE-011).
+
+## Changelog

package/schema/examples/workspace/ventures/northstar/provenance.jsonl

@@ -0,0 +1,3 @@
+{"at":"2026-10-29T05:51:45.173Z","entity":"people/founders/ana-ruiz.json","route":"people/founders/ana-ruiz","activity":"write","agent":{"kind":"person","via":"cli","id":"ana-ruiz"},"note":"Ana Ruiz, general-partner, as answered at create-venture","sha256":"d7c4f1ba5608dc88a46a08c6a65efe7de090cf41875fbe990a8ea4974a13ef7d","prev":"genesis","hash":"da61087eaffa48394c6c4aa1bf22492c66f618fc088be798c05732e1e42a5e4b"}
+{"at":"2026-10-29T05:51:45.174Z","entity":"people/founders/ben-okafor.json","route":"people/founders/ben-okafor","activity":"write","agent":{"kind":"person","via":"cli","id":"ana-ruiz"},"note":"Ben Okafor, general-partner, as answered at create-venture","sha256":"f7a91c21c45ed11b0f2444d9cbdef6b63d2078ed59808e00c0797097d4a0d631","prev":"da61087eaffa48394c6c4aa1bf22492c66f618fc088be798c05732e1e42a5e4b","hash":"04db571364b36d0d2b1a9dda24145e1718688106f3ed8f94d681efb60c398f6d"}
+{"at":"2026-10-29T05:51:45.174Z","entity":"people/people.json","route":"people","activity":"write","agent":{"kind":"person","via":"cli","id":"ana-ruiz"},"note":"team: Ana Ruiz (general-partner), Ben Okafor (general-partner)","sha256":"55b93788772996b7c077d62e23c0c3adde60f8d999dafb559c0c2602709d9a13","prev":"04db571364b36d0d2b1a9dda24145e1718688106f3ed8f94d681efb60c398f6d","hash":"4acf7b3e96494b22e222bd9dd4b0b021103c0aab2432a122db0b926f478a279b"}

package/schema/examples/workspace/ventures/northstar/purpose/README.md

@@ -0,0 +1,3 @@
+# purpose
+
+Why this venture exists: its core product, products and the Product Anatomy matrix.

package/schema/examples/workspace/ventures/northstar/venture.json

@@ -0,0 +1,49 @@
+{
+  "id": "northstar",
+  "name": "Northstar Climate Fund",
+  "type": "vc-fund",
+  "parent": null,
+  "phase": "validation",
+  "form": {
+    "funding": "mixed"
+  },
+  "core": {
+    "promise": "",
+    "promised_to": "",
+    "must_not": "",
+    "competence": ""
+  },
+  "owner": "self",
+  "status": "active",
+  "profile": "profile.md",
+  "layers": {
+    "purpose": {
+      "location": "purpose/"
+    },
+    "knowledge": {
+      "location": "knowledge/"
+    },
+    "operations": {
+      "location": "operations/"
+    },
+    "evidence": {
+      "location": "evidence/"
+    },
+    "governance": {
+      "location": "governance/"
+    }
+  },
+  "departments": [
+    "strategy",
+    "finance",
+    "external-relationships",
+    "risk-and-compliance",
+    "human-capital"
+  ],
+  "members": [
+    {
+      "role": "partner",
+      "kind": "person"
+    }
+  ]
+}

package/schema/founder.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "founder.schema.json",
+  "title": "Founder",
+  "description": "One founder of the venture (people/founders/<id>.json): role, the functions they own, when they joined, and where their founder agreement is. One file per founder, so each founder's record changes on its own.",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "role",
+    "hats",
+    "joined"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$"
+    },
+    "name": {
+      "type": "string"
+    },
+    "role": {
+      "enum": [
+        "founder",
+        "co-founder",
+        "general-partner"
+      ]
+    },
+    "hats": {
+      "type": "array",
+      "items": {
+        "enum": [
+          "strategy",
+          "products",
+          "marketing-and-sales",
+          "supply-chain",
+          "service-delivery",
+          "customer-service",
+          "human-capital",
+          "it",
+          "finance",
+          "assets",
+          "risk-and-compliance",
+          "external-relationships",
+          "capabilities"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "joined": {
+      "type": "string",
+      "format": "date"
+    },
+    "agreement": {
+      "type": "object",
+      "required": [
+        "path",
+        "signed"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "signed": {
+          "type": "boolean"
+        }
+      }
+    }
+  }
+}