naive-framework 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (549) hide show
  1. package/AGENTS.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +37 -2
  4. package/docs/decisions/decisions.json +888 -0
  5. package/docs/ontology.json +796 -0
  6. package/docs/ontology.md +163 -0
  7. package/docs/reference/ROUTES.md +124 -0
  8. package/evidence/benchmarks/2026-10-27-golden.jev.after-catalog-fix.json +558 -0
  9. package/evidence/benchmarks/2026-10-27-golden.jev.json +501 -0
  10. package/evidence/benchmarks/2026-10-27-golden.reasoning-answers.json +177 -0
  11. package/evidence/benchmarks/JEV_VS_REASONING_MODEL_2026-10-27.md +68 -0
  12. package/evidence/capabilities/agent-capabilities.json +86 -0
  13. package/evidence/design-documents.registry.json +2896 -0
  14. package/evidence/evals/evals.json +25 -0
  15. package/evidence/evals/harness-evals.json +140 -0
  16. package/evidence/layer.json +51 -0
  17. package/evidence/skills/agent-capabilities/SKILL.md +35 -0
  18. package/evidence/skills/design-coverage/SKILL.md +57 -0
  19. package/evidence/skills/design-coverage/check.mjs +192 -0
  20. package/evidence/skills/design-coverage/scan.mjs +45 -0
  21. package/evidence/skills/fidelity-ladder-audit/SKILL.md +121 -0
  22. package/evidence/skills/fidelity-ladder-audit/ladder-census.mjs +180 -0
  23. package/evidence/skills/findability/SKILL.md +32 -0
  24. package/evidence/skills/findability/inventory.rb +41 -0
  25. package/evidence/skills/foreshadowing-audit/SKILL.md +183 -0
  26. package/evidence/skills/metrics-review/SKILL.md +177 -0
  27. package/evidence/tooling/integrations.json +153 -0
  28. package/governance/layer.json +102 -0
  29. package/governance/references/references.json +26 -0
  30. package/governance/skills/board-design/SKILL.md +68 -0
  31. package/governance/skills/brand-pillar/SKILL.md +90 -0
  32. package/governance/skills/business-pillar/SKILL.md +96 -0
  33. package/governance/skills/chief-of-staff/SKILL.md +45 -0
  34. package/governance/skills/cofounder-structure/SKILL.md +64 -0
  35. package/governance/skills/cross-pillar-tradeoff/SKILL.md +168 -0
  36. package/governance/skills/equity-and-share-classes/SKILL.md +68 -0
  37. package/governance/skills/executive-roles/SKILL.md +95 -0
  38. package/governance/skills/exit-planning/SKILL.md +66 -0
  39. package/governance/skills/financing-and-investor-rights/SKILL.md +73 -0
  40. package/governance/skills/office-hours-mode/SKILL.md +113 -0
  41. package/governance/skills/product-pillar/SKILL.md +81 -0
  42. package/governance/skills/publication-policy/SKILL.md +63 -0
  43. package/governance/skills/role-and-candidate-authoring/SKILL.md +198 -0
  44. package/governance/skills/stakeholder-update/SKILL.md +177 -0
  45. package/governance/tooling/integrations.json +37 -0
  46. package/governance/venture-template/AGENT_ROLES_AND_DECISION_RIGHTS.md +58 -0
  47. package/governance/venture-template/COMPANY_VAULT_DEFINITION_2026-10-25.md +204 -0
  48. package/governance/venture-template/README.md +74 -0
  49. package/governance/venture-template/decision-rights.json +186 -0
  50. package/governance/venture-template/index.md +151 -0
  51. package/governance/venture-template/pillars/brand.md +209 -0
  52. package/governance/venture-template/pillars/business.md +255 -0
  53. package/governance/venture-template/pillars/product.md +254 -0
  54. package/governance/venture-template/render-roles.py +11 -0
  55. package/governance/venture-template/roles/README.md +85 -0
  56. package/governance/venture-template/roles/agent-roles.json +202 -0
  57. package/governance/venture-template/roles/ceo.md +163 -0
  58. package/governance/venture-template/roles/chief-of-staff.md +153 -0
  59. package/governance/venture-template/roles/cmo.md +165 -0
  60. package/governance/venture-template/roles/coo.md +189 -0
  61. package/governance/venture-template/roles/cto.md +158 -0
  62. package/governance/venture-template/roles/department-head.md +47 -0
  63. package/governance/venture-template/roles/forward-deployed-engineer.md +51 -0
  64. package/governance/venture-template/roles/founder.md +173 -0
  65. package/governance/venture-template/roles/hr-manager.md +49 -0
  66. package/governance/venture-template/roles/talent-acquisition-manager.md +50 -0
  67. package/governance/venture-template/roles/venture-roles.json +62 -0
  68. package/interface/acting.mjs +83 -0
  69. package/interface/adapters/claude-code.json +16 -0
  70. package/interface/adapters/codex.json +14 -0
  71. package/interface/adapters/cursor.json +16 -0
  72. package/interface/adapters.mjs +182 -0
  73. package/interface/api/server.mjs +71 -0
  74. package/interface/boundaries.mjs +218 -0
  75. package/interface/brand.mjs +214 -0
  76. package/interface/cli/find-venture.mjs +15 -0
  77. package/interface/cli/freshness.mjs +59 -0
  78. package/interface/cli/guard.mjs +6 -0
  79. package/interface/cli/mentura.mjs +341 -0
  80. package/interface/cli/naive.mjs +194 -0
  81. package/interface/context.mjs +524 -0
  82. package/interface/demo/board.mjs +581 -0
  83. package/interface/demo/decision-harness.mjs +91 -0
  84. package/interface/demo/live-agent.mjs +47 -0
  85. package/interface/dev/setup.mjs +84 -0
  86. package/interface/gate-hooks.mjs +36 -0
  87. package/interface/harness/evals.mjs +90 -0
  88. package/interface/harness/examples/pt-no-shows.dump.md +19 -0
  89. package/interface/harness/run.mjs +313 -0
  90. package/interface/harness/site.mjs +59 -0
  91. package/interface/instrumentation.mjs +86 -0
  92. package/interface/kit-boundary.mjs +73 -0
  93. package/interface/layer.json +37 -0
  94. package/interface/mcp/server.mjs +162 -0
  95. package/interface/operator-console/README.md +58 -0
  96. package/interface/package-routes.mjs +196 -0
  97. package/interface/provenance.mjs +65 -0
  98. package/interface/reads.mjs +173 -0
  99. package/interface/references/references.json +28 -0
  100. package/interface/release-card.mjs +42 -0
  101. package/interface/route-aliases.json +32 -0
  102. package/interface/router.mjs +653 -0
  103. package/interface/skills/install-mentura/SKILL.md +88 -0
  104. package/interface/skills/naive-setup/SKILL.md +71 -0
  105. package/interface/skills/naive-setup/artifact.html +83 -0
  106. package/interface/tooling/integrations.json +112 -0
  107. package/interface/vitals.mjs +115 -0
  108. package/interface/writes.mjs +190 -0
  109. package/knowledge/connectors/README.md +54 -0
  110. package/knowledge/connectors/catalog.mjs +118 -0
  111. package/knowledge/connectors/contract.mjs +56 -0
  112. package/knowledge/connectors/eval.mjs +176 -0
  113. package/knowledge/connectors/filesystem.mjs +79 -0
  114. package/knowledge/connectors/index.mjs +102 -0
  115. package/knowledge/connectors/resolve.mjs +44 -0
  116. package/knowledge/connectors/suite.mjs +80 -0
  117. package/knowledge/freshness.json +85 -0
  118. package/knowledge/layer.json +50 -0
  119. package/knowledge/skills/find-reference/SKILL.md +38 -0
  120. package/knowledge/skills/industry-awareness/SKILL.md +277 -0
  121. package/knowledge/templates/glossary.md +23 -0
  122. package/knowledge/tooling/integrations.json +127 -0
  123. package/knowledge/tooling/questions.md +46 -0
  124. package/operations/FOUNDER_OPERATING_MODEL_CAMPAIGN_2026-10-14.md +16 -0
  125. package/operations/departments.json +162 -0
  126. package/operations/handoff-v2.md +93 -0
  127. package/operations/layer.json +67 -0
  128. package/operations/marketing/check-public.mjs +68 -0
  129. package/operations/marketing/site/README.md +86 -0
  130. package/operations/marketing/site/matrix.json +731 -0
  131. package/operations/marketing/site/plan.mjs +117 -0
  132. package/operations/marketing/site/presence.mjs +252 -0
  133. package/operations/references/references.json +45 -0
  134. package/operations/skills/recruiting/SKILL.md +32 -0
  135. package/operations/skills/team-design/SKILL.md +36 -0
  136. package/operations/skills/tool-selection/SKILL.md +46 -0
  137. package/operations/templates/marketing-brand.md +46 -0
  138. package/operations/templates/public-assets.md +39 -0
  139. package/operations/templates/recruiting-brief.md +35 -0
  140. package/operations/tooling/integrations.json +158 -0
  141. package/package.json +59 -4
  142. package/packages/catalog.json +280 -0
  143. package/packages/cofounder/package.json +42 -0
  144. package/packages/counsel/package.json +47 -0
  145. package/packages/customers/package.json +41 -0
  146. package/packages/deals/package.json +27 -0
  147. package/packages/decisions/package.json +28 -0
  148. package/packages/engineering/package.json +41 -0
  149. package/packages/evidence/package.json +17 -0
  150. package/packages/finance/frames/fund-without-ceding-control.frame.json +177 -0
  151. package/packages/finance/package.json +48 -0
  152. package/packages/foundation/package.json +59 -0
  153. package/packages/fund/package.json +48 -0
  154. package/packages/investor/package.json +57 -0
  155. package/packages/investors/package.json +21 -0
  156. package/packages/legal/package.json +73 -0
  157. package/packages/marketing/package.json +63 -0
  158. package/packages/money/package.json +42 -0
  159. package/packages/operations/package.json +74 -0
  160. package/packages/partner/package.json +38 -0
  161. package/packages/people/package.json +64 -0
  162. package/packages/product/package.json +49 -0
  163. package/packages/raw/package.json +19 -0
  164. package/packages/relationships/package.json +52 -0
  165. package/packages/validation/package.json +112 -0
  166. package/platform/README.md +51 -0
  167. package/platform/adapter.json +15 -0
  168. package/platform/connectors/eval.mjs +154 -0
  169. package/platform/connectors/fake-github.mjs +91 -0
  170. package/platform/connectors/github.mjs +105 -0
  171. package/platform/integrations/jev.mjs +30 -0
  172. package/platform/integrations/langsmith-docket.mjs +53 -0
  173. package/platform/integrations/langsmith-setup.mjs +115 -0
  174. package/platform/integrations/langsmith.mjs +47 -0
  175. package/platform/integrations/remote-image.mjs +79 -0
  176. package/platform/integrations/rho.mjs +146 -0
  177. package/platform/integrations/site.mjs +75 -0
  178. package/platform/kits/README.md +14 -0
  179. package/platform/kits/agent-upgrade/kit.json +15 -0
  180. package/platform/kits/agent-upgrade/run.mjs +82 -0
  181. package/platform/kits/agent-upgrade/stand-in-agent.mjs +32 -0
  182. package/platform/kits/validation-kickoff/kit.json +29 -0
  183. package/platform/mcp/research.mjs +64 -0
  184. package/platform/webhooks/server.mjs +70 -0
  185. package/purpose/checklists/vault-and-tooling-consultancy-setup.md +216 -0
  186. package/purpose/frameworks/business-discovery-framework-amendments-2026-05-20.md +181 -0
  187. package/purpose/frameworks/business-discovery-framework.html +938 -0
  188. package/purpose/frameworks/business-discovery-framework.md +326 -0
  189. package/purpose/frameworks/idea-map/README.md +74 -0
  190. package/purpose/frameworks/idea-map/conventions.json +146 -0
  191. package/purpose/frameworks/idea-map/graph.mjs +182 -0
  192. package/purpose/frameworks/idea-map/ideamap.mjs +181 -0
  193. package/purpose/frameworks/idea-map/route.mjs +140 -0
  194. package/purpose/frameworks/onboarding-handoff-framework.md +269 -0
  195. package/purpose/frameworks/post-discovery-deliverable-playbook.md +274 -0
  196. package/purpose/frameworks/product-anatomy/README.md +63 -0
  197. package/purpose/frameworks/product-anatomy/anatomy.mjs +195 -0
  198. package/purpose/frameworks/product-anatomy/examples/polity.answers.reasoned.json +11 -0
  199. package/purpose/frameworks/product-anatomy/examples/polity.json +89 -0
  200. package/purpose/frameworks/product-anatomy/phases.json +107 -0
  201. package/purpose/frameworks/product-anatomy/questions.json +74 -0
  202. package/purpose/kits/validation/README.md +14 -0
  203. package/purpose/kits/validation/references/references.json +122 -0
  204. package/purpose/kits/validation/skills/problem-validation/SKILL.md +43 -0
  205. package/purpose/kits/validation/skills/validation-score/SKILL.md +35 -0
  206. package/purpose/kits/validation/templates/go-to-market.md +19 -0
  207. package/purpose/kits/validation/templates/operations-readiness.md +20 -0
  208. package/purpose/kits/validation/templates/pricing.md +22 -0
  209. package/purpose/kits/validation/templates/problem-interview.md +36 -0
  210. package/purpose/kits/validation/templates/problem.md +45 -0
  211. package/purpose/kits/validation/templates/product-market-fit.md +23 -0
  212. package/purpose/kits/validation/templates/solution.md +18 -0
  213. package/purpose/kits/validation/templates/team.md +19 -0
  214. package/purpose/kits/validation/weights.json +22 -0
  215. package/purpose/layer.json +53 -0
  216. package/purpose/references/references.json +324 -0
  217. package/purpose/skills/ambition-tier/SKILL.md +205 -0
  218. package/purpose/skills/telos/SKILL.md +52 -0
  219. package/purpose/strategic-foundation.json +133 -0
  220. package/purpose/templates/telos-based-smart.md +39 -0
  221. package/purpose/tooling/integrations.json +48 -0
  222. package/schema/README.md +62 -0
  223. package/schema/VERSION +1 -0
  224. package/schema/access.mjs +57 -0
  225. package/schema/account.schema.json +79 -0
  226. package/schema/adapter.schema.json +33 -0
  227. package/schema/add-department.mjs +41 -0
  228. package/schema/agent-capability.schema.json +94 -0
  229. package/schema/alignment.schema.json +61 -0
  230. package/schema/assess-problem.mjs +131 -0
  231. package/schema/assets.mjs +212 -0
  232. package/schema/bdd.mjs +56 -0
  233. package/schema/board.schema.json +101 -0
  234. package/schema/brand.mjs +373 -0
  235. package/schema/build-release.mjs +61 -0
  236. package/schema/caching.mjs +505 -0
  237. package/schema/check-assets.mjs +24 -0
  238. package/schema/check-boundary.mjs +54 -0
  239. package/schema/check-brand.mjs +24 -0
  240. package/schema/check-config.mjs +110 -0
  241. package/schema/check-data-model.mjs +170 -0
  242. package/schema/check-data-packages.mjs +83 -0
  243. package/schema/check-departments.mjs +45 -0
  244. package/schema/check-execution.mjs +85 -0
  245. package/schema/check-governance.mjs +98 -0
  246. package/schema/check-integrations.mjs +33 -0
  247. package/schema/check-nextjs-status.mjs +79 -0
  248. package/schema/check-nouns.mjs +49 -0
  249. package/schema/check-people.mjs +70 -0
  250. package/schema/check-private.mjs +61 -0
  251. package/schema/check-provenance.mjs +55 -0
  252. package/schema/check-publication.mjs +96 -0
  253. package/schema/check-ready.mjs +89 -0
  254. package/schema/check-sources.mjs +74 -0
  255. package/schema/check-team.mjs +94 -0
  256. package/schema/check-telos.mjs +59 -0
  257. package/schema/check-validation.mjs +165 -0
  258. package/schema/check-ventures.mjs +81 -0
  259. package/schema/check-where-used.mjs +58 -0
  260. package/schema/data-master.schema.json +14 -0
  261. package/schema/data-model.json +1584 -0
  262. package/schema/data-model.schema.json +152 -0
  263. package/schema/deal.schema.json +80 -0
  264. package/schema/decision-analytics.mjs +77 -0
  265. package/schema/decision-record.schema.json +290 -0
  266. package/schema/decision-rights.schema.json +34 -0
  267. package/schema/decision.schema.json +30 -0
  268. package/schema/decisions.mjs +327 -0
  269. package/schema/department-catalog.schema.json +55 -0
  270. package/schema/department.schema.json +15 -0
  271. package/schema/departments.mjs +32 -0
  272. package/schema/docket-eval.mjs +89 -0
  273. package/schema/docket.mjs +135 -0
  274. package/schema/eval-suite.schema.json +45 -0
  275. package/schema/evidence.schema.json +110 -0
  276. package/schema/examples/frames/judge.mjs +10 -0
  277. package/schema/examples/migrate/agent.mjs +12 -0
  278. package/schema/examples/venture-type/jev.mjs +12 -0
  279. package/schema/examples/workspace/ventures/acme-labs/AGENTS.md +17 -0
  280. package/schema/examples/workspace/ventures/acme-labs/accounts/.gitkeep +0 -0
  281. package/schema/examples/workspace/ventures/acme-labs/decisions/discovery-goal.decision.json +23 -0
  282. package/schema/examples/workspace/ventures/acme-labs/decisions/statement-icp.decision.json +22 -0
  283. package/schema/examples/workspace/ventures/acme-labs/decisions/statement-problem.decision.json +22 -0
  284. package/schema/examples/workspace/ventures/acme-labs/decisions/venture.team.decision.json +37 -0
  285. package/schema/examples/workspace/ventures/acme-labs/knowledge/README.md +3 -0
  286. package/schema/examples/workspace/ventures/acme-labs/knowledge/sources.json +46 -0
  287. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000001.json +12 -0
  288. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000002.json +12 -0
  289. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000003.json +12 -0
  290. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000004.json +12 -0
  291. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000005.json +12 -0
  292. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000006.json +12 -0
  293. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000007.json +12 -0
  294. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000008.json +12 -0
  295. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000009.json +12 -0
  296. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000010.json +12 -0
  297. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000011.json +12 -0
  298. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000012.json +12 -0
  299. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000013.json +12 -0
  300. package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000014.json +12 -0
  301. package/schema/examples/workspace/ventures/acme-labs/money/_streams/transactions/stream.json +5 -0
  302. package/schema/examples/workspace/ventures/acme-labs/money/_summary.json +30 -0
  303. package/schema/examples/workspace/ventures/acme-labs/operations/departments/customer-service/README.md +5 -0
  304. package/schema/examples/workspace/ventures/acme-labs/operations/departments/customer-service/department.json +5 -0
  305. package/schema/examples/workspace/ventures/acme-labs/operations/departments/finance/README.md +5 -0
  306. package/schema/examples/workspace/ventures/acme-labs/operations/departments/finance/department.json +5 -0
  307. package/schema/examples/workspace/ventures/acme-labs/operations/departments/human-capital/README.md +5 -0
  308. package/schema/examples/workspace/ventures/acme-labs/operations/departments/human-capital/department.json +5 -0
  309. package/schema/examples/workspace/ventures/acme-labs/operations/departments/it/README.md +5 -0
  310. package/schema/examples/workspace/ventures/acme-labs/operations/departments/it/department.json +5 -0
  311. package/schema/examples/workspace/ventures/acme-labs/operations/departments/marketing-and-sales/README.md +5 -0
  312. package/schema/examples/workspace/ventures/acme-labs/operations/departments/marketing-and-sales/department.json +5 -0
  313. package/schema/examples/workspace/ventures/acme-labs/operations/departments/products/README.md +5 -0
  314. package/schema/examples/workspace/ventures/acme-labs/operations/departments/products/department.json +5 -0
  315. package/schema/examples/workspace/ventures/acme-labs/operations/departments/strategy/README.md +5 -0
  316. package/schema/examples/workspace/ventures/acme-labs/operations/departments/strategy/department.json +5 -0
  317. package/schema/examples/workspace/ventures/acme-labs/people/founders/maya-chen.json +15 -0
  318. package/schema/examples/workspace/ventures/acme-labs/people/people.json +22 -0
  319. package/schema/examples/workspace/ventures/acme-labs/pillars/brand.md +5 -0
  320. package/schema/examples/workspace/ventures/acme-labs/pillars/business.md +5 -0
  321. package/schema/examples/workspace/ventures/acme-labs/pillars/product.md +5 -0
  322. package/schema/examples/workspace/ventures/acme-labs/products/.gitkeep +0 -0
  323. package/schema/examples/workspace/ventures/acme-labs/products/decisions/product.core-product.decision.json +28 -0
  324. package/schema/examples/workspace/ventures/acme-labs/products/decisions/product.exists.decision.json +38 -0
  325. package/schema/examples/workspace/ventures/acme-labs/products/decisions/product.flagship.decision.json +27 -0
  326. package/schema/examples/workspace/ventures/acme-labs/profile.md +12 -0
  327. package/schema/examples/workspace/ventures/acme-labs/provenance.jsonl +12 -0
  328. package/schema/examples/workspace/ventures/acme-labs/raw/dump.md +6 -0
  329. package/schema/examples/workspace/ventures/acme-labs/venture.json +27 -0
  330. package/schema/examples/workspace/ventures/northstar/AGENTS.md +17 -0
  331. package/schema/examples/workspace/ventures/northstar/accounts/.gitkeep +0 -0
  332. package/schema/examples/workspace/ventures/northstar/deals/ductline.json +8 -0
  333. package/schema/examples/workspace/ventures/northstar/deals/kilnworks.json +14 -0
  334. package/schema/examples/workspace/ventures/northstar/decisions/venture.team.decision.json +31 -0
  335. package/schema/examples/workspace/ventures/northstar/evidence/README.md +3 -0
  336. package/schema/examples/workspace/ventures/northstar/fund/decisions/terms.decision.json +27 -0
  337. package/schema/examples/workspace/ventures/northstar/fund/decisions/terms.first-close.decision.json +27 -0
  338. package/schema/examples/workspace/ventures/northstar/fund/decisions/thesis.decision.json +26 -0
  339. package/schema/examples/workspace/ventures/northstar/fund/terms.json +22 -0
  340. package/schema/examples/workspace/ventures/northstar/fund/thesis.json +22 -0
  341. package/schema/examples/workspace/ventures/northstar/governance/README.md +3 -0
  342. package/schema/examples/workspace/ventures/northstar/governance/departments/external-relationships/charter.md +5 -0
  343. package/schema/examples/workspace/ventures/northstar/governance/departments/external-relationships/department.json +5 -0
  344. package/schema/examples/workspace/ventures/northstar/governance/departments/finance/charter.md +5 -0
  345. package/schema/examples/workspace/ventures/northstar/governance/departments/finance/department.json +5 -0
  346. package/schema/examples/workspace/ventures/northstar/governance/departments/human-capital/charter.md +5 -0
  347. package/schema/examples/workspace/ventures/northstar/governance/departments/human-capital/department.json +5 -0
  348. package/schema/examples/workspace/ventures/northstar/governance/departments/risk-and-compliance/charter.md +5 -0
  349. package/schema/examples/workspace/ventures/northstar/governance/departments/risk-and-compliance/department.json +5 -0
  350. package/schema/examples/workspace/ventures/northstar/governance/departments/strategy/charter.md +5 -0
  351. package/schema/examples/workspace/ventures/northstar/governance/departments/strategy/department.json +5 -0
  352. package/schema/examples/workspace/ventures/northstar/knowledge/README.md +3 -0
  353. package/schema/examples/workspace/ventures/northstar/operations/README.md +3 -0
  354. package/schema/examples/workspace/ventures/northstar/operations/departments/external-relationships/README.md +5 -0
  355. package/schema/examples/workspace/ventures/northstar/operations/departments/external-relationships/department.json +5 -0
  356. package/schema/examples/workspace/ventures/northstar/operations/departments/finance/README.md +5 -0
  357. package/schema/examples/workspace/ventures/northstar/operations/departments/finance/department.json +5 -0
  358. package/schema/examples/workspace/ventures/northstar/operations/departments/human-capital/README.md +5 -0
  359. package/schema/examples/workspace/ventures/northstar/operations/departments/human-capital/department.json +5 -0
  360. package/schema/examples/workspace/ventures/northstar/operations/departments/risk-and-compliance/README.md +5 -0
  361. package/schema/examples/workspace/ventures/northstar/operations/departments/risk-and-compliance/department.json +5 -0
  362. package/schema/examples/workspace/ventures/northstar/operations/departments/strategy/README.md +5 -0
  363. package/schema/examples/workspace/ventures/northstar/operations/departments/strategy/department.json +5 -0
  364. package/schema/examples/workspace/ventures/northstar/people/founders/ana-ruiz.json +13 -0
  365. package/schema/examples/workspace/ventures/northstar/people/founders/ben-okafor.json +7 -0
  366. package/schema/examples/workspace/ventures/northstar/people/people.json +27 -0
  367. package/schema/examples/workspace/ventures/northstar/pillars/brand.md +5 -0
  368. package/schema/examples/workspace/ventures/northstar/pillars/business.md +5 -0
  369. package/schema/examples/workspace/ventures/northstar/pillars/product.md +5 -0
  370. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/AGENTS.md +17 -0
  371. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/accounts/.gitkeep +0 -0
  372. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/decisions/venture.team.decision.json +31 -0
  373. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/knowledge/README.md +3 -0
  374. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/customer-service/README.md +5 -0
  375. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/customer-service/department.json +5 -0
  376. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/finance/README.md +5 -0
  377. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/finance/department.json +5 -0
  378. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/human-capital/README.md +5 -0
  379. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/human-capital/department.json +5 -0
  380. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/it/README.md +5 -0
  381. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/it/department.json +5 -0
  382. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/marketing-and-sales/README.md +5 -0
  383. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/marketing-and-sales/department.json +5 -0
  384. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/products/README.md +5 -0
  385. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/products/department.json +5 -0
  386. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/strategy/README.md +5 -0
  387. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/strategy/department.json +5 -0
  388. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/brand.md +5 -0
  389. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/business.md +5 -0
  390. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/product.md +5 -0
  391. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/.gitkeep +0 -0
  392. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.core-product.decision.json +28 -0
  393. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.exists.decision.json +32 -0
  394. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.flagship.decision.json +27 -0
  395. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/profile.md +5 -0
  396. package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/venture.json +27 -0
  397. package/schema/examples/workspace/ventures/northstar/products/.gitkeep +0 -0
  398. package/schema/examples/workspace/ventures/northstar/profile.md +5 -0
  399. package/schema/examples/workspace/ventures/northstar/provenance.jsonl +3 -0
  400. package/schema/examples/workspace/ventures/northstar/purpose/README.md +3 -0
  401. package/schema/examples/workspace/ventures/northstar/venture.json +49 -0
  402. package/schema/examples/workspace/ventures/studio/accounts/bakery/account.json +18 -0
  403. package/schema/examples/workspace/ventures/studio/evidence/.gitkeep +0 -0
  404. package/schema/examples/workspace/ventures/studio/governance/.gitkeep +0 -0
  405. package/schema/examples/workspace/ventures/studio/knowledge/.gitkeep +0 -0
  406. package/schema/examples/workspace/ventures/studio/operations/.gitkeep +0 -0
  407. package/schema/examples/workspace/ventures/studio/print/knowledge/.gitkeep +0 -0
  408. package/schema/examples/workspace/ventures/studio/print/purpose/.gitkeep +0 -0
  409. package/schema/examples/workspace/ventures/studio/print/venture.json +37 -0
  410. package/schema/examples/workspace/ventures/studio/products/brand-care.json +19 -0
  411. package/schema/examples/workspace/ventures/studio/products/brand-kit.json +23 -0
  412. package/schema/examples/workspace/ventures/studio/provenance.jsonl +3 -0
  413. package/schema/examples/workspace/ventures/studio/purpose/.gitkeep +0 -0
  414. package/schema/examples/workspace/ventures/studio/venture.json +43 -0
  415. package/schema/examples/workspace/ventures/tandem/accounts/.gitkeep +0 -0
  416. package/schema/examples/workspace/ventures/tandem/evidence/README.md +3 -0
  417. package/schema/examples/workspace/ventures/tandem/governance/README.md +3 -0
  418. package/schema/examples/workspace/ventures/tandem/governance/agreements/dee-fast.md +3 -0
  419. package/schema/examples/workspace/ventures/tandem/governance/board.json +51 -0
  420. package/schema/examples/workspace/ventures/tandem/governance/departments/finance/charter.md +5 -0
  421. package/schema/examples/workspace/ventures/tandem/governance/departments/finance/department.json +5 -0
  422. package/schema/examples/workspace/ventures/tandem/governance/departments/primary/marketing-and-sales/charter.md +5 -0
  423. package/schema/examples/workspace/ventures/tandem/governance/departments/primary/marketing-and-sales/department.json +5 -0
  424. package/schema/examples/workspace/ventures/tandem/governance/exit.json +33 -0
  425. package/schema/examples/workspace/ventures/tandem/governance/founder-agreement.json +24 -0
  426. package/schema/examples/workspace/ventures/tandem/governance/founder-agreement.md +3 -0
  427. package/schema/examples/workspace/ventures/tandem/governance/ownership.json +131 -0
  428. package/schema/examples/workspace/ventures/tandem/governance/publication-policy.json +171 -0
  429. package/schema/examples/workspace/ventures/tandem/knowledge/README.md +3 -0
  430. package/schema/examples/workspace/ventures/tandem/knowledge/research/friends-feedback-2026-08.md +3 -0
  431. package/schema/examples/workspace/ventures/tandem/knowledge/research/pilot-2026-10.md +3 -0
  432. package/schema/examples/workspace/ventures/tandem/knowledge/research/problem-interviews-2026-09.md +20 -0
  433. package/schema/examples/workspace/ventures/tandem/knowledge/sources.json +8 -0
  434. package/schema/examples/workspace/ventures/tandem/knowledge/where-used.json +13 -0
  435. package/schema/examples/workspace/ventures/tandem/operations/README.md +3 -0
  436. package/schema/examples/workspace/ventures/tandem/operations/departments/finance/README.md +5 -0
  437. package/schema/examples/workspace/ventures/tandem/operations/departments/finance/department.json +5 -0
  438. package/schema/examples/workspace/ventures/tandem/operations/departments/primary/marketing-and-sales/README.md +5 -0
  439. package/schema/examples/workspace/ventures/tandem/operations/departments/primary/marketing-and-sales/department.json +5 -0
  440. package/schema/examples/workspace/ventures/tandem/pillars/brand.md +5 -0
  441. package/schema/examples/workspace/ventures/tandem/pillars/business.md +5 -0
  442. package/schema/examples/workspace/ventures/tandem/pillars/product.md +5 -0
  443. package/schema/examples/workspace/ventures/tandem/products/.gitkeep +0 -0
  444. package/schema/examples/workspace/ventures/tandem/products/shop-app.json +22 -0
  445. package/schema/examples/workspace/ventures/tandem/profile.md +5 -0
  446. package/schema/examples/workspace/ventures/tandem/provenance.jsonl +13 -0
  447. package/schema/examples/workspace/ventures/tandem/purpose/README.md +3 -0
  448. package/schema/examples/workspace/ventures/tandem/purpose/telos.json +78 -0
  449. package/schema/examples/workspace/ventures/tandem/purpose/validation/go-to-market.json +35 -0
  450. package/schema/examples/workspace/ventures/tandem/purpose/validation/pricing.json +37 -0
  451. package/schema/examples/workspace/ventures/tandem/purpose/validation/problem.json +74 -0
  452. package/schema/examples/workspace/ventures/tandem/purpose/validation/product-market-fit.json +66 -0
  453. package/schema/examples/workspace/ventures/tandem/purpose/validation/solution.json +33 -0
  454. package/schema/examples/workspace/ventures/tandem/purpose/validation/team.json +52 -0
  455. package/schema/examples/workspace/ventures/tandem/venture.json +79 -0
  456. package/schema/examples/workspace/ventures/woodworking/knowledge/.gitkeep +0 -0
  457. package/schema/examples/workspace/ventures/woodworking/venture.json +21 -0
  458. package/schema/examples/workspace/workspace.json +8 -0
  459. package/schema/exit.schema.json +74 -0
  460. package/schema/foundation.mjs +118 -0
  461. package/schema/founder-agreement.schema.json +83 -0
  462. package/schema/founder.schema.json +72 -0
  463. package/schema/frame.schema.json +240 -0
  464. package/schema/frames.mjs +228 -0
  465. package/schema/freshness-log.schema.json +40 -0
  466. package/schema/freshness-profiles.schema.json +44 -0
  467. package/schema/freshness.mjs +473 -0
  468. package/schema/fund-terms.schema.json +107 -0
  469. package/schema/fund-thesis.schema.json +87 -0
  470. package/schema/gate-drafts.mjs +130 -0
  471. package/schema/gate.mjs +133 -0
  472. package/schema/glossary.schema.json +25 -0
  473. package/schema/handoff.schema.json +239 -0
  474. package/schema/icp.schema.json +136 -0
  475. package/schema/idea-graph.schema.json +61 -0
  476. package/schema/init-venture.mjs +128 -0
  477. package/schema/integration.schema.json +143 -0
  478. package/schema/judgment.schema.json +38 -0
  479. package/schema/kit.schema.json +47 -0
  480. package/schema/kits.mjs +24 -0
  481. package/schema/knowledge-sources.schema.json +260 -0
  482. package/schema/layer.json +59 -0
  483. package/schema/layer.schema.json +119 -0
  484. package/schema/load-packages.mjs +26 -0
  485. package/schema/marketing-brand.schema.json +116 -0
  486. package/schema/marketing-sitemap.schema.json +232 -0
  487. package/schema/migrate-venture.mjs +192 -0
  488. package/schema/migrations/kit-to-package.mjs +94 -0
  489. package/schema/migrations/package-layout.mjs +86 -0
  490. package/schema/model-steps.mjs +717 -0
  491. package/schema/money-summary.schema.json +138 -0
  492. package/schema/naive-config.mjs +165 -0
  493. package/schema/naive-config.schema.json +268 -0
  494. package/schema/need-now.json +772 -0
  495. package/schema/need-now.mjs +108 -0
  496. package/schema/nextjs-status.schema.json +29 -0
  497. package/schema/ownership.schema.json +282 -0
  498. package/schema/packages.json +4 -0
  499. package/schema/packages.mjs +252 -0
  500. package/schema/payouts.mjs +91 -0
  501. package/schema/people.schema.json +86 -0
  502. package/schema/port-venture.mjs +161 -0
  503. package/schema/product.schema.json +223 -0
  504. package/schema/provenance-entry.schema.json +154 -0
  505. package/schema/public-assets.schema.json +76 -0
  506. package/schema/publication-policy.schema.json +293 -0
  507. package/schema/raw-source.schema.json +15 -0
  508. package/schema/reference.schema.json +115 -0
  509. package/schema/release-read.mjs +111 -0
  510. package/schema/releases.mjs +497 -0
  511. package/schema/route-aliases.schema.json +25 -0
  512. package/schema/run-handoff.mjs +51 -0
  513. package/schema/scaffold/defaults.json +54 -0
  514. package/schema/setup.mjs +164 -0
  515. package/schema/site-presence.schema.json +337 -0
  516. package/schema/stale.mjs +111 -0
  517. package/schema/start-release.mjs +41 -0
  518. package/schema/strategic-foundation.schema.json +74 -0
  519. package/schema/stream.schema.json +14 -0
  520. package/schema/structure.mjs +186 -0
  521. package/schema/systems-catalog.json +126 -0
  522. package/schema/systems-catalog.schema.json +78 -0
  523. package/schema/team-plan.schema.json +157 -0
  524. package/schema/telos.schema.json +197 -0
  525. package/schema/time-to-ready.mjs +93 -0
  526. package/schema/trigger.schema.json +44 -0
  527. package/schema/triggers.mjs +237 -0
  528. package/schema/upgrade-registry.schema.json +60 -0
  529. package/schema/upgrade-venture.mjs +107 -0
  530. package/schema/upgrades.json +69 -0
  531. package/schema/upgrades.mjs +385 -0
  532. package/schema/use-model.mjs +10 -0
  533. package/schema/validate.py +58 -0
  534. package/schema/validation-evidence.schema.json +123 -0
  535. package/schema/validation-go-to-market.schema.json +110 -0
  536. package/schema/validation-operations-readiness.schema.json +91 -0
  537. package/schema/validation-pricing.schema.json +114 -0
  538. package/schema/validation-problem.schema.json +118 -0
  539. package/schema/validation-product-market-fit.schema.json +135 -0
  540. package/schema/validation-solution.schema.json +79 -0
  541. package/schema/validation-team.schema.json +116 -0
  542. package/schema/venture-role.schema.json +64 -0
  543. package/schema/venture-type.mjs +62 -0
  544. package/schema/venture-types.json +346 -0
  545. package/schema/venture-types.schema.json +129 -0
  546. package/schema/venture.schema.json +460 -0
  547. package/schema/vocab/business-models.json +298 -0
  548. package/schema/where-used.schema.json +56 -0
  549. package/schema/workspace.schema.json +38 -0
@@ -0,0 +1,326 @@
1
+ ---
2
+ type: framework
3
+ ai-model: none
4
+ source: human
5
+ created: 2026-05-19T05:11:51Z
6
+ tags: [methodology, consultancy, discovery, intake, framework, conversation, business-understanding]
7
+ related-entities:
8
+ - "a project note"
9
+ - "[[everything-ecosystem]]"
10
+ related-checklists:
11
+ - "[[vault-and-tooling-consultancy-setup]]"
12
+ status: living-document
13
+ ---
14
+
15
+ # Business Discovery Framework
16
+
17
+ A conversation framework for understanding another operator's business comprehensively enough to build their vault and systems on top of it. Industry-agnostic structure with industry-specific addenda.
18
+
19
+ This is the tool the consultant opens during a discovery / intake session. It is *not a script*. It's a structure that ensures the conversation surfaces what needs to be surfaced.
20
+
21
+ ---
22
+
23
+ ## When to use this
24
+
25
+ - First in-depth session with a new operator
26
+ - Re-engagement with an existing operator after a major business change
27
+ - Diagnostic when an existing operator feels stuck and isn't sure why
28
+
29
+ ## How to use it
30
+
31
+ - **Open this doc and the checklist** (`vault-and-tooling-consultancy-setup.md`) side-by-side at the start of the session
32
+ - **Run the layers in order** for a first session; you can jump between layers in later sessions
33
+ - **Take notes directly in the operator's vault** — they see capture happening; this enacts the data sovereignty principle
34
+ - **Use their own words** wherever possible; don't translate to methodology vocabulary in real-time
35
+ - **Don't fill silences too quickly** — operators often surface the most useful answers when given thinking room
36
+
37
+ Expect 60-120 minutes for a first session covering all 7 layers. If you have less time, prioritize Layers 1, 3, 4, and 7.
38
+
39
+ ---
40
+
41
+ ## The seven layers
42
+
43
+ ### Layer 1 — The Vivid Present
44
+
45
+ **Purpose**: get the operator talking comfortably; surface ops, customers, tools, time-use, energy, frustrations, and joys in one pass.
46
+
47
+ **Magic prompt**: *"Walk me through what a typical Tuesday looks like — from when you wake up until you stop working."*
48
+
49
+ **Follow-on prompts**:
50
+ - "Walk me through what happens when a new client first contacts you — from their first message to their first visit."
51
+ - "What's the most recent thing you did for the business, in the last 24 hours?"
52
+ - "What did this week look like? Last week?"
53
+
54
+ **What to listen for**: tools mentioned in passing, time of day they work, energy peaks/valleys, who else is involved, recurring frustrations they don't even name as frustrations.
55
+
56
+ ### Layer 2 — The Full Surface
57
+
58
+ **Purpose**: factual picture of the business — what, who, when, where, how much, with whom.
59
+
60
+ **Prompts**:
61
+
62
+ - **What** — "What services do you offer, and what does each one cost?"
63
+ - **Who** — "How many active clients do you have right now? How many are recurring?"
64
+ - **When** — "What does your schedule look like? Are there busy days/seasons?"
65
+ - **Where** — "What geography do you serve? How far do you travel? Do you have a physical location?"
66
+ - **How much** — "Roughly, what's a good month vs. a tough month?" (only if comfortable — calibrate to relationship)
67
+ - **With whom** — "Are you the only person doing this, or do you have help? Contractors? Partners?"
68
+
69
+ **Optional deeper cuts**:
70
+ - "What's your client mix — long-term recurring, one-time, mix?"
71
+ - "How do new clients usually find you?"
72
+ - "What's your booking lead time — same-day, week ahead, month ahead?"
73
+
74
+ **What to listen for**: revenue model (recurring vs. transactional), capacity constraints (solo vs. team), geographic scope, customer acquisition channels.
75
+
76
+ ### Layer 3 — The Pain & Friction
77
+
78
+ **Purpose**: surface where the vault + methodology will deliver immediate value. Pain points point to where to build first.
79
+
80
+ **Prompts**:
81
+
82
+ - "What part of the business takes way more time than it should?"
83
+ - "What's something that keeps slipping through the cracks?"
84
+ - "If you could wave a wand and eliminate one part of your job, what would it be?"
85
+ - "Tell me about the last time something went wrong — a missed visit, a billing issue, a lost client. What happened?"
86
+ - "What's the Sunday-night feeling about the week ahead?" *(emotional temperature check)*
87
+ - "What part of running the business do you dread?"
88
+
89
+ **What to listen for**: repeated manual tasks (automation candidates), forgotten/dropped things (capture-system candidates), high-stakes errors (process candidates), emotional weight (coaching candidates).
90
+
91
+ ### Layer 4 — The Dreams (apply BASED)
92
+
93
+ **Purpose**: surface the operator's actual ambition, uncensored. This is the Phase 0C work — refuse premature narrowing.
94
+
95
+ **Prompts** (deploy progressively):
96
+
97
+ - "If you could design the business of your dreams, with zero constraints on money, time, or possibility — what does it look like in five years?"
98
+ - "What would make you say 'I made it'?"
99
+ - "What's the most ambitious version of this you've ever imagined, even if you've never said it out loud?"
100
+ - "If a customer wrote you a review you'd love to receive — what does it say?"
101
+ - "What would you build if you knew you couldn't fail?"
102
+
103
+ **Watch for self-censorship cues**:
104
+
105
+ | Cue | What it usually means | Gentle redirect |
106
+ |---|---|---|
107
+ | "I just want to..." | Pre-narrowed | "What if 'just' wasn't a limit — what would you actually want?" |
108
+ | "Realistically..." | Pre-narrowing | "Set realism aside for a sec — what's the dream?" |
109
+ | "I don't know if I could..." | Premature humility | "If you could, what would it be?" |
110
+ | "That's probably too..." | Premature dismissal | "Say it anyway — let's see what it sounds like." |
111
+ | "But the market is..." | Pre-defensiveness | "Forget the market for a moment — what's the version of this you'd build for yourself?" |
112
+
113
+ **Apply each BASED letter as a check on what you hear**:
114
+
115
+ - **Broad** — is the aperture as wide as it could be?
116
+ - **Audacious** — would they be willing to say this in public?
117
+ - **Silly** — is there a playful / Willy-Wonka-tier vivid version of this?
118
+ - **Egotistical** — are they willing to put themselves at the center?
119
+ - **Delusional** — are they refusing current evidence long enough to imagine what isn't yet?
120
+
121
+ **Note**: don't say "BASED" or explain the framework to the operator. You're applying it as the consultant; the operator just sees you asking thoughtful, generative questions.
122
+
123
+ ### Layer 5 — The Gap
124
+
125
+ **Purpose**: surface what's between today (Layer 1-2) and the dream (Layer 4).
126
+
127
+ **Prompts**:
128
+
129
+ - "What's standing between you and that dream version of the business?"
130
+ - "What's one thing that, if solved, would make the biggest difference?"
131
+ - "Is the bottleneck time, money, knowledge, energy, people, or something else?"
132
+ - "What have you tried that didn't work?"
133
+ - "What do you wish you knew that you don't?"
134
+
135
+ **What to listen for**: the *specific* shape of the bottleneck. "I need more clients" is vague; "I lose every Friday to billing reconciliation" is specific. Specificity is the substrate of action.
136
+
137
+ ### Layer 6 — The Next Step
138
+
139
+ **Purpose**: identify the smallest immediate action that moves the needle, so the operator walks away with momentum, not just structure.
140
+
141
+ **Prompts**:
142
+
143
+ - "If we did ONE thing today that would make this week better, what would it be?"
144
+ - "What's a small win that would feel disproportionately good?"
145
+ - "What's something you've been meaning to do but haven't gotten around to?"
146
+ - "What's the smallest version of the dream we could start on today?"
147
+
148
+ This conversation produces **the first planned session** for the operator's vault — concrete, scoped, actionable.
149
+
150
+ ### Layer 7 — Tooling Inventory
151
+
152
+ **Purpose**: groundwork for connector setup; understand what already exists vs. what needs to be built.
153
+
154
+ **Prompts**:
155
+
156
+ - "Walk me through every tool, app, or piece of software you use for the business."
157
+ - "Where do client records live? Schedules? Payments? Photos? Communications?"
158
+ - "Phone setup — separate business line, or personal?"
159
+ - "How do you take payment?"
160
+ - "Business email? Social accounts? Website?"
161
+ - "What tools do you wish you used but haven't set up?"
162
+
163
+ **Categories to walk through systematically**:
164
+ - Scheduling / calendar
165
+ - Client intake / forms
166
+ - Client database / CRM
167
+ - Payment processing
168
+ - Accounting / bookkeeping
169
+ - Tax preparation
170
+ - Communications (email, SMS, social DMs)
171
+ - Photo / file storage
172
+ - Marketing (social, email lists, ads)
173
+ - Supplier portals / inventory
174
+ - Insurance / licensing portals
175
+ - Banking
176
+ - Domain / website / hosting
177
+
178
+ For each tool, capture: what's used, who else has access, what data lives there, whether they're happy with it. This feeds Phase 5 of the consultancy checklist (external tool connections).
179
+
180
+ ---
181
+
182
+ ## Capture protocol
183
+
184
+ During the session:
185
+
186
+ 1. **Open her vault. Create a new file**: `_sessions/raw/<date>-discovery-session.md`
187
+ 2. **Take notes there in real time**, in her own words
188
+ 3. **Don't pre-categorize** — capture raw; organize later
189
+ 4. **Use timestamps** for major shifts in topic (helpful when reviewing)
190
+ 5. **Don't try to be comprehensive in-line** — flag for follow-up rather than chasing every thread
191
+
192
+ After the conversation, take a 10-15 minute break and synthesize:
193
+
194
+ - Pull observations into the entity-profile draft
195
+ - Pull ideas into `_ideas/`
196
+ - Pull next-steps into `_sessions/planned/`
197
+ - Pull dreams into a draft VISION_SPEC
198
+
199
+ ---
200
+
201
+ ## Output artifacts by end of session
202
+
203
+ By the time the operator leaves the first session, her vault should contain:
204
+
205
+ - [ ] **`entity-profile.md`** for the business (concept or scoped stage)
206
+ - [ ] **3-5 idea notes** in `_ideas/` (captured from Layers 3, 4, 5)
207
+ - [ ] **1-2 planned sessions** in `_sessions/planned/` (from Layer 6)
208
+ - [ ] **Session-log entry** for today's discovery session
209
+ - [ ] **VISION_SPEC draft** (rough — Phase 0C output from Layer 4)
210
+ - [ ] **Tooling inventory note** at `_meta/tooling-inventory.md`
211
+ - [ ] **Pain points / friction note** for prioritization
212
+ - [ ] **`code-pointer.md` placeholder** if any tech work will follow
213
+
214
+ The vault should feel *populated*, not empty. She should be able to open it and see her business reflected back.
215
+
216
+ ---
217
+
218
+ ## Industry-specific addenda
219
+
220
+ ### Pet-care / pet-sitting (tomorrow's friend)
221
+
222
+ Specific questions to surface pet-care nuance:
223
+
224
+ - **Pet types served** — dogs only? Cats? Exotic (reptiles, birds, fish)? Special needs?
225
+ - **Service types** — boarding, drop-in visits, dog walks, overnight stays, transport, training, grooming?
226
+ - **Visit cadence** — daily for some clients? Weekly? Ad-hoc?
227
+ - **Key handoff protocol** — does she hold keys, use lockboxes, smart locks?
228
+ - **Insurance + bonding** — Pet Sitters International? Local liability? Bonded for key-holding?
229
+ - **Vet partnerships** — does she have go-to vets for emergencies? Referral relationships?
230
+ - **Emergency protocols** — what happens when a pet gets injured / loose / sick during her visit?
231
+ - **Vehicle / travel** — does she travel between clients? Mileage tracked? Vehicle insured commercially?
232
+ - **Equipment owned** — leashes, treats, first aid, transport carriers, cleanup supplies?
233
+ - **Background check / certifications** — pet CPR? Pet first aid? Background check for client trust?
234
+ - **Pet info storage** — where do allergy / medication / behavior / vet info live today?
235
+ - **Photo / update protocol** — does she send daily photos? Update clients in real-time?
236
+ - **Pricing structure** — per-visit, per-day, monthly package, sliding by service?
237
+ - **Geographic radius** — how far does she travel? Strict limits?
238
+ - **Seasonal patterns** — summer/holiday peaks? Slow seasons?
239
+
240
+ ### Restaurant / food-service (future)
241
+
242
+ - Menu and recipe versioning
243
+ - Vendor / supplier relationships
244
+ - Health code / food safety
245
+ - Shift scheduling
246
+ - POS integration
247
+ - Liquor license / age verification
248
+
249
+ ### Solo consulting (future)
250
+
251
+ - Service offerings / packaging
252
+ - Client intake / contracts
253
+ - Time tracking / invoicing
254
+ - Knowledge management *is* the product
255
+
256
+ ### E-commerce / D2C (future)
257
+
258
+ - Product catalog
259
+ - Inventory
260
+ - Fulfillment
261
+ - Customer support
262
+
263
+ ### Software / SaaS (future)
264
+
265
+ - Existing SAD applies directly
266
+ - Code repo, CI/CD, deploy
267
+ - Customer onboarding flows
268
+
269
+ ---
270
+
271
+ ## Anti-patterns
272
+
273
+ Things to avoid during the discovery session:
274
+
275
+ - **Don't lead with the methodology.** Lead with her business. The methodology is invisible scaffolding.
276
+ - **Don't translate her vocabulary to yours.** Capture in her language; harmonize later.
277
+ - **Don't fill silences too quickly.** The best answers come after a pause.
278
+ - **Don't make it feel like an interview or audit.** This is a generative conversation.
279
+ - **Don't commit to building anything mid-session.** Capture, decide between sessions.
280
+ - **Don't pre-narrow her BASED ambition** with "well, realistically..."
281
+ - **Don't pretend you have answers you don't have.** "I don't know — let's figure it out" is a strong consultant move.
282
+ - **Don't try to cover all 7 layers if it's killing the energy.** A great Layer 1-4 + Layer 7 is better than a forced full pass.
283
+ - **Don't tell her the Wonka story today.** The brand isn't ready; the methodology is doing the work.
284
+
285
+ ---
286
+
287
+ ## Variations by operator type
288
+
289
+ | Operator type | Adjustments |
290
+ |---|---|
291
+ | **Solo founder** | All layers as-is |
292
+ | **Team-based** | Add: "Walk me through your team — roles, who does what, who you trust with what." |
293
+ | **Service business** | Standard framework applies |
294
+ | **Product business** | Layer 2 emphasis on inventory / catalog / fulfillment |
295
+ | **Pre-launch** | Layer 1 → "what does a typical week look like *now*, even though the business isn't started yet?" |
296
+ | **Running business** | Standard framework |
297
+ | **Local** | Layer 2: emphasis on geographic constraints and community |
298
+ | **Online / national** | Layer 2: emphasis on channel mix and customer acquisition |
299
+
300
+ ---
301
+
302
+ ## Pre-session prep (30 minutes before)
303
+
304
+ A quick prep ritual before the session:
305
+
306
+ - [ ] Open this framework + the consultancy checklist
307
+ - [ ] Confirm her machine has Obsidian (or be ready to install)
308
+ - [ ] Confirm Claude Code / Cowork is reachable
309
+ - [ ] Have a notebook ready (in case her vault isn't accessible at start)
310
+ - [ ] Hydrate; restroom
311
+ - [ ] Set time expectation with her ("This will probably take 2-3 hours; let me know when you need breaks")
312
+ - [ ] Note your own energy — discovery work is dense; pace matters
313
+ - [ ] Make sure no other Claude session has heavy state competing for your attention
314
+
315
+ ---
316
+
317
+ ## After-session protocol
318
+
319
+ Within 24 hours of the discovery session:
320
+
321
+ - [ ] Synthesize the raw session notes into the artifacts listed in *Output artifacts*
322
+ - [ ] Send her the entity-profile draft + VISION_SPEC draft for review
323
+ - [ ] Schedule the follow-up session (this is when actual setup work happens)
324
+ - [ ] Add your own retrospective notes to `a consulting practice/_ideas/`: what worked, what didn't, what's missing from this framework
325
+
326
+ The framework gets better every time you use it. Refine.
@@ -0,0 +1,74 @@
1
+ ---
2
+ type: framework
3
+ source: hybrid
4
+ created: 2026-10-28T19:44:02Z
5
+ ai-model: claude-opus-5.5
6
+ tags: [everything-ecosystem, purpose, idea-map, idea-graph, routing, kanban, typesafe, jev]
7
+ description: "From an idea dump to next steps: how Naive parses the dump (Jev), structures it as an idea graph, routes each idea to its destination in the framework, and shows the destinations and the decision docket as Kanban boards. Version 0.1.0, unevaluated."
8
+ ---
9
+
10
+ # From an idea dump to next steps
11
+
12
+ Version 0.1.0, ours and unevaluated (EE-059, EE-060, EE-061). Each step has its own payoff for the founder, so each is worth doing before the next exists.
13
+
14
+ | Step | File | What the founder gets | Command |
15
+ |---|---|---|---|
16
+ | Idea dump | `purpose/ideas/dump.md` | Everything out of their head, kept verbatim | (the founder writes it) |
17
+ | Idea map | `purpose/ideas/map.mdx` | Their ideas on one canvas, by pillar and department: strengths and gaps at a glance | `purpose/ideas` |
18
+ | Idea graph | `purpose/ideas/graph.json` | Structure on the same ideas: what builds on what, what to develop next, what moves in order and what moves on its own | `purpose/ideas/graph` |
19
+ | Idea routes | computed, not stored | Next steps: each idea at its destination in the framework, each destination with the one step that moves it | `purpose/ideas/routes` |
20
+
21
+ The dump and the map stay loose: no decisions. Decisions begin where the routes reach the framework. Time-based roadmaps come later (deferred for the hackathon, 2026-10-28).
22
+
23
+ ## 1. Parsing the dump (Jev)
24
+
25
+ The rules travel with every Jev request as `state.guidelines` (`conventions.json` `guidelines`).
26
+
27
+ - **The dump is the founder's, not a prompt.** Every idea stays verbatim. Naive never rewrites, merges or summarises an idea; the `ideas_verbatim` eval checks it.
28
+ - **One line or bullet is one idea.** A heading names a section. A hard-wrapped continuation joins its line. A paragraph over 200 characters is split into sentences, grouped under 160, never reworded.
29
+ - **Tag by what an idea is mainly about.** Jev answers one typed question per idea, per department, per record ("Is the idea … mainly about …?"). An idea keeps at most two departments and three records, each at or above 0.8, strongest first. Its pillar follows its first department.
30
+ - **Existing means the founder's own.** An idea "exists" only if the founder or their team has built, launched or sold it. A competitor's product does not count.
31
+ - **Untagged ideas stay loose.** They stay on the map. They are never forced into a record.
32
+ - **Without Jev,** an agent tags with the same vocabulary. Unknown tags are dropped.
33
+
34
+ ## 2. Dump to graph
35
+
36
+ - **An idea builds on another only when it needs that idea's answer first.** Jev answers one question per ordered pair of ideas, with a bar of 0.5. Without Jev, Naive's record order supplies the edges (`ORDER` in `graph.mjs`).
37
+ - **The graph stays acyclic.** Edges are added strongest first, an edge that would close a cycle is dropped, and only direct dependencies are kept (transitive reduction).
38
+ - **It is a Merkle DAG.** An idea's hash covers its text and the hashes of what it builds on, so a change upstream changes every hash below it.
39
+ - **Signal.** Each idea is weighted by what the phase needs of its records (0.35), how much builds on it (0.25), how concrete it is (0.25) and how much of the dump circles it (0.15).
40
+ - **Lanes.** Ideas tied by dependencies form a lane that moves in order. An idea tied to nothing moves on its own.
41
+
42
+ ## 3. Graph to routes
43
+
44
+ Every tagged idea goes to the records it feeds. A record is a destination: the problem, who it is for, products, the core promise, vision, the solution, go to market, pricing, the team, alignment and brand. The routing table is `conventions.json` `records`: each entry has a title, the route that writes the record, and the decisions it settles (foundation statements and Naive's product and team questions). Any decision an agent proposed about that record also belongs to it.
45
+
46
+ A destination's stage comes from the framework's own state, never from a guess:
47
+
48
+ | Stage | When | Next step |
49
+ |---|---|---|
50
+ | Routed | The destination has ideas, and nothing has been drafted or proposed for it | An agent drafts the record from those ideas. The draft waits for the founder. |
51
+ | Drafted | An agent's draft or wording waits for the founder | The founder accepts, confirms or approves it (about a minute) |
52
+ | Your decision | A decision only a person can make, with no draft | The founder decides, in their own words |
53
+ | Waiting | Another decision holds it, or its phase has not come | Nothing until the holder settles |
54
+ | Done | The record is written and nothing about it is open | None |
55
+
56
+ A destination moves **in order** when it sits on the fail-closed path or its ideas share a lane that builds in order. Its number is its place in Naive's record order. It moves **on its own** when its decisions fail open (the team question) or its ideas stand alone.
57
+
58
+ ## 4. Routes to the decision docket
59
+
60
+ The docket is every open decision, staged the same way and ranked as before (EE-057).
61
+
62
+ - **Traced to ideas.** Each decision traces back to the ideas it comes from: its own `ideas` field (decision records, EE-061), the `i-NN` ids its question and answer cite, or else its destination's ideas.
63
+ - **Agent proposals must carry `ideas`.** The `decisions_traced` eval checks that every agent proposal cites ideas that exist.
64
+
65
+ ## The boards
66
+
67
+ `node interface/demo/board.mjs` serves four pages:
68
+
69
+ - `/map`: the idea map;
70
+ - `/graph`: the idea graph;
71
+ - `/kanban`: the destinations and the docket as Kanban boards;
72
+ - `/`: the decision board.
73
+
74
+ The map and the graph use React Flow, because their value is structure on a canvas. The Kanban boards are plain columns: a board is a list per stage, and dragging a card would bypass the framework, since cards move only when the founder or an agent does the step.
@@ -0,0 +1,146 @@
1
+ {
2
+ "version": "0.1.0",
3
+ "note": "The tags an idea map uses (EE-059): Naive's own conventions, never free-form labels. Each idea in a founder's idea dump is tagged with the departments it bears on (operations/departments.json, APQC with Porter's value chain), the records it feeds (schema/data-model.json), and whether it describes something that already exists. Its pillar follows from its first department. Each idea keeps at most max.departments departments and max.records records, strongest first, at or above the threshold. Version 0.x, ours and unevaluated.",
4
+ "threshold": 0.8,
5
+ "pillars": {
6
+ "product": [
7
+ "products",
8
+ "it",
9
+ "service-delivery",
10
+ "supply-chain"
11
+ ],
12
+ "brand": [
13
+ "marketing-and-sales",
14
+ "customer-service",
15
+ "external-relationships"
16
+ ],
17
+ "business": [
18
+ "strategy",
19
+ "finance",
20
+ "human-capital",
21
+ "assets",
22
+ "risk-and-compliance",
23
+ "capabilities"
24
+ ]
25
+ },
26
+ "departments": {
27
+ "strategy": "the venture's direction, vision, positioning against competitors, or what to do first",
28
+ "products": "designing, building or improving a product, feature or service the venture offers",
29
+ "marketing-and-sales": "reaching, persuading or selling to customers: channels, content, campaigns, launches, sales",
30
+ "supply-chain": "sourcing, making or moving physical goods",
31
+ "service-delivery": "delivering a service to customers day to day",
32
+ "customer-service": "supporting, onboarding or keeping customers after they buy",
33
+ "human-capital": "people: cofounders, hiring, roles, culture, the founder's own development",
34
+ "it": "the technology, data, infrastructure, integrations or AI the venture runs on",
35
+ "finance": "money: pricing, revenue, costs, funding, investors",
36
+ "assets": "property, equipment or other assets the venture buys or owns",
37
+ "risk-and-compliance": "legal, regulatory, privacy, security or other risks",
38
+ "external-relationships": "partners, community, investors relations, the public or government",
39
+ "capabilities": "how the venture improves itself: processes, knowledge, quality, measurement"
40
+ },
41
+ "records": {
42
+ "validation-problem": {
43
+ "title": "The problem",
44
+ "route": "purpose/validation/problem",
45
+ "about": "a problem or pain that people have",
46
+ "decisions": [
47
+ "foundation-problem"
48
+ ]
49
+ },
50
+ "icp": {
51
+ "title": "Who it is for",
52
+ "route": "purpose/icp",
53
+ "about": "who the customer, user or audience is",
54
+ "decisions": [
55
+ "foundation-icp"
56
+ ]
57
+ },
58
+ "product": {
59
+ "title": "Products",
60
+ "route": "purpose/product",
61
+ "about": "a specific product, feature or offering",
62
+ "decisions": [
63
+ "foundation-products",
64
+ "product-exists",
65
+ "flagship",
66
+ "foundation-business-models",
67
+ "foundation-markets"
68
+ ]
69
+ },
70
+ "venture-core": {
71
+ "title": "The core promise",
72
+ "route": "venture.json core",
73
+ "about": "the venture's core promise, who it is promised to, or the competence that makes it deliverable",
74
+ "decisions": [
75
+ "core-product",
76
+ "foundation-mission",
77
+ "foundation-promised-to",
78
+ "foundation-competence"
79
+ ]
80
+ },
81
+ "telos": {
82
+ "title": "Vision",
83
+ "route": "purpose/telos",
84
+ "about": "the long-run vision, end state, ambition or exit",
85
+ "decisions": [
86
+ "foundation-vision",
87
+ "foundation-exit-criteria"
88
+ ]
89
+ },
90
+ "validation-solution": {
91
+ "title": "The solution",
92
+ "route": "purpose/validation/solution",
93
+ "about": "how a problem would be solved",
94
+ "decisions": []
95
+ },
96
+ "validation-go-to-market": {
97
+ "title": "Go to market",
98
+ "route": "purpose/validation/go-to-market",
99
+ "about": "how the venture would reach and win its first customers",
100
+ "decisions": [
101
+ "foundation-channels"
102
+ ]
103
+ },
104
+ "validation-pricing": {
105
+ "title": "Pricing",
106
+ "route": "purpose/validation/pricing",
107
+ "about": "a price, a business model or how the venture makes money",
108
+ "decisions": []
109
+ },
110
+ "validation-team": {
111
+ "title": "The team",
112
+ "route": "purpose/validation/team",
113
+ "about": "who would build or run the venture",
114
+ "decisions": [
115
+ "founding-team"
116
+ ]
117
+ },
118
+ "alignment": {
119
+ "title": "Alignment",
120
+ "route": "purpose/alignment",
121
+ "about": "principles, values, or what the venture must never do",
122
+ "decisions": [
123
+ "foundation-alignment"
124
+ ]
125
+ },
126
+ "brand": {
127
+ "title": "Brand",
128
+ "route": "venture.json brand",
129
+ "about": "the venture's name, tagline, story or look",
130
+ "decisions": [
131
+ "foundation-tagline"
132
+ ]
133
+ }
134
+ },
135
+ "exists": "the founder (or their team) has already built, launched or sold this product, prototype or pilot themselves; a competitor's product does not count",
136
+ "max": {
137
+ "departments": 2,
138
+ "records": 3
139
+ },
140
+ "guidelines": {
141
+ "dump": "The idea dump is the founder's, not a prompt: every idea stays verbatim. One line or bullet is one idea; a heading names a section; a long paragraph is split into sentences, never rewritten.",
142
+ "tags": "Tag an idea with what it is mainly about, not everything it touches: at most two departments and three records, each at or above the threshold. An idea about a competitor is not an existing product. An idea with no tag stays on the map, loose; it is never forced into a record.",
143
+ "graph": "An idea builds on another only when it needs that idea's answer first. Dependencies are kept acyclic, strongest first, and reduced to the direct ones. Ideas tied by dependencies form a lane that moves in order; an idea with no tie moves on its own.",
144
+ "routes": "Each tagged idea is routed to the records it feeds, the framework's destinations. A destination's stage comes from the framework's own state: routed (ideas, nothing drafted), drafted (an agent's draft awaits the founder), yours (a decision only a person can make), waiting (held by another decision), done. The next step is the framework's, never invented."
145
+ }
146
+ }