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.
- package/AGENTS.md +62 -0
- package/LICENSE +21 -0
- package/README.md +37 -2
- package/docs/decisions/decisions.json +888 -0
- package/docs/ontology.json +796 -0
- package/docs/ontology.md +163 -0
- package/docs/reference/ROUTES.md +124 -0
- package/evidence/benchmarks/2026-10-27-golden.jev.after-catalog-fix.json +558 -0
- package/evidence/benchmarks/2026-10-27-golden.jev.json +501 -0
- package/evidence/benchmarks/2026-10-27-golden.reasoning-answers.json +177 -0
- package/evidence/benchmarks/JEV_VS_REASONING_MODEL_2026-10-27.md +68 -0
- package/evidence/capabilities/agent-capabilities.json +86 -0
- package/evidence/design-documents.registry.json +2896 -0
- package/evidence/evals/evals.json +25 -0
- package/evidence/evals/harness-evals.json +140 -0
- package/evidence/layer.json +51 -0
- package/evidence/skills/agent-capabilities/SKILL.md +35 -0
- package/evidence/skills/design-coverage/SKILL.md +57 -0
- package/evidence/skills/design-coverage/check.mjs +192 -0
- package/evidence/skills/design-coverage/scan.mjs +45 -0
- package/evidence/skills/fidelity-ladder-audit/SKILL.md +121 -0
- package/evidence/skills/fidelity-ladder-audit/ladder-census.mjs +180 -0
- package/evidence/skills/findability/SKILL.md +32 -0
- package/evidence/skills/findability/inventory.rb +41 -0
- package/evidence/skills/foreshadowing-audit/SKILL.md +183 -0
- package/evidence/skills/metrics-review/SKILL.md +177 -0
- package/evidence/tooling/integrations.json +153 -0
- package/governance/layer.json +102 -0
- package/governance/references/references.json +26 -0
- package/governance/skills/board-design/SKILL.md +68 -0
- package/governance/skills/brand-pillar/SKILL.md +90 -0
- package/governance/skills/business-pillar/SKILL.md +96 -0
- package/governance/skills/chief-of-staff/SKILL.md +45 -0
- package/governance/skills/cofounder-structure/SKILL.md +64 -0
- package/governance/skills/cross-pillar-tradeoff/SKILL.md +168 -0
- package/governance/skills/equity-and-share-classes/SKILL.md +68 -0
- package/governance/skills/executive-roles/SKILL.md +95 -0
- package/governance/skills/exit-planning/SKILL.md +66 -0
- package/governance/skills/financing-and-investor-rights/SKILL.md +73 -0
- package/governance/skills/office-hours-mode/SKILL.md +113 -0
- package/governance/skills/product-pillar/SKILL.md +81 -0
- package/governance/skills/publication-policy/SKILL.md +63 -0
- package/governance/skills/role-and-candidate-authoring/SKILL.md +198 -0
- package/governance/skills/stakeholder-update/SKILL.md +177 -0
- package/governance/tooling/integrations.json +37 -0
- package/governance/venture-template/AGENT_ROLES_AND_DECISION_RIGHTS.md +58 -0
- package/governance/venture-template/COMPANY_VAULT_DEFINITION_2026-10-25.md +204 -0
- package/governance/venture-template/README.md +74 -0
- package/governance/venture-template/decision-rights.json +186 -0
- package/governance/venture-template/index.md +151 -0
- package/governance/venture-template/pillars/brand.md +209 -0
- package/governance/venture-template/pillars/business.md +255 -0
- package/governance/venture-template/pillars/product.md +254 -0
- package/governance/venture-template/render-roles.py +11 -0
- package/governance/venture-template/roles/README.md +85 -0
- package/governance/venture-template/roles/agent-roles.json +202 -0
- package/governance/venture-template/roles/ceo.md +163 -0
- package/governance/venture-template/roles/chief-of-staff.md +153 -0
- package/governance/venture-template/roles/cmo.md +165 -0
- package/governance/venture-template/roles/coo.md +189 -0
- package/governance/venture-template/roles/cto.md +158 -0
- package/governance/venture-template/roles/department-head.md +47 -0
- package/governance/venture-template/roles/forward-deployed-engineer.md +51 -0
- package/governance/venture-template/roles/founder.md +173 -0
- package/governance/venture-template/roles/hr-manager.md +49 -0
- package/governance/venture-template/roles/talent-acquisition-manager.md +50 -0
- package/governance/venture-template/roles/venture-roles.json +62 -0
- package/interface/acting.mjs +83 -0
- package/interface/adapters/claude-code.json +16 -0
- package/interface/adapters/codex.json +14 -0
- package/interface/adapters/cursor.json +16 -0
- package/interface/adapters.mjs +182 -0
- package/interface/api/server.mjs +71 -0
- package/interface/boundaries.mjs +218 -0
- package/interface/brand.mjs +214 -0
- package/interface/cli/find-venture.mjs +15 -0
- package/interface/cli/freshness.mjs +59 -0
- package/interface/cli/guard.mjs +6 -0
- package/interface/cli/mentura.mjs +341 -0
- package/interface/cli/naive.mjs +194 -0
- package/interface/context.mjs +524 -0
- package/interface/demo/board.mjs +581 -0
- package/interface/demo/decision-harness.mjs +91 -0
- package/interface/demo/live-agent.mjs +47 -0
- package/interface/dev/setup.mjs +84 -0
- package/interface/gate-hooks.mjs +36 -0
- package/interface/harness/evals.mjs +90 -0
- package/interface/harness/examples/pt-no-shows.dump.md +19 -0
- package/interface/harness/run.mjs +313 -0
- package/interface/harness/site.mjs +59 -0
- package/interface/instrumentation.mjs +86 -0
- package/interface/kit-boundary.mjs +73 -0
- package/interface/layer.json +37 -0
- package/interface/mcp/server.mjs +162 -0
- package/interface/operator-console/README.md +58 -0
- package/interface/package-routes.mjs +196 -0
- package/interface/provenance.mjs +65 -0
- package/interface/reads.mjs +173 -0
- package/interface/references/references.json +28 -0
- package/interface/release-card.mjs +42 -0
- package/interface/route-aliases.json +32 -0
- package/interface/router.mjs +653 -0
- package/interface/skills/install-mentura/SKILL.md +88 -0
- package/interface/skills/naive-setup/SKILL.md +71 -0
- package/interface/skills/naive-setup/artifact.html +83 -0
- package/interface/tooling/integrations.json +112 -0
- package/interface/vitals.mjs +115 -0
- package/interface/writes.mjs +190 -0
- package/knowledge/connectors/README.md +54 -0
- package/knowledge/connectors/catalog.mjs +118 -0
- package/knowledge/connectors/contract.mjs +56 -0
- package/knowledge/connectors/eval.mjs +176 -0
- package/knowledge/connectors/filesystem.mjs +79 -0
- package/knowledge/connectors/index.mjs +102 -0
- package/knowledge/connectors/resolve.mjs +44 -0
- package/knowledge/connectors/suite.mjs +80 -0
- package/knowledge/freshness.json +85 -0
- package/knowledge/layer.json +50 -0
- package/knowledge/skills/find-reference/SKILL.md +38 -0
- package/knowledge/skills/industry-awareness/SKILL.md +277 -0
- package/knowledge/templates/glossary.md +23 -0
- package/knowledge/tooling/integrations.json +127 -0
- package/knowledge/tooling/questions.md +46 -0
- package/operations/FOUNDER_OPERATING_MODEL_CAMPAIGN_2026-10-14.md +16 -0
- package/operations/departments.json +162 -0
- package/operations/handoff-v2.md +93 -0
- package/operations/layer.json +67 -0
- package/operations/marketing/check-public.mjs +68 -0
- package/operations/marketing/site/README.md +86 -0
- package/operations/marketing/site/matrix.json +731 -0
- package/operations/marketing/site/plan.mjs +117 -0
- package/operations/marketing/site/presence.mjs +252 -0
- package/operations/references/references.json +45 -0
- package/operations/skills/recruiting/SKILL.md +32 -0
- package/operations/skills/team-design/SKILL.md +36 -0
- package/operations/skills/tool-selection/SKILL.md +46 -0
- package/operations/templates/marketing-brand.md +46 -0
- package/operations/templates/public-assets.md +39 -0
- package/operations/templates/recruiting-brief.md +35 -0
- package/operations/tooling/integrations.json +158 -0
- package/package.json +59 -4
- package/packages/catalog.json +280 -0
- package/packages/cofounder/package.json +42 -0
- package/packages/counsel/package.json +47 -0
- package/packages/customers/package.json +41 -0
- package/packages/deals/package.json +27 -0
- package/packages/decisions/package.json +28 -0
- package/packages/engineering/package.json +41 -0
- package/packages/evidence/package.json +17 -0
- package/packages/finance/frames/fund-without-ceding-control.frame.json +177 -0
- package/packages/finance/package.json +48 -0
- package/packages/foundation/package.json +59 -0
- package/packages/fund/package.json +48 -0
- package/packages/investor/package.json +57 -0
- package/packages/investors/package.json +21 -0
- package/packages/legal/package.json +73 -0
- package/packages/marketing/package.json +63 -0
- package/packages/money/package.json +42 -0
- package/packages/operations/package.json +74 -0
- package/packages/partner/package.json +38 -0
- package/packages/people/package.json +64 -0
- package/packages/product/package.json +49 -0
- package/packages/raw/package.json +19 -0
- package/packages/relationships/package.json +52 -0
- package/packages/validation/package.json +112 -0
- package/platform/README.md +51 -0
- package/platform/adapter.json +15 -0
- package/platform/connectors/eval.mjs +154 -0
- package/platform/connectors/fake-github.mjs +91 -0
- package/platform/connectors/github.mjs +105 -0
- package/platform/integrations/jev.mjs +30 -0
- package/platform/integrations/langsmith-docket.mjs +53 -0
- package/platform/integrations/langsmith-setup.mjs +115 -0
- package/platform/integrations/langsmith.mjs +47 -0
- package/platform/integrations/remote-image.mjs +79 -0
- package/platform/integrations/rho.mjs +146 -0
- package/platform/integrations/site.mjs +75 -0
- package/platform/kits/README.md +14 -0
- package/platform/kits/agent-upgrade/kit.json +15 -0
- package/platform/kits/agent-upgrade/run.mjs +82 -0
- package/platform/kits/agent-upgrade/stand-in-agent.mjs +32 -0
- package/platform/kits/validation-kickoff/kit.json +29 -0
- package/platform/mcp/research.mjs +64 -0
- package/platform/webhooks/server.mjs +70 -0
- package/purpose/checklists/vault-and-tooling-consultancy-setup.md +216 -0
- package/purpose/frameworks/business-discovery-framework-amendments-2026-05-20.md +181 -0
- package/purpose/frameworks/business-discovery-framework.html +938 -0
- package/purpose/frameworks/business-discovery-framework.md +326 -0
- package/purpose/frameworks/idea-map/README.md +74 -0
- package/purpose/frameworks/idea-map/conventions.json +146 -0
- package/purpose/frameworks/idea-map/graph.mjs +182 -0
- package/purpose/frameworks/idea-map/ideamap.mjs +181 -0
- package/purpose/frameworks/idea-map/route.mjs +140 -0
- package/purpose/frameworks/onboarding-handoff-framework.md +269 -0
- package/purpose/frameworks/post-discovery-deliverable-playbook.md +274 -0
- package/purpose/frameworks/product-anatomy/README.md +63 -0
- package/purpose/frameworks/product-anatomy/anatomy.mjs +195 -0
- package/purpose/frameworks/product-anatomy/examples/polity.answers.reasoned.json +11 -0
- package/purpose/frameworks/product-anatomy/examples/polity.json +89 -0
- package/purpose/frameworks/product-anatomy/phases.json +107 -0
- package/purpose/frameworks/product-anatomy/questions.json +74 -0
- package/purpose/kits/validation/README.md +14 -0
- package/purpose/kits/validation/references/references.json +122 -0
- package/purpose/kits/validation/skills/problem-validation/SKILL.md +43 -0
- package/purpose/kits/validation/skills/validation-score/SKILL.md +35 -0
- package/purpose/kits/validation/templates/go-to-market.md +19 -0
- package/purpose/kits/validation/templates/operations-readiness.md +20 -0
- package/purpose/kits/validation/templates/pricing.md +22 -0
- package/purpose/kits/validation/templates/problem-interview.md +36 -0
- package/purpose/kits/validation/templates/problem.md +45 -0
- package/purpose/kits/validation/templates/product-market-fit.md +23 -0
- package/purpose/kits/validation/templates/solution.md +18 -0
- package/purpose/kits/validation/templates/team.md +19 -0
- package/purpose/kits/validation/weights.json +22 -0
- package/purpose/layer.json +53 -0
- package/purpose/references/references.json +324 -0
- package/purpose/skills/ambition-tier/SKILL.md +205 -0
- package/purpose/skills/telos/SKILL.md +52 -0
- package/purpose/strategic-foundation.json +133 -0
- package/purpose/templates/telos-based-smart.md +39 -0
- package/purpose/tooling/integrations.json +48 -0
- package/schema/README.md +62 -0
- package/schema/VERSION +1 -0
- package/schema/access.mjs +57 -0
- package/schema/account.schema.json +79 -0
- package/schema/adapter.schema.json +33 -0
- package/schema/add-department.mjs +41 -0
- package/schema/agent-capability.schema.json +94 -0
- package/schema/alignment.schema.json +61 -0
- package/schema/assess-problem.mjs +131 -0
- package/schema/assets.mjs +212 -0
- package/schema/bdd.mjs +56 -0
- package/schema/board.schema.json +101 -0
- package/schema/brand.mjs +373 -0
- package/schema/build-release.mjs +61 -0
- package/schema/caching.mjs +505 -0
- package/schema/check-assets.mjs +24 -0
- package/schema/check-boundary.mjs +54 -0
- package/schema/check-brand.mjs +24 -0
- package/schema/check-config.mjs +110 -0
- package/schema/check-data-model.mjs +170 -0
- package/schema/check-data-packages.mjs +83 -0
- package/schema/check-departments.mjs +45 -0
- package/schema/check-execution.mjs +85 -0
- package/schema/check-governance.mjs +98 -0
- package/schema/check-integrations.mjs +33 -0
- package/schema/check-nextjs-status.mjs +79 -0
- package/schema/check-nouns.mjs +49 -0
- package/schema/check-people.mjs +70 -0
- package/schema/check-private.mjs +61 -0
- package/schema/check-provenance.mjs +55 -0
- package/schema/check-publication.mjs +96 -0
- package/schema/check-ready.mjs +89 -0
- package/schema/check-sources.mjs +74 -0
- package/schema/check-team.mjs +94 -0
- package/schema/check-telos.mjs +59 -0
- package/schema/check-validation.mjs +165 -0
- package/schema/check-ventures.mjs +81 -0
- package/schema/check-where-used.mjs +58 -0
- package/schema/data-master.schema.json +14 -0
- package/schema/data-model.json +1584 -0
- package/schema/data-model.schema.json +152 -0
- package/schema/deal.schema.json +80 -0
- package/schema/decision-analytics.mjs +77 -0
- package/schema/decision-record.schema.json +290 -0
- package/schema/decision-rights.schema.json +34 -0
- package/schema/decision.schema.json +30 -0
- package/schema/decisions.mjs +327 -0
- package/schema/department-catalog.schema.json +55 -0
- package/schema/department.schema.json +15 -0
- package/schema/departments.mjs +32 -0
- package/schema/docket-eval.mjs +89 -0
- package/schema/docket.mjs +135 -0
- package/schema/eval-suite.schema.json +45 -0
- package/schema/evidence.schema.json +110 -0
- package/schema/examples/frames/judge.mjs +10 -0
- package/schema/examples/migrate/agent.mjs +12 -0
- package/schema/examples/venture-type/jev.mjs +12 -0
- package/schema/examples/workspace/ventures/acme-labs/AGENTS.md +17 -0
- package/schema/examples/workspace/ventures/acme-labs/accounts/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/acme-labs/decisions/discovery-goal.decision.json +23 -0
- package/schema/examples/workspace/ventures/acme-labs/decisions/statement-icp.decision.json +22 -0
- package/schema/examples/workspace/ventures/acme-labs/decisions/statement-problem.decision.json +22 -0
- package/schema/examples/workspace/ventures/acme-labs/decisions/venture.team.decision.json +37 -0
- package/schema/examples/workspace/ventures/acme-labs/knowledge/README.md +3 -0
- package/schema/examples/workspace/ventures/acme-labs/knowledge/sources.json +46 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000001.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000002.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000003.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000004.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000005.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000006.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000007.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000008.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000009.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000010.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000011.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000012.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000013.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000014.json +12 -0
- package/schema/examples/workspace/ventures/acme-labs/money/_streams/transactions/stream.json +5 -0
- package/schema/examples/workspace/ventures/acme-labs/money/_summary.json +30 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/customer-service/README.md +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/customer-service/department.json +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/finance/README.md +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/finance/department.json +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/human-capital/README.md +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/human-capital/department.json +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/it/README.md +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/it/department.json +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/marketing-and-sales/README.md +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/marketing-and-sales/department.json +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/products/README.md +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/products/department.json +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/strategy/README.md +5 -0
- package/schema/examples/workspace/ventures/acme-labs/operations/departments/strategy/department.json +5 -0
- package/schema/examples/workspace/ventures/acme-labs/people/founders/maya-chen.json +15 -0
- package/schema/examples/workspace/ventures/acme-labs/people/people.json +22 -0
- package/schema/examples/workspace/ventures/acme-labs/pillars/brand.md +5 -0
- package/schema/examples/workspace/ventures/acme-labs/pillars/business.md +5 -0
- package/schema/examples/workspace/ventures/acme-labs/pillars/product.md +5 -0
- package/schema/examples/workspace/ventures/acme-labs/products/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/acme-labs/products/decisions/product.core-product.decision.json +28 -0
- package/schema/examples/workspace/ventures/acme-labs/products/decisions/product.exists.decision.json +38 -0
- package/schema/examples/workspace/ventures/acme-labs/products/decisions/product.flagship.decision.json +27 -0
- package/schema/examples/workspace/ventures/acme-labs/profile.md +12 -0
- package/schema/examples/workspace/ventures/acme-labs/provenance.jsonl +12 -0
- package/schema/examples/workspace/ventures/acme-labs/raw/dump.md +6 -0
- package/schema/examples/workspace/ventures/acme-labs/venture.json +27 -0
- package/schema/examples/workspace/ventures/northstar/AGENTS.md +17 -0
- package/schema/examples/workspace/ventures/northstar/accounts/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/northstar/deals/ductline.json +8 -0
- package/schema/examples/workspace/ventures/northstar/deals/kilnworks.json +14 -0
- package/schema/examples/workspace/ventures/northstar/decisions/venture.team.decision.json +31 -0
- package/schema/examples/workspace/ventures/northstar/evidence/README.md +3 -0
- package/schema/examples/workspace/ventures/northstar/fund/decisions/terms.decision.json +27 -0
- package/schema/examples/workspace/ventures/northstar/fund/decisions/terms.first-close.decision.json +27 -0
- package/schema/examples/workspace/ventures/northstar/fund/decisions/thesis.decision.json +26 -0
- package/schema/examples/workspace/ventures/northstar/fund/terms.json +22 -0
- package/schema/examples/workspace/ventures/northstar/fund/thesis.json +22 -0
- package/schema/examples/workspace/ventures/northstar/governance/README.md +3 -0
- package/schema/examples/workspace/ventures/northstar/governance/departments/external-relationships/charter.md +5 -0
- package/schema/examples/workspace/ventures/northstar/governance/departments/external-relationships/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/governance/departments/finance/charter.md +5 -0
- package/schema/examples/workspace/ventures/northstar/governance/departments/finance/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/governance/departments/human-capital/charter.md +5 -0
- package/schema/examples/workspace/ventures/northstar/governance/departments/human-capital/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/governance/departments/risk-and-compliance/charter.md +5 -0
- package/schema/examples/workspace/ventures/northstar/governance/departments/risk-and-compliance/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/governance/departments/strategy/charter.md +5 -0
- package/schema/examples/workspace/ventures/northstar/governance/departments/strategy/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/knowledge/README.md +3 -0
- package/schema/examples/workspace/ventures/northstar/operations/README.md +3 -0
- package/schema/examples/workspace/ventures/northstar/operations/departments/external-relationships/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/operations/departments/external-relationships/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/operations/departments/finance/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/operations/departments/finance/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/operations/departments/human-capital/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/operations/departments/human-capital/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/operations/departments/risk-and-compliance/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/operations/departments/risk-and-compliance/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/operations/departments/strategy/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/operations/departments/strategy/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/people/founders/ana-ruiz.json +13 -0
- package/schema/examples/workspace/ventures/northstar/people/founders/ben-okafor.json +7 -0
- package/schema/examples/workspace/ventures/northstar/people/people.json +27 -0
- package/schema/examples/workspace/ventures/northstar/pillars/brand.md +5 -0
- package/schema/examples/workspace/ventures/northstar/pillars/business.md +5 -0
- package/schema/examples/workspace/ventures/northstar/pillars/product.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/AGENTS.md +17 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/accounts/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/decisions/venture.team.decision.json +31 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/knowledge/README.md +3 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/customer-service/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/customer-service/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/finance/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/finance/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/human-capital/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/human-capital/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/it/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/it/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/marketing-and-sales/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/marketing-and-sales/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/products/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/products/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/strategy/README.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/operations/departments/strategy/department.json +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/brand.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/business.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/product.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.core-product.decision.json +28 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.exists.decision.json +32 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.flagship.decision.json +27 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/profile.md +5 -0
- package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/venture.json +27 -0
- package/schema/examples/workspace/ventures/northstar/products/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/northstar/profile.md +5 -0
- package/schema/examples/workspace/ventures/northstar/provenance.jsonl +3 -0
- package/schema/examples/workspace/ventures/northstar/purpose/README.md +3 -0
- package/schema/examples/workspace/ventures/northstar/venture.json +49 -0
- package/schema/examples/workspace/ventures/studio/accounts/bakery/account.json +18 -0
- package/schema/examples/workspace/ventures/studio/evidence/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/studio/governance/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/studio/knowledge/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/studio/operations/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/studio/print/knowledge/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/studio/print/purpose/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/studio/print/venture.json +37 -0
- package/schema/examples/workspace/ventures/studio/products/brand-care.json +19 -0
- package/schema/examples/workspace/ventures/studio/products/brand-kit.json +23 -0
- package/schema/examples/workspace/ventures/studio/provenance.jsonl +3 -0
- package/schema/examples/workspace/ventures/studio/purpose/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/studio/venture.json +43 -0
- package/schema/examples/workspace/ventures/tandem/accounts/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/tandem/evidence/README.md +3 -0
- package/schema/examples/workspace/ventures/tandem/governance/README.md +3 -0
- package/schema/examples/workspace/ventures/tandem/governance/agreements/dee-fast.md +3 -0
- package/schema/examples/workspace/ventures/tandem/governance/board.json +51 -0
- package/schema/examples/workspace/ventures/tandem/governance/departments/finance/charter.md +5 -0
- package/schema/examples/workspace/ventures/tandem/governance/departments/finance/department.json +5 -0
- package/schema/examples/workspace/ventures/tandem/governance/departments/primary/marketing-and-sales/charter.md +5 -0
- package/schema/examples/workspace/ventures/tandem/governance/departments/primary/marketing-and-sales/department.json +5 -0
- package/schema/examples/workspace/ventures/tandem/governance/exit.json +33 -0
- package/schema/examples/workspace/ventures/tandem/governance/founder-agreement.json +24 -0
- package/schema/examples/workspace/ventures/tandem/governance/founder-agreement.md +3 -0
- package/schema/examples/workspace/ventures/tandem/governance/ownership.json +131 -0
- package/schema/examples/workspace/ventures/tandem/governance/publication-policy.json +171 -0
- package/schema/examples/workspace/ventures/tandem/knowledge/README.md +3 -0
- package/schema/examples/workspace/ventures/tandem/knowledge/research/friends-feedback-2026-08.md +3 -0
- package/schema/examples/workspace/ventures/tandem/knowledge/research/pilot-2026-10.md +3 -0
- package/schema/examples/workspace/ventures/tandem/knowledge/research/problem-interviews-2026-09.md +20 -0
- package/schema/examples/workspace/ventures/tandem/knowledge/sources.json +8 -0
- package/schema/examples/workspace/ventures/tandem/knowledge/where-used.json +13 -0
- package/schema/examples/workspace/ventures/tandem/operations/README.md +3 -0
- package/schema/examples/workspace/ventures/tandem/operations/departments/finance/README.md +5 -0
- package/schema/examples/workspace/ventures/tandem/operations/departments/finance/department.json +5 -0
- package/schema/examples/workspace/ventures/tandem/operations/departments/primary/marketing-and-sales/README.md +5 -0
- package/schema/examples/workspace/ventures/tandem/operations/departments/primary/marketing-and-sales/department.json +5 -0
- package/schema/examples/workspace/ventures/tandem/pillars/brand.md +5 -0
- package/schema/examples/workspace/ventures/tandem/pillars/business.md +5 -0
- package/schema/examples/workspace/ventures/tandem/pillars/product.md +5 -0
- package/schema/examples/workspace/ventures/tandem/products/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/tandem/products/shop-app.json +22 -0
- package/schema/examples/workspace/ventures/tandem/profile.md +5 -0
- package/schema/examples/workspace/ventures/tandem/provenance.jsonl +13 -0
- package/schema/examples/workspace/ventures/tandem/purpose/README.md +3 -0
- package/schema/examples/workspace/ventures/tandem/purpose/telos.json +78 -0
- package/schema/examples/workspace/ventures/tandem/purpose/validation/go-to-market.json +35 -0
- package/schema/examples/workspace/ventures/tandem/purpose/validation/pricing.json +37 -0
- package/schema/examples/workspace/ventures/tandem/purpose/validation/problem.json +74 -0
- package/schema/examples/workspace/ventures/tandem/purpose/validation/product-market-fit.json +66 -0
- package/schema/examples/workspace/ventures/tandem/purpose/validation/solution.json +33 -0
- package/schema/examples/workspace/ventures/tandem/purpose/validation/team.json +52 -0
- package/schema/examples/workspace/ventures/tandem/venture.json +79 -0
- package/schema/examples/workspace/ventures/woodworking/knowledge/.gitkeep +0 -0
- package/schema/examples/workspace/ventures/woodworking/venture.json +21 -0
- package/schema/examples/workspace/workspace.json +8 -0
- package/schema/exit.schema.json +74 -0
- package/schema/foundation.mjs +118 -0
- package/schema/founder-agreement.schema.json +83 -0
- package/schema/founder.schema.json +72 -0
- package/schema/frame.schema.json +240 -0
- package/schema/frames.mjs +228 -0
- package/schema/freshness-log.schema.json +40 -0
- package/schema/freshness-profiles.schema.json +44 -0
- package/schema/freshness.mjs +473 -0
- package/schema/fund-terms.schema.json +107 -0
- package/schema/fund-thesis.schema.json +87 -0
- package/schema/gate-drafts.mjs +130 -0
- package/schema/gate.mjs +133 -0
- package/schema/glossary.schema.json +25 -0
- package/schema/handoff.schema.json +239 -0
- package/schema/icp.schema.json +136 -0
- package/schema/idea-graph.schema.json +61 -0
- package/schema/init-venture.mjs +128 -0
- package/schema/integration.schema.json +143 -0
- package/schema/judgment.schema.json +38 -0
- package/schema/kit.schema.json +47 -0
- package/schema/kits.mjs +24 -0
- package/schema/knowledge-sources.schema.json +260 -0
- package/schema/layer.json +59 -0
- package/schema/layer.schema.json +119 -0
- package/schema/load-packages.mjs +26 -0
- package/schema/marketing-brand.schema.json +116 -0
- package/schema/marketing-sitemap.schema.json +232 -0
- package/schema/migrate-venture.mjs +192 -0
- package/schema/migrations/kit-to-package.mjs +94 -0
- package/schema/migrations/package-layout.mjs +86 -0
- package/schema/model-steps.mjs +717 -0
- package/schema/money-summary.schema.json +138 -0
- package/schema/naive-config.mjs +165 -0
- package/schema/naive-config.schema.json +268 -0
- package/schema/need-now.json +772 -0
- package/schema/need-now.mjs +108 -0
- package/schema/nextjs-status.schema.json +29 -0
- package/schema/ownership.schema.json +282 -0
- package/schema/packages.json +4 -0
- package/schema/packages.mjs +252 -0
- package/schema/payouts.mjs +91 -0
- package/schema/people.schema.json +86 -0
- package/schema/port-venture.mjs +161 -0
- package/schema/product.schema.json +223 -0
- package/schema/provenance-entry.schema.json +154 -0
- package/schema/public-assets.schema.json +76 -0
- package/schema/publication-policy.schema.json +293 -0
- package/schema/raw-source.schema.json +15 -0
- package/schema/reference.schema.json +115 -0
- package/schema/release-read.mjs +111 -0
- package/schema/releases.mjs +497 -0
- package/schema/route-aliases.schema.json +25 -0
- package/schema/run-handoff.mjs +51 -0
- package/schema/scaffold/defaults.json +54 -0
- package/schema/setup.mjs +164 -0
- package/schema/site-presence.schema.json +337 -0
- package/schema/stale.mjs +111 -0
- package/schema/start-release.mjs +41 -0
- package/schema/strategic-foundation.schema.json +74 -0
- package/schema/stream.schema.json +14 -0
- package/schema/structure.mjs +186 -0
- package/schema/systems-catalog.json +126 -0
- package/schema/systems-catalog.schema.json +78 -0
- package/schema/team-plan.schema.json +157 -0
- package/schema/telos.schema.json +197 -0
- package/schema/time-to-ready.mjs +93 -0
- package/schema/trigger.schema.json +44 -0
- package/schema/triggers.mjs +237 -0
- package/schema/upgrade-registry.schema.json +60 -0
- package/schema/upgrade-venture.mjs +107 -0
- package/schema/upgrades.json +69 -0
- package/schema/upgrades.mjs +385 -0
- package/schema/use-model.mjs +10 -0
- package/schema/validate.py +58 -0
- package/schema/validation-evidence.schema.json +123 -0
- package/schema/validation-go-to-market.schema.json +110 -0
- package/schema/validation-operations-readiness.schema.json +91 -0
- package/schema/validation-pricing.schema.json +114 -0
- package/schema/validation-problem.schema.json +118 -0
- package/schema/validation-product-market-fit.schema.json +135 -0
- package/schema/validation-solution.schema.json +79 -0
- package/schema/validation-team.schema.json +116 -0
- package/schema/venture-role.schema.json +64 -0
- package/schema/venture-type.mjs +62 -0
- package/schema/venture-types.json +346 -0
- package/schema/venture-types.schema.json +129 -0
- package/schema/venture.schema.json +460 -0
- package/schema/vocab/business-models.json +298 -0
- package/schema/where-used.schema.json +56 -0
- package/schema/workspace.schema.json +38 -0
|
@@ -0,0 +1,255 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: venture-template-pillar
|
|
3
|
+
ai-model: claude
|
|
4
|
+
pillar: business
|
|
5
|
+
source: hybrid
|
|
6
|
+
created: 2026-05-14
|
|
7
|
+
last-reviewed: 2026-05-14
|
|
8
|
+
authorship: hybrid
|
|
9
|
+
authors: [the author, Claude]
|
|
10
|
+
ip-sensitivity: normal
|
|
11
|
+
scope: global
|
|
12
|
+
scope-entity: "[[everything-ecosystem]]"
|
|
13
|
+
tags: [venture-template, pillar, business, methodology, 2026-05-14]
|
|
14
|
+
canonical-for: "business-pillar-reference"
|
|
15
|
+
related:
|
|
16
|
+
- "[[governance/venture-template/index]]"
|
|
17
|
+
- "[[governance/venture-template/pillars/product]]"
|
|
18
|
+
- "[[governance/venture-template/pillars/brand]]"
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
# Business pillar
|
|
22
|
+
|
|
23
|
+
> **Purpose:** *How the company sustains itself.* The commercial + operational surface — money, people, contracts, partnerships, day-to-day machinery of being a going concern.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Business pillar products (optional)
|
|
28
|
+
|
|
29
|
+
Per [[_ideas/build-roadmap-and-html-orchestration-2026-05-12|build-roadmap §35]], the Business pillar **may** have products of its own — commercial or operational offerings that are themselves "products" rather than supporting artifacts for the Product pillar.
|
|
30
|
+
|
|
31
|
+
Common Business-pillar products:
|
|
32
|
+
|
|
33
|
+
- **Partnership programs** — formal partner offerings with tier structures, partner benefits, joint go-to-market
|
|
34
|
+
- **Training programs + certifications** — for users, developers, partners; sold or freely offered
|
|
35
|
+
- **Sales kits / partner enablement bundles** — productized as deliverables to partners
|
|
36
|
+
- **Services + service tiers** — when service is sold by Business as a standalone offering, distinct from a Product-pillar service product
|
|
37
|
+
- **Enterprise consulting / professional services** — accompanies the main product but is itself a productized offering
|
|
38
|
+
- **Investor relations products** — annual reports, board package as a recurring product
|
|
39
|
+
- **Affiliate / referral programs** — productized growth mechanisms
|
|
40
|
+
- **Marketplace operations** — when the company runs a marketplace as a Business-pillar product (e.g., the marketplace UX is Product, but the operational marketplace product — listings, ranking, dispute resolution, take-rate management — is Business)
|
|
41
|
+
|
|
42
|
+
Business-pillar products carry their own articulation closure inventory, roadmap, and life-cycle through the four lanes. Their product-type (partnership / program / service / etc.) determines which Tier 2 deliverable templates apply.
|
|
43
|
+
|
|
44
|
+
Most early-stage companies do NOT have Business-pillar products. They have Business-pillar deliverables (business model, pricing, ops runbooks) that *support* the Product-pillar product. Business-pillar products emerge when the company has growing commercial reach and the operational offerings themselves become significant enough to manage as products.
|
|
45
|
+
|
|
46
|
+
**Business-pillar products are themselves recursive.** Per [[_ideas/build-roadmap-and-html-orchestration-2026-05-12|§36]], a Business-pillar product (say, a partnership program) has its own three-pillar structure: its own Product (the program offering), its own Brand (often distinct from parent — "the reference project for Educators" has its own positioning), and its own Business (revenue model, partner ops, legal structure, possibly its own P&L). The methodology applies fractally — a partnership program is its own sub-company with the same three-pillar treatment.
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## What the Business pillar owns
|
|
51
|
+
|
|
52
|
+
The Business pillar owns everything that isn't the product (Product) or the identity (Brand) but is necessary for the company to function as a going concern. This is the broadest pillar in scope and the one that varies most by company stage.
|
|
53
|
+
|
|
54
|
+
Concretely, Business owns:
|
|
55
|
+
|
|
56
|
+
- **Commercial.** Business model, pricing, revenue strategy, sales motion, partnerships, BD, contracts.
|
|
57
|
+
- **People.** Hiring, onboarding, performance management, compensation, culture, all-hands.
|
|
58
|
+
- **Operations.** Internal tooling, vendor management, procurement, office/remote ops.
|
|
59
|
+
- **Finance.** Bookkeeping, fundraising, runway management, financial reporting.
|
|
60
|
+
- **Legal.** Contracts, IP, ToS, privacy, regulatory compliance, employment law.
|
|
61
|
+
- **Customer Success.** Onboarding, support, retention, expansion (overlap with Product).
|
|
62
|
+
- **Trust & Safety.** Policy, enforcement, escalation (overlap with Product + Brand).
|
|
63
|
+
- **Strategy & Planning.** Annual planning, OKRs, board materials, investor relations.
|
|
64
|
+
|
|
65
|
+
Business **does not** own:
|
|
66
|
+
- The product itself — that's Product. Business may shape the product through commercial constraints (pricing, target market) but doesn't author specs.
|
|
67
|
+
- Identity — that's Brand. Business uses brand assets but doesn't define them.
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Typical teams
|
|
72
|
+
|
|
73
|
+
- **Operations.** General ops, internal tooling, vendor management. Often where the most cross-pillar coordination happens.
|
|
74
|
+
- **Finance.** Accounting, FP&A, fundraising support. Small team but high-leverage.
|
|
75
|
+
- **Sales.** Inbound, outbound, account management. Sits under Business when commercial; sometimes under Brand when growth-led / marketing-led.
|
|
76
|
+
- **Business Development.** Partnerships, channel deals, ecosystem relationships. Distinct from Sales — BD signs partners, Sales signs customers.
|
|
77
|
+
- **People** (sometimes called HR / People Ops). Hiring, performance, comp, culture.
|
|
78
|
+
- **Legal.** General counsel, contract review, IP, regulatory. Often outside counsel + small in-house team early; in-house team grows with scale.
|
|
79
|
+
- **Customer Success** (overlap with Product). Owns post-sale customer relationship. CS feedback loops back to Product; CS commercial expansion sits squarely under Business.
|
|
80
|
+
- **Trust & Safety** (overlap with Brand + Product). Policy lives under Business; community standards under Brand; tooling under Product. Coordination across all three required.
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## Typical roles
|
|
85
|
+
|
|
86
|
+
**Pillar lead:**
|
|
87
|
+
- *To author:* [[../roles/coo|COO]] — Chief Operating Officer. Pillar lead for Business in most modern companies. (Some companies split Business into multiple C-level roles; COO most often owns the broadest scope.)
|
|
88
|
+
|
|
89
|
+
**Cross-cutting C-level:**
|
|
90
|
+
- **CFO** — Chief Financial Officer. Owns Finance; reports to CEO; sits under Business but has independent board reporting.
|
|
91
|
+
- **General Counsel** — heads Legal; reports to CEO; often considered C-level in companies with legal complexity.
|
|
92
|
+
- **CRO** — Chief Revenue Officer. Owns Sales + sometimes BD. C-level in revenue-driven companies.
|
|
93
|
+
- **CPO** — Chief People Officer. Owns People; C-level in companies that have scaled past ~150 people.
|
|
94
|
+
|
|
95
|
+
**VP-level + management roles:**
|
|
96
|
+
- VP Sales — runs Sales day-to-day; reports to CRO (or CEO if no CRO)
|
|
97
|
+
- VP Operations — runs Ops
|
|
98
|
+
- VP BD — runs Business Development
|
|
99
|
+
- Head of People — runs People (pre-CPO scale)
|
|
100
|
+
- Head of Customer Success — runs CS
|
|
101
|
+
- VP Legal — runs Legal (under GC or directly to CEO)
|
|
102
|
+
|
|
103
|
+
**Specialist IC + lead roles:**
|
|
104
|
+
- Customer Success Lead — runs a CS pod or customer segment
|
|
105
|
+
- Sales Engineer — technical sales support
|
|
106
|
+
- BD Manager — owns specific partner relationships
|
|
107
|
+
- Recruiter — sources + closes candidates
|
|
108
|
+
- Accountant / Controller — owns books + reporting
|
|
109
|
+
- Office Manager / Operations Coordinator — handles day-to-day ops
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## Tier 1 deliverables — every Business pillar produces these
|
|
114
|
+
|
|
115
|
+
1. **Business profile** (`<entity>/business/profile.md`) — sub-profile describing what Business is for this entity.
|
|
116
|
+
2. **Business idea-dumps** (`<entity>/business/_ideas/`) — raw business thinking, commercial hypotheses, partnership ideas.
|
|
117
|
+
3. **Market thesis** — who the customer is, what the market looks like, why this entity should exist commercially.
|
|
118
|
+
4. **Business model** — how the entity makes money (or, for non-commercial entities, how it sustains itself).
|
|
119
|
+
5. **Pricing** — explicit pricing strategy + tiers. (Even free / pre-revenue entities should declare "currently free + the path to monetization.")
|
|
120
|
+
6. **Sales collateral** — pitch decks, one-pagers, battle cards (overlap with Brand).
|
|
121
|
+
7. **Partnership memos** — for each major partner, a memo describing the relationship + terms.
|
|
122
|
+
8. **Operational runbooks** — for each recurring ops task (deploy, incident, on-call, etc.), a runbook.
|
|
123
|
+
9. **Metrics framework** — what metrics the company tracks, definitions, dashboards (overlap with Product on Analytics).
|
|
124
|
+
10. **Marketing collateral** — landing pages, email sequences, ads (overlap with Brand on voice).
|
|
125
|
+
11. **Anti-scraping / ToS clauses** — legal posture for product data + IP (overlap with Product on enforcement).
|
|
126
|
+
12. **App store listings** (for app-distribution products) — store metadata, copy, screenshots, preview videos (overlap with Brand).
|
|
127
|
+
13. **Pitch deck** — investor / partner pitch (overlap with Brand on narrative).
|
|
128
|
+
14. **Investor materials** — board decks, update emails, financial reports.
|
|
129
|
+
15. **Contracts** — customer agreements, vendor agreements, NDAs, employment agreements.
|
|
130
|
+
16. **Hiring rubric** — what we hire for, by role + by level (overlap with company-wide).
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## Tier 2 deliverables — per-company-stage
|
|
135
|
+
|
|
136
|
+
Business pillar varies most by company stage. The typical splits:
|
|
137
|
+
|
|
138
|
+
### Pre-revenue / pre-product
|
|
139
|
+
|
|
140
|
+
- Business hypothesis (lightweight model)
|
|
141
|
+
- One-pager describing the entity
|
|
142
|
+
- Founder bios / why-this-team narrative
|
|
143
|
+
- Initial market scan
|
|
144
|
+
- Pre-product fundraising deck (if applicable)
|
|
145
|
+
- Defer most operational deliverables until product is in users' hands
|
|
146
|
+
|
|
147
|
+
### Early-stage (post-launch, pre-PMF)
|
|
148
|
+
|
|
149
|
+
- Refined business model (post-first-customer-conversations)
|
|
150
|
+
- Pricing v1 + first-customer pricing
|
|
151
|
+
- Light ops runbooks (deploy, incident)
|
|
152
|
+
- Initial metrics framework (vanity metrics tolerated; deep cohorts not yet)
|
|
153
|
+
- Fundraising materials (seed → Series A)
|
|
154
|
+
- First sales collateral (often founder-led sales)
|
|
155
|
+
|
|
156
|
+
### Growth-stage (post-PMF, scaling)
|
|
157
|
+
|
|
158
|
+
- Full ops runbooks (incident, on-call, escalation, vendor management)
|
|
159
|
+
- Full metrics framework (cohort analysis, retention, unit economics, growth accounting)
|
|
160
|
+
- Sales playbooks (per segment + per stage)
|
|
161
|
+
- People processes (hiring, onboarding, performance management, comp)
|
|
162
|
+
- Partnership program (formal partner tier structure)
|
|
163
|
+
- Legal compliance program (privacy, security, regulatory)
|
|
164
|
+
- Investor reporting cadence
|
|
165
|
+
- Customer success program
|
|
166
|
+
|
|
167
|
+
### Mature-stage
|
|
168
|
+
|
|
169
|
+
- All of the above + board governance, strategic planning cycle, M&A capability, IPO readiness (if applicable)
|
|
170
|
+
|
|
171
|
+
---
|
|
172
|
+
|
|
173
|
+
## Tier 2 deliverables — per-business-model
|
|
174
|
+
|
|
175
|
+
Different business models have different Tier 2 deliverables.
|
|
176
|
+
|
|
177
|
+
### Subscription (SaaS, content subscription, membership)
|
|
178
|
+
|
|
179
|
+
- Pricing tiers + feature gating matrix
|
|
180
|
+
- Churn analysis + retention dashboards
|
|
181
|
+
- Upgrade/downgrade flows (overlap with Product)
|
|
182
|
+
- Annual contract vs. monthly mix model
|
|
183
|
+
|
|
184
|
+
### Transactional (e-commerce, marketplace)
|
|
185
|
+
|
|
186
|
+
- Transaction fee structure
|
|
187
|
+
- Take-rate analysis
|
|
188
|
+
- Buyer + seller acquisition costs
|
|
189
|
+
- Refund + dispute policies
|
|
190
|
+
|
|
191
|
+
### Advertising-supported
|
|
192
|
+
|
|
193
|
+
- Ad inventory pricing
|
|
194
|
+
- Audience segmentation
|
|
195
|
+
- Advertiser relationships
|
|
196
|
+
- Privacy + data policy (heavy overlap with Legal)
|
|
197
|
+
|
|
198
|
+
### Open-source + commercial
|
|
199
|
+
|
|
200
|
+
- OSS license decision
|
|
201
|
+
- Commercial license / SaaS offering structure
|
|
202
|
+
- Community → customer conversion model
|
|
203
|
+
- Contributor agreements
|
|
204
|
+
|
|
205
|
+
### Free / non-commercial
|
|
206
|
+
|
|
207
|
+
- Sustainability model (grants, donations, sponsorships, founder-funded, etc.)
|
|
208
|
+
- Sustainability cadence + runway
|
|
209
|
+
- Optional "what would make this commercial" deferred plan
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
## Tier 3 deliverables — idea-derived
|
|
214
|
+
|
|
215
|
+
Examples from the reference project:
|
|
216
|
+
|
|
217
|
+
- "Privacy positioning" — captured in marketing/privacy-positioning.md
|
|
218
|
+
- "App store preview briefs" — Tier 2-ish for app-distribution products, but the specific brief format was Tier 3 for the reference project
|
|
219
|
+
- "Concentric-rings allowlist governance" — V1 search policy, lives at the Product × Business overlap
|
|
220
|
+
- "Anti-scraping plan" — V1 IP protection posture, lives at the Product × Business overlap
|
|
221
|
+
|
|
222
|
+
---
|
|
223
|
+
|
|
224
|
+
## Cross-pillar overlap zones (Business side)
|
|
225
|
+
|
|
226
|
+
How Business participates in overlap zones with Product and Brand:
|
|
227
|
+
|
|
228
|
+
- **Business × Product → Analytics + Instrumentation.** Product owns instrumentation; Business owns metric definitions + dashboards.
|
|
229
|
+
- **Business × Product → Customer Success.** Product owns in-product onboarding + feedback; Business owns support runbooks + CS ops.
|
|
230
|
+
- **Business × Product → Pricing-as-Product.** Business owns pricing strategy + tiers; Product owns paywall implementation + plan-gate UX.
|
|
231
|
+
- **Business × Brand → Sales Collateral.** Brand owns voice + identity; Business owns commercial framing + sales playbooks.
|
|
232
|
+
- **Business × Brand → Partnership Materials.** Brand owns assets + voice; Business owns terms + relationship management.
|
|
233
|
+
- **Business × Brand → PR Strategy.** Brand owns narrative; Business owns analyst + investor + press relationships.
|
|
234
|
+
- **Business × Product + Brand → Trust & Safety.** Business owns policy + legal posture; Product owns moderation tooling; Brand owns community standards.
|
|
235
|
+
|
|
236
|
+
---
|
|
237
|
+
|
|
238
|
+
## Methodology mechanisms that touch Business
|
|
239
|
+
|
|
240
|
+
- **Skills:** `business-pillar` (auto-loads on Business work), `metrics-review` (overlap with Product on analytics), `articulation-closure` (Business-pillar deliverable matrix's gating), `deliverable-discovery`.
|
|
241
|
+
- **Hooks:** `pre-deploy` (gates on Business deliverables that are deploy-blocking — e.g., ToS, privacy policy, app-store listing readiness).
|
|
242
|
+
- **Selective slash commands:** `/metrics-review`, `/stakeholder-update` (composes a stakeholder update from project state).
|
|
243
|
+
|
|
244
|
+
---
|
|
245
|
+
|
|
246
|
+
## Related per-role files
|
|
247
|
+
|
|
248
|
+
- *To author:* [[../roles/coo|COO]] — Business pillar lead
|
|
249
|
+
- *To author:* CFO, GC, CRO, CPO as methodology mechanisms need them
|
|
250
|
+
|
|
251
|
+
---
|
|
252
|
+
|
|
253
|
+
## Status
|
|
254
|
+
|
|
255
|
+
- **2026-05-14:** Initial authoring. Tier 1 surfaced; Tier 2 split by stage + business-model; Tier 3 illustrated from the reference project. COO role file queued.
|
|
@@ -0,0 +1,254 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: venture-template-pillar
|
|
3
|
+
ai-model: claude
|
|
4
|
+
pillar: product
|
|
5
|
+
source: hybrid
|
|
6
|
+
created: 2026-05-14
|
|
7
|
+
last-reviewed: 2026-05-14
|
|
8
|
+
authorship: hybrid
|
|
9
|
+
authors: [the author, Claude]
|
|
10
|
+
ip-sensitivity: normal
|
|
11
|
+
scope: global
|
|
12
|
+
scope-entity: "[[everything-ecosystem]]"
|
|
13
|
+
tags: [venture-template, pillar, product, methodology, 2026-05-14]
|
|
14
|
+
canonical-for: "product-pillar-reference"
|
|
15
|
+
related:
|
|
16
|
+
- "[[governance/venture-template/index]]"
|
|
17
|
+
- "[[governance/venture-template/pillars/brand]]"
|
|
18
|
+
- "[[governance/venture-template/pillars/business]]"
|
|
19
|
+
- "[[sad/SAD_SKILL_v3]]"
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
# Product pillar
|
|
23
|
+
|
|
24
|
+
> **Purpose:** *What the company makes.* The product itself + everything required to specify it, build it, ship it, and operate it.
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## Product pillar products
|
|
29
|
+
|
|
30
|
+
Per [[_ideas/build-roadmap-and-html-orchestration-2026-05-12|build-roadmap §35]], each pillar can have products. Product pillar holds the **canonical company products** — the thing(s) the audience uses, reads, plays with, learns from, or builds with.
|
|
31
|
+
|
|
32
|
+
A company may have one Product-pillar product (the simple case) or many (e.g., the reference project's seven surfaces: The reference project, the reference project News, the reference project SDK, the reference project Forum, etc.). Each Product-pillar product carries its own:
|
|
33
|
+
|
|
34
|
+
- Spec stack (vision → version → product → data model → impl → behavioral → verification)
|
|
35
|
+
- Audience definition + success metrics
|
|
36
|
+
- Roadmap
|
|
37
|
+
- Articulation closure inventory
|
|
38
|
+
- Build → ship → operate lane traversal
|
|
39
|
+
|
|
40
|
+
Multi-product Product pillars share some company-wide deliverables (the entity's overarching mission, the cross-product strategic plan) but most product-specific deliverables are per-product.
|
|
41
|
+
|
|
42
|
+
**Product-pillar products are themselves recursive.** Per [[_ideas/build-roadmap-and-html-orchestration-2026-05-12|§36]], each Product-pillar product is itself a company-in-miniature with its own three-pillar structure: its own Product sub-pillar (the product itself + any sub-products), its own Brand sub-pillar (the product's identity within or distinct from parent), and its own Business sub-pillar (the product's commercial / operational concerns specific to its scope). The reference project's seven surfaces are the canonical example — each surface is itself a sub-company. The methodology applies fractally; articulation closure, version-identity, deliverable templates all work the same way at every recursion level.
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## What the Product pillar owns
|
|
47
|
+
|
|
48
|
+
The Product pillar owns the **product spec stack** and everything downstream of it that's specific to the product as a thing-the-audience-uses. This is the pillar where SAD v3 lives — the methodology is Product-pillar-focused, software-product-type-focused at its current state of development.
|
|
49
|
+
|
|
50
|
+
Concretely, Product owns:
|
|
51
|
+
|
|
52
|
+
- The product's vision, version scoping, and full spec stack
|
|
53
|
+
- The product's data model, architecture, and implementation
|
|
54
|
+
- The product's user experience, information architecture, and accessibility
|
|
55
|
+
- The product's verification — does it do what we said it would?
|
|
56
|
+
- The codebase (or content library, or service offering — whatever the product type implies)
|
|
57
|
+
- The deploy/distribute workflow that gets the product to the audience
|
|
58
|
+
- The product's internal observability + performance instrumentation (often co-owned with Business via the Analytics overlap zone)
|
|
59
|
+
|
|
60
|
+
Product **does not** own:
|
|
61
|
+
- Brand identity (visual + verbal) — that's Brand. Product *imports* brand into its UI + microcopy.
|
|
62
|
+
- Marketing copy or commercial positioning — that's Business or Brand depending on the artifact.
|
|
63
|
+
- Pricing — that's Business (with Product input via the Pricing-as-Product overlap zone).
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## Typical teams
|
|
68
|
+
|
|
69
|
+
Teams under Product (primary pillar). Overlap teams are noted explicitly.
|
|
70
|
+
|
|
71
|
+
- **Engineering.** Backend, frontend, infrastructure, mobile. The team that writes code.
|
|
72
|
+
- **Design** (overlap with Brand). Product design (UX, IA, interaction). Sits under Product when the work is "how the product behaves"; sits under Brand when the work is "how the company visually shows up." Most companies need both kinds of design and the boundary is a frequent source of friction. The methodology convention: product designers sit under Product; brand designers sit under Brand; the design system itself is a Product × Brand overlap.
|
|
73
|
+
- **Product Management.** PMs, group PMs, technical PMs. Owns the product-spec authoring + version scoping work.
|
|
74
|
+
- **QA / Quality.** Test engineering, automation, manual QA. Owns the verification → ship gate.
|
|
75
|
+
- **Data Engineering.** Pipelines, warehousing, data platform. Sits under Product when the data is the product (analytics product, dataset product) or when data infra is product-critical.
|
|
76
|
+
- **DevRel** (overlap with Brand + Business). Developer relations sits cross-pillar: code samples + SDK docs are Product; developer-facing voice + content is Brand; developer partnerships + community programs are Business.
|
|
77
|
+
- **Security** (overlap with Business). Product security (vuln management, threat modeling) is Product; corporate security + compliance + legal posture is Business.
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Typical roles
|
|
82
|
+
|
|
83
|
+
Roles under Product. Per-role files exist for those that get methodology mechanisms; others are listed here for reference.
|
|
84
|
+
|
|
85
|
+
**Pillar lead:**
|
|
86
|
+
- [[../roles/cto|CTO]] — Chief Technology Officer. Sets Product pillar's technical direction.
|
|
87
|
+
|
|
88
|
+
**Senior IC + management roles:**
|
|
89
|
+
- VP Engineering — runs the engineering organization day-to-day
|
|
90
|
+
- Engineering Manager (EM) — manages a team of engineers
|
|
91
|
+
- Tech Lead — sets technical direction within a team
|
|
92
|
+
- Staff / Principal / Distinguished Engineer — senior IC roles
|
|
93
|
+
- Senior Engineer — experienced IC
|
|
94
|
+
- Software Engineer — IC
|
|
95
|
+
|
|
96
|
+
**Specialist IC roles:**
|
|
97
|
+
- Designer — product designer (UX + interaction)
|
|
98
|
+
- UX Researcher — user research, usability testing
|
|
99
|
+
- Data Engineer — pipelines, warehousing
|
|
100
|
+
- ML Engineer — machine learning systems
|
|
101
|
+
- Security Engineer — application + infrastructure security
|
|
102
|
+
- DevRel Engineer — developer relations
|
|
103
|
+
- Site Reliability Engineer (SRE) — infra reliability + observability
|
|
104
|
+
|
|
105
|
+
**Product Management:**
|
|
106
|
+
- VP Product — runs the product organization
|
|
107
|
+
- Group PM — manages a group of PMs
|
|
108
|
+
- Product Manager (PM) — owns one or more product areas
|
|
109
|
+
- Technical PM — PM for technical / API / infra products
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## Tier 1 deliverables — every Product pillar produces these
|
|
114
|
+
|
|
115
|
+
Universal Product-pillar deliverables, regardless of product type:
|
|
116
|
+
|
|
117
|
+
1. **Product profile** (`<entity>/product/profile.md`) — sub-profile under the entity profile; describes what the Product pillar is for this entity.
|
|
118
|
+
2. **Idea-dumps** (`<entity>/product/_ideas/`) — raw idea capture, per the two-layer data model.
|
|
119
|
+
3. **Research synthesis** (`<entity>/product/RESEARCH_SYNTHESIS.md`) — compiled from `_sources/`; produced in Phase 0B.
|
|
120
|
+
4. **Idea map** (`<entity>/product/IDEA_MAP.md`) — compiled from `_ideas/`; produced in Phase 0A.
|
|
121
|
+
5. **Vision spec** (`<entity>/product/spec/VISION_SPEC.md`) — permanent unconstrained vision; produced in Phase 0C.
|
|
122
|
+
6. **Version spec** (`<entity>/product/spec/VERSION_SPEC_v[N].md`) — subtractive cut of vision for version N; produced in Phase 1A.
|
|
123
|
+
7. **Product spec** (`<entity>/product/spec/PRODUCT_SPEC.md`) — intent, scope, user taxonomy; produced in Phase 1B.
|
|
124
|
+
8. **Roadmap** (`<entity>/product/roadmap-*.html` or `.md`) — engineering + content + brand + ops deliverables, ordered for build.
|
|
125
|
+
9. **Audience definition** — who this version is for; what they want; what they don't.
|
|
126
|
+
10. **Success metrics framework** — what "working" looks like, measured (overlap with Business).
|
|
127
|
+
11. **Session log** (`<entity>/product/SESSION_LOG.md`) — institutional memory across all phases.
|
|
128
|
+
12. **Code pointer** (`<entity>/product/code/pointer.md`) — frontmatter pointing to the repo at `<repos>/<repo>/`.
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## Tier 2 deliverables — per-product-type
|
|
133
|
+
|
|
134
|
+
Additional deliverables depending on what kind of product. The methodology assumes "default = software product" because SAD v3 was authored for software; other product types have their own deliverable shapes and are queued for variant authoring.
|
|
135
|
+
|
|
136
|
+
### Software product
|
|
137
|
+
|
|
138
|
+
The most fully-developed product-type. Tier 2 deliverables:
|
|
139
|
+
|
|
140
|
+
- Data model spec (`DATA_MODEL_SPEC.md`)
|
|
141
|
+
- Implementation spec (`IMPL_SPEC.md`)
|
|
142
|
+
- Behavioral spec (`BEHAVIORAL_SPEC.md`)
|
|
143
|
+
- Verification spec (`VERIFICATION_SPEC.md`)
|
|
144
|
+
- Phase 1B-Final cross-spec review (`PHASE_1B_FINAL_REVIEW.md`)
|
|
145
|
+
- Sitemap + URL structure
|
|
146
|
+
- Information architecture doc
|
|
147
|
+
- UX flows (per F-flow in PRODUCT_SPEC)
|
|
148
|
+
- Microcopy + states (empty / loading / error)
|
|
149
|
+
- Accessibility checklist
|
|
150
|
+
- Responsive breakpoints
|
|
151
|
+
- Wireframes (per page)
|
|
152
|
+
- Component library catalogue
|
|
153
|
+
- Articulation closure inventory
|
|
154
|
+
- Deploy workflow (CI/CD config)
|
|
155
|
+
- Operational runbooks
|
|
156
|
+
- Tests (unit / integration / E2E)
|
|
157
|
+
- Verification test plan (§9-style)
|
|
158
|
+
|
|
159
|
+
#### Software sub-types (further specialization)
|
|
160
|
+
|
|
161
|
+
- **Web app** — sitemap is primary; SEO, analytics, OG/share assets matter.
|
|
162
|
+
- **Mobile app** — store-listing copy + screenshots primary; platform-specific UX patterns.
|
|
163
|
+
- **API / SDK** — auth model + reference docs primary; backwards-compat policy.
|
|
164
|
+
- **CLI tool** — install/uninstall + help text primary; package manager strategy.
|
|
165
|
+
- **Library** — semantic versioning policy; example apps; contributor docs.
|
|
166
|
+
- **Platform** (multi-tenant) — governance + isolation model; tenancy boundary docs.
|
|
167
|
+
|
|
168
|
+
### Content product
|
|
169
|
+
|
|
170
|
+
Additional deliverables when the product is content (newsletter, podcast, book, course, documentary):
|
|
171
|
+
|
|
172
|
+
- Editorial calendar
|
|
173
|
+
- Content production workflow
|
|
174
|
+
- Distribution strategy (channels, cadence)
|
|
175
|
+
- Audience growth plan
|
|
176
|
+
- Editorial guidelines (separate from brand voice — content-specific)
|
|
177
|
+
- Episode / issue / chapter template
|
|
178
|
+
|
|
179
|
+
### Service product
|
|
180
|
+
|
|
181
|
+
Additional deliverables when the product is a service (consulting, agency, coaching):
|
|
182
|
+
|
|
183
|
+
- Service catalog
|
|
184
|
+
- Engagement model (proposal → SOW → delivery → handoff)
|
|
185
|
+
- Delivery playbooks per service offering
|
|
186
|
+
- Pricing tiers (overlap with Business)
|
|
187
|
+
- Case study template
|
|
188
|
+
|
|
189
|
+
### Hardware product
|
|
190
|
+
|
|
191
|
+
Additional deliverables when the product is hardware (consumer device, industrial):
|
|
192
|
+
|
|
193
|
+
- Bill of materials (BOM)
|
|
194
|
+
- Manufacturing plan
|
|
195
|
+
- Supplier qualification
|
|
196
|
+
- Certification roadmap (FCC, CE, UL, etc.)
|
|
197
|
+
- Field service / warranty model
|
|
198
|
+
- Unboxing + setup experience design
|
|
199
|
+
|
|
200
|
+
### Hybrid
|
|
201
|
+
|
|
202
|
+
Real products are often hybrid (software + content; software + service; hardware + software companion app). Hybrid products produce the union of relevant Tier 2 deliverables.
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## Tier 3 deliverables — idea-derived
|
|
207
|
+
|
|
208
|
+
Discovered per-project; not in any standard template. Surfaced by the deliverable-discovery skill (per [[_ideas/build-roadmap-and-html-orchestration-2026-05-12|build-roadmap idea-dump §33–§34]]).
|
|
209
|
+
|
|
210
|
+
Examples from the reference project:
|
|
211
|
+
|
|
212
|
+
- Concentric-rings source classification
|
|
213
|
+
- Foreshadowing audit (V[N] foreshadows V[N+1] audience)
|
|
214
|
+
- Version-identities document (one-persona-per-version discipline)
|
|
215
|
+
- Anti-scraping plan (Twitter-posture for civic data)
|
|
216
|
+
- District-map SVG strategy
|
|
217
|
+
- Portrait standards
|
|
218
|
+
|
|
219
|
+
Tier 3 deliverables originate from conversation; they get added to the deliverable templates inventory as they accumulate across projects and start to feel reusable.
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
## Cross-pillar overlap zones (Product side)
|
|
224
|
+
|
|
225
|
+
How Product participates in overlap zones with Brand and Business:
|
|
226
|
+
|
|
227
|
+
- **Product × Brand → Design System.** Product owns interaction patterns + component behavior; Brand owns visual tokens + voice; the design system is the shared artifact.
|
|
228
|
+
- **Product × Brand → Developer Experience.** Product owns SDK + API docs; Brand owns the developer-facing voice + dev portal aesthetic.
|
|
229
|
+
- **Product × Business → Analytics.** Product owns instrumentation + event taxonomy; Business owns metric definitions + dashboards.
|
|
230
|
+
- **Product × Business → Customer Success.** Product owns onboarding flows + in-product feedback; Business owns support runbooks + customer success ops.
|
|
231
|
+
- **Product × Business → Pricing-as-Product.** Product owns paywalls + plan-gate UX; Business owns pricing tiers + commercial strategy.
|
|
232
|
+
- **Product × Brand + Business → Trust & Safety.** Product owns moderation tooling; Brand owns community standards; Business owns legal posture.
|
|
233
|
+
|
|
234
|
+
---
|
|
235
|
+
|
|
236
|
+
## Methodology mechanisms that touch Product
|
|
237
|
+
|
|
238
|
+
- **Skills:** `product-pillar` (auto-loads on Product work), `software-product` / `content-product` / `service-product` / `hardware-product` (per-type guidance), `articulation-closure` (the Product-pillar deliverable matrix's gating), `build-roadmap`, `version-identity`.
|
|
239
|
+
- **Hooks:** `pre-deploy` (gates on articulation-closure verification), `post-tool-use` (timestamp on compiled-artifact edits), `session-start` (read SESSION_LOG before any code work).
|
|
240
|
+
- **Selective slash commands:** `/articulation-close` (runs the closure gate), `/discover-deliverables` (gap discovery for Tier 3 candidates), `/spec` (begins spec stack authoring).
|
|
241
|
+
|
|
242
|
+
---
|
|
243
|
+
|
|
244
|
+
## Related per-role files
|
|
245
|
+
|
|
246
|
+
- [[../roles/ceo|CEO]] — cross-pillar lead who sets Product direction
|
|
247
|
+
- *To author:* [[../roles/cto|CTO]] — Product pillar lead
|
|
248
|
+
- *To author:* VP Engineering, Designer, PM, QA roles as methodology mechanisms need them as context
|
|
249
|
+
|
|
250
|
+
---
|
|
251
|
+
|
|
252
|
+
## Status
|
|
253
|
+
|
|
254
|
+
- **2026-05-14:** Initial authoring. Software product type developed; other product types listed but Tier 2 deliverables not yet detailed exhaustively. CTO role file queued.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# Regenerates AGENT_ROLES_AND_DECISION_RIGHTS.md from roles/agent-roles.json and decision-rights.json.
|
|
2
|
+
import json,os
|
|
3
|
+
os.chdir(os.path.dirname(os.path.abspath(__file__)))
|
|
4
|
+
cat=json.load(open('roles/agent-roles.json')); dr=json.load(open('decision-rights.json'))
|
|
5
|
+
md=["---","type: reference","source: machine","created: "+cat["updated"],"ai-model: claude-opus-5.5","generated-from: roles/agent-roles.json, decision-rights.json","tags: [venture-template, roles, agents, decision-rights]","---","","# Agent roles and decision rights","","*Generated by `render-roles.py`. Decided in "+cat["governed_by"]+". Roles are templates; entities instantiate positions ([[position-schema]]).*","","## Roles","","| Role | Occupant | Model tier | Decides | Research | Reviews | Escalates to |","|---|---|---|---|---|---|---|"]
|
|
6
|
+
for r in cat["roles"]: md.append("| **%s** | %s | %s | %s | %s | %s | %s |"%(r['name'],r['occupant'],r['tier'],'; '.join(r['decides']),r['research'],r['reviews'],r['escalates_to'] or '—'))
|
|
7
|
+
md+=["",cat["conformance"],"","## Decision rights (template)","","| Class | Owner | Level | Condition |","|---|---|---|---|"]
|
|
8
|
+
for c in dr["classes"]: md.append("| %s | %s | **%s** | %s |"%(c['description'],c['owner'],c['level'],c.get('condition','')))
|
|
9
|
+
md+=["","Levels: "+"; ".join("**%s**: %s"%(k,v) for k,v in dr["levels"].items())]
|
|
10
|
+
open('AGENT_ROLES_AND_DECISION_RIGHTS.md','w').write("\n".join(md)+"\n")
|
|
11
|
+
print(len(cat["roles"]),"roles;",len(dr["classes"]),"classes")
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: venture-template-roles-readme
|
|
3
|
+
ai-model: claude-opus-5
|
|
4
|
+
source: hybrid
|
|
5
|
+
created: 2026-05-14
|
|
6
|
+
last-reviewed: 2026-08-10
|
|
7
|
+
updated: 2026-08-10
|
|
8
|
+
authorship: hybrid
|
|
9
|
+
authors: [the author, Claude]
|
|
10
|
+
ip-sensitivity: normal
|
|
11
|
+
scope: global
|
|
12
|
+
scope-entity: "[[everything-ecosystem]]"
|
|
13
|
+
tags: [venture-template, roles, methodology, position-schema]
|
|
14
|
+
related:
|
|
15
|
+
- "[[position-schema]]"
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
# `roles/` — role **templates** (not the org chart)
|
|
19
|
+
|
|
20
|
+
Per-role files describe what a seat *is in general* — responsibilities, non-responsibilities, pillar home. They are **role templates**.
|
|
21
|
+
|
|
22
|
+
**Position instances** (filled or vacant seats *in a specific company*, with occupancy human/agent/vacant/hybrid and team/project assignments) live on the entity under `business/org/positions/` (or brand/product `org/`). Canonical system: [[position-schema]]. Template: `_meta/templates/tpl-position.md`.
|
|
23
|
+
|
|
24
|
+
```
|
|
25
|
+
venture-template/roles/<slug>.md → what the role is
|
|
26
|
+
<entity>/business/org/positions/ → the seat here + who/what fills it
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
The roles folder is **selective, not exhaustive**. Most ICs and many specialist roles don't have a file here — they live in the pillar files at `pillars/` or as one-off position instances. A role gets its own template file when:
|
|
30
|
+
|
|
31
|
+
1. Methodology mechanisms invoke it as context (e.g., `/ceo-review` reads `ceo.md` to know what to evaluate).
|
|
32
|
+
2. The role is common across most companies regardless of stage / industry.
|
|
33
|
+
3. The role has distinct enough deliverables + collaboration patterns to warrant its own page (rather than being one section in a pillar file).
|
|
34
|
+
4. **Staffing posture matters** (e.g. forward-deployed engineer as a `human-required` archetype).
|
|
35
|
+
|
|
36
|
+
## Status of role files
|
|
37
|
+
|
|
38
|
+
| Role | Status | Pillar | File |
|
|
39
|
+
|---|---|---|---|
|
|
40
|
+
| CEO | Authored 2026-05-14 | Company-wide | [[ceo]] |
|
|
41
|
+
| CTO | Authored 2026-05-14 | Product (lead) | [[cto]] |
|
|
42
|
+
| CMO | Authored 2026-05-14 | Brand (lead) | [[cmo]] |
|
|
43
|
+
| COO | Authored 2026-05-14 | Business (lead) | [[coo]] |
|
|
44
|
+
| Founder | Authored 2026-05-14 | Company-wide | [[founder]] |
|
|
45
|
+
| Chief of Staff | Authored 2026-05-14 | Company-wide | [[chief-of-staff]] |
|
|
46
|
+
| HR Manager | Stub 2026-08-10 | Business | [[hr-manager]] |
|
|
47
|
+
| Talent Acquisition Manager | Stub 2026-08-10 | Business | [[talent-acquisition-manager]] |
|
|
48
|
+
| Department Head (pattern) | Stub 2026-08-10 | Pattern | [[department-head]] |
|
|
49
|
+
| Forward-Deployed Engineer | Stub 2026-08-10 | Product | [[forward-deployed-engineer]] |
|
|
50
|
+
| CFO | Future | Business | `cfo.md` |
|
|
51
|
+
| General Counsel | Future | Business | `general-counsel.md` |
|
|
52
|
+
| CRO / VP Sales | Future | Business | `cro.md` |
|
|
53
|
+
| CPO (People) | Future | Business | `cpo.md` |
|
|
54
|
+
| VP Engineering | Future | Product | `vp-engineering.md` |
|
|
55
|
+
| Designer (Product) | Future | Product (× Brand) | `designer-product.md` |
|
|
56
|
+
| Designer (Brand) | Future | Brand (× Product) | `designer-brand.md` |
|
|
57
|
+
| Product Manager | Future | Product | `pm.md` |
|
|
58
|
+
| Engineering Manager | Future | Product | `em.md` |
|
|
59
|
+
| Customer Success Lead | Future | Business (× Product) | `cs-lead.md` |
|
|
60
|
+
|
|
61
|
+
**Authoring wave:** 6 exec roles authored 2026-05-14. Functional stubs (HR, TA, FDE, department-head pattern) added 2026-08-10 with [[position-schema]]. Next priority remains CFO + General Counsel when Business scope expands beyond COO.
|
|
62
|
+
|
|
63
|
+
## Per-role file structure
|
|
64
|
+
|
|
65
|
+
Every per-role file follows the same shape:
|
|
66
|
+
|
|
67
|
+
1. **Purpose** — one paragraph on what the role is for
|
|
68
|
+
2. **Primary pillar + secondary pillars** — where the role sits
|
|
69
|
+
3. **Typical responsibilities** — what the role owns
|
|
70
|
+
4. **Typical deliverables** — artifacts the role produces or sponsors
|
|
71
|
+
5. **Reporting + collaboration patterns** — who the role reports to + who reports to it
|
|
72
|
+
6. **Stage variations** — how the role changes from early-stage to mature
|
|
73
|
+
7. **Methodology mechanisms** — skills, hooks, or commands that invoke this role
|
|
74
|
+
8. **Status**
|
|
75
|
+
|
|
76
|
+
Stubs may omit later sections until expanded.
|
|
77
|
+
|
|
78
|
+
## How this folder relates to the pillars
|
|
79
|
+
|
|
80
|
+
Pillar files (`pillars/*.md`) list typical roles by pillar with one-line descriptions. Per-role files expand those into substantive descriptions. The two cross-link:
|
|
81
|
+
|
|
82
|
+
- Pillar file lists "CTO — Product pillar lead" with a link to `roles/cto.md`.
|
|
83
|
+
- Per-role file links back to `pillars/product.md` for the pillar context.
|
|
84
|
+
|
|
85
|
+
When pillar work needs role-specific guidance (e.g., articulation closure for the Product pillar needs to know what the CTO should review), the methodology mechanism reads both the pillar file and the role file.
|