v1.0.25
Plan my moves, connected data and valuation guidanceOctober 28, 2026The workbench's "How to move the number" becomes Your plan: the same priced moves, now in three zones (Start here, Everything holding the number back, Already working for you) each with its kind, the fixed worth sentence, arithmetic from your inputs, a first step, how you'll know and the benchmark behind it. Owners can plan a move, tick its checklist and set an owner, due date and cadence; the plan lives on the practice and every status change is recorded. Engine 1.8.0 unchanged. Every figure is identical; server 1.30.0; still eighteen tools.
Your plan
The driver block, organized as moves an owner can plan, track and prove.
- The tray assistant now has focused expertise for every move category. Ask about this starts an answer using the selected billing or client-book section and its exact analysis totals, including synthetic connected sources; follow-ups retain that context only for the same firm and move. Household rows stay private and valuation math is unchanged.
- Your firms (picking, adding, renaming and archiving practices, and the selected firm's data and data requests) now lives on the Your firm(s) page under Settings. The Connect page keeps the agent connection steps, coverage and the archived list.
- An isolated integration test now runs the full demo reset, checks both generated NDA PDFs and their recorded document hashes, verifies all seven Network sell firms have connected analyses, and ensures a failed document upload cannot report success. Test runs do not change live demo accounts.
- Demo reset sets up the synthetic CRM and billing connection and both analysis reports for all seven sell-side Network firms, as well as the standalone sell demos. Reset reports success only after every sell demo is set up; valuations and buy targets are unchanged.
- Each sell demo gets Cottonwood's one-click synthetic billing and client-book pulls as soon as its firm is created, even if a later reset step fails. Source-loading errors are shown rather than mistaken for no connections.
- Demo reset clears abandoned impersonation records only when their sign-in session no longer exists, while still blocking resets during a live demo session.
- Demo reset uses a self-contained document generator for fictional NDAs and checks it before changing demo data, avoiding a PDF helper import failure partway through reset.
- The side tray can expand to the left for wider client book and fee analysis tables. The expand icon beside Close restores the previous width on a second click; switching widths keeps the current results and selections intact. On phones the tray already fills the screen.
- Three zones in a fixed order, in the server's order inside each and never re-sorted. The top Start here card is still the report's first holding bullet.
- Each card reads: kind (Paperwork, Data or Business), effort and horizon; the fact and its consequence; "About … on the fair estimate at a score of 85, every other factor held still"; a second line of arithmetic from your inputs, shown only when the raw metric is on file; Start here; How we'll know; and the benchmark, with a currency note when your figures aren't in USD.
- Plan this move, Show the math and Ask an agent sit on every card. Planning opens a checklist with owner, due date, cadence and notes; the first time a move is planned, the fair estimate it started from is captured once.
- Ask an agent now answers on the card for Owner plans and above: the move assistant reads your last saved valuation and the live Plan my moves skill, writes words only, any line stating a number is removed, and cites figures by the engine's own displays. Apply to plan adds its proposed steps after yours and sets only the owner, due date or cadence it proposed. Use your own assistant keeps the copyable prompt.
- A progress strip shows the baseline, how many moves are planned, in progress and done, and the next re-run 90 days after the last recorded run; a standing list says what won't move the number.
- Free accounts can plan one move; Owner and above plan every move.
Plan my moves: for assistants
Additive only: no new tool, no changed input.
- compute_valuation rows gain kind, proof, benchmark, businessEffect and firstStep, plus a wontMove list. list_practices(practice_id) returns movePlan; upsert_practice accepts an optional moves[] written only after the owner confirms.
- value-driver-playbook 3.0.0 is now titled Plan my moves (same slug); presentation-contract 2.6.0 adds the move vocabulary; four skills read the plan before suggesting work on a driver.
Prove a move
A move marked done can now be proved: when a saved valuation shows its measure moved on file, the server marks it verified with the before and after reading and where the figure came from. A check-in lists what's overdue, due soon, stalled or waiting for proof, and Owner plans can choose to get it by email. Two new assistant workflows prove moves and run check-ins, and the succession workflow now runs a short interview. Engine 1.8.0 unchanged. Every figure is identical; server 1.29.0; still eighteen tools.
Proof and check-ins
Verified only by the server, only from figures on file.
- On a saved valuation, each move you marked done is compared with the run it started from. If its measure rose (and, for book-quality moves, the figure is on file rather than a placeholder) the move becomes Verified, with the reading before and after and its source. If not, it stays Done and says so: confirm the new figure and re-run.
- What changed lists the moves verified on that run, and never credits them with the change in value.
- A Check-in card at the top of Your plan, and on your saved valuations, lists overdue and due-soon moves, moves with no step ticked in thirty days, moves waiting for proof and whether a re-run is due.
- Owner plans and above can turn on check-in emails per practice, weekly, monthly or quarterly; off until you choose. Figures in the email are copied from your last saved valuation.
Prove a move: for assistants
Additive only: no new tool, no changed input.
- list_practices gains a check-in note per practice; compute_valuation comparisons gain the moves verified on that run.
- New skills prove-a-move and move-check-in; succession-readiness-gap 2.0.0 adds a structured interview; valuation-delta 1.3.0 adds the moves line.
Pricing and fees, MCP-first
The revenue-per-household move gets a fee analysis: realized yield, households below a fee floor, discounts against your stated schedule and revenue-only what-ifs. It starts where your billing data already lives: a connected billing or portfolio server, then lists the servers you could connect, and only then offers an export upload. Household rows are never stored. Engine 1.8.0 unchanged. Every figure is identical; server 1.30.0; still eighteen tools.
Where the data lives
Connected servers first, connectable servers next, an export last.
- Connected servers that can supply household billing come first: pull from one, map its report once, and next quarter's pull is one click. Rows pass through ValuationMCP's server to reach your browser and are not stored; only your mapping is saved.
- Servers you could connect are listed with their kind, hosting and sign-in. Remote servers with a published endpoint connect in the app; the others are set up in your own assistant, with the steps and a copyable prompt.
- Saved figures record the server they came from, or Billing export (CSV).
Pricing and fees, MCP-first, for assistants
Additive only: no new tool, no changed input.
- list_data_requirements gains a datasets block: household billing's columns and the catalog servers that can supply it, with their connect steps.
- pricing-and-fees 1.1.0 pulls from a connected server first, then helps the owner connect one, and only then asks for an export. Rows stay in the client; aggregates only.
Client book
The retention, concentration and demographics moves share one client book analysis: household retention over the last year, an at-risk review list, the top ten's dependence on single advisors, the age and life-stage mix and next-generation coverage. It starts with a connected CRM, then lists the CRMs you could connect, and only then offers an export upload. Revenue that left with departed households is a fact about last year, never a forecast. Engine 1.8.0 unchanged. Every figure is identical; server 1.30.0; still eighteen tools.
One analysis, three moves
The card you open from comes first.
- Run the client book analysis from the retention, concentration or demographics card. Household names stay in your browser; tables show up to two hundred rows and download in full.
- Retention needs your departed households. Without them the panel says so and shows no rate.
- Save the aggregates you tick: the source is recorded first. AUM saves only when you confirm your CRM's AUM is complete.
- On the retention card, try last year's departed revenue as an unsaved what-if in the workbench.
- Current coverage now sits above both connect paths, since your agent and the app both raise it.
Client book: for assistants
Additive only: no new tool, no changed input.
- list_data_requirements' datasets block gains the client book: its columns and the CRM servers that can supply it.
- client-book 1.0.0 serves the three moves MCP-first and drafts outreach with placeholders; value-driver-playbook 3.3.0 hands off to it.
Billing panel
Analysis buttons now appear only on moves that are holding the number back. Strengths stay one line, each with a chip naming where its figure came from. The fee analysis became the Billing panel: fees, recurring mix and concentration. Engine 1.8.0 unchanged; server 1.30.0; still eighteen tools.
Where the buttons go
One rule for every card.
- “Analyze your billing” on the revenue per household, recurring revenue and concentration moves; concentration also keeps the client book button beside it.
- Every line shows owner-stated, benchmark-derived or system-pulled. The first two link to “verify”, which opens the pull that can replace them.
- The data coverage card offers “Pull from your billing system” and “Pull from your CRM”, each listing the figures it can replace.
- The recurring mix lists commission and one-off households ranked by fees: your re-papering list.
Agent shelf
The workbench has one work surface: a panel on the right with Plan, Math, Data and Assistant. Move cards are compact and open it. One conversation per firm keeps the move you asked about beside each message. Engine 1.8.0 unchanged; server 1.30.0; still eighteen tools.
One place to work
The board is the map; the panel is the work.
- “Open” on a card shows its plan, or the math for a strength; dataset buttons open the analysis.
- The Assistant button asks about the whole board; replies may propose changes to several moves, each applied on its own.
- The panel remembers its width on this device and turns fully opaque when you ask for less transparency.
Explain this valuation
A button under the suggested asking price opens the panel with your valuation in focus. A valuation consultant explains what the asking price, range, coverage and methods mean in plain words, citing the engine's figures verbatim, and suggests up to three next steps that open existing pages and workflows. New guided workflow: Explain my valuation 1.1.0. Engine 1.8.0 unchanged; server 1.30.0; still eighteen tools.
Your valuation, explained
Plain words beside the engine's own figures.
- The consultant explains why each figure was calculated the way it was, from your own facts and the published rules behind the engine, not only what the figure is.
- Ask what the number means, why there is a range, which methods drive it and how confident it is.
- Next best actions link to a move on your board, the Deal room, your saved valuations, or a workflow to run in your own assistant. Nothing is changed without you.
- These chats join the firm's conversation, tagged Valuation; choose All to see everything in time order.
A tidier signed-in header
The signed-in header shows the logo at the same size as the home page, with every account control on one even line.
- Requests moves out of the menu strip into a button beside Assistant, with a small count of unread requests when there are any.
- Assistant, Requests, the light/dark switch, your email (which opens your settings) and Sign out sit in one fixed order at one height.
- Network accounts find Settings, Billing and Network under the same Settings menu firms use.
- The menu strip reads Valuation, Deal room, Skills & artifacts, Settings. The Valuation menu opens Workbench and Recorded; the Settings menu opens Connect (the firm data hub, formerly Workspace), Your firm(s), Billing and Network. The signed-in button on the public pages reads Connect too.
- Signing in now lands on the Workbench; links that name a destination (consent and request flows) still go where they point.
Billing and Client book, easier to follow
Each panel now says what it answers and what to do next.
- Each panel opens with one sentence on the question it answers and one line on the next step.
- Once a report is pulled or uploaded, the list of servers folds into one line with Change source, so the results sit directly under the heading instead of below every server you could connect.
- Servers you could connect now sit behind a single click; only your connected servers show until you open the list.
- The one confirmation each analysis needs comes first: the full-trailing-year check in Billing, and how your CRM's words are read in Client book, each with a short reason.
- A server call that returns a refusal is now recorded as an error in the activity log, not as ok.