naive-framework 0.0.0-stage → 0.2.0

package/schema/validation-evidence.schema.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "validation-evidence.schema.json",
+  "title": "Validation evidence item",
+  "description": "One piece of cited evidence behind a validation record (EE-026), shared by every validation sub-score. schema/check-validation.mjs grades each item from its kind, audience, sample, specificity and age (adapted from GRADE), and grades the record from its items. A claim with no evidence grades very low.",
+  "type": "object",
+  "required": [
+    "id",
+    "kind",
+    "summary",
+    "source",
+    "audience",
+    "collected"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$"
+    },
+    "kind": {
+      "enum": [
+        "behavior",
+        "commitment",
+        "stated",
+        "desk-research",
+        "opinion"
+      ],
+      "description": "behavior: what people did (retention, payments, repeat use, money or time already spent on workarounds); commitment: what they put at stake (deposit, pre-order, letter of intent, time booked); stated: what they said when asked (interview, survey); desk-research: published data or reports; opinion: unprompted praise, advice or compliments"
+    },
+    "summary": {
+      "type": "string",
+      "description": "What the evidence shows, specific enough to check"
+    },
+    "supports": {
+      "type": "boolean",
+      "default": true,
+      "description": "false when the evidence contradicts the claim"
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "description": "Where to see it: a URL with the date it was checked, or a file relative to the venture folder (interview notes, a data export), or both",
+      "properties": {
+        "title": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri"
+        },
+        "checked": {
+          "type": "string",
+          "format": "date"
+        },
+        "path": {
+          "type": "string"
+        }
+      }
+    },
+    "audience": {
+      "enum": [
+        "target",
+        "adjacent",
+        "wrong",
+        "unknown"
+      ],
+      "description": "Whether the people behind it are the venture's target segment for this claim (for pricing, the buyer)"
+    },
+    "sample": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "n"
+      ],
+      "properties": {
+        "n": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "types": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "specificity": {
+      "enum": [
+        "specific",
+        "general"
+      ],
+      "description": "specific: past facts, numbers, named instances; general: hypotheticals, generalities, opinions about the future (The Mom Test)"
+    },
+    "collected": {
+      "type": "string",
+      "format": "date"
+    },
+    "assumption": {
+      "enum": [
+        "exists",
+        "segment",
+        "hurts",
+        "why-now"
+      ],
+      "description": "Problem records only (EE-050): the assumption the item bears on. exists: the problem is real; segment: our segment has it; hurts: it costs enough that people already spend time or money on it; why-now: something has changed. Without it the item counts toward exists. schema/assess-problem.mjs labels each assumption from its items."
+    },
+    "origin": {
+      "enum": [
+        "first-hand",
+        "reported"
+      ],
+      "description": "first-hand: the venture saw it (its own interviews, payments, data exports); reported: someone else says so (a vendor's customer count, a report, a roundup). Defaults to first-hand for a file in the venture folder and reported for a URL. Only first-hand evidence can demonstrate an assumption (EE-050)."
+    },
+    "form": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "description": "Problem records only (EE-050): the id of the form the item bears on. It counts for that form and for the root."
+    }
+  }
+}

package/schema/validation-go-to-market.schema.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "validation-go-to-market.schema.json",
+  "title": "Validation: go-to-market",
+  "description": "The go-to-market sub-score (EE-026), at <venture>/purpose/validation/go-to-market.json: the path (build first, market first, cofounder first), the motion and the channels, with cited evidence that a channel reaches the segment at a known cost. The path sets the validation weights.",
+  "type": "object",
+  "required": [
+    "venture",
+    "path",
+    "channels",
+    "evidence"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "venture": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date"
+    },
+    "path": {
+      "enum": [
+        "build-first",
+        "market-first",
+        "cofounder-first"
+      ],
+      "description": "build-first: ship, then sell; market-first: market the core product before the flagship ships (waitlists, pre-orders); cofounder-first: form the team before the product"
+    },
+    "motion": {
+      "enum": [
+        "product-led",
+        "sales-led",
+        "marketing-led",
+        "community-led",
+        "partner-led"
+      ]
+    },
+    "channels": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "kind"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "kind": {
+            "type": "string",
+            "description": "e.g. search, social, outbound, referral, marketplace, partner, events"
+          },
+          "cost_per_customer": {
+            "type": "number",
+            "minimum": 0
+          },
+          "currency": {
+            "type": "string",
+            "pattern": "^[A-Z]{3}$"
+          },
+          "conversion": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          }
+        }
+      }
+    },
+    "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-operations-readiness.schema.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "validation-operations-readiness.schema.json",
+  "title": "Validation: operations readiness",
+  "description": "The operations-readiness sub-score (EE-026), at <venture>/purpose/validation/operations-readiness.json: one entry per MAD tier (governance, delivery, software engineering, automation), each with its own evidence; the record grades as its weakest tier.",
+  "type": "object",
+  "required": [
+    "venture",
+    "tiers",
+    "evidence"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "venture": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date"
+    },
+    "tiers": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "tier",
+          "evidence"
+        ],
+        "properties": {
+          "tier": {
+            "enum": [
+              "governance",
+              "delivery",
+              "software-engineering",
+              "automation"
+            ]
+          },
+          "ready_on": {
+            "type": "string",
+            "format": "date",
+            "description": "When the tier's records and checks first held for the phase's work"
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "$ref": "validation-evidence.schema.json"
+            }
+          }
+        }
+      }
+    },
+    "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-pricing.schema.json

@@ -0,0 +1,114 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "validation-pricing.schema.json",
+  "title": "Validation: pricing",
+  "description": "The pricing sub-score (EE-026), at <venture>/purpose/validation/pricing.json: the price model and points, who pays, and cited evidence that the buyer pays it.",
+  "type": "object",
+  "required": [
+    "venture",
+    "product",
+    "model",
+    "buyer",
+    "evidence"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "venture": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date"
+    },
+    "product": {
+      "type": "string"
+    },
+    "model": {
+      "enum": [
+        "subscription",
+        "one-time",
+        "usage",
+        "freemium",
+        "transaction-fee",
+        "licence",
+        "donation",
+        "other"
+      ]
+    },
+    "buyer": {
+      "type": "string",
+      "description": "Who pays; may differ from the user"
+    },
+    "points": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "amount",
+          "currency"
+        ],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "amount": {
+            "type": "number",
+            "minimum": 0
+          },
+          "currency": {
+            "type": "string",
+            "pattern": "^[A-Z]{3}$"
+          },
+          "period": {
+            "enum": [
+              "once",
+              "day",
+              "week",
+              "month",
+              "year",
+              "use"
+            ]
+          }
+        }
+      }
+    },
+    "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-problem.schema.json

@@ -0,0 +1,118 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "validation-problem.schema.json",
+  "title": "Validation: problem",
+  "description": "The problem sub-score (EE-026), at <venture>/purpose/validation/problem.json: the problem, who has it, how they cope today, and the cited evidence that it is real. A statement alone is the weakest form of this record; schema/check-validation.mjs grades it from its evidence.",
+  "type": "object",
+  "required": [
+    "venture",
+    "statement",
+    "segment",
+    "evidence"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "venture": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date"
+    },
+    "statement": {
+      "type": "string",
+      "description": "The problem in the words of the people who have it"
+    },
+    "segment": {
+      "type": "string",
+      "description": "Who has it, specifically enough to find them"
+    },
+    "frequency": {
+      "type": "string",
+      "description": "How often it happens to them"
+    },
+    "cost": {
+      "type": "string",
+      "description": "What it costs them now: money, time, risk"
+    },
+    "workarounds": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "How they cope today; money or time already spent on a workaround is strong evidence"
+    },
+    "why_now": {
+      "type": "string",
+      "description": "What has changed that makes the problem solvable or urgent now (EE-050)"
+    },
+    "forms": {
+      "type": "array",
+      "description": "The forms the problem takes (EE-050): one root problem in statement, and each form a narrower problem with its own segment and evidence, assessed on its own so it can be validated or dropped without touching the root",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "statement"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]+$"
+          },
+          "statement": {
+            "type": "string"
+          },
+          "segment": {
+            "type": "string",
+            "description": "Only when narrower than the root's"
+          },
+          "status": {
+            "enum": [
+              "open",
+              "dropped"
+            ],
+            "default": "open"
+          }
+        }
+      }
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "$ref": "validation-evidence.schema.json"
+      }
+    },
+    "probability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "p",
+        "by",
+        "scored"
+      ],
+      "description": "The Jev probability that the problem is real and worth solving for this segment; 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-product-market-fit.schema.json

@@ -0,0 +1,135 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "validation-product-market-fit.schema.json",
+  "title": "Validation: product-market fit",
+  "description": "The product-market fit sub-score (EE-026), at <venture>/purpose/validation/product-market-fit.json: whether a segment keeps using the product. Retention cohorts and the Sean Ellis survey are recorded as data; schema/check-validation.mjs reads them (does retention level off; what share would be very disappointed).",
+  "type": "object",
+  "required": [
+    "venture",
+    "product",
+    "segment",
+    "evidence"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "venture": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date"
+    },
+    "product": {
+      "type": "string"
+    },
+    "segment": {
+      "type": "string"
+    },
+    "retention": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "period",
+        "cohorts"
+      ],
+      "properties": {
+        "period": {
+          "enum": [
+            "day",
+            "week",
+            "month"
+          ]
+        },
+        "cohorts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "start",
+              "size",
+              "active"
+            ],
+            "properties": {
+              "start": {
+                "type": "string",
+                "format": "date"
+              },
+              "size": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "active": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "description": "Active users at the end of each period after the cohort started"
+              }
+            }
+          }
+        }
+      }
+    },
+    "ellis": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "asked",
+        "very_disappointed"
+      ],
+      "description": "Sean Ellis survey: how would you feel if you could no longer use the product? Asked of active users",
+      "properties": {
+        "asked": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "very_disappointed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "collected": {
+          "type": "string",
+          "format": "date"
+        }
+      }
+    },
+    "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"
+        }
+      }
+    }
+  }
+}