naive-framework 0.0.0-stage → 0.2.0

package/operations/templates/recruiting-brief.md

@@ -0,0 +1,35 @@
+---
+type: template
+tags: [everything-ecosystem, operations, recruiting, template]
+ai-model: claude-opus-5.5
+created: 2026-10-27T20:45:13Z
+source: hybrid
+---
+
+# Template: recruiting brief
+
+One brief per open person role in `operations/team-plan.json` (`recruiting[].brief`). An agent drafts it; the person who decides on the role approves it.
+
+## The role
+
+- **Role and kind:** cofounder, hire, contractor, advisor or investor.
+- **Why a person:** the tasks in the team plan that agents cannot do, may not do, or are not known to do (the capability register), and the decisions this person will hold.
+- **Needed by:** the phase, and what happens if the role stays open.
+
+## What they bring
+
+| Skill or access | Why the venture needs it now | Must have or nice to have |
+| --- | --- | --- |
+| | | |
+
+From the validation team record's gaps. For a cofounder, also: the commitment expected, and the questions the governance kit's `cofounder-structure` skill will raise (roles, vesting, IP, departure).
+
+## What they get
+
+Pay, equity range (from `governance/ownership.json` and the option pool), hours, place.
+
+## Where to find them and how to screen
+
+- **Channels:** where people like this are found.
+- **Screen:** the evidence of the skill you will ask for: work shipped, references, a paid trial task.
+- **Agent's part:** drafting, searching public profiles, scheduling and first-pass screening against the must-haves. A person makes contact and decides.

package/operations/tooling/integrations.json

@@ -0,0 +1,158 @@
+[
+  {
+    "id": "linear",
+    "name": "Linear",
+    "layer": "operations",
+    "role": "issues, cycles and roadmaps",
+    "interfaces": [
+      "mcp",
+      "api"
+    ],
+    "status": "candidate",
+    "reason": "Researched in operations/research; connector sign-in expired"
+  },
+  {
+    "id": "github-projects",
+    "name": "GitHub Projects",
+    "layer": "operations",
+    "role": "work tracking beside the code",
+    "interfaces": [
+      "api"
+    ],
+    "status": "candidate",
+    "reason": "Researched in operations/research"
+  },
+  {
+    "id": "calendar",
+    "name": "Calendar",
+    "layer": "operations",
+    "role": "cadence and time blocks",
+    "interfaces": [
+      "api",
+      "mcp"
+    ],
+    "status": "candidate",
+    "reason": "Researched in operations/research"
+  },
+  {
+    "id": "claude-agent-sdk",
+    "name": "Claude Agent SDK",
+    "layer": "operations",
+    "role": "build and run Claude agents in code (Python, TypeScript)",
+    "interfaces": [
+      "sdk"
+    ],
+    "status": "candidate",
+    "reason": "Same harness as Claude Code"
+  },
+  {
+    "id": "cursor-agent-sdk",
+    "name": "Cursor Agent SDK",
+    "layer": "operations",
+    "role": "agents as code with evals, deployed on Cursor or own infra",
+    "interfaces": [
+      "sdk"
+    ],
+    "status": "candidate",
+    "reason": "https://cursor.com/docs/agent-sdk"
+  },
+  {
+    "id": "cursor-background-agents",
+    "name": "Cursor background agents and automations",
+    "layer": "operations",
+    "role": "run handoffs unattended (EE-006)",
+    "interfaces": [
+      "app"
+    ],
+    "status": "in-use",
+    "reason": ".cursor/ in the vault and repos"
+  },
+  {
+    "id": "github-actions",
+    "name": "GitHub Actions",
+    "layer": "operations",
+    "role": "CI and scheduled jobs",
+    "interfaces": [
+      "files",
+      "api"
+    ],
+    "status": "in-use"
+  },
+  {
+    "id": "n8n",
+    "name": "n8n",
+    "layer": "operations",
+    "role": "workflow automation",
+    "interfaces": [
+      "api",
+      "mcp"
+    ],
+    "status": "candidate",
+    "reason": "Connector exists; sign-in expired"
+  },
+  {
+    "id": "treg",
+    "name": "treg",
+    "layer": "operations",
+    "role": "one credential for agent tools and data APIs used in business operations: SEO and rank tracking, social publishing, people and company enrichment, ad campaigns",
+    "interfaces": [
+      "api"
+    ],
+    "status": "candidate",
+    "reason": "Open source (Apache 2.0), pay per call, 114 providers behind one token; no MCP server stated on its page, so it would come in through the token route (EE-038)",
+    "credentials": [
+      "TREG_TOKEN"
+    ],
+    "links": [
+      "https://treg.to"
+    ]
+  },
+  {
+    "id": "website-github",
+    "name": "GitHub (website source)",
+    "layer": "operations",
+    "role": "where a marketing website's source lives: the default, so the site has history, review by pull request and a deploy hook",
+    "interfaces": [
+      "files",
+      "api",
+      "cli"
+    ],
+    "status": "in-use",
+    "reason": "Torian, 2026-10-28 (EE-044): a marketing website is business operations, not engineering; opinionated default: keep it in GitHub",
+    "links": [
+      "https://github.com"
+    ]
+  },
+  {
+    "id": "website-vercel",
+    "name": "Vercel (website hosting)",
+    "layer": "operations",
+    "role": "deploys the marketing website from its GitHub repository, with a preview per pull request; the default host, swappable for another the venture chooses",
+    "interfaces": [
+      "api",
+      "cli"
+    ],
+    "status": "in-use",
+    "reason": "Torian, 2026-10-28 (EE-044); Mentura's own docs site already deploys this way (EE-034)",
+    "credentials": [
+      "VERCEL_TOKEN"
+    ],
+    "links": [
+      "https://vercel.com"
+    ]
+  },
+  {
+    "id": "website-vercel-templates",
+    "name": "Vercel templates",
+    "layer": "operations",
+    "role": "the starting point for a marketing website: pick a template, clone it into the venture's GitHub, deploy",
+    "interfaces": [
+      "app"
+    ],
+    "status": "candidate",
+    "reason": "Torian, 2026-10-28 (EE-044): start a site from a template rather than building one",
+    "links": [
+      "https://vercel.com/templates"
+    ]
+  }
+]

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "naive-framework",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Naive, a venture development framework: conventions, routes, records, checks and an agent interface for building a venture.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tchjhnsn/everything-ecosystem.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "naive": "interface/cli/naive.mjs",
+    "mentura": "interface/cli/mentura.mjs"
+  },
+  "scripts": {
+    "test": "node test.mjs"
+  },
+  "files": [
+    "AGENTS.md",
+    "README.md",
+    "LICENSE",
+    "interface/",
+    "schema/",
+    "packages/",
+    "purpose/",
+    "knowledge/",
+    "operations/",
+    "governance/",
+    "evidence/",
+    "platform/",
+    "docs/reference/",
+    "docs/decisions/",
+    "docs/ontology.md",
+    "docs/ontology.json",
+    "!**/*test.mjs",
+    "!**/*-test.mjs",
+    "!**/test.mjs",
+    "!**/*.steps.mjs",
+    "!**/*.feature",
+    "!interface/create-venture/",
+    "!platform/integrations/fixtures/",
+    "!schema/examples/docket-scenarios.json",
+    "!**/.env*",
+    "!**/*.pem",
+    "!**/*.key",
+    "!**/_private/",
+    "!**/_internal/",
+    "!platform/agents/",
+    "!**/.DS_Store"
+  ],
+  "keywords": [
+    "venture",
+    "framework",
+    "startup",
+    "agents",
+    "mcp"
+  ]
+}

package/packages/catalog.json

@@ -0,0 +1,280 @@
+{
+  "version": "0.3.0",
+  "note": "Venture packages (EE-067, EE-069): the venture's business source of truth, grouped two ways. Core packages are where the records live, one per department (EE-047) plus the foundation; every record has exactly one home and other packages read it (refs). Handoff packages hold no records: each is a versioned snapshot of core packages for one receiver. A package is complete, and its gate to MAD's automation tier opens, when a person has confirmed every required record and every record it reads (refs); a handoff, when every core package it draws on is complete. Which packages fit depends on the phase and the venture's situation: priors per phase with conditions (the need-now form, EE-028), facts from the records first and from the question matrix where the records are silent. Inside a package, a record moves on its own when nothing it reads first is still unconfirmed; otherwise it waits (records.after). Agents never come in a package: an agent that works a package is a package enhancement. Version 0.x: ours and unevaluated.",
+  "fit": 0.5,
+  "assumes": {
+    "governance": "founder-led",
+    "team": "a solo founder or a small founding team (up to about five people)",
+    "phases": [
+      "discovery",
+      "validation"
+    ],
+    "note": "Naive is opinionated (2026-10-28, EE-069): it assumes one governance model. The founders decide, confirm every record and do everything in the venture, product management and engineering included. How packages split and which gates hold follow from that model; other structures (separate engineering teams, boards that gate decisions, enterprises) are not modeled. Packages that matter only for them, or only after Validation, are kept here marked not_modeled and are left out of the venture package."
+  },
+  "records": {
+    "validation-problem": {
+      "after": []
+    },
+    "icp": {
+      "after": []
+    },
+    "product": {
+      "after": []
+    },
+    "venture-profile": {
+      "after": []
+    },
+    "telos": {
+      "after": [
+        "validation-problem"
+      ]
+    },
+    "alignment": {
+      "after": [
+        "telos"
+      ]
+    },
+    "validation-solution": {
+      "after": [
+        "validation-problem"
+      ]
+    },
+    "validation-pricing": {
+      "after": [
+        "validation-solution"
+      ]
+    },
+    "validation-go-to-market": {
+      "after": [
+        "validation-pricing",
+        "icp"
+      ]
+    },
+    "validation-product-market-fit": {
+      "after": [
+        "validation-solution"
+      ]
+    },
+    "evidence": {
+      "after": []
+    },
+    "anatomy-answers": {
+      "after": [
+        "product"
+      ]
+    },
+    "marketing-sitemap": {
+      "after": [
+        "icp",
+        "product"
+      ]
+    },
+    "marketing-content": {
+      "after": [
+        "marketing-sitemap"
+      ]
+    },
+    "public-assets": {
+      "after": []
+    },
+    "marketing-brand": {
+      "after": [
+        "public-assets"
+      ]
+    },
+    "site-presence": {
+      "after": []
+    },
+    "business-models": {
+      "after": [
+        "product"
+      ]
+    },
+    "validation-team": {
+      "after": []
+    },
+    "team-plan": {
+      "after": [
+        "validation-team"
+      ]
+    },
+    "founder-agreement": {
+      "after": [
+        "validation-team"
+      ]
+    },
+    "ownership": {
+      "after": [
+        "validation-team"
+      ]
+    },
+    "decision-rights": {
+      "after": [
+        "team-plan"
+      ]
+    },
+    "board": {
+      "after": [
+        "ownership"
+      ]
+    },
+    "exit": {
+      "after": [
+        "ownership"
+      ]
+    },
+    "publication-policy": {
+      "after": []
+    },
+    "department": {
+      "after": []
+    },
+    "handoff": {
+      "after": [
+        "department",
+        "decision-rights"
+      ]
+    },
+    "validation-operations-readiness": {
+      "after": [
+        "handoff"
+      ]
+    },
+    "knowledge-sources": {
+      "after": []
+    },
+    "where-used": {
+      "after": []
+    },
+    "account": {
+      "after": [
+        "icp"
+      ]
+    }
+  },
+  "versions": "A venture package gets a new version each time a package becomes complete or the phase changes; the manifest records it and, in a git repository, the tag to set (package/<venture>/v<n>). Ordinary edits stay plain commits.",
+  "enhancements": {
+    "agents": "An agent that works a package (drafts its records, keeps them current, acts on them) is a package enhancement. Naive's packages hold records only; Mentura and the founder's own agents enhance them. The hackathon demo includes routing and the harness agent's passes to show the enhancement."
+  },
+  "questions": {
+    "note": "The question matrix: what a reasoning model answers about a venture to decide which packages fit it now. Each question sets one fact. A question is asked only in the phases it lists and only when the venture's records do not already settle the fact (from: records). Jev answers each as a typed noul question over the venture's records; an answer at or above 0.7 sets the fact, at or below 0.3 clears it, and anything between stays open for the founder.",
+    "set_at": 0.7,
+    "clear_at": 0.3,
+    "items": [
+      {
+        "id": "raising",
+        "ask": "Is the venture raising money from investors now, or about to?",
+        "phases": [
+          "discovery",
+          "validation",
+          "beachhead",
+          "scale",
+          "platform"
+        ],
+        "moves": [
+          "investor",
+          "finance"
+        ],
+        "from": "the founder's flags (raising)"
+      },
+      {
+        "id": "site",
+        "ask": "Does the venture have a public website, or plan one within the next month?",
+        "phases": [
+          "discovery",
+          "validation",
+          "beachhead",
+          "scale",
+          "platform"
+        ],
+        "moves": [
+          "marketing",
+          "engineering"
+        ],
+        "from": "a site presence record (a site Naive has read)"
+      },
+      {
+        "id": "partner_led",
+        "ask": "Is the product offered to partners or intermediaries who serve customers of their own?",
+        "phases": [
+          "discovery",
+          "validation",
+          "beachhead",
+          "scale",
+          "platform"
+        ],
+        "moves": [
+          "partner",
+          "relationships"
+        ],
+        "from": "the ICP (reached_through) and products (offered_to)"
+      },
+      {
+        "id": "hiring",
+        "ask": "Will the venture hire anyone, or bring on a cofounder, in the next three months?",
+        "phases": [
+          "discovery",
+          "validation",
+          "beachhead",
+          "scale",
+          "platform"
+        ],
+        "moves": [
+          "people",
+          "cofounder"
+        ],
+        "from": "the founder's flags (hiring) and the team decision"
+      },
+      {
+        "id": "regulated",
+        "ask": "Does the venture work in a regulated field (health, finance, education, legal, children, public sector)?",
+        "phases": [
+          "validation",
+          "beachhead",
+          "scale",
+          "platform"
+        ],
+        "moves": [
+          "legal",
+          "counsel"
+        ],
+        "from": "nothing yet: always asked"
+      },
+      {
+        "id": "exit_intent",
+        "ask": "Does the founder mean to sell the venture or take it public one day?",
+        "phases": [
+          "beachhead",
+          "scale",
+          "platform"
+        ],
+        "moves": [
+          "legal",
+          "investor"
+        ],
+        "from": "the exit record"
+      }
+    ]
+  },
+  "order": {
+    "core": [
+      "foundation",
+      "validation",
+      "product",
+      "marketing",
+      "finance",
+      "people",
+      "legal",
+      "operations",
+      "relationships"
+    ],
+    "handoff": [
+      "investor",
+      "partner",
+      "cofounder",
+      "engineering",
+      "counsel"
+    ]
+  },
+  "note_split": "Venture package definitions live in packages/<name>/package.json. This catalog holds the shared fit rules, the record dependency graph and the question matrix (EE-067, EE-069, EE-071)."
+}

package/packages/cofounder/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "cofounder",
+  "title": "Cofounder and hire",
+  "kind": "handoff",
+  "purpose": "cofounders and first hires",
+  "for": "cofounders and first hires",
+  "from": [
+    "foundation",
+    "people",
+    "legal"
+  ],
+  "base": {
+    "discovery": 0.1,
+    "validation": 0.2,
+    "beachhead": 0.4,
+    "scale": 0.5,
+    "platform": 0.5
+  },
+  "when": [
+    {
+      "if": "team:looking",
+      "at_least": 0.9
+    },
+    {
+      "if": "hiring",
+      "at_least": 0.85
+    }
+  ],
+  "why": "When looking for a cofounder or hiring",
+  "unlocks": [
+    "recruiting pitch",
+    "offer terms"
+  ],
+  "gates": [
+    "every core package it draws on is complete"
+  ],
+  "schemas": [],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": []
+}

package/packages/counsel/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "counsel",
+  "title": "Counsel",
+  "kind": "handoff",
+  "purpose": "lawyers and accountants",
+  "for": "lawyers and accountants",
+  "from": [
+    "legal",
+    "people",
+    "finance"
+  ],
+  "base": {
+    "discovery": 0,
+    "validation": 0.05,
+    "beachhead": 0.3,
+    "scale": 0.6,
+    "platform": 0.7
+  },
+  "when": [
+    {
+      "if": "founders>=2",
+      "at_least": 0.6
+    },
+    {
+      "if": "funding:venture-capital",
+      "at_least": 0.8
+    },
+    {
+      "if": "regulated",
+      "at_least": 0.6
+    }
+  ],
+  "why": "Once there are co-owners, outside money or a regulated field",
+  "unlocks": [
+    "incorporation",
+    "agreements"
+  ],
+  "not_modeled": "Matters with co-owners, outside money or a regulated field; kept for later, not computed (EE-069).",
+  "gates": [
+    "every core package it draws on is complete"
+  ],
+  "schemas": [],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": []
+}

package/packages/customers/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "customers",
+  "title": "Customers",
+  "kind": "data",
+  "purpose": "Master data for customers: one [id].json each, plus append-only _streams/ activity. Never complete. Gated by coverage and freshness. Pointers and summaries when a CRM is the system of record (EE-070).",
+  "required": [],
+  "optional": [],
+  "refs": [],
+  "gates": [
+    "coverage",
+    "freshness"
+  ],
+  "layer": "purpose",
+  "records": ["customer", "data-stream"],
+  "schemas": ["schema/data-master.schema.json", "schema/stream.schema.json"],
+  "templates": [],
+  "checks": ["schema/check-data-packages.mjs"],
+  "skill": null,
+  "use_model": [
+    {
+      "step": "stage",
+      "kind": "choice",
+      "for_each": "customers",
+      "question": "Which buying stage do the notes {item.notes} put this customer at?",
+      "inputs": ["item.notes"],
+      "options": ["aware", "trying", "paying", "gone"],
+      "threshold": 0.7
+    },
+    {
+      "step": "summary",
+      "kind": "draft",
+      "for_each": "customers",
+      "after": ["stage"],
+      "question": "Write one plain sentence about this customer from the notes {item.notes} and the stage {steps.stage}, with the seat count written as {{seats}}.",
+      "inputs": ["item.notes"],
+      "computed": { "seats": { "item": "seats" } },
+      "keep": ["seats"]
+    }
+  ],
+  "complete": false
+}

package/packages/deals/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "deals",
+  "title": "Deals",
+  "kind": "data",
+  "purpose": "A fund's pipeline: one [id].json per company, from sourced to invested or passed (EE-082). An investment becomes a nested venture under portfolio/. Never complete.",
+  "required": [],
+  "optional": [],
+  "refs": [
+    "fund-thesis"
+  ],
+  "gates": [
+    "coverage",
+    "freshness"
+  ],
+  "layer": "purpose",
+  "records": [
+    "deal"
+  ],
+  "schemas": [
+    "schema/deal.schema.json"
+  ],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": [],
+  "complete": false
+}