naive-framework 0.0.0-stage → 0.2.0

package/packages/decisions/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "decisions",
+  "title": "Decisions",
+  "kind": "folder",
+  "purpose": "The docket: one file per decision, linked to what it changed (EE-070).",
+  "required": [],
+  "optional": [],
+  "refs": [],
+  "gates": [
+    "present"
+  ],
+  "schemas": [],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": [],
+  "use_cache": [
+    {
+      "route": "governance/decisions",
+      "level": "record",
+      "life": "minutes",
+      "vary": [
+        "hour",
+        "env:DECISIONS_NOW"
+      ]
+    }
+  ]
+}

package/packages/engineering/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "engineering",
+  "title": "Engineering",
+  "kind": "handoff",
+  "purpose": "you, or your own coding agent, when you build the site and the product",
+  "for": "you, or your own coding agent, when you build the site and the product",
+  "from": [
+    "product",
+    "marketing"
+  ],
+  "base": {
+    "discovery": 0.2,
+    "validation": 0.6,
+    "beachhead": 0.9,
+    "scale": 0.9,
+    "platform": 0.9
+  },
+  "when": [
+    {
+      "if": "software",
+      "at_least": 0.7
+    },
+    {
+      "if": "site",
+      "at_least": 0.7
+    }
+  ],
+  "why": "Founders build it themselves (the assumed model): this is what they, or their coding agent, build from",
+  "unlocks": [
+    "the site build",
+    "the product build"
+  ],
+  "gates": [
+    "every core package it draws on is complete"
+  ],
+  "schemas": [],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": []
+}

package/packages/evidence/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "evidence",
+  "title": "Evidence",
+  "kind": "folder",
+  "purpose": "Graded, cited evidence (EE-070). The evidence record's venture home in the fit model stays the validation package until the folder move.",
+  "required": [],
+  "optional": [],
+  "refs": [],
+  "gates": [
+    "present"
+  ],
+  "schemas": [],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": []
+}

package/packages/finance/frames/fund-without-ceding-control.frame.json

@@ -0,0 +1,177 @@
+{
+  "id": "fund-without-ceding-control",
+  "title": "Fund growth without ceding control",
+  "functions": [
+    "finance",
+    "governance"
+  ],
+  "triggers": [
+    "I need investors to scale but I don't want to give up control",
+    "I want to raise money without losing control of my company",
+    "I need funding but I don't want to give away equity",
+    "I don't want investors telling me what to do"
+  ],
+  "goal": "{goal}",
+  "premises": [
+    {
+      "id": "needs-outside-money",
+      "claim": "Reaching the venture's goal needs outside money now, beyond what revenue, customers or partners can fund within the current runway.",
+      "attack": "test-the-goal",
+      "reads": [
+        "goal",
+        "phase",
+        "revenue",
+        "runway"
+      ]
+    },
+    {
+      "id": "money-means-ownership",
+      "claim": "For this venture, taking outside money means selling ownership.",
+      "attack": "split-the-dimension",
+      "reads": [
+        "phase",
+        "revenue",
+        "jurisdiction"
+      ]
+    },
+    {
+      "id": "ownership-means-control",
+      "claim": "For this venture, giving up ownership means giving up control.",
+      "attack": "split-the-dimension",
+      "reads": [
+        "cap_table",
+        "control_rights"
+      ]
+    },
+    {
+      "id": "control-is-one-thing",
+      "claim": "The control the founder wants to keep is one thing, not several separate rights.",
+      "attack": "name-the-control",
+      "reads": [
+        "control_rights"
+      ]
+    }
+  ],
+  "attacks": [
+    "test-the-goal",
+    "split-the-dimension",
+    "name-the-control",
+    "false-dichotomy",
+    "sequence-not-choose"
+  ],
+  "dichotomy": "Take outside money and lose control, or keep control and grow more slowly.",
+  "reframe": "With the goal \"{goal}\", which ways of funding it keep the specific control rights the founder will not give up, in the {phase} phase?",
+  "composes": [
+    "which-control-matters",
+    "fund-growth-how"
+  ],
+  "props": [
+    "phase",
+    "goal",
+    "revenue",
+    "runway",
+    "cap_table",
+    "control_rights",
+    "jurisdiction"
+  ],
+  "freshness": {
+    "look_for": [
+      "funding structures that separate money from ownership",
+      "structures that separate ownership from votes, board seats or vetoes"
+    ],
+    "filter_by": [
+      "jurisdiction",
+      "phase",
+      "revenue"
+    ],
+    "max_age_days": 180,
+    "cite": true
+  },
+  "reasoning": [
+    "Restate the goal and the decisions hidden in the founder's sentence before proposing anything.",
+    "Test each premise as a yes/no proposition against the venture's facts; say unknown when the facts do not settle it.",
+    "Say whether the trade is false, a real trade-off, or a sequence.",
+    "Draw funding options only from a dated, cited lookup, never from memory.",
+    "Return decisions with open options. Do not pick one."
+  ],
+  "emits": [
+    {
+      "id": "which-control-matters",
+      "question": "Which control rights will the founder not give up?",
+      "options": [
+        "the product's direction",
+        "votes on major decisions",
+        "board seats",
+        "vetoes over a sale or new money",
+        "day-to-day authority to run the venture",
+        "the mission"
+      ],
+      "layer": "governance",
+      "needed_in": "discovery"
+    },
+    {
+      "id": "fund-growth-how",
+      "question": "Which way of funding the goal keeps the control rights the founder will not give up?",
+      "options_from": "lookup",
+      "layer": "governance",
+      "needed_in": "validation"
+    }
+  ],
+  "cases": [
+    {
+      "id": "solo-saas-pre-revenue",
+      "facts": {
+        "phase": "discovery",
+        "goal": "ten paying clinics by June",
+        "revenue": "none",
+        "runway": "4 months of the founder's savings",
+        "cap_table": "the founder owns 100%",
+        "control_rights": "the product's direction",
+        "jurisdiction": "Texas, USA"
+      },
+      "expect": {
+        "needs-outside-money": "unknown",
+        "money-means-ownership": "unknown",
+        "ownership-means-control": "no",
+        "control-is-one-thing": "yes",
+        "dichotomy": "sequence"
+      }
+    },
+    {
+      "id": "services-firm-profitable",
+      "facts": {
+        "phase": "beachhead",
+        "goal": "open a second office",
+        "revenue": "profitable, 30% margins",
+        "runway": "18 months from cash flow",
+        "cap_table": "two founders, 50/50",
+        "control_rights": "day-to-day authority and the timing of a sale",
+        "jurisdiction": "Ontario, Canada"
+      },
+      "expect": {
+        "needs-outside-money": "no",
+        "money-means-ownership": "unknown",
+        "ownership-means-control": "no",
+        "control-is-one-thing": "no",
+        "dichotomy": "false"
+      }
+    },
+    {
+      "id": "hardware-pre-revenue-board",
+      "facts": {
+        "phase": "validation",
+        "goal": "ship 500 units of a medical device through regulatory approval by 2028",
+        "revenue": "none",
+        "runway": "2 months",
+        "cap_table": "the founder owns 100%",
+        "control_rights": "a majority of the board and votes on every major decision",
+        "jurisdiction": "Delaware, USA"
+      },
+      "expect": {
+        "needs-outside-money": "yes",
+        "control-is-one-thing": "no",
+        "dichotomy": "trade-off"
+      }
+    }
+  ]
+}

package/packages/finance/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "finance",
+  "title": "Finance",
+  "kind": "core",
+  "purpose": "How the venture makes and spends money: business models, pricing, budget and runway.",
+  "department": "finance",
+  "required": [
+    "business-models"
+  ],
+  "optional": [],
+  "refs": [
+    "validation-pricing",
+    "product"
+  ],
+  "planned": [
+    "budget and runway",
+    "revenue",
+    "financial model"
+  ],
+  "base": {
+    "discovery": 0.2,
+    "validation": 0.5,
+    "beachhead": 0.8,
+    "scale": 1,
+    "platform": 1
+  },
+  "when": [
+    {
+      "if": "raising",
+      "at_least": 0.8
+    }
+  ],
+  "why": "From Validation, or sooner when raising",
+  "unlocks": [
+    "pricing tests",
+    "invoicing",
+    "bookkeeping",
+    "financial models"
+  ],
+  "gates": [
+    "a person has confirmed every required record and every record this package reads"
+  ],
+  "schemas": [],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": []
+}

package/packages/foundation/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "foundation",
+  "title": "Foundation",
+  "kind": "core",
+  "purpose": "What the venture is, why, for whom and with what: the records every other package reads, reviewed near daily.",
+  "department": "strategy",
+  "required": [
+    "validation-problem",
+    "icp"
+  ],
+  "optional": [
+    "venture-profile",
+    "telos",
+    "alignment"
+  ],
+  "refs": [
+    "product"
+  ],
+  "planned": [],
+  "base": {
+    "discovery": 0.95,
+    "validation": 0.95,
+    "beachhead": 0.95,
+    "scale": 0.95,
+    "platform": 0.95
+  },
+  "why": "Every venture, every phase",
+  "unlocks": [
+    "agents may draft every other package",
+    "the near-daily review"
+  ],
+  "gates": [
+    "a person has confirmed every required record and every record this package reads"
+  ],
+  "schemas": [
+    "schema/validation-problem.schema.json",
+    "schema/icp.schema.json",
+    "schema/telos.schema.json",
+    "schema/alignment.schema.json"
+  ],
+  "templates": [
+    "purpose/templates/telos-based-smart.md"
+  ],
+  "checks": [
+    "schema/check-telos.mjs",
+    "schema/validate.py",
+    "schema/check-validation.mjs",
+    "schema/foundation.mjs"
+  ],
+  "skill": null,
+  "use_model": [],
+  "use_cache": [
+    {
+      "route": "purpose/foundation",
+      "level": "record",
+      "life": "hours"
+    }
+  ]
+}

package/packages/fund/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "fund",
+  "title": "Fund",
+  "kind": "core",
+  "purpose": "A fund's foundation: the thesis it invests on and the terms it raises under (EE-082). The VC fund venture type starts with it; a startup never needs it.",
+  "department": "finance",
+  "layer": "purpose",
+  "records": [
+    "fund-thesis",
+    "fund-terms"
+  ],
+  "required": [
+    "fund-thesis",
+    "fund-terms"
+  ],
+  "optional": [],
+  "refs": [],
+  "planned": [],
+  "base": {
+    "discovery": 0.0,
+    "validation": 0.0,
+    "beachhead": 0.0,
+    "scale": 0.0,
+    "platform": 0.0
+  },
+  "when": [
+    {
+      "if": "type:vc-fund",
+      "at_least": 0.9
+    }
+  ],
+  "why": "Only a fund or firm raises on a thesis and terms",
+  "unlocks": [
+    "raising from limited partners",
+    "screening deals against the thesis"
+  ],
+  "gates": [
+    "a person has confirmed the thesis and the terms"
+  ],
+  "schemas": [
+    "schema/fund-thesis.schema.json",
+    "schema/fund-terms.schema.json"
+  ],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": []
+}

package/packages/investor/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "investor",
+  "title": "Investor",
+  "kind": "handoff",
+  "purpose": "investors",
+  "for": "investors",
+  "from": [
+    "foundation",
+    "validation",
+    "finance",
+    "people",
+    "legal"
+  ],
+  "base": {
+    "discovery": 0.05,
+    "validation": 0.2,
+    "beachhead": 0.35,
+    "scale": 0.45,
+    "platform": 0.45
+  },
+  "when": [
+    {
+      "if": "raising",
+      "at_least": 0.95
+    },
+    {
+      "if": "funding:venture-capital",
+      "at_least": 0.7
+    },
+    {
+      "if": "funding:angel",
+      "at_least": 0.6
+    },
+    {
+      "if": "funding:bootstrapped",
+      "at_most": 0.1
+    },
+    {
+      "if": "ambition:hobby",
+      "at_most": 0.05
+    }
+  ],
+  "why": "Only while raising, or when the venture means to take outside money",
+  "unlocks": [
+    "pitch deck",
+    "data room",
+    "investor updates"
+  ],
+  "gates": [
+    "every core package it draws on is complete"
+  ],
+  "schemas": [],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": []
+}

package/packages/investors/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "investors",
+  "title": "Investors",
+  "kind": "data",
+  "purpose": "Master data for investors: one [id].json each, plus append-only _streams/ activity. Never complete. Gated by coverage and freshness (EE-070).",
+  "required": [],
+  "optional": [],
+  "refs": [],
+  "gates": [
+    "coverage",
+    "freshness"
+  ],
+  "layer": "purpose",
+  "records": ["investor"],
+  "schemas": ["schema/data-master.schema.json"],
+  "templates": [],
+  "checks": ["schema/check-data-packages.mjs"],
+  "skill": null,
+  "use_model": [],
+  "complete": false
+}

package/packages/legal/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "legal",
+  "title": "Legal and governance",
+  "kind": "core",
+  "purpose": "Who owns what, who decides what, what may be published, and how the venture ends.",
+  "department": "risk-and-compliance",
+  "required": [
+    "ownership",
+    "decision-rights"
+  ],
+  "optional": [
+    "board",
+    "exit",
+    "publication-policy"
+  ],
+  "refs": [
+    "founder-agreement"
+  ],
+  "planned": [],
+  "base": {
+    "discovery": 0,
+    "validation": 0.1,
+    "beachhead": 0.4,
+    "scale": 0.8,
+    "platform": 0.9
+  },
+  "when": [
+    {
+      "if": "founders>=2",
+      "at_least": 0.7
+    },
+    {
+      "if": "funding:venture-capital",
+      "at_least": 0.8
+    },
+    {
+      "if": "regulated",
+      "at_least": 0.6
+    },
+    {
+      "if": "exit_intent",
+      "phase": "scale",
+      "at_least": 0.9
+    }
+  ],
+  "why": "Once ownership is shared, outside money comes in, or the field is regulated",
+  "unlocks": [
+    "agreements",
+    "filings",
+    "reminders"
+  ],
+  "not_modeled": "Matters after Validation or under another governance model; kept for later, not computed (EE-069).",
+  "gates": [
+    "a person has confirmed every required record and every record this package reads"
+  ],
+  "schemas": [
+    "schema/ownership.schema.json",
+    "schema/decision-rights.schema.json",
+    "schema/board.schema.json",
+    "schema/exit.schema.json",
+    "schema/publication-policy.schema.json"
+  ],
+  "templates": [],
+  "checks": [
+    "schema/check-execution.mjs",
+    "schema/check-governance.mjs",
+    "schema/payouts.mjs",
+    "schema/check-telos.mjs",
+    "schema/check-publication.mjs"
+  ],
+  "skill": null,
+  "use_model": []
+}

package/packages/marketing/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "marketing",
+  "title": "Marketing and sales",
+  "kind": "core",
+  "purpose": "Who the site and campaigns speak to, what goes where and why, the brand, the public variants and the pipeline.",
+  "department": "marketing-and-sales",
+  "required": [
+    "marketing-sitemap"
+  ],
+  "optional": [
+    "marketing-content",
+    "site-presence",
+    "marketing-brand",
+    "public-assets"
+  ],
+  "refs": [
+    "icp",
+    "product"
+  ],
+  "planned": [
+    "campaigns",
+    "sales pipeline"
+  ],
+  "base": {
+    "discovery": 0.35,
+    "validation": 0.7,
+    "beachhead": 0.9,
+    "scale": 0.9,
+    "platform": 0.9
+  },
+  "when": [
+    {
+      "if": "site",
+      "at_least": 0.75
+    },
+    {
+      "if": "publishes",
+      "at_least": 0.8
+    }
+  ],
+  "why": "Once there is something to show, or a site already speaks for the venture",
+  "unlocks": [
+    "site build",
+    "campaigns",
+    "outreach sequences"
+  ],
+  "gates": [
+    "a person has confirmed every required record and every record this package reads"
+  ],
+  "schemas": [
+    "schema/marketing-sitemap.schema.json",
+    "schema/site-presence.schema.json",
+    "schema/marketing-brand.schema.json",
+    "schema/public-assets.schema.json"
+  ],
+  "templates": [],
+  "checks": [
+    "schema/check-brand.mjs",
+    "schema/check-assets.mjs"
+  ],
+  "skill": null,
+  "use_model": []
+}

package/packages/money/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "money",
+  "title": "Money",
+  "kind": "data",
+  "purpose": "Master data for money: one [id].json each, plus append-only _streams/ activity. Never complete. Gated by coverage and freshness. Pointers and summaries when a bank or spend tool is the system of record (EE-070).",
+  "required": [],
+  "optional": [],
+  "refs": [],
+  "gates": [
+    "coverage",
+    "freshness"
+  ],
+  "gate_rules": [
+    {
+      "id": "money-to-finance",
+      "routes": [
+        "money/[id]"
+      ],
+      "actors": [
+        "agent"
+      ],
+      "then": "owner",
+      "note": "Money master data an agent writes goes to the finance function's owner before it is the record"
+    }
+  ],
+  "layer": "purpose",
+  "records": [
+    "money-account",
+    "money-summary"
+  ],
+  "schemas": [
+    "schema/data-master.schema.json",
+    "schema/money-summary.schema.json"
+  ],
+  "templates": [],
+  "checks": [
+    "schema/check-data-packages.mjs"
+  ],
+  "skill": null,
+  "use_model": [],
+  "complete": false
+}