naive-framework 0.0.0-stage → 0.2.0

package/schema/examples/workspace/ventures/studio/print/venture.json

@@ -0,0 +1,37 @@
+{
+  "id": "studio-print",
+  "name": "Alex Studio print line",
+  "parent": "studio",
+  "phase": "validation",
+  "ambition": "lifestyle",
+  "core": {
+    "promise": "Restaurant print that matches the brand, delivered in two days",
+    "promised_to": "Alex Studio's restaurant clients",
+    "must_not": "Print that drifts from the brand system",
+    "competence": "Print-ready files from the brand system"
+  },
+  "owner": "self",
+  "status": "active",
+  "profile": "profile.md",
+  "layers": {
+    "purpose": {
+      "location": "purpose/"
+    },
+    "knowledge": {
+      "location": "knowledge/"
+    },
+    "operations": false,
+    "evidence": false
+  },
+  "links": [
+    {
+      "to": "studio",
+      "access": "shares-with",
+      "carries": [
+        "sales",
+        "costs"
+      ],
+      "border": "open"
+    }
+  ]
+}

package/schema/examples/workspace/ventures/studio/products/brand-care.json

@@ -0,0 +1,19 @@
+{
+  "id": "brand-care",
+  "name": "Brand Care",
+  "description": "Monthly updates to menus, seasonal signage and social posts in the restaurant's brand.",
+  "market": {
+    "customer": "b2b",
+    "segment": "independent restaurants",
+    "geography": "US-TX",
+    "vertical": true
+  },
+  "job": "Keep the brand current without hiring a designer",
+  "technology": "design service",
+  "offering": "service",
+  "business_model": [
+    "subscription"
+  ],
+  "allowed_from": "beachhead",
+  "status": "building"
+}

package/schema/examples/workspace/ventures/studio/products/brand-kit.json

@@ -0,0 +1,23 @@
+{
+  "id": "brand-kit",
+  "name": "Brand Kit",
+  "description": "Logo, menu, signage and site templates built in one week for a restaurant about to open.",
+  "market": {
+    "customer": "b2b",
+    "segment": "restaurants about to open",
+    "geography": "US-TX",
+    "vertical": true
+  },
+  "job": "Open with a menu, sign and site that match",
+  "technology": "design service plus templates",
+  "offering": "service",
+  "business_model": [
+    "fee-for-service",
+    "add-on"
+  ],
+  "allowed_from": "validation",
+  "flows_to": [
+    "brand-care"
+  ],
+  "status": "live"
+}

package/schema/examples/workspace/ventures/studio/provenance.jsonl

@@ -0,0 +1,3 @@
+{"at":"2026-10-27T21:01:55.765Z","entity":"accounts/bakery/account.json","route":"purpose/account","activity":"baseline","agent":{"kind":"agent","via":"cli","id":"builder","harness":"Claude Code"},"note":"existed before the provenance log; its history before this is in git","sha256":"370c11ef6365be264e0ea7799f261ff5dc058a6860b34fb3066261324b160d22","prev":"genesis","hash":"faa7d64c6c62a66e8e33fb27368e8555afd6cdc9cfe42d6ab0d44e7eff3adf4a"}
+{"at":"2026-10-27T21:01:55.767Z","entity":"products/brand-care.json","route":"purpose/product","activity":"baseline","agent":{"kind":"agent","via":"cli","id":"builder","harness":"Claude Code"},"note":"existed before the provenance log; its history before this is in git","sha256":"bd1540d50f1cc51fcc7b071d47ee1287ab63bb0cf932723f092ddac9a392032f","prev":"faa7d64c6c62a66e8e33fb27368e8555afd6cdc9cfe42d6ab0d44e7eff3adf4a","hash":"db84fc785cb173ce50b69751fc92582be55d2a2eb03f901ed14606ce317ddf4d"}
+{"at":"2026-10-27T21:01:55.767Z","entity":"products/brand-kit.json","route":"purpose/product","activity":"baseline","agent":{"kind":"agent","via":"cli","id":"builder","harness":"Claude Code"},"note":"existed before the provenance log; its history before this is in git","sha256":"aea7058e9feb3f722d06e36f184352e84c7430a08dab76e1fd0aa92d6d31bae2","prev":"db84fc785cb173ce50b69751fc92582be55d2a2eb03f901ed14606ce317ddf4d","hash":"26b51e9a180e596a787aa5c8909d8abf634e5b5be88d0f45abd3554985a65467"}

package/schema/examples/workspace/ventures/studio/venture.json

@@ -0,0 +1,43 @@
+{
+  "id": "studio",
+  "name": "Alex Studio",
+  "parent": null,
+  "phase": "beachhead",
+  "ambition": "managed-growth",
+  "form": {
+    "legal_form": "llc",
+    "funding": "bootstrapped"
+  },
+  "industry": {
+    "system": "naics",
+    "code": "541430",
+    "label": "Graphic Design Services"
+  },
+  "core": {
+    "promise": "A brand that looks established on day one",
+    "promised_to": "Independent restaurant owners",
+    "must_not": "Templates passed off as custom work",
+    "competence": "Fast brand systems built from a restaurant's own story"
+  },
+  "owner": "self",
+  "status": "active",
+  "opened": "2025-03-01",
+  "profile": "profile.md",
+  "layers": {
+    "purpose": {
+      "location": "purpose/"
+    },
+    "knowledge": {
+      "location": "knowledge/"
+    },
+    "operations": {
+      "location": "operations/"
+    },
+    "evidence": {
+      "location": "evidence/"
+    },
+    "governance": {
+      "location": "governance/"
+    }
+  }
+}

package/schema/examples/workspace/ventures/tandem/evidence/README.md

@@ -0,0 +1,3 @@
+# evidence
+
+Did it work: reviews, evals and metrics.

package/schema/examples/workspace/ventures/tandem/governance/README.md

@@ -0,0 +1,3 @@
+# governance
+
+Who may decide what: roles and decision rights.

package/schema/examples/workspace/ventures/tandem/governance/agreements/dee-fast.md

@@ -0,0 +1,3 @@
+# Advisor agreement: Dee Park (example)
+
+Fictional example. Based on the Founder Institute's FAST template: standard advisor, 0.5% of common over 24 months.

package/schema/examples/workspace/ventures/tandem/governance/board.json

@@ -0,0 +1,51 @@
+{
+  "updated": "2026-10-01",
+  "boards": [
+    {
+      "id": "directors",
+      "kind": "formal",
+      "formed": "2026-09-15",
+      "meets": "every-6-weeks",
+      "seats": [
+        {
+          "id": "seat-common-1",
+          "person": "Ana Reyes",
+          "type": "founder",
+          "appointed_by": "common"
+        },
+        {
+          "id": "seat-preferred",
+          "person": "Jo Lark",
+          "type": "investor",
+          "appointed_by": "series-seed"
+        },
+        {
+          "id": "seat-independent",
+          "person": null,
+          "type": "independent",
+          "appointed_by": "board"
+        }
+      ],
+      "reserved_matters": [
+        "issue or reclassify shares",
+        "approve the annual budget",
+        "hire or remove the CEO",
+        "sell, merge or wind down the company",
+        "take on debt over 100,000 USD"
+      ]
+    },
+    {
+      "id": "advisors",
+      "kind": "advisory",
+      "meets": "quarterly",
+      "seats": [
+        {
+          "id": "seat-dee",
+          "person": "Dee Park",
+          "type": "advisor",
+          "appointed_by": "board"
+        }
+      ]
+    }
+  ]
+}

package/schema/examples/workspace/ventures/tandem/governance/departments/finance/charter.md

@@ -0,0 +1,5 @@
+# Finance and accounting: charter
+
+Holds: Spending authority, controls and audit.
+
+APQC 9.0 Manage Financial Resources; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/tandem/governance/departments/finance/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "finance",
+  "value_chain": "support",
+  "apqc": "9.0"
+}

package/schema/examples/workspace/ventures/tandem/governance/departments/primary/marketing-and-sales/charter.md

@@ -0,0 +1,5 @@
+# Marketing and sales: charter
+
+Holds: Brand guidelines and the publication policy.
+
+APQC 3.0 Market and Sell Products and Services; value chain: primary (marketing and sales).

package/schema/examples/workspace/ventures/tandem/governance/departments/primary/marketing-and-sales/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "marketing-and-sales",
+  "value_chain": "primary",
+  "apqc": "3.0"
+}

package/schema/examples/workspace/ventures/tandem/governance/exit.json

@@ -0,0 +1,33 @@
+{
+  "paths": [
+    {
+      "kind": "acquisition",
+      "stance": "preferred",
+      "note": "Vertical software buyers consolidate small-business tools"
+    },
+    {
+      "kind": "ipo",
+      "stance": "open"
+    },
+    {
+      "kind": "wind-down",
+      "stance": "open",
+      "note": "If the seed runs out without traction"
+    }
+  ],
+  "scenarios": [
+    {
+      "id": "soft-landing",
+      "value": 3000000,
+      "note": "Acqui-hire"
+    },
+    {
+      "id": "base",
+      "value": 40000000
+    },
+    {
+      "id": "strong",
+      "value": 150000000
+    }
+  ]
+}

package/schema/examples/workspace/ventures/tandem/governance/founder-agreement.json

@@ -0,0 +1,24 @@
+{
+  "signed": "2026-03-02",
+  "document": "governance/founder-agreement.md",
+  "founders": [
+    {
+      "holder": "ana",
+      "role": "CEO",
+      "commitment": "full-time",
+      "ip_assigned": true
+    },
+    {
+      "holder": "ben",
+      "role": "CTO",
+      "commitment": "full-time",
+      "ip_assigned": true
+    }
+  ],
+  "departure": {
+    "good_leaver": "Keeps vested shares; the company may buy unvested shares back at cost",
+    "bad_leaver": "Keeps vested shares; unvested shares return at cost",
+    "buyback": "unvested-at-cost"
+  },
+  "deadlock": "Founders talk it through with the independent director; if still split, the CEO decides product and the CTO decides engineering"
+}

package/schema/examples/workspace/ventures/tandem/governance/founder-agreement.md

@@ -0,0 +1,3 @@
+# Founder agreement (example)
+
+Fictional example for the schema. A real agreement is drafted with counsel; this file would hold its text or point to the signed copy.

package/schema/examples/workspace/ventures/tandem/governance/ownership.json

@@ -0,0 +1,131 @@
+{
+  "updated": "2026-10-01",
+  "unit": "shares",
+  "currency": "USD",
+  "classes": [
+    {
+      "id": "common",
+      "kind": "common",
+      "votes_per_share": 1
+    },
+    {
+      "id": "series-seed",
+      "kind": "preferred",
+      "votes_per_share": 1,
+      "price_per_share": 1,
+      "liquidation": {
+        "multiple": 1,
+        "participating": false,
+        "seniority": 1
+      },
+      "rights": [
+        "board-seat",
+        "information",
+        "pro-rata",
+        "protective-provisions",
+        "anti-dilution-broad-based",
+        "drag-along",
+        "right-of-first-refusal",
+        "co-sale"
+      ]
+    }
+  ],
+  "holders": [
+    {
+      "id": "ana",
+      "name": "Ana Reyes",
+      "kind": "founder",
+      "role": "founder"
+    },
+    {
+      "id": "ben",
+      "name": "Ben Okafor",
+      "kind": "founder",
+      "role": "founder"
+    },
+    {
+      "id": "pool",
+      "name": "Option pool",
+      "kind": "pool"
+    },
+    {
+      "id": "dee",
+      "name": "Dee Park",
+      "kind": "advisor",
+      "agreement": "governance/agreements/dee-fast.md"
+    },
+    {
+      "id": "lark-ventures",
+      "name": "Lark Ventures",
+      "kind": "investor"
+    },
+    {
+      "id": "angel-one",
+      "name": "Sam Wu",
+      "kind": "investor"
+    }
+  ],
+  "grants": [
+    {
+      "holder": "ana",
+      "class": "common",
+      "amount": 4000000,
+      "granted": "2026-03-02",
+      "vesting": {
+        "start": "2026-03-02",
+        "months": 48,
+        "cliff_months": 12,
+        "acceleration": "double-trigger"
+      }
+    },
+    {
+      "holder": "ben",
+      "class": "common",
+      "amount": 4000000,
+      "granted": "2026-03-02",
+      "vesting": {
+        "start": "2026-03-02",
+        "months": 48,
+        "cliff_months": 12,
+        "acceleration": "double-trigger"
+      }
+    },
+    {
+      "holder": "pool",
+      "class": "common",
+      "amount": 1000000
+    },
+    {
+      "holder": "dee",
+      "class": "common",
+      "amount": 50000,
+      "granted": "2026-05-01",
+      "vesting": {
+        "start": "2026-05-01",
+        "months": 24,
+        "cliff_months": 3,
+        "acceleration": "single-trigger"
+      }
+    },
+    {
+      "holder": "lark-ventures",
+      "class": "series-seed",
+      "amount": 2000000,
+      "granted": "2026-09-15"
+    }
+  ],
+  "instruments": [
+    {
+      "id": "safe-wu",
+      "holder": "angel-one",
+      "kind": "safe-post-money",
+      "amount": 250000,
+      "signed": "2026-10-01",
+      "valuation_cap": 20000000,
+      "converts_to": "series-a",
+      "rights": [
+        "pro-rata"
+      ]
+    }
+  ]
+}

package/schema/examples/workspace/ventures/tandem/governance/publication-policy.json

@@ -0,0 +1,171 @@
+{
+  "venture": "tandem",
+  "updated": "2026-10-27",
+  "note": "A venture-backed example: a product website and investor updates. The founders approve together anything about money or control.",
+  "teams": [
+    {
+      "id": "founders",
+      "name": "The founders",
+      "pillar": "business",
+      "members": [
+        "founder"
+      ]
+    }
+  ],
+  "guidelines": [
+    {
+      "id": "brand",
+      "title": "Brand pillar: voice and visual identity",
+      "kind": "brand",
+      "owner": "brand",
+      "path": "pillars/brand.md"
+    },
+    {
+      "id": "ftc-endorsements",
+      "title": "FTC Endorsement Guides: disclose paid or free-product endorsements",
+      "kind": "legal",
+      "url": "https://www.ftc.gov/business-guidance/resources/ftcs-endorsement-guides-what-people-are-asking",
+      "checked": "2026-10-27"
+    },
+    {
+      "id": "information-rights",
+      "title": "Investor information rights in the cap table: who receives updates",
+      "kind": "disclosure",
+      "owner": "founder",
+      "path": "governance/ownership.json"
+    },
+    {
+      "id": "substack-content",
+      "title": "Substack Content Guidelines",
+      "kind": "platform",
+      "url": "https://substack.com/content",
+      "checked": "2026-10-27"
+    }
+  ],
+  "channels": [
+    {
+      "id": "website",
+      "name": "Product website",
+      "kind": "website",
+      "destination": "the venture's public website",
+      "audience": "prospective customers",
+      "guidelines": [
+        "brand",
+        "ftc-endorsements"
+      ],
+      "rules": [
+        {
+          "content": "product pages",
+          "from_layers": [
+            "purpose",
+            "knowledge"
+          ],
+          "drafters": [
+            "builder"
+          ],
+          "approvers": [
+            "founder"
+          ]
+        },
+        {
+          "content": "funding announcement",
+          "from_layers": [
+            "governance"
+          ],
+          "drafters": [
+            "builder"
+          ],
+          "approvers": [
+            "founders"
+          ]
+        }
+      ],
+      "checks": [
+        {
+          "id": "brand-review",
+          "check": "Copy follows the brand pillar's voice and every endorsement discloses its connection",
+          "kind": "review"
+        }
+      ],
+      "preview": "A staging deploy the approver reads before it goes live"
+    },
+    {
+      "id": "substack",
+      "name": "Tandem newsletter",
+      "kind": "newsletter",
+      "platform": "substack",
+      "destination": "the venture's Substack publication",
+      "audience": "customers and followers",
+      "guidelines": [
+        "brand",
+        "ftc-endorsements",
+        "substack-content"
+      ],
+      "rules": [
+        {
+          "content": "newsletter post",
+          "from_layers": [
+            "purpose",
+            "knowledge",
+            "evidence"
+          ],
+          "drafters": [
+            "builder"
+          ],
+          "approvers": [
+            "founder"
+          ]
+        }
+      ],
+      "replies": {
+        "mode": "delegated",
+        "delegates": [
+          "founder"
+        ],
+        "note": "Either founder may answer comments within the brand pillar's voice; anything about money, control or a customer's data goes through the gate"
+      },
+      "checks": [
+        {
+          "id": "brand-review",
+          "check": "Copy follows the brand pillar's voice and every endorsement discloses its connection",
+          "kind": "review"
+        }
+      ],
+      "preview": "Substack's test email to the approver"
+    },
+    {
+      "id": "investor-update",
+      "name": "Monthly investor update",
+      "kind": "investor-update",
+      "destination": "holders with information rights",
+      "audience": "investors",
+      "guidelines": [
+        "brand",
+        "information-rights"
+      ],
+      "rules": [
+        {
+          "content": "monthly update",
+          "from_layers": [
+            "evidence",
+            "governance"
+          ],
+          "drafters": [
+            "builder"
+          ],
+          "approvers": [
+            "founders"
+          ]
+        }
+      ],
+      "checks": [
+        {
+          "id": "cap-table-consistent",
+          "check": "node schema/check-governance.mjs schema/examples/workspace/ventures/tandem",
+          "kind": "conformance"
+        }
+      ],
+      "preview": "The draft email sent to the founders first"
+    }
+  ]
+}

package/schema/examples/workspace/ventures/tandem/knowledge/README.md

@@ -0,0 +1,3 @@
+# knowledge
+
+What is known and intended: notes, specs, decisions and references (SAD).

package/schema/examples/workspace/ventures/tandem/knowledge/research/friends-feedback-2026-08.md

@@ -0,0 +1,3 @@
+# Feedback from friends, August 2026 (example)
+
+Fictional. Six friends of the founders, none of whom run a shop, said a one-phone shop app "sounds really useful".

package/schema/examples/workspace/ventures/tandem/knowledge/research/pilot-2026-10.md

@@ -0,0 +1,3 @@
+# Pilot, July to October 2026 (example)
+
+Fictional. Eleven shops from the problem interviews ran the shop app in a paid pilot at $49 a month. Weekly active shops by week are in purpose/validation/product-market-fit.json. In October, 34 active users across the shops answered the Sean Ellis survey; 16 said they would be very disappointed without the app. Two shops cancelled over price, and both were one-person shops outside the segment.

package/schema/examples/workspace/ventures/tandem/knowledge/research/problem-interviews-2026-09.md

@@ -0,0 +1,20 @@
+# Problem interviews, September 2026 (example)
+
+Fictional notes for the tandem example venture. Twelve owners of two-to-ten-person service shops (salons, repair shops, studios), found through local business directories, interviewed using The Mom Test: past facts only, no pitch.
+
+| # | Shop | Staff | Tools in use for bookings, stock and payroll | Hours a week on admin | Paid for a fix in the last year |
+| --- | --- | --- | --- | --- | --- |
+| 1 | Hair salon | 4 | 3 | 6 | yes |
+| 2 | Bike repair | 3 | 4 | 5 | yes |
+| 3 | Nail studio | 6 | 3 | 8 | yes |
+| 4 | Phone repair | 2 | 2 | 3 | no |
+| 5 | Barber | 5 | 3 | 7 | yes |
+| 6 | Tailor | 3 | 1 | 2 | no |
+| 7 | Pet grooming | 7 | 4 | 9 | yes |
+| 8 | Massage studio | 4 | 3 | 5 | yes |
+| 9 | Shoe repair | 2 | 2 | 4 | no |
+| 10 | Tattoo studio | 6 | 3 | 6 | yes |
+| 11 | Salon | 9 | 5 | 10 | yes |
+| 12 | Print shop | 5 | 3 | 6 | yes |
+
+Nine of twelve pay for three or more separate tools and spend five or more hours a week reconciling them.

package/schema/examples/workspace/ventures/tandem/knowledge/sources.json

@@ -0,0 +1,8 @@
+{
+  "sources": [],
+  "records": {},
+  "rules": [
+    { "record": "product", "attribute": "*", "phase": "*", "product": "*", "account": "*", "actor": "*", "system_of_record": "venture", "owner": "founder", "note": "Product cards live in the venture folder; the founder owns them" }
+  ],
+  "note": "Example source-of-truth matrix (EE-042). A venture that keeps a record type elsewhere adds that source to `sources` and points a rule at it."
+}

package/schema/examples/workspace/ventures/tandem/knowledge/where-used.json

@@ -0,0 +1,13 @@
+{
+  "facts": [
+    {
+      "id": "shop-app-name",
+      "parent": { "route": "purpose/product/shop-app", "pointer": "/name" },
+      "children": [
+        { "source": "venture", "path": "profile.md", "match": { "kind": "text", "template": "{value}" }, "status": "live", "deliver": "agent", "note": "The profile names the product" },
+        { "source": "venture", "path": "evidence/README.md", "match": { "kind": "text", "template": "{value}" }, "status": "frozen", "deliver": "person", "note": "Example of history: never checked or changed" }
+      ]
+    }
+  ],
+  "note": "Example where-used list (EE-042): a price would work the same way, with the pricing page, newsletters and the payment provider as children."
+}