Sign inStart

Documentation

How to get a twin working and read what comes out

Six pages on using the software and four on the thinking behind it. No page here sells anything. If something is missing or only half built, it is named as such.

Getting startedOpen the app

Written against version 1.0 of the plugin. Where behaviour depends on a setting, the setting is named.

Filesstatements, lists, contractsFactseach with the line it came fromGraphpeople, accounts, suppliers, rivalsAgentsobjectives, limits, personalityRunshundreds of them, seededBriefthe answer and its tripwires

Start here, in this order

About forty minutes end to end if you have a profit and loss and a customer list to hand. Less if you use the worked example first.

  1. 1

    Make a twin and load the worked example

    Harborline Components is an invented contract manufacturer that ships with the plugin. Loading it takes a second and gives you a fully populated twin to poke at before any of your own numbers go anywhere.

  2. 2

    Upload three files against your own twin

    A profit and loss, a customer list with revenue per account, and whatever you have on competitors. Three files gets the readiness score out of the red.

  3. 3

    Rebuild, then read the ledger before you read the answer

    The ledger tells you how much of the model is standing on industry defaults. That number governs how much weight the first run deserves.

  4. 4

    Run the price scenario and read the brief top to bottom

    Then replace the top default in the ledger with something you actually know, and run it again. Watch the band, not the median.

Using the software

Getting startedFrom a new account to a brief you can argue with, in nine steps.What to uploadThe thirteen kinds of file the app accepts, what each one gives the model, and the column headings the extractor recognises.Every leverAll twenty four, with units, ranges and what each one does inside the simulation.Reading a briefThe six blocks, how to read a band, and how to argue with the thing rather than nod at it.The APIThe cfct/v1 namespace, cookie and nonce authentication, and every route the app itself uses.Installing on your own WordPressTwo plugins, the requirements, the settings that matter, and a diagnostics screen that runs the engine on your own server.Connecting StripeFive products, five prices, one webhook and one mapping table. Written out click by click, including the test card and how to check it worked.

The thinking behind it

Read these if you want to know whether to believe the output, which is a better question than how to produce more of it.

The methodWhere the equations come from, what they assume, and the list of things that are deliberately not modelled.How this comparesAgainst a spreadsheet, a language model, a consulting engagement and an enterprise simulation product. Including when each of those is the right answer and this is not.Why not just ask a language modelThe difference between a plausible paragraph and a mechanism, written by someone who uses both.GlossaryBand, replication, tripwire, elasticity, origin, readiness, seed, and the rest of the vocabulary the app uses without explaining.

Adjacent pages that answer documentation questions

What it can and cannot tell youThe limits, written down before you are asked for money.What happens to your filesWhere uploads are stored, how they are chunked, and what deletion actually removes.Where a language model is usedThree places, none of them the simulation.What is built and what is notThe running list, kept honest on purpose.

If a page here disagrees with the software, the software is right and the page is a bug. Say so on the contact form and it gets fixed in the next release.

The fastest way through all of this is the worked example

It is an invented contract manufacturer with one customer at 18 percent of revenue and a price unchanged since 2023. Every scenario is already set up on it, so you can read a real brief before you upload anything.

Getting startedBuild a twin