@rubytech/create-maxy-code 0.1.98 → 0.1.100

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-maxy-code",
-  "version": "0.1.98",
+  "version": "0.1.100",
   "description": "Install Maxy — AI for Productive People",
   "bin": {
     "create-maxy-code": "./dist/index.js"

package/payload/platform/plugins/founder-pack/skills/investor-data-room/SKILL.md

@@ -60,13 +60,18 @@ Complete when the data room contains:
       business-plan.pdf                     # rendered output
       logo-light.png logo-dark.png
     prospectus/
-      index.html
+      index.html                            # A4 portrait, 10-15 page persuasive cut
+      term_sheet.html                       # A4 portrait, 6-8 page formal term sheet
       render-pdf.mjs
-      prospectus.pdf
-    deck/                                   # NOT YET BUILT in the reference project
-      index.html
+      prospectus.pdf term_sheet.pdf
+      logo-light.png logo-dark.png
+    deck/
+      index.html                            # 16:9 landscape (297mm x 167mm), 12+1 slides
       render-pdf.mjs
       deck.pdf
+      logo-light.png logo-dark.png
+      team/                                 # cropped headshot WebPs for slide 8 founder grid
+        <founder-firstname>-<lastname>.webp
 ```
 
 Skip stages that are already complete; do not regenerate stale artefacts blindly.
@@ -137,6 +142,32 @@ Compliance research is mandatory before drafting Section 10. WebSearch (or equiv
 
 References: `references/business-plan-template.md` for the section-by-section template; `references/compliance-research-checklist.md` for the UK + EU regulatory regimes to verify.
 
+## Stage 3b — Term sheet synthesis
+
+Generate `html/prospectus/term_sheet.html` as an **A4 portrait, 10-page formal term sheet** sectioned as:
+
+1. Cover + preamble + parties (Issuer / Founders / Investors / round size / minimum cheque / target close)
+2. Share economics & use of proceeds (instrument, valuation, dilution, issue price, share count, use of funds)
+3. Cap table on closing (post-money, fully diluted, total = 100%)
+4. Governance & shareholder protections (board, info rights, pre-emption, drag/tag, SEIS/EIS posture)
+5. Closing terms (governing law, IP assignment, conditions to closing, long-form docs timeline)
+6. Signatures (Company + Investor blocks)
+7. **Appendix A — High Net Worth Individual Investor Statement** (FSMA 2000 / FCA COBS 4 Annex 2 verbatim)
+8. **Appendix B — Self-Certified Sophisticated Investor Statement** (FSMA 2000 / FCA COBS 4 Annex 4 verbatim)
+9. Backpage (contact)
+
+**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").
+- **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.
+- **SEIS/EIS posture is post-funding obligation, not closing contingency.** Never assured prior to distribution; no representation as to qualifying status. Forms no part of consideration.
+- **Confidentiality and exclusivity provisions are the only binding clauses.** Everything else non-binding until long-form docs.
+- **FCA self-certification statements are appendices to the term sheet, not separate documents.** The High Net Worth Individual Investor Statement (FSMA 2000 (Financial Promotion) Order 2005 / FCA COBS 4 Annex 2) and the Self-Certified Sophisticated Investor Statement (COBS 4 Annex 4) ship as Appendix A and Appendix B. **Use verbatim wording**; never paraphrase regulatory text. Current source: UKBAA's templated PDFs (Feb 2024 versions reflect the post-31 Jan 2024 reverted thresholds: HNW £170k income or £430k net assets; sophisticated director threshold £1.6m turnover). When the regulatory wording changes, the templates change first at UKBAA / FCA COBS Annexes; re-fetch before issue.
+
+References: `references/termsheet-template.md`.
+
 ## Stage 4 — Deck blueprint synthesis
 
 Generate `01-narrative/deck-blueprint.md` as a **12-slide brief** the deck designer can execute. Each slide has Purpose, Headline (one-line message), Body (bullets + figures pulled from the business plan), Visual suggestion, and Source reference. The 12 slides:
@@ -194,6 +225,14 @@ References: `references/html-pdf-pipeline.md` for the canonical `render-pdf.mjs`
 - **Even page count for booklet binding.** Multiple of 4 ideally; minimum even. Add or remove a supporting page to maintain parity if a section change breaks it.
 - **Verify by reading every rendered page.** `pdfinfo` page count is not verification. The bottom 30% of every page must reach the content margin without significant whitespace.
 
+## Slide-design patterns (collected from the deck build)
+
+- **Cap-table over labelled pie chart.** A labelled donut with seven slices puts the percentages on the chart but adds visual clutter at small slice counts. A clean post-investment cap table (Shareholder / Shares / % with a gold-rule Total row) reads faster on the slide and matches the term-sheet treatment. Default to the table; reserve the pie for slides with three to four large slices.
+- **Circular founder avatars on the team slide.** Square photos at full card width over-allocate vertical real-estate and crowd the bio + advisor band. Fixed-diameter circular avatars (e.g. 42mm × 42mm, `border-radius: 50%`, centred `margin: 0 auto`) leave room for the eyebrow + name + 3-line bio + advisor band on a 16:9 slide.
+- **Headshot crops are face-centred, not full-environment.** Crop each source PNG/JPG to a tight head + shoulders square at 1200×1200 (`magick <src> -crop WxH+X+Y +repage -resize 1200x1200 -strip <crop>.png`), then encode with `cwebp -q 88 -m 6 -mt`. Resize-then-encode never loses face fidelity at the 42mm display size. Track per-founder face position from the source dimensions and centre the crop window on it.
+- **Bio line budget on slide 8 is ~3 lines at 8.5pt.** A 4th line crashes into the advisor band's `border-top`. Trim aggressively: lead with the headline number ("33 years residential estate agency"), then 2-3 firms and 1-2 awards.
+- **Linter strips trailing text in long edits.** When editing a multi-line founder bio (or any cell where you append clauses past a verbatim sentence), the auto-formatter has rewritten the trailing fragment on this project. Always re-grep the file after the edit; if "Sole IN01 director." or "2× Capper" went missing, the edit needs a second pass with a smaller anchor.
+
 ## Pitfalls to avoid (collected from the reference project)
 
 - **Renaming a directory after the URL is published.** Keep `<project-site>/.docs/data-room/html/<artefact>/index.html` stable; if the URL changes, downstream investor links break.
@@ -212,6 +251,7 @@ References: `references/html-pdf-pipeline.md` for the canonical `render-pdf.mjs`
 - `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/termsheet-template.md` — A4-portrait term-sheet structure, cap-table reconciliation, common defects
 
 ## Reference project
 

package/payload/platform/plugins/founder-pack/skills/investor-data-room/references/termsheet-template.md

@@ -0,0 +1,88 @@
+# Term sheet template
+
+A4-portrait, 6-to-8-page formal term sheet, same render pipeline as the business plan (Playwright + img2pdf + qpdf). Lives at `html/prospectus/term_sheet.html`. The reference project produces a 7-page artefact: cover + 5 content pages + signatures.
+
+## Page-by-page structure
+
+| # | Page | Contents |
+|---|---|---|
+| 1 | Cover + preamble | Issuer (full Companies-House-filed legal name), document title, "Non-binding — confidentiality and exclusivity bind", preamble (round purpose, recipient self-cert reminder), introductory parties table (Issuer, Founders list, Investors, round size, minimum cheque, minimum aggregate, target first close) |
+| 2 | Share economics & use of proceeds | Instrument (ordinary £0.001 or £0.01 nominal, ranking *pari passu*), pre-money / post-money / dilution, issue price (computed from pre-money ÷ pre-investment shares), Round Share count, use of proceeds split, long-stop date, funds-expected timing |
+| 3 | Cap table on closing | Holder / Role / Shares / % table; founders subtotal; Round Shares row; total = 100% / 625,000 |
+| 4 | Governance & shareholder protections | Board composition (director-designate per IN01), information rights (≥5% threshold), pre-emption, drag-along / tag-along, share-transfer good-leaver / bad-leaver, SEIS/EIS posture, confidentiality (binding), exclusivity (binding) |
+| 5 | Closing terms | Governing law (English), expenses (each party bears own), founder IP assignment (deed at first close, no licence-back, no royalty), conditions to closing, long-form documentation timeline |
+| 6 | Signatures | Company block (director-designate per IN01) + Investor block (name / entity / commitment / signature line) |
+| 7 | **Appendix A — High Net Worth Individual Investor Statement** | FSMA 2000 (Financial Promotion) Order 2005 / FCA COBS 4 Annex 2 statement, verbatim. Income £170,000 / net assets £430,000 thresholds (post-31 Jan 2024 reverted thresholds). Checkboxes, declaration callout, signature lines. |
+| 8 | **Appendix B — Self-Certified Sophisticated Investor Statement** | FSMA 2000 (Financial Promotion) Order 2005 / FCA COBS 4 Annex 4 statement, verbatim. Conditions A (PE / SME finance professional past 2yr), B (director of company with £1.6m+ turnover past 2yr), C (business-angel network member 6m+). Checkboxes, declaration callout, signature lines. |
+| 9 | Backpage | Contact card (2×2 founder grid: role / name / email / phone) + confidentiality reminder + companies-house identifier |
+
+## Cap table reconciliation
+
+The cap table on closing **must reconcile against the IN01 + the Round 1 dilution model exactly**. The pattern from the reference project:
+
+| Step | Source |
+|---|---|
+| Pre-investment shares (e.g. 500,000) | IN01 statement of capital |
+| Per-founder pre-investment % | IN01 cap table |
+| Dilution % | (Round size / post-money) = 350 / 1,750 = 20% in the reference project |
+| Post-investment % per founder | Pre-investment % × (1 − dilution%) |
+| Post-investment shares per founder | Pre-investment shares × (1 − dilution%) — note this only works if all founders dilute pro rata |
+| Round Shares | New investor's post-investment % × total post-investment shares |
+| Total post-closing shares | Pre-investment shares ÷ (1 − dilution%) |
+
+Reference project numbers (pre 500k, dilution 20%):
+- Joel 24.90% / 124,500 → 19.92% / 124,500 (no change in shares; dilution is via issuance of new shares)
+- Adam 24.90% / 124,500 → 19.92% / 124,500
+- Alex 20.00% / 100,000 → 16.00% / 100,000
+- Jamie 15.16% / 75,813 → 12.13% / 75,813
+- BackleyBlack 8.75% / 43,749 → 7.00% / 43,749
+- Stewart Smalley 6.29% / 31,438 → 5.03% / 31,438
+- Founders subtotal 500,000 / 80.00%
+- New investors (Round 1) 125,000 / 20.00%
+- Total post-closing 625,000 / 100.00%
+
+Issue price = pre-money / pre-investment shares = £1,400,000 / 500,000 = **£2.80 per Round Share** (£0.001 nominal + £2.799 share premium in the reference project where nominal was £0.001; or £0.01 nominal + £2.79 premium if the term sheet sets nominal at £0.01).
+
+## 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.
+- **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.
+- **Confidentiality + exclusivity bind; everything else is non-binding** until subscription & shareholders' agreement.
+
+## FCA self-certification appendices — sourcing the verbatim wording
+
+Both appendices reproduce the FCA template **word-for-word**. Never paraphrase regulatory text. The FCA Handbook pages (COBS 4 Annex 2 / Annex 4) are JavaScript-rendered and not directly fetchable; the most reliable verbatim source is the **UK Business Angels Association** templated PDFs, updated whenever HM Treasury or the FCA change the thresholds:
+
+- High Net Worth: <https://ukbaa.org.uk/wp-content/uploads/2024/02/HighNetWorthStatement.pdf>
+- Sophisticated: <https://ukbaa.org.uk/wp-content/uploads/2024/02/SelfCertifiedStatement.pdf>
+
+These are the **Feb 2024 versions**, reflecting the thresholds in force after HM Treasury reverted the January-2024 increases. Current thresholds:
+
+| Statement | Condition | Threshold |
+|---|---|---|
+| HNW | A — income | £170,000 in last financial year (excludes one-off pension withdrawals) |
+| HNW | B — net assets | £430,000 (excludes primary residence, loan secured on it, equity released from it, pension, insurance rights) |
+| Sophisticated | A — PE / SME finance professional | last two years |
+| Sophisticated | B — director of company | annual turnover ≥ £1.6 million, last two years |
+| Sophisticated | C — business-angel network | member ≥ 6 months, still a member |
+
+**Re-fetch before issue.** Thresholds change. The Feb 2024 templates were issued after HM Treasury reverted a Jan 2024 increase to £170k income / £430k net assets / £1.6m turnover (the original 2023 thresholds were £100k / £250k / £1m). The pattern: if it changes again, UKBAA reissues; re-fetch their PDF and re-render the appendix.
+
+Render the appendices in the **same A4 stylesheet as the term sheet** but with a `.page--appendix` class that tightens `h2` (22pt instead of 26pt), `.form-question` margins (2.5mm instead of 4mm), and `.form-declaration` padding (3mm instead of 4mm). Without these overrides, the Sophisticated page (3 questions + 4 declarations + signature) overflows A4.
+
+## Render
+
+Same `render-pdf.mjs` pattern as the business plan; viewport 794×1123 (A4 portrait at 96 dpi), deviceScaleFactor 3.125 (300 dpi PNG), `img2pdf --pagesize 210mmx297mm`, `qpdf --linearize`. Output: `html/prospectus/term_sheet.pdf`.
+
+## Common defects to avoid
+
+| Defect | Fix |
+|---|---|
+| Issuer name mismatch (marketing vs filed) | Use the IN01 legal name verbatim on every page header |
+| Founder list includes individuals also represented by an LLP holding | Use the LLP holding only; do not double-count |
+| Issue price stated without showing the calculation | `£2.80 = £1.4m ÷ 500,000 pre-shares` in the issue-price row |
+| Cap-table % rounding doesn't sum to 100% | Compute % as `shares / total` and verify the sum; never hand-enter % rows |
+| SEIS/EIS implied as confirmed | "Pursuing SEIS/EIS Advance Assurance from HMRC is a post-funding obligation … not a closing contingency … no representation as to qualifying status" |
+| Director-designate doesn't match IN01 | Read the IN01 PDF; the proposed director on IN01 is the director-designate |

package/payload/premium-plugins/founder-pack/skills/investor-data-room/SKILL.md

@@ -60,13 +60,18 @@ Complete when the data room contains:
       business-plan.pdf                     # rendered output
       logo-light.png logo-dark.png
     prospectus/
-      index.html
+      index.html                            # A4 portrait, 10-15 page persuasive cut
+      term_sheet.html                       # A4 portrait, 6-8 page formal term sheet
       render-pdf.mjs
-      prospectus.pdf
-    deck/                                   # NOT YET BUILT in the reference project
-      index.html
+      prospectus.pdf term_sheet.pdf
+      logo-light.png logo-dark.png
+    deck/
+      index.html                            # 16:9 landscape (297mm x 167mm), 12+1 slides
       render-pdf.mjs
       deck.pdf
+      logo-light.png logo-dark.png
+      team/                                 # cropped headshot WebPs for slide 8 founder grid
+        <founder-firstname>-<lastname>.webp
 ```
 
 Skip stages that are already complete; do not regenerate stale artefacts blindly.
@@ -137,6 +142,32 @@ Compliance research is mandatory before drafting Section 10. WebSearch (or equiv
 
 References: `references/business-plan-template.md` for the section-by-section template; `references/compliance-research-checklist.md` for the UK + EU regulatory regimes to verify.
 
+## Stage 3b — Term sheet synthesis
+
+Generate `html/prospectus/term_sheet.html` as an **A4 portrait, 10-page formal term sheet** sectioned as:
+
+1. Cover + preamble + parties (Issuer / Founders / Investors / round size / minimum cheque / target close)
+2. Share economics & use of proceeds (instrument, valuation, dilution, issue price, share count, use of funds)
+3. Cap table on closing (post-money, fully diluted, total = 100%)
+4. Governance & shareholder protections (board, info rights, pre-emption, drag/tag, SEIS/EIS posture)
+5. Closing terms (governing law, IP assignment, conditions to closing, long-form docs timeline)
+6. Signatures (Company + Investor blocks)
+7. **Appendix A — High Net Worth Individual Investor Statement** (FSMA 2000 / FCA COBS 4 Annex 2 verbatim)
+8. **Appendix B — Self-Certified Sophisticated Investor Statement** (FSMA 2000 / FCA COBS 4 Annex 4 verbatim)
+9. Backpage (contact)
+
+**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").
+- **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.
+- **SEIS/EIS posture is post-funding obligation, not closing contingency.** Never assured prior to distribution; no representation as to qualifying status. Forms no part of consideration.
+- **Confidentiality and exclusivity provisions are the only binding clauses.** Everything else non-binding until long-form docs.
+- **FCA self-certification statements are appendices to the term sheet, not separate documents.** The High Net Worth Individual Investor Statement (FSMA 2000 (Financial Promotion) Order 2005 / FCA COBS 4 Annex 2) and the Self-Certified Sophisticated Investor Statement (COBS 4 Annex 4) ship as Appendix A and Appendix B. **Use verbatim wording**; never paraphrase regulatory text. Current source: UKBAA's templated PDFs (Feb 2024 versions reflect the post-31 Jan 2024 reverted thresholds: HNW £170k income or £430k net assets; sophisticated director threshold £1.6m turnover). When the regulatory wording changes, the templates change first at UKBAA / FCA COBS Annexes; re-fetch before issue.
+
+References: `references/termsheet-template.md`.
+
 ## Stage 4 — Deck blueprint synthesis
 
 Generate `01-narrative/deck-blueprint.md` as a **12-slide brief** the deck designer can execute. Each slide has Purpose, Headline (one-line message), Body (bullets + figures pulled from the business plan), Visual suggestion, and Source reference. The 12 slides:
@@ -194,6 +225,14 @@ References: `references/html-pdf-pipeline.md` for the canonical `render-pdf.mjs`
 - **Even page count for booklet binding.** Multiple of 4 ideally; minimum even. Add or remove a supporting page to maintain parity if a section change breaks it.
 - **Verify by reading every rendered page.** `pdfinfo` page count is not verification. The bottom 30% of every page must reach the content margin without significant whitespace.
 
+## Slide-design patterns (collected from the deck build)
+
+- **Cap-table over labelled pie chart.** A labelled donut with seven slices puts the percentages on the chart but adds visual clutter at small slice counts. A clean post-investment cap table (Shareholder / Shares / % with a gold-rule Total row) reads faster on the slide and matches the term-sheet treatment. Default to the table; reserve the pie for slides with three to four large slices.
+- **Circular founder avatars on the team slide.** Square photos at full card width over-allocate vertical real-estate and crowd the bio + advisor band. Fixed-diameter circular avatars (e.g. 42mm × 42mm, `border-radius: 50%`, centred `margin: 0 auto`) leave room for the eyebrow + name + 3-line bio + advisor band on a 16:9 slide.
+- **Headshot crops are face-centred, not full-environment.** Crop each source PNG/JPG to a tight head + shoulders square at 1200×1200 (`magick <src> -crop WxH+X+Y +repage -resize 1200x1200 -strip <crop>.png`), then encode with `cwebp -q 88 -m 6 -mt`. Resize-then-encode never loses face fidelity at the 42mm display size. Track per-founder face position from the source dimensions and centre the crop window on it.
+- **Bio line budget on slide 8 is ~3 lines at 8.5pt.** A 4th line crashes into the advisor band's `border-top`. Trim aggressively: lead with the headline number ("33 years residential estate agency"), then 2-3 firms and 1-2 awards.
+- **Linter strips trailing text in long edits.** When editing a multi-line founder bio (or any cell where you append clauses past a verbatim sentence), the auto-formatter has rewritten the trailing fragment on this project. Always re-grep the file after the edit; if "Sole IN01 director." or "2× Capper" went missing, the edit needs a second pass with a smaller anchor.
+
 ## Pitfalls to avoid (collected from the reference project)
 
 - **Renaming a directory after the URL is published.** Keep `<project-site>/.docs/data-room/html/<artefact>/index.html` stable; if the URL changes, downstream investor links break.
@@ -212,6 +251,7 @@ References: `references/html-pdf-pipeline.md` for the canonical `render-pdf.mjs`
 - `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/termsheet-template.md` — A4-portrait term-sheet structure, cap-table reconciliation, common defects
 
 ## Reference project
 

package/payload/premium-plugins/founder-pack/skills/investor-data-room/references/termsheet-template.md

@@ -0,0 +1,88 @@
+# Term sheet template
+
+A4-portrait, 6-to-8-page formal term sheet, same render pipeline as the business plan (Playwright + img2pdf + qpdf). Lives at `html/prospectus/term_sheet.html`. The reference project produces a 7-page artefact: cover + 5 content pages + signatures.
+
+## Page-by-page structure
+
+| # | Page | Contents |
+|---|---|---|
+| 1 | Cover + preamble | Issuer (full Companies-House-filed legal name), document title, "Non-binding — confidentiality and exclusivity bind", preamble (round purpose, recipient self-cert reminder), introductory parties table (Issuer, Founders list, Investors, round size, minimum cheque, minimum aggregate, target first close) |
+| 2 | Share economics & use of proceeds | Instrument (ordinary £0.001 or £0.01 nominal, ranking *pari passu*), pre-money / post-money / dilution, issue price (computed from pre-money ÷ pre-investment shares), Round Share count, use of proceeds split, long-stop date, funds-expected timing |
+| 3 | Cap table on closing | Holder / Role / Shares / % table; founders subtotal; Round Shares row; total = 100% / 625,000 |
+| 4 | Governance & shareholder protections | Board composition (director-designate per IN01), information rights (≥5% threshold), pre-emption, drag-along / tag-along, share-transfer good-leaver / bad-leaver, SEIS/EIS posture, confidentiality (binding), exclusivity (binding) |
+| 5 | Closing terms | Governing law (English), expenses (each party bears own), founder IP assignment (deed at first close, no licence-back, no royalty), conditions to closing, long-form documentation timeline |
+| 6 | Signatures | Company block (director-designate per IN01) + Investor block (name / entity / commitment / signature line) |
+| 7 | **Appendix A — High Net Worth Individual Investor Statement** | FSMA 2000 (Financial Promotion) Order 2005 / FCA COBS 4 Annex 2 statement, verbatim. Income £170,000 / net assets £430,000 thresholds (post-31 Jan 2024 reverted thresholds). Checkboxes, declaration callout, signature lines. |
+| 8 | **Appendix B — Self-Certified Sophisticated Investor Statement** | FSMA 2000 (Financial Promotion) Order 2005 / FCA COBS 4 Annex 4 statement, verbatim. Conditions A (PE / SME finance professional past 2yr), B (director of company with £1.6m+ turnover past 2yr), C (business-angel network member 6m+). Checkboxes, declaration callout, signature lines. |
+| 9 | Backpage | Contact card (2×2 founder grid: role / name / email / phone) + confidentiality reminder + companies-house identifier |
+
+## Cap table reconciliation
+
+The cap table on closing **must reconcile against the IN01 + the Round 1 dilution model exactly**. The pattern from the reference project:
+
+| Step | Source |
+|---|---|
+| Pre-investment shares (e.g. 500,000) | IN01 statement of capital |
+| Per-founder pre-investment % | IN01 cap table |
+| Dilution % | (Round size / post-money) = 350 / 1,750 = 20% in the reference project |
+| Post-investment % per founder | Pre-investment % × (1 − dilution%) |
+| Post-investment shares per founder | Pre-investment shares × (1 − dilution%) — note this only works if all founders dilute pro rata |
+| Round Shares | New investor's post-investment % × total post-investment shares |
+| Total post-closing shares | Pre-investment shares ÷ (1 − dilution%) |
+
+Reference project numbers (pre 500k, dilution 20%):
+- Joel 24.90% / 124,500 → 19.92% / 124,500 (no change in shares; dilution is via issuance of new shares)
+- Adam 24.90% / 124,500 → 19.92% / 124,500
+- Alex 20.00% / 100,000 → 16.00% / 100,000
+- Jamie 15.16% / 75,813 → 12.13% / 75,813
+- BackleyBlack 8.75% / 43,749 → 7.00% / 43,749
+- Stewart Smalley 6.29% / 31,438 → 5.03% / 31,438
+- Founders subtotal 500,000 / 80.00%
+- New investors (Round 1) 125,000 / 20.00%
+- Total post-closing 625,000 / 100.00%
+
+Issue price = pre-money / pre-investment shares = £1,400,000 / 500,000 = **£2.80 per Round Share** (£0.001 nominal + £2.799 share premium in the reference project where nominal was £0.001; or £0.01 nominal + £2.79 premium if the term sheet sets nominal at £0.01).
+
+## 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.
+- **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.
+- **Confidentiality + exclusivity bind; everything else is non-binding** until subscription & shareholders' agreement.
+
+## FCA self-certification appendices — sourcing the verbatim wording
+
+Both appendices reproduce the FCA template **word-for-word**. Never paraphrase regulatory text. The FCA Handbook pages (COBS 4 Annex 2 / Annex 4) are JavaScript-rendered and not directly fetchable; the most reliable verbatim source is the **UK Business Angels Association** templated PDFs, updated whenever HM Treasury or the FCA change the thresholds:
+
+- High Net Worth: <https://ukbaa.org.uk/wp-content/uploads/2024/02/HighNetWorthStatement.pdf>
+- Sophisticated: <https://ukbaa.org.uk/wp-content/uploads/2024/02/SelfCertifiedStatement.pdf>
+
+These are the **Feb 2024 versions**, reflecting the thresholds in force after HM Treasury reverted the January-2024 increases. Current thresholds:
+
+| Statement | Condition | Threshold |
+|---|---|---|
+| HNW | A — income | £170,000 in last financial year (excludes one-off pension withdrawals) |
+| HNW | B — net assets | £430,000 (excludes primary residence, loan secured on it, equity released from it, pension, insurance rights) |
+| Sophisticated | A — PE / SME finance professional | last two years |
+| Sophisticated | B — director of company | annual turnover ≥ £1.6 million, last two years |
+| Sophisticated | C — business-angel network | member ≥ 6 months, still a member |
+
+**Re-fetch before issue.** Thresholds change. The Feb 2024 templates were issued after HM Treasury reverted a Jan 2024 increase to £170k income / £430k net assets / £1.6m turnover (the original 2023 thresholds were £100k / £250k / £1m). The pattern: if it changes again, UKBAA reissues; re-fetch their PDF and re-render the appendix.
+
+Render the appendices in the **same A4 stylesheet as the term sheet** but with a `.page--appendix` class that tightens `h2` (22pt instead of 26pt), `.form-question` margins (2.5mm instead of 4mm), and `.form-declaration` padding (3mm instead of 4mm). Without these overrides, the Sophisticated page (3 questions + 4 declarations + signature) overflows A4.
+
+## Render
+
+Same `render-pdf.mjs` pattern as the business plan; viewport 794×1123 (A4 portrait at 96 dpi), deviceScaleFactor 3.125 (300 dpi PNG), `img2pdf --pagesize 210mmx297mm`, `qpdf --linearize`. Output: `html/prospectus/term_sheet.pdf`.
+
+## Common defects to avoid
+
+| Defect | Fix |
+|---|---|
+| Issuer name mismatch (marketing vs filed) | Use the IN01 legal name verbatim on every page header |
+| Founder list includes individuals also represented by an LLP holding | Use the LLP holding only; do not double-count |
+| Issue price stated without showing the calculation | `£2.80 = £1.4m ÷ 500,000 pre-shares` in the issue-price row |
+| Cap-table % rounding doesn't sum to 100% | Compute % as `shares / total` and verify the sum; never hand-enter % rows |
+| SEIS/EIS implied as confirmed | "Pursuing SEIS/EIS Advance Assurance from HMRC is a post-funding obligation … not a closing contingency … no representation as to qualifying status" |
+| Director-designate doesn't match IN01 | Read the IN01 PDF; the proposed director on IN01 is the director-designate |

package/payload/premium-plugins/real-agent/plugins/brochures/skills/make-brochure/SKILL.md

@@ -342,6 +342,7 @@ Report `DONE` only after:
 - The **web bundle** exists at `output/web/` and as a zipped `output/<slug>-web.zip` — see `property-brochure → Web bundle` for what it contains. The bundle includes both `brochure.html` and the companion `index.html` (see `property-brochure → Page`), plus a copy of the web PDF named simply `<property_slug>-brochure.pdf` to match the in-page Download links. Smoke-test was performed: an isolated HTTP server returned 200 for every referenced asset (HTML, web-tier images, jpg snapshots, the bundled PDF), and **both** `brochure.html` and `index.html` rendered correctly. Typical zip is 30–50 MB for a 16-page folio.
 - **Back-page QR codes are clickable.** Each QR is wrapped in an `<a target="_blank">` tag and accompanied by a visible underlined URL beneath the label, so a digital reader can click instead of scan. See `property-brochure → Back-page QR codes`.
 - The user-facing report names which steps ran and which were reused, **and the chosen orientation**, **and the path to both the canonical print archive and the web zip**.
+- **The web PDF and the web zip are delivered to the user via `SendUserFile` (Claude Code native), not via `admin: file-attach`.** Call `SendUserFile` with both paths in one call: `<property_dir>/output/<property_slug>-brochure-web.pdf` and `<property_dir>/output/<property_slug>-web.zip`. Include a one-line caption naming the property and the bundle size. `admin: file-attach` writes the file into the admin attachment store and returns an `attachmentId` envelope that LOOKS like success, but produces no visible attachment in the chat surface for this channel — that's the wasted first-turn failure mode that ships on every make-brochure run when the agent reaches for the admin tool. Reach for `SendUserFile` first, every time. **30 MiB ceiling:** `SendUserFile` accepts files up to 30 MiB each. The web PDF is well within (~7–15 MB at JPEG-embedded). The web zip can exceed when the bundle carries many photos — if `du -h <slug>-web.zip` reports > 30 MiB, do NOT call `SendUserFile` with it; instead, send the operator the public URL at `<tunnel-url>/files/output/<slug>-web.zip` (the bundle already lives under `output/` which the tunnel serves). The web PDF still goes via `SendUserFile`. Per `system-prompt.ts:267`: *"The tool returns 'N files delivered to user' even when the byte upload silently fails, so the response is not evidence of delivery."* Treat the operator's visible-attachment tile as the only evidence of delivery; if they don't see it, retry once with the public-URL path.
 - No image was read in violation of the 2000px rule (verifiable: every image read should have been preceded by a `sips`/`identify` measurement, and any over-threshold image was previewed via `/tmp/`).
 
 If any condition is unmet, report `DONE_WITH_CONCERNS` and list the gap.

package/payload/premium-plugins/real-agent/plugins/brochures/skills/property-brochure/SKILL.md

@@ -174,7 +174,7 @@ When any field above is unresolved after consulting its primary source, **stop b
 - **Doc-comment strip pass runs against BOTH templates.** After substitution, the `<!-- REPLACE … -->` authoring notes must be removed from both `brochure.html` AND `index.html`. A strip pass that covers only the brochure leaves landing-page authoring notes rendering as visible body text whenever a comment delimiter is misplaced. The companion source-side check in `references/build.md → Template authoring hygiene + CI lint` catches the same defect class at template-edit time.
 - **EPC is mandatory — `TBC` is not shippable.** UK law requires an EPC for any marketed property. The brochure must not render with `epc_rating: "TBC"`, no matter what `property-extract` returned. If the rating is missing or the listing displayed `TBC`, the operator confirmation prompt must demand an actual A–G band (plus current/potential scores and the certificate path) before substitution proceeds. The operator's authoritative fallback is the [EPC Register](https://www.epcregister.com/) — look up by address or postcode, download the certificate, supply the values. `TBC` is the one answer the operator cannot confirm for this field.
 - **Web bundle ships the PDF, not per-page JPGs.** The bundle does not include `cover-print.jpg … backpage-print.jpg` — those duplicate the brochure content already embedded in `<slug>-brochure.pdf`. The web copy of `brochure.html` has its `.print-img` src attributes cleared so the print stylesheet drops to the live-DOM fallback; operators who want a printable PDF download the bundled PDF directly. See `references/build.md → Clear .print-img src in the web copy`. Shipping both was the historical bundle-bloat defect.
-- **Pages with absolutely-positioned bottom elements must reserve their footprint in the in-flow content's padding.** Two absolute elements live at the bottom of every `.page`: the `.folio` page-number strip (`bottom: 8mm`, ~8mm tall → occupies bottom ~16mm) and, on the back page only, the `.back-disclaimer` (`bottom: 16mm`, wraps to up to 5 lines × 3.7mm → occupies bottom ~34.5mm). In-flow content above them (`.mi-foot` with `margin-top: auto` inside `.mi-page`, or `.backpage-inner` content with `justify-content: center`) is a SIBLING of those absolute elements — nothing in CSS structure enforces clearance. The fix is always to pull the in-flow container UP via its parent's `padding-bottom`: `.mi-page` uses **22mm** (folio clearance), `.backpage-inner` uses **42mm** (folio + disclaimer clearance with 4mm gap). Any future page that adds an absolute bottom element must update the in-flow parent's `padding-bottom` accordingly — never try to push the absolute element down with `margin-*` (no positional effect on `position: absolute` whose anchor is `bottom`). This is the "Absolute vs in-flow" lesson from the recommendations doc — pull the in-flow element, never the absolute one.
+- **Bottom chrome on `.page` is absolutely-positioned and stacks deterministically.** Three classes of bottom element exist: (1) the `.folio` page-number strip (`bottom: 8mm`, ~8mm tall → occupies bottom ~16mm of every page); (2) `.back-disclaimer` on the back page (`bottom: 16mm`, wraps to up to 5 lines × 3.7mm → occupies bottom ~34.5mm); (3) `.mi-foot` on the Material Information page (`bottom: 22mm`, ~7mm tall → occupies bottom ~22–29mm). All are `position: absolute`, anchored to their nearest positioned ancestor (`.page` which is `position: relative`). In-flow content above (e.g. `.mi-grid` inside `.mi-page`, `.backpage-inner` centred content) is a SIBLING in the stacking flow — nothing in CSS structure enforces clearance from the absolute layer. The fix is to either (a) **make the relevant footer absolute** (the approach used for `.mi-foot` to prevent oversized `.mi-grid` from pushing the disclaimer into the folio), or (b) **pull the in-flow container up via its parent's `padding-bottom`** when the footer is small and predictable (e.g. `.backpage-inner` uses 42mm to clear folio + disclaimer with a 4mm gap). Never use `margin-*` on a `position: absolute` element whose anchor is `bottom` — it has no positional effect.
 - **Folio is plain text on whitespace or absent — never chrome over imagery.** The `.folio > span` carries no background, blur, padding, border-radius, or shadow. It is plain text in `--teal-900` that sits on the clean whitespace reserved at the page bottom (see the previous rule on padding-bottom clearance). The folio is **hidden entirely** on full-bleed-bottom pages: `.cover`, `.page.intermission`, `.page.folio-dark`, and any `.page` whose body wraps a `.feature-page` (photo+panel layout where the photo bleeds to the page bottom). Never reintroduce a folio-pill background to "make it readable over the image" — that's competing chrome on the page; suppress the folio on that page instead. Any new full-bleed-bottom page class must be added to the `.folio` `display: none` selector in `references/template.html`.
 - **Page 13's `{{ siteplan_src }}` is never the floorplan.** Page 13 (the site-plan / plot page, `.page siteplan-page`, "Continued, Chapter VI · The plot") expects a plot drawing, site plan, or aerial photo — an image distinct from the floorplan that page 14 already carries. If no such image is naturally available (no `<slug>-siteplan.png` line-art, no aerial photo on disk), the operator confirmation prompt MUST list `{{ siteplan_src }}` as an unresolved field and request a substitute by name — a wide exterior, a paddock/grounds photo, a drone shot of the property in its setting, or a hand-marked site sketch. Silently falling back to the floorplan duplicates page 14's content and is a defect (the brochure ships with the same image on two consecutive pages — visible immediately on review). The fallback is forbidden by the same doctrine as `TBC`: never coerce a field to a default the operator did not confirm. If the operator cannot supply a substitute, the brochure drops to the 12-page reduced layout (no page 13) — not to a 16-page layout with a duplicated floorplan.
 - **Verification covers every page in the deliverable — sampling is a defect, not a shortcut.** `scrollHeight` fit checks, computed-style collision probes (`.mi-foot` ↔ `.folio` gap, `.back-disclaimer` ↔ in-flow content, any future absolute-bottom element vs in-flow neighbour), and visual review before declaring done all walk **every page** in the 16-page folio (or 12-page reduced layout). "Sample-checked 3 of 12 pages" or any variant ("spot-checked the spreads I changed", "skimmed a few representative pages") is not authorised — the skill explicitly says "verify every page" in `references/build.md → Live editing workflow` step 8 and in `references/structure.md`. The deliverable is the brochure as a whole; a defect on an unchecked page ships exactly as readily as a defect on a checked one. If a probe is expensive enough that walking 16 pages feels burdensome, the cost is the probe's, not the skill's — propose a faster probe rather than narrowing the coverage.

package/payload/premium-plugins/real-agent/plugins/brochures/skills/property-brochure/references/template.html

@@ -1023,7 +1023,16 @@
     letter-spacing: 0.01em;
   }
   .mi-foot {
-    margin-top: auto;
+    /* Absolute positioning — anchored to page bottom so an oversized .mi-grid
+       cannot push the disclaimer into the folio zone. The folio sits at
+       bottom 8mm with ~8mm visible height (occupies 8-16mm from page bottom);
+       this anchor at 22mm leaves a 6mm gap above the folio. Any .mi-grid
+       overflow extends UNDERNEATH this footer (clipped by .page's
+       overflow:hidden at 210mm) without disrupting the chrome layer. */
+    position: absolute;
+    left: 14mm; right: 14mm; bottom: 22mm;
+    background: var(--paper-25);
+    z-index: 3;
     padding-top: 14px;
     border-top: 1px solid var(--rule);
     font-family: var(--serif);