@rubytech/create-maxy-code 0.1.107 → 0.1.108

package/payload/{premium-plugins/founder-pack → platform/plugins/venture-studio}/skills/investor-data-room/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: investor-data-room
-description: Use when a UK-domiciled founder needs to produce a full seed-raise pack from idea to deliverables: graph-structured data room, 15-section business plan, 12-slide deck blueprint, print-ready HTML+PDF for both. Trigger phrases include "build me a data room", "draft a business plan", "deck from the business plan", "print-ready PDF for the prospectus", "from office hours to investor pack", "set up the fundraise repo". The skill never speculates on financial figures or cap-table values: every number traces to a Companies House filing, a financial model worksheet, or a source citation. Public-facing artefacts contain zero internal workings (no "reconciliation pending", no "open Q" markers, no comparison-to-baseline commentary). Design tokens are harmonised across business plan, deck, and prospectus per `realagent-site/.docs/design-tokens.md`.
+description: Use when a UK-domiciled founder needs to produce a full seed-raise pack from idea to deliverables: graph-structured data room, 15-section business plan, persuasive prospectus + formal term sheet (with FCA self-certification appendices), 12-slide deck blueprint, print-ready HTML+PDF for each. Trigger phrases include "build me a data room", "draft a business plan", "deck from the business plan", "draft an investment prospectus", "generate a term sheet", "from office hours to investor pack", "set up the fundraise repo". The skill never speculates on financial figures or cap-table values: every number traces to a Companies House filing, a financial model worksheet, or a source citation. Public-facing artefacts contain zero internal workings (no "reconciliation pending", no "open Q" markers, no comparison-to-baseline commentary). Design tokens are harmonised across business plan, prospectus, term sheet, and deck via the operator's project design-tokens spec.
 allowed-tools:
   - Bash
   - Read
@@ -78,7 +78,7 @@ Skip stages that are already complete; do not regenerate stale artefacts blindly
 
 ## Stage 1 — Office-hours ideation
 
-Drive a conversational discovery session using the `/office-hours` skill (or equivalent YC-style forcing questions: demand reality, status quo, desperate specificity, narrowest wedge, observation, future-fit). Output a single `office-hours-design.md` capturing:
+Drive a conversational discovery session using the sibling `office-hours` skill. Output a single `office-hours-design.md` capturing:
 
 - Problem statement
 - Demand evidence (with numbers and dates)
@@ -158,7 +158,7 @@ Generate `html/prospectus/term_sheet.html` as an **A4 portrait, 10-page formal t
 
 **Doctrine for the term sheet:**
 
-- **Entity name is the IN01-filed name**, not a marketing entity. Issuer must read as the actual filed company (e.g. "Real Agent Network Limited" not "Real Agent Systems Ltd").
+- **Entity name is the IN01-filed name**, not a marketing entity. Issuer must read as the actual filed company (e.g. the name on the IN01 statement of capital, not the trading or marketing brand).
 - **Cap table matches the IN01 + Round 1 dilution model exactly.** Pre-investment shares + new investor Round Shares = post-investment total. No fractional shares; no rounding to the % column that breaks share totals.
 - **Founder list reads exactly as the cap table.** No phantom founders. Strategic shareholders (e.g. an investing LLP) ride in the cap table by entity name, not via their individuals.
 - **Sole director on IN01 is the director-designate.** A term sheet that names two directors when IN01 names one is a defect.
@@ -185,10 +185,110 @@ Generate `01-narrative/deck-blueprint.md` as a **12-slide brief** the deck desig
 11. Milestones (M0 to M-final timeline)
 12. Other Information (compliance + platform dependency + contact)
 
-Production notes attached: format (16:9 landscape, PDF + source deck), design tokens reference (`realagent-site/.docs/design-tokens.md` or project equivalent), chart-source consistency with the financial model, speaker-note attribution.
+Production notes attached: format (16:9 landscape, PDF + source deck), design tokens reference (the operator's project design-tokens spec, path supplied at Stage 5 invocation), chart-source consistency with the financial model, speaker-note attribution.
 
 References: `references/deck-blueprint-template.md`.
 
+## Stage 4b — Prospectus synthesis
+
+Generate `html/prospectus/index.html` as an **A4 portrait, 7-page persuasive prospectus** alongside the formal term sheet from Stage 3b. The prospectus is the narrative companion to the term sheet: cover + executive summary + architecture + go-to-market + platform asset + operating plan + use of funds / founders / team.
+
+The templates live under `templates/prospectus/`:
+
+```
+templates/prospectus/
+  index.html          # 7-page prospectus with {{ placeholders }}
+  term_sheet.html     # 8-page term sheet with {{ placeholders }} (shared with Stage 3b)
+  render-pdf.mjs      # image-only PDF renderer (shared with Stage 5)
+```
+
+**Intake — ask these before substituting any placeholder.** Group by section; wait for answers before drafting.
+
+*Company identity:*
+
+1. Legal name of the company (use "to be incorporated" if pre-IN01).
+2. Trading / brand name (topbar + body copy + signatures).
+3. Tagline / one-paragraph deck — what does the company do, who is it for, why is it different. ≤ 80 words.
+4. Brand icon — 22×22 px PNG/SVG mark. Save as `<brand>-icon.png` alongside the HTML.
+5. Cover hero image — landscape photograph, ≥ 2800 px on the long edge. Save as `hero.png` alongside the HTML.
+6. Document month / year (topbar meta, e.g. "May 2026").
+7. Document IDs — short refs for footers: prospectus (e.g. "ACME / FIN-001 / V1.0") and term sheet (e.g. "ACME / TS-001 / V1.0").
+
+*The round:*
+
+8. Round size, gross, £.
+9. Post-money valuation cap, £.
+10. Issue price per share, £. Confirm split between nominal value (typically £0.01) and share premium.
+11. Number of new Round Shares (= round size ÷ issue price).
+12. Founder shares retained at close — total and percentage (typically 80%).
+13. Total shares post-closing.
+14. Minimum cheque per investor, £.
+15. Minimum aggregate raise, £, below which the round does not proceed.
+16. Round close date and funds expected date (DD Month YYYY).
+17. Use-of-proceeds split — typically four buckets (product, GTM, infrastructure, working capital + legal) totalling 100%.
+
+*Founders and team:*
+
+18. Founders — for each: full name, role, share count, percentage. Mark full-time vs advisors.
+19. Director-designates at closing (at least one executive director).
+20. NED nomination right — confirm threshold (e.g. any investor ≥ 10% may nominate one NED, subject to founder approval not unreasonably withheld).
+21. Observer threshold (typically ≥ 5%).
+22. First product hires planned in Y1 — trigger conditions for each.
+
+*The thesis (narrative):*
+
+23. The market — size, growth rate, target customer cohort. Cite sources (ONS, industry reports, named studies).
+24. The opportunity / problem — what is currently broken or unmet.
+25. Value proposition — pricing, what the customer gets, why it beats alternatives.
+26. Architecture and differentiation — the structural moat. What does the company do that nobody else does? "AI" is not a moat; the moat is in *how* AI is applied.
+27. Wedge → beachhead → blitzscale — staged GTM. Wedge = narrow entry product. Beachhead = one decisively winnable segment funded by Round 1. Blitzscale = market expansion funded by Round 2.
+28. Distribution funnel — specific channels producing customers in months 1–6. Concrete: integrations, channels, named partners.
+29. Pilots / paying customers at close — name them, who runs them, what they're paying.
+
+*Financial model:*
+
+30. Opening cash post-close — founder subscription + this round proceeds, less any capex at M0.
+31. Capex at M0 — one-off hardware / set-up costs.
+32. Monthly burn by phase — M1–M2 (founders only), M3–M9 (with first hire), M10–M12 (with second hire). Per-line breakdown.
+33. MRR ramp — month-by-month MRR for M1–M12. Distinguish customer segments.
+34. Customer count and device count by month if hardware is part of the offering.
+35. Cash trajectory — month-by-month closing cash balance derived from (33) − burn. Identify cash low point and break-even month.
+36. Round 2 plan — size range, timing (which month), gating milestones, what it funds.
+
+*Operational / legal:*
+
+37. Founder IP assignment — who is assigning IP to the company at closing? Outright? Any licence-back?
+38. Conditions to closing — incorporation, IP assignment, DD, shareholders' agreement, cleared funds.
+39. Governing law — confirm "English law, Exclusive jurisdiction of England & Wales courts" or substitute.
+40. Long-form documentation timeline — within how many days of mutual signature will the subscription & shareholders' agreement and articles be circulated?
+
+If the operator cannot answer (28), (33–35), or (36), flag explicitly that the prospectus will be incomplete and ask for sensible base-case assumptions. The financial chart on the cover and the operating-plan section both depend on these numbers.
+
+**How to apply answers.**
+
+1. Copy `templates/prospectus/{index.html, term_sheet.html, render-pdf.mjs}` into `html/prospectus/`.
+2. Save the operator-supplied hero image as `hero.png` and brand icon as `<brand>-icon.png`.
+3. Replace **global atomic placeholders** in both HTML files (the templates already carry these): `{{ BRAND_NAME }}`, `{{ COMPANY_LEGAL_NAME }}`, `{{ BRAND_ICON }}`, `{{ HERO_IMAGE }}`, `{{ TERM_SHEET_HTML }}`, `{{ TERM_SHEET_PDF }}`, `{{ PROSPECTUS_PDF }}`, `{{ TERM_SHEET_DOC_ID }}`, `{{ PROSPECTUS_DOC_ID }}`, `{{ DOC_MONTH_YEAR }}`, `{{ ROUND_SIZE }}`, `{{ POST_MONEY_CAP }}`, `{{ ISSUE_PRICE }}`, `{{ NOMINAL_VALUE }}`, `{{ SHARE_PREMIUM }}`, `{{ ROUND_SHARES }}`, `{{ FOUNDER_SHARES }}`, `{{ TOTAL_SHARES_POST }}`, `{{ MIN_CHEQUE }}`, `{{ MIN_AGGREGATE }}`, `{{ ROUND_CLOSE_DATE }}`, `{{ FUNDS_EXPECTED_DATE }}`, `{{ NEW_INVESTOR_PCT }}`, `{{ FOUNDERS_PCT }}`.
+4. Replace **narrative blocks** in `index.html` paragraph-by-paragraph using the answers from sections (23)–(29) and (32)–(36). The placeholder narrative blocks are structural references, not content to keep.
+5. Replace **cap table rows** in `term_sheet.html` (`<tr>` inside `<div class="captable">`) with the operator's actual founder names, roles, share counts, percentages.
+6. Replace **signature block** in `term_sheet.html` with the director-designates.
+7. Replace **financial chart data** in `index.html`. The cover chart is hand-coded SVG — find the `<polyline points="...">` for the cash line, the `<rect>` MRR bars, and the burn step-lines, and recompute coordinates from the new financial model (each MRR bar's `y` = `290 - (mrr_k / 60) * 120`, height = `120 - y_offset`). If recomputation is non-trivial, ask the operator for the 12 monthly cash and MRR values directly.
+8. Update `<title>` and `<meta>` tags to reflect the new company.
+
+**Doctrine for the prospectus.**
+
+- **UK seed round only.** The templates encode UK FCA self-certification under FSMA 2000 (FPO) articles 48 (HNWI) and 50A (Self-certified Sophisticated Investor). Do not adapt for US, EU, or non-UK regimes without explicit operator instruction — the legal exemption text is jurisdiction-specific.
+- **SEIS/EIS is post-funding, not a closing contingency.** The templates state that SEIS/EIS advance assurance will be pursued *after* the round closes and is not a condition of subscription. Do not promote SEIS/EIS as assured before distribution — it is misleading and breaks the FCA exemption.
+- **Image-only PDF via Stage 5's `render-pdf.mjs`.** Same pipeline; the prospectus shares one renderer with the business plan and deck.
+- **A4 fit is enforced.** Every `<section class="page">` must have `scrollHeight ≤ 1123 px + 2 px slack`. The remedy on overflow is to split the section into two `<section class="page">` blocks — never to shrink fonts or pad less.
+- **Render to the same folder as the HTML.** The renderer reads relative asset paths (icon, hero image).
+
+**Verify before shipping.**
+
+1. Read every PNG in `.tmp-*/`. `pdfinfo` reporting "7 pages, A4" is not verification. Confirm: content fills the page, no whitespace gaps > 25 mm at the bottom, the cover hero looks right, the chart values match the model, founder names are spelled correctly, the cap table totals to 100%.
+2. Hero image resolution floor: 2800 px on the long edge. Below that the cover prints soft.
+3. The two FCA self-cert pages render cleanly — HNWI (FPO art. 48) and Sophisticated (FPO art. 50A). These are legally prescribed text; do not edit their wording without lawyer sign-off.
+
 ## Stage 5 — HTML + PDF render pipeline
 
 For each artefact that ships as a print-ready PDF (business plan, prospectus, deck), produce three files under `html/<artefact>/`:
@@ -199,7 +299,7 @@ render-pdf.mjs    # Playwright + img2pdf + qpdf pipeline (image-only PDF, linear
 <artefact>.pdf    # rendered output (regenerate after every HTML edit)
 ```
 
-**Hard constraints** (from the `property-brochure:a4-print-documents` skill):
+**Hard constraints (A4 portrait, image-only PDF):**
 
 - A4 portrait: `@page { size: A4 portrait; margin: 18mm 16mm 20mm; }`
 - One `<section class="page">` per A4 page; renderer aborts if `scrollHeight` exceeds 1123px + 2px slack.
@@ -250,9 +350,10 @@ References: `references/html-pdf-pipeline.md` for the canonical `render-pdf.mjs`
 - `references/html-pdf-pipeline.md` — render-pdf.mjs canonical source + CSS scaffold
 - `references/compliance-research-checklist.md` — UK + EU regulatory regimes to verify
 - `references/internal-workings-scrub.md` — the public-vs-internal doctrine, patterns to scrub, recurrence list
-- `references/design-tokens-application.md` — how to consume `realagent-site/.docs/design-tokens.md` from an artefact's `:root` block
+- `references/design-tokens-application.md` — how to consume the operator's project design-tokens spec from an artefact's `:root` block
 - `references/termsheet-template.md` — A4-portrait term-sheet structure, cap-table reconciliation, common defects
+- `templates/prospectus/` — A4-portrait prospectus + term-sheet HTML templates and the shared `render-pdf.mjs` (consumed by Stages 3b, 4b, 5)
 
-## Reference project
+## Reference example
 
-The first execution of this skill produced `realagent-site/.docs/data-room/` for Real Agent Network Limited (Companies House 17237239). Read that directory as the canonical example; the skill's job is to reproduce its structure and doctrine for any subsequent UK seed raise.
+When this skill has previously rendered a data room for the current operator, that directory is the canonical example — read it before drafting. When no prior data room exists for the operator, the fallback reference is `references/data-room-structure.md` (section-by-section purpose statements) plus the per-stage references listed above.

package/payload/{premium-plugins/founder-pack → platform/plugins/venture-studio}/skills/investor-data-room/references/html-pdf-pipeline.md

@@ -1,6 +1,6 @@
 # HTML + PDF render pipeline
 
-Image-only A4 portrait PDF, rendered from a single HTML file via Playwright + img2pdf + qpdf. Mirrors the constraints in the `property-brochure:a4-print-documents` skill.
+Image-only A4 portrait PDF, rendered from a single HTML file via Playwright + img2pdf + qpdf. Constraints inlined in the parent `SKILL.md` Stage 5.
 
 ## File layout per artefact
 

package/payload/{premium-plugins/founder-pack → platform/plugins/venture-studio}/skills/investor-data-room/references/termsheet-template.md

@@ -45,7 +45,7 @@ Issue price = pre-money / pre-investment shares = £1,400,000 / 500,000 = **£2.
 
 ## Doctrine
 
-- **Issuer name is the IN01-filed legal entity.** Stale term sheets that reference a marketing entity (e.g. "Real Agent Systems Ltd" instead of the filed "Real Agent Network Limited") are defects. The Companies House number on every page header should match.
+- **Issuer name is the IN01-filed legal entity.** Stale term sheets that reference a marketing or trading entity instead of the filed company are defects. The Companies House number on every page header should match the IN01.
 - **Founder list reads exactly as the cap table.** Six holders on the cap table = six in the founder list. No phantom founders. Strategic shareholders (e.g. an investing LLP) ride in by entity name, not by their constituent individuals.
 - **Sole director on IN01 is the director-designate on the term sheet's signature page.** A term sheet that names two directors when IN01 named one needs reconciling before issue.
 - **SEIS/EIS posture is post-funding obligation, never closing contingency.** Never assured prior to distribution; no representation as to qualifying status. Forms no part of consideration.