The problem
You don't know the technique
Bottom line up front. The pyramid principle. SCQA. PREP.
Situation–impact–action. Claim–evidence–reasoning. There are more
than a dozen in common use, and most people can name two.
Praxis holds twelve as inspectable data — each with what it
favours, what it avoids, and when it is the wrong choice.
You don't know which one to use
The right shape depends on who reads it first, what they can
actually approve, what happens if they delay, and how much time
they have. Those are answerable questions. Nobody answers them.
Praxis computes the shape from your answers — and asks only
the questions whose answers would change it.
You leave something out
The deadline. The caveat. The figure. The person who owns the next
step. Rewriting for tone is exactly when these go missing, and the
draft still reads fine without them.
Praxis checks, and shows its evidence — no score, no verdict,
just what it saw and where.
Praxis at work
A real draft, and real output — this is what the tool actually printed,
not a mock-up. The message is a request to a busy stakeholder at high
stakes, which is the situation most likely to be got wrong.
The draft
Hi Priya,
I wanted to give you some background on the migration work. Over the last six weeks the team has been looking at the legacy queue and we've done a fair amount of analysis on the failure modes. There's quite a lot of history here, some of which predates the current team.
The upshot is that we think we should probably move to the new pipeline. It would be good to get your thoughts when you have a moment.
Thanks,
Dave
Reads fine. Sends badly.
What praxis says
Fix 5 things before sending: no request of the reader; 1 unsupported
claim; nothing marked uncertain. Plus 2 more. Shape it bottom line
up front.
moderate confidence · nothing else you could tell me would change it
(7 unknowns checked)
- Shape Bottom line up front — because time is low and the intent is a request. Pyramid principle came second, on a lower score.
- Gap No explicit action, no named owner, no deadline.
- Gap "We think we should probably move" is consequential and carries no evidence.
- Gap Six weeks of analysis is asserted; nothing marks what is still estimated.
- Held Every figure, link and commitment in your draft must survive any rewrite, byte for byte.
Ask for changes and it stops describing and starts pointing. Each edit
carries a character offset into your draft, so there is no guessing
which sentence it meant.
- Insert at 11 State the single action the reader must take, in its own sentence at the top. Name the actor and the action; do not describe the situation again. Include the time by which it must happen. outcome_clarity
- Revise 71–203 Attach the figure, log, or named source that makes this claim checkable, or state that it is an estimate. evidence_fit
- Insert at 11 Mark what is still estimated or pending, at the point the claim is made rather than in a closing caveat. uncertainty_integrity
- Insert at 432 Name who is doing the work. risk_calibration
- Insert at 432 Say how the reader confirms they received this — a reply, an approval, or a read-back. risk_calibration
Nothing here is prose. Praxis locates the change; you or the model you
already use writes it.
It knows when to stop asking
Every intake form you have ever filled in asked for everything. Praxis
walks each unknown across its range, re-runs the recommendation, and
asks only where the outcome actually splits. Three states of the same
draft:
-
You have told it nothing.
low confidence · 7 questions would still change this
Asks 1 question. Splits 11 ways.
-
You have said the stakes are high.
low confidence · 6 questions would still change this
Asks 1 question. Splits 9 ways.
-
You have answered three.
moderate confidence · nothing else you could tell me would change it
Asks nothing. 7 unknowns checked.
Three answers. One question at a time. It tells you when more input
stops buying you anything.
What it will not do
It does not write your message.
The engine holds no API key, calls no model, and reaches no network.
It cannot produce a sentence, and adding that would destroy the
reason to trust its audits — a rewriter grading its own rewriting is
not an audit.
It does not score you.
No number, no grade, no percentage out of a hundred. Findings come
with the evidence attached, and you are free to disagree with every
one of them.
It cannot tell you whether you are right.
It can see that no deadline appears and that a consequential claim
sits nowhere near a figure. It cannot see whether your argument is
sound or your number is true. It reports unknown often, and
on purpose.
It is working, not finished.
Which is what the testing is for.
What I need
Bring one message you are actually about to send.
A recommendation to leadership, a request that needs a decision, a
piece of bad news. Something with a real reader and a real consequence
— the tool is uninteresting on writing that does not matter.
- Run it, and tell me where the shape it picked was wrong for your reader.
- Tell me which question it should have asked and didn't — that is the mechanism I most need to break.
- Tell me the finding you disagreed with, and why you were right.
Fifteen minutes. It runs entirely in your browser: no account, no
upload, nothing leaves your machine. Bring the message you would be
nervous to get wrong.
Opens an email to test-praxis@dhk.io. I send the link back the same day.
Background, if you want it first —
In Defense of Mechanical Writing ↗
and
More on Mechanical Writing ↗.
The side-by-side matrix shows the
mechanisms against each other.