naive-framework 0.0.0-stage → 0.1.0

package/schema/validation-solution.schema.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "validation-solution.schema.json",
+  "title": "Validation: solution",
+  "description": "The solution sub-score (EE-026), at <venture>/purpose/validation/solution.json: how the venture solves the problem, what people use instead, and cited evidence that people in the segment choose it over their current way.",
+  "type": "object",
+  "required": [
+    "venture",
+    "statement",
+    "alternatives",
+    "evidence"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "venture": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date"
+    },
+    "statement": {
+      "type": "string",
+      "description": "How it solves the problem, in one or two sentences"
+    },
+    "product": {
+      "type": "string",
+      "description": "Product id, if one product carries the solution"
+    },
+    "alternatives": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string"
+      },
+      "description": "What people use instead today, including doing nothing"
+    },
+    "difference": {
+      "type": "string",
+      "description": "Why someone would switch"
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "$ref": "validation-evidence.schema.json"
+      }
+    },
+    "probability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "p",
+        "by",
+        "scored"
+      ],
+      "description": "The Jev probability for this sub-score; the evidence grade weighs it in the validation score",
+      "properties": {
+        "p": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "by": {
+          "enum": [
+            "jev",
+            "owner"
+          ]
+        },
+        "scored": {
+          "type": "string",
+          "format": "date"
+        },
+        "note": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/schema/validation-team.schema.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "validation-team.schema.json",
+  "title": "Validation: team",
+  "description": "The team sub-score (EE-026), at <venture>/purpose/validation/team.json: the skills the coming phases need, the skills held and by whom, and the gaps, including whether a cofounder is sought for them. schema/check-validation.mjs lists the gaps.",
+  "type": "object",
+  "required": [
+    "venture",
+    "needed",
+    "held",
+    "evidence"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "venture": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date"
+    },
+    "needed": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "skill",
+          "by_phase"
+        ],
+        "properties": {
+          "skill": {
+            "type": "string"
+          },
+          "by_phase": {
+            "enum": [
+              "discovery",
+              "validation",
+              "beachhead",
+              "scale",
+              "platform"
+            ]
+          },
+          "why": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "held": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "skill",
+          "by"
+        ],
+        "properties": {
+          "skill": {
+            "type": "string"
+          },
+          "by": {
+            "type": "string",
+            "description": "A role id, or 'agent:<role>' when an agent holds it"
+          }
+        }
+      }
+    },
+    "cofounder_sought": {
+      "type": "boolean"
+    },
+    "cofounder_skills": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "$ref": "validation-evidence.schema.json"
+      }
+    },
+    "probability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "p",
+        "by",
+        "scored"
+      ],
+      "description": "The Jev probability for this sub-score; the evidence grade weighs it in the validation score",
+      "properties": {
+        "p": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "by": {
+          "enum": [
+            "jev",
+            "owner"
+          ]
+        },
+        "scored": {
+          "type": "string",
+          "format": "date"
+        },
+        "note": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/schema/venture.schema.json

@@ -0,0 +1,407 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "venture.schema.json",
+  "title": "Venture",
+  "description": "One venture: anything a builder undertakes, from a hobby to a company (EE-011). Each venture keeps a venture.json at its root, beside its venture profile. Its products are cards in products/, the parties it keeps records for are accounts in accounts/ (optional, EE-021), and ventures can hold ventures. Cross-venture rules are checked by schema/check-ventures.mjs. Nouns follow docs/ontology.md (EE-014).",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "parent",
+    "phase",
+    "owner",
+    "status",
+    "layers"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$"
+    },
+    "name": {
+      "type": "string"
+    },
+    "kind": {
+      "enum": [
+        "venture",
+        "product"
+      ],
+      "default": "venture",
+      "description": "venture: building a venture, whose root and strategic foundation fail closed. product: a product without a venture, which fails open (EE-054)."
+    },
+    "parent": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "The id of the venture that holds this one; null at the top of a workspace."
+    },
+    "phase": {
+      "enum": [
+        "discovery",
+        "validation",
+        "beachhead",
+        "scale",
+        "platform"
+      ],
+      "description": "How far the venture has come (EE-012). discovery: does a real problem exist, and who has it. validation: will people adopt this solution and keep using it. beachhead: can it win one segment repeatably at a profitable cost. scale: how fast can it take the mass market. platform: what will others build on. Gates and references: purpose/frameworks/product-anatomy/phases.json."
+    },
+    "ambition": {
+      "enum": [
+        "hobby",
+        "survival",
+        "lifestyle",
+        "managed-growth",
+        "aggressive-growth"
+      ],
+      "description": "Why the venture exists and how far through the phases it means to go. hobby follows the IRS sense: not engaged in for profit."
+    },
+    "form": {
+      "type": "object",
+      "description": "Whether and how the venture is formalized.",
+      "properties": {
+        "legal_form": {
+          "enum": [
+            "none",
+            "sole-prop",
+            "partnership",
+            "llc",
+            "s-corp",
+            "c-corp",
+            "benefit-corp",
+            "nonprofit"
+          ]
+        },
+        "funding": {
+          "enum": [
+            "bootstrapped",
+            "grant",
+            "angel",
+            "venture-capital",
+            "debt",
+            "mixed"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "industry": {
+      "type": "object",
+      "description": "What the venture produces, by its current flagship. Re-checked at each phase gate.",
+      "required": [
+        "system",
+        "code"
+      ],
+      "properties": {
+        "system": {
+          "enum": [
+            "naics"
+          ],
+          "description": "NAICS (North American Industry Classification System), production-oriented"
+        },
+        "code": {
+          "type": "string",
+          "pattern": "^\\d{2,6}$"
+        },
+        "label": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "core": {
+      "type": "object",
+      "description": "The core product (Product Anatomy): what anyone can claim from this venture. Required once the venture leaves discovery.",
+      "required": [
+        "promise",
+        "promised_to",
+        "must_not",
+        "competence"
+      ],
+      "properties": {
+        "promise": {
+          "type": "string"
+        },
+        "promised_to": {
+          "type": "string"
+        },
+        "must_not": {
+          "type": "string",
+          "description": "What it must never deliver under its name"
+        },
+        "competence": {
+          "type": "string",
+          "description": "The core competence that makes the promise deliverable (Prahalad and Hamel)"
+        }
+      },
+      "additionalProperties": false
+    },
+    "departments": {
+      "type": "array",
+      "description": "The departments this venture imports, by id from operations/departments.json (EE-047). Only these get folders; the rest are not in the venture at all until need-now suggests them and the builder adds them (EE-048).",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9-]+$"
+      },
+      "uniqueItems": true
+    },
+    "brand": {
+      "type": "object",
+      "description": "The venture's verbal brand elements, owned by the brand pillar. Visual identity (tokens, logos) is a separate record.",
+      "properties": {
+        "tagline": {
+          "type": "string",
+          "description": "The brand's enduring short line, kept across campaigns (Burger King's 'Have it your way'). A campaign's slogan is not this; it belongs to the campaign."
+        }
+      },
+      "additionalProperties": false
+    },
+    "owner": {
+      "enum": [
+        "self",
+        "shared",
+        "other"
+      ]
+    },
+    "members": {
+      "type": "array",
+      "description": "The others who work in the venture, by role, people and agents alike: a string role (co-founder, partner, investor) or an object naming the kind. No personal details. Any member switches on governance, since agents need decision rights too.",
+      "items": {
+        "oneOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "object",
+            "required": [
+              "role",
+              "kind"
+            ],
+            "properties": {
+              "role": {
+                "type": "string",
+                "description": "A role id from the roles register (builder, architect) or a plain role"
+              },
+              "kind": {
+                "enum": [
+                  "person",
+                  "agent"
+                ]
+              },
+              "tools": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "For agents: the interfaces or runtimes it runs in (integration ids)"
+              }
+            },
+            "additionalProperties": false
+          }
+        ]
+      }
+    },
+    "governed_by": {
+      "type": "string"
+    },
+    "status": {
+      "enum": [
+        "active",
+        "paused",
+        "closed",
+        "archived"
+      ]
+    },
+    "opened": {
+      "type": "string",
+      "format": "date"
+    },
+    "closed": {
+      "type": "string",
+      "format": "date"
+    },
+    "profile": {
+      "type": "string",
+      "description": "Path to the venture profile (Markdown): narrative, pillars and changelog."
+    },
+    "layers": {
+      "type": "object",
+      "description": "Every venture has the same six layers (execution folded into operations, EE-038), at the depth it needs. A layer not used yet is false.",
+      "required": [
+        "purpose",
+        "knowledge",
+        "operations",
+        "evidence"
+      ],
+      "properties": {
+        "purpose": {
+          "$ref": "#/$defs/layer"
+        },
+        "knowledge": {
+          "$ref": "#/$defs/layer"
+        },
+        "operations": {
+          "$ref": "#/$defs/layer"
+        },
+        "evidence": {
+          "$ref": "#/$defs/layer"
+        },
+        "governance": {
+          "$ref": "#/$defs/layer"
+        },
+        "interface": {
+          "$ref": "#/$defs/layer"
+        }
+      },
+      "additionalProperties": false
+    },
+    "links": {
+      "type": "array",
+      "description": "What crosses from this venture into another, one way.",
+      "items": {
+        "type": "object",
+        "required": [
+          "to",
+          "access",
+          "carries"
+        ],
+        "properties": {
+          "to": {
+            "type": "string"
+          },
+          "access": {
+            "enum": [
+              "reads",
+              "shares-with"
+            ]
+          },
+          "carries": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "border": {
+            "enum": [
+              "closed",
+              "filtered",
+              "open"
+            ],
+            "default": "filtered"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "repos": {
+      "type": "array",
+      "description": "The venture's repositories (repo is short for repository): version-controlled stores, normally Git, holding code and the documents that ship with it (docs-as-code). The venture folder itself lives in the vault. A venture that builds software needs at least one; ventures in other industries may need none (EE-020)",
+      "items": {
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9.-]+$"
+          },
+          "url": {
+            "type": "string",
+            "format": "uri"
+          },
+          "location": {
+            "type": "string",
+            "description": "Path relative to the workspace's code folder"
+          },
+          "products": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Product ids whose code it holds"
+          }
+        }
+      }
+    },
+    "regulation": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "How much laws, regulators or formal standards constrain what the venture may do (EE-040; MAD's governance tier reads it as regulatory_exposure). The obligations themselves are founder decisions made with counsel.",
+      "properties": {
+        "exposure": {
+          "enum": [
+            "light",
+            "some",
+            "heavy"
+          ],
+          "description": "light: ordinary terms of service and licences. some: obligations such as personal data, accessibility rules or industry codes. heavy: health, finance, safety-critical or government work, where an auditor or regulator must be satisfied."
+        },
+        "regimes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The laws, regulators or standards that apply, such as GDPR, HIPAA or SOC 2"
+        }
+      }
+    }
+  },
+  "$defs": {
+    "layer": {
+      "oneOf": [
+        {
+          "const": false
+        },
+        {
+          "type": "object",
+          "required": [
+            "location"
+          ],
+          "properties": {
+            "location": {
+              "type": "string",
+              "description": "Folder path, relative to the folder that holds venture.json"
+            },
+            "tools": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "phase": {
+            "not": {
+              "const": "discovery"
+            }
+          }
+        },
+        "required": [
+          "phase"
+        ]
+      },
+      "then": {
+        "required": [
+          "core"
+        ]
+      }
+    }
+  ],
+  "additionalProperties": false
+}