naive-framework 0.1.0 → 0.3.0

package/schema/examples/workspace/ventures/acme-labs/profile.md

@@ -0,0 +1,12 @@
+# Acme Labs
+
+A software startup in discovery: an app that watches what an independent cafe sells and drafts the supplier reorder for the owner to approve. It is Naive's demo venture (EE-082, EE-083), created with create-venture, and every check passes on it.
+
+- **People:** Maya Chen, solo founder, wears every hat (`people/`). Maya is fictional.
+- **Sources of truth:** the product is pointed at a local repo, GitHub and Vercel; marketing and sales at Vercel's analytics; finance is connected to Rho (`knowledge/sources.json`).
+- **Money:** `money/` holds Rho's sandbox, a fictional company Rho runs for developers (Acme Corporation), synced from a saved answer (`platform/integrations/fixtures/rho-sandbox.json`). `knowledge/sources.json` marks it as a fixture. It is not a real account.
+- **Decided so far:** a prototype exists, the founder is solo, the problem, the ideal customer, and the goal for discovery (`decisions/`). The vision, the core product and the rest of the foundation are next.
+
+## Changelog
+
+- 2026-10-29: created as the demo venture.

package/schema/examples/workspace/ventures/acme-labs/provenance.jsonl

@@ -0,0 +1,12 @@
+{"at":"2026-10-29T06:28:55.639Z","entity":"people/founders/maya-chen.json","route":"people/founders/maya-chen","activity":"write","agent":{"kind":"person","via":"cli","id":"maya-chen"},"note":"Maya Chen, founder, as answered at create-venture","sha256":"436954d76ad3b0be2b52c145581d185e1c759c2ae393f7dfc376fe4ddfc65ef6","prev":"genesis","hash":"edd4e33feaedb0eb70898424b52204f0b87a8ab2ef26289ca3e16dad0bdc18ec"}
+{"at":"2026-10-29T06:28:55.641Z","entity":"people/people.json","route":"people","activity":"write","agent":{"kind":"person","via":"cli","id":"maya-chen"},"note":"solo: Maya Chen (founder)","sha256":"59ed0433f4c7deed37b54adf0992973ba59aaf19aa4f941caeb960873fd4b7ca","prev":"edd4e33feaedb0eb70898424b52204f0b87a8ab2ef26289ca3e16dad0bdc18ec","hash":"22f031922fe67ebf3ec4ab02fd87b96b060d0a6be71cc43bcc05a355e0dc9246"}
+{"at":"2026-10-29T06:28:55.641Z","entity":"raw/dump.md","route":"raw/dump","activity":"write","agent":{"kind":"person","via":"cli"},"note":"the founder's idea dump, verbatim, from /private/tmp/claude-501/-Users-torianm-workspace-code/5dc2fede-2484-409d-b80a-6f0f2cc6a9ca/scratchpad/acme-dump.md","sha256":"8b60df268a0cdaf8ad796b049cecf05c80c42b3bb269af171031b7c772c15c86","prev":"22f031922fe67ebf3ec4ab02fd87b96b060d0a6be71cc43bcc05a355e0dc9246","hash":"76178f401f4420790ec13aade784839ffa4fd74f96724417937112e4a22122e2"}
+{"at":"2026-10-29T06:28:55.721Z","entity":"knowledge/sources.json","route":"knowledge/knowledge-sources","activity":"write","agent":{"kind":"person","via":"cli","id":"maya-chen"},"note":"systems of record: products local-repo (pointed), github (pointed), vercel (pointed); marketing-and-sales vercel (pointed); finance rho (connected)","sha256":"6f5c2396c9fcdc03eca3d4058567cdd5f6c766bd64b9205d1bc94f232e80a642","prev":"76178f401f4420790ec13aade784839ffa4fd74f96724417937112e4a22122e2","hash":"0a988432bba5c3a40461a43967c98c6e13fd1da718a263796abbd9a7df55fa53"}
+{"at":"2026-10-29T06:29:12.158Z","entity":"products/decisions/product.exists.decision.json","route":"governance/decisions","activity":"accept","agent":{"kind":"person","via":"api","id":"Maya Chen"},"note":"a clickable prototype, piloted with two cafes","sha256":"29eb52737214c4720993a5e8c3939860c196947727c9923355b7f1b566aa8a6c","prev":"0a988432bba5c3a40461a43967c98c6e13fd1da718a263796abbd9a7df55fa53","hash":"3669d77c832f760f8fc7794a5132f4774861790f21bdc055f7a46ee022032a21"}
+{"at":"2026-10-29T06:29:12.276Z","entity":"decisions/venture.team.decision.json","route":"governance/decisions","activity":"accept","agent":{"kind":"person","via":"api","id":"Maya Chen"},"note":"approved decision founding-team (own)","sha256":"469d9dc10506992ab279b1b20cba9adf8001eafdbdda71c625979095c0bbd6c6","prev":"3669d77c832f760f8fc7794a5132f4774861790f21bdc055f7a46ee022032a21","hash":"0496a439b120a807ad6526d6721faa72bda490210d8a2ab7428e7427fb8f9189"}
+{"at":"2026-10-29T06:29:12.425Z","entity":"decisions/statement-problem.decision.json","route":"governance/decisions","activity":"draft","agent":{"kind":"agent","via":"api"},"note":"proposed decision statement-problem","sha256":"96dcaeaf4ad32309ac4aab4ad61b43a1ce2a21330a96a5b57460145da97fdb91","prev":"0496a439b120a807ad6526d6721faa72bda490210d8a2ab7428e7427fb8f9189","hash":"b8e46cb42e395c6d1b4a4b2e918dc5b2a95539ddf5d70fee19789db2794ce489"}
+{"at":"2026-10-29T06:29:12.531Z","entity":"decisions/statement-problem.decision.json","route":"governance/decisions","activity":"accept","agent":{"kind":"person","via":"api","id":"Maya Chen"},"note":"the founder words at /setup","sha256":"93cb0447d915e59c9979cc822cc96a82d04ecfd6c58f6a5fbaafc2467abe32d7","prev":"b8e46cb42e395c6d1b4a4b2e918dc5b2a95539ddf5d70fee19789db2794ce489","hash":"a1afaaa15408cd3943da0e40bc83a61ab6a6a08e6264a02810ab23242a233e11"}
+{"at":"2026-10-29T06:29:12.659Z","entity":"decisions/statement-icp.decision.json","route":"governance/decisions","activity":"draft","agent":{"kind":"agent","via":"api"},"note":"proposed decision statement-icp","sha256":"fd3762b22a792b5222d282bf9156e98ba6e55b55dc3c9f02513bbe1dc4426f6e","prev":"a1afaaa15408cd3943da0e40bc83a61ab6a6a08e6264a02810ab23242a233e11","hash":"499093a4cf006b3fdcf1505315ea0839ad2de681b493058831f47a1493db15b5"}
+{"at":"2026-10-29T06:29:12.853Z","entity":"decisions/statement-icp.decision.json","route":"governance/decisions","activity":"accept","agent":{"kind":"person","via":"api","id":"Maya Chen"},"note":"the founder words at /setup","sha256":"0a0bb15a864f695776b83e5d1b956c10d1739984ae3dd8acdc3565c71cf47ad0","prev":"499093a4cf006b3fdcf1505315ea0839ad2de681b493058831f47a1493db15b5","hash":"3e0ea9f5026191e993f18a7d6caac5de38832cd544ec5a97055da7a9bd5df130"}
+{"at":"2026-10-29T06:29:13.009Z","entity":"decisions/discovery-goal.decision.json","route":"governance/decisions","activity":"draft","agent":{"kind":"agent","via":"api"},"note":"proposed decision discovery-goal","sha256":"42ec3ef2a84a101f8cd171f7ee9153f8df26ede2db872af6884579108d5ca7e5","prev":"3e0ea9f5026191e993f18a7d6caac5de38832cd544ec5a97055da7a9bd5df130","hash":"646eb4207e8b216c6159831a502b152e857bd5db0f07acd51492899a8641c1b1"}
+{"at":"2026-10-29T06:29:13.141Z","entity":"decisions/discovery-goal.decision.json","route":"governance/decisions","activity":"accept","agent":{"kind":"person","via":"api","id":"Maya Chen"},"note":"approved decision discovery-goal (own)","sha256":"d4bbf2288abc0ae2d5b72af5dcb7e671ddeb36353802da14c7ffc0c9348e2133","prev":"646eb4207e8b216c6159831a502b152e857bd5db0f07acd51492899a8641c1b1","hash":"f85d2bf315c9ca9ba95d61d5b6400b8c7922cd5abbd12581935f63204dfef84d"}

package/schema/examples/workspace/ventures/acme-labs/raw/dump.md

@@ -0,0 +1,6 @@
+# Acme Labs ideas
+
+Cafes and small restaurants reorder supplies by hand, from paper lists and supplier phone calls.
+Owners say it takes three to five hours a week and they still run out of oat milk.
+We could build an app that watches what sells and drafts the reorder for the owner to approve.
+Start with independent cafes in one city; charge per location per month.

package/schema/examples/workspace/ventures/acme-labs/venture.json

@@ -0,0 +1,27 @@
+{
+  "id": "acme-labs",
+  "name": "Acme Labs",
+  "type": "software-startup",
+  "parent": null,
+  "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/AGENTS.md

@@ -0,0 +1,17 @@
+# AGENTS.md: northstar
+
+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: validation
+voice: plain words, in the founder's own terms
+private: _private/

package/schema/examples/workspace/ventures/northstar/deals/ductline.json

@@ -0,0 +1,8 @@
+{
+  "id": "ductline",
+  "company": "Ductline",
+  "round": "pre-seed",
+  "status": "diligence",
+  "sector": "climate software",
+  "source": "inbound"
+}

package/schema/examples/workspace/ventures/northstar/deals/kilnworks.json

@@ -0,0 +1,14 @@
+{
+  "id": "kilnworks",
+  "company": "Kilnworks",
+  "round": "seed",
+  "status": "invested",
+  "sector": "industrial decarbonization",
+  "source": "founder referral",
+  "check": {
+    "amount": 750000,
+    "currency": "USD"
+  },
+  "thesis_fit": "Software that cuts kiln fuel use, from a former plant manager",
+  "portfolio": "portfolio/kilnworks"
+}

package/schema/examples/workspace/ventures/northstar/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": "validation",
+  "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/evidence/README.md

@@ -0,0 +1,3 @@
+# evidence
+
+Did it work: reviews, evals and metrics.

package/schema/examples/workspace/ventures/northstar/fund/decisions/terms.decision.json

@@ -0,0 +1,27 @@
+{
+  "id": "fund-terms",
+  "parent": "fund-thesis",
+  "question": "What are the fund's terms: target size, vintage, structure, management fee, carry and term?",
+  "decides": {
+    "record": "fund-terms",
+    "path": "fund/terms.json"
+  },
+  "unlocks": [
+    {
+      "activity": "Raise from limited partners",
+      "routes": [
+        "investors/*"
+      ]
+    }
+  ],
+  "layer": "purpose",
+  "boundary": "fail-closed",
+  "needed_in": "validation",
+  "status": "open",
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    }
+  }
+}

package/schema/examples/workspace/ventures/northstar/fund/decisions/terms.first-close.decision.json

@@ -0,0 +1,27 @@
+{
+  "id": "first-close",
+  "parent": "fund-terms",
+  "question": "When is the first close, and how much must be committed to hold it?",
+  "decides": {
+    "record": "fund-terms",
+    "path": "fund/terms.json"
+  },
+  "unlocks": [
+    {
+      "activity": "Make the first investment",
+      "routes": [
+        "portfolio/*"
+      ]
+    }
+  ],
+  "layer": "purpose",
+  "boundary": "fail-closed",
+  "needed_in": "validation",
+  "status": "open",
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    }
+  }
+}

package/schema/examples/workspace/ventures/northstar/fund/decisions/thesis.decision.json

@@ -0,0 +1,26 @@
+{
+  "id": "fund-thesis",
+  "question": "What does the fund invest in, and why does it win: rounds, sectors, geographies, check size and its edge?",
+  "decides": {
+    "record": "fund-thesis",
+    "path": "fund/thesis.json"
+  },
+  "unlocks": [
+    {
+      "activity": "Screen deals against the thesis",
+      "routes": [
+        "deals/*"
+      ]
+    }
+  ],
+  "layer": "purpose",
+  "boundary": "fail-closed",
+  "needed_in": "validation",
+  "status": "open",
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    }
+  }
+}

package/schema/examples/workspace/ventures/northstar/fund/terms.json

@@ -0,0 +1,22 @@
+{
+  "venture": "northstar",
+  "target_size": {
+    "amount": 25000000,
+    "currency": "USD"
+  },
+  "vintage": 2026,
+  "structure": "limited-partnership",
+  "management_fee": 0.02,
+  "carry": 0.2,
+  "term_years": 10,
+  "gp_commit": 0.02,
+  "closes": [
+    {
+      "date": "2026-09-30",
+      "committed": {
+        "amount": 11000000,
+        "currency": "USD"
+      }
+    }
+  ]
+}

package/schema/examples/workspace/ventures/northstar/fund/thesis.json

@@ -0,0 +1,22 @@
+{
+  "venture": "northstar",
+  "statement": "Seed checks into software that cuts industrial emissions, led by founders who have run plants.",
+  "rounds": [
+    "pre-seed",
+    "seed"
+  ],
+  "sectors": [
+    "industrial decarbonization",
+    "climate software"
+  ],
+  "geographies": [
+    "North America"
+  ],
+  "check_size": {
+    "min": 250000,
+    "max": 1000000,
+    "currency": "USD"
+  },
+  "ownership_target": 0.08,
+  "edge": "Both partners ran manufacturing plants, so founders from industry come to us first."
+}

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

@@ -0,0 +1,3 @@
+# governance
+
+Who may decide what: roles and decision rights.

package/schema/examples/workspace/ventures/northstar/governance/departments/external-relationships/charter.md

@@ -0,0 +1,5 @@
+# External relationships: charter
+
+Holds: Who may speak for the venture.
+
+APQC 12.0 Manage External Relationships; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/northstar/governance/departments/external-relationships/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "external-relationships",
+  "value_chain": "support",
+  "apqc": "12.0"
+}

package/schema/examples/workspace/ventures/northstar/governance/departments/finance/charter.md

@@ -0,0 +1,5 @@
+# Finance and accounting: charter
+
+Holds: Spending authority, controls and audit.
+
+APQC 9.0 Manage Financial Resources; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/northstar/governance/departments/finance/department.json

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

package/schema/examples/workspace/ventures/northstar/governance/departments/human-capital/charter.md

@@ -0,0 +1,5 @@
+# Human capital (HR): charter
+
+Holds: HR policies, the handbook, hiring decision rights.
+
+APQC 7.0 Develop and Manage Human Capital; value chain: support (human resource management).

package/schema/examples/workspace/ventures/northstar/governance/departments/human-capital/department.json

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

package/schema/examples/workspace/ventures/northstar/governance/departments/risk-and-compliance/charter.md

@@ -0,0 +1,5 @@
+# Legal, risk and compliance: charter
+
+Holds: Policies, the risk register, contract approval.
+
+APQC 11.0 Manage Enterprise Risk, Compliance, Remediation, and Resiliency; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/northstar/governance/departments/risk-and-compliance/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "risk-and-compliance",
+  "value_chain": "support",
+  "apqc": "11.0"
+}

package/schema/examples/workspace/ventures/northstar/governance/departments/strategy/charter.md

@@ -0,0 +1,5 @@
+# Strategy: charter
+
+Holds: Strategic decisions and the link to the telos.
+
+APQC 1.0 Develop Vision and Strategy; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/northstar/governance/departments/strategy/department.json

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

package/schema/examples/workspace/ventures/northstar/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/operations/README.md

@@ -0,0 +1,3 @@
+# operations
+
+How work is run here: the MAD record (.mad/) and chosen methods, and handoffs of work to people and agents.

package/schema/examples/workspace/ventures/northstar/operations/departments/external-relationships/README.md

@@ -0,0 +1,5 @@
+# External relationships: operations
+
+Holds: Investor relations, partners, press and government affairs.
+
+APQC 12.0 Manage External Relationships; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/northstar/operations/departments/external-relationships/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "external-relationships",
+  "value_chain": "support",
+  "apqc": "12.0"
+}

package/schema/examples/workspace/ventures/northstar/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/operations/departments/finance/department.json

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

package/schema/examples/workspace/ventures/northstar/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/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/operations/departments/risk-and-compliance/README.md

@@ -0,0 +1,5 @@
+# Legal, risk and compliance: operations
+
+Holds: Filings, contract work, privacy requests.
+
+APQC 11.0 Manage Enterprise Risk, Compliance, Remediation, and Resiliency; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/northstar/operations/departments/risk-and-compliance/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "risk-and-compliance",
+  "value_chain": "support",
+  "apqc": "11.0"
+}

package/schema/examples/workspace/ventures/northstar/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/operations/departments/strategy/department.json

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

package/schema/examples/workspace/ventures/northstar/people/founders/ana-ruiz.json

@@ -0,0 +1,13 @@
+{
+  "id": "ana-ruiz",
+  "name": "Ana Ruiz",
+  "role": "general-partner",
+  "hats": [
+    "strategy",
+    "finance",
+    "external-relationships",
+    "risk-and-compliance",
+    "human-capital"
+  ],
+  "joined": "2026-10-29"
+}

package/schema/examples/workspace/ventures/northstar/people/founders/ben-okafor.json

@@ -0,0 +1,7 @@
+{
+  "id": "ben-okafor",
+  "name": "Ben Okafor",
+  "role": "general-partner",
+  "hats": [],
+  "joined": "2026-10-29"
+}

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"
+}