@rubytech/create-maxy-code 0.1.277 → 0.1.278

package/package.json

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

package/payload/platform/config/brand.json

@@ -16,7 +16,7 @@
   "claudeSessionManagerPort": 19400,
   "commercialMode": false,
   "vertical": null,
-  "shipsPremiumBundles": ["venture-studio", "writer-craft", "teaching"],
+  "shipsPremiumBundles": ["venture-studio", "writer-craft", "teaching", "management-consulting"],
 
   "defaultColors": {
     "primary": "#7C8C72",

package/payload/platform/plugins/admin/skills/plainly/SKILL.md

@@ -19,6 +19,30 @@ Textbook explanations are technically correct and pedagogically poor. They conve
 
 Failing the aloud test produces opacity; failing the understanding test produces parroting; failing the new-to-topic test produces *appearance of clarity*: the answer reads as crisp to the writer but lands as a wall of jargon to the audience. A reader who can teach the concept onward to someone else has cleared all three.
 
+## The shape of natural writing
+
+The AI-tells catalogue below says what to strip. This section says what to reach *for*. The model is the short-essay voice of good pre-GenAI blog writing: plain words, one idea, and a reader who is dropped straight into the middle of it. Read a handful of those posts and the first thing you notice is how *spoken* they are. The sentences are uneven. Nothing warms up. The piece says one true thing and stops. That texture is not decoration; it is what "human" reads as, and it is exactly what AI prose sands off.
+
+These are tools, not a template. Use the ones the content actually calls for. Stamping all of them onto every output is its own tell.
+
+- **Start in the middle.** The first sentence is the first sentence. No runway, no "in order to understand X we first have to," no restating the question back to the reader. Open with the claim itself, a small concrete scene, or the single question the whole piece answers, and let the reader catch up. The test: if you can delete your opening sentence and the piece still stands, it was runway. Delete it.
+  - Runway: "In order to understand caching, we first need to think about how computers store data."
+  - Dropped in: "Your computer keeps a few things close at hand, the way you keep your keys by the door."
+
+- **Let the sentences breathe unevenly.** Natural prose alternates a long, winding sentence with a short flat one, and now and then a fragment standing alone. A three-word sentence after a thirty-word one is a gear change the reader feels in the body. This is the positive form of the uniform-cadence tell catalogued below: don't just avoid the steady 12-to-18-word march, reach for the opposite.
+  - "A cache is a small, fast store of the things you'll probably want again. That's it. The hard part was never keeping them. It's knowing when the copy you kept stopped being true."
+
+- **Anchor every abstraction to something you can see or touch.** Swap the category word for the physical thing. "Latency" becomes "the half-second between asking and getting an answer." "Stakeholders" becomes "the three people who can say no." "Synchronisation overhead" becomes "the time everyone spends waiting for everyone else." The concrete noun is almost always the plain-English one too, so this move and the recursive rule pull in the same direction.
+
+- **Earn one turn.** Most short pieces have a single hinge: the thing the reader already assumes, and then the truer thing. Set up the assumption in plain terms, then turn it. One turn, not three. The turn *is* the point; stacking several buries it, and inventing one where the content has none reads as forced. (The earned turn often carries a negation, "the trick isn't X, it's Y". That is *not* the banned antithetical-parallelism tell below. The tell is the same shape used as reflexive flourish with no new content, especially as an opener; the earned turn delivers the actual point of the piece. Use it once, where the content genuinely hinges.)
+  - "Everyone thinks the trick is finding the data fast. The trick is trusting that what you found is still true."
+
+- **Land, don't summarise.** The last line reframes; it does not recap. A closing that opens with "In summary" or "So to wrap up" is throat-clearing at the wrong end. The endings that work are a quiet observation, a small instruction to the reader, or a turn that recasts everything above it. Say it once, then stop.
+  - Recap (weak): "In summary, caching trades freshness for speed."
+  - Land (strong): "So a cache isn't really about speed. It's a bet that the world won't change before you look again."
+
+**Scope of these moves.** The structural ones (the dropped-in open, the single turn, the landing close) apply when the output is a paragraph or more of explanation. A bare two-sentence definition needs only the register and the cadence: plain words, concrete anchors, uneven sentences. Do not bolt a manufactured hook or a profound-sounding reframe onto a definition that has no genuine turn. A reframe with nothing to reframe is indistinguishable from manufactured profundity, which is itself an AI tell.
+
 ## The recursive rule (load-bearing)
 
 A plain-English explanation **cannot itself contain terms that need explanation**. Reject any candidate sentence that contains:
@@ -87,19 +111,12 @@ These are patterns common in AI-generated prose but rare in actual human writing
 
 ## Worked examples
 
-Twelve worked examples are kept in [`references/worked-examples.md`](references/worked-examples.md), loaded on demand. The examples cover, in order:
-
-1. Integration: a primitive operation, two-sentence definition.
-2. "S_T is lognormal": a richer concept that uses all four template items.
-3. The Merton model dimensionality question: function-signature notation is itself a formula.
-4. Quadrature, well-framed: density beats scaffolding when the framing is already audience-appropriate.
-5. Quadrature, new reader: precision without bridging fails the new-to-topic test.
-6. Quadrature, in-document phrasing: scope-matching, the operational definition is often enough.
-7. "parameter standard errors fall out of the calibrated Jacobian": one sentence in, one sentence out (transliterate, don't expand).
-8. "V_0 memory has decayed to θ": symbol anchoring (meaning first, symbol parenthetical).
-9. VIX options under regime-switching Heston: Greek letters are jargon, parenthetical clarifications must add substance, watch the register.
-10. "Same closure as the constant-σ path": "same as X" references must define X, not punt to it.
-11. VIX pricing under Heston: when in doubt, go simpler, the audience is less experienced than the writer thinks.
-12. Marketing-pitch format scaffolding: bold-headings-with-em-dashes is itself the AI tell, regardless of how plain the words inside are.
-
-Read the relevant example before producing a polish in a similar register. The principles in this file are the load-bearing rules; the examples are the concrete demonstrations of each one.
+Five worked examples are kept in [`references/worked-examples.md`](references/worked-examples.md), loaded on demand. Examples 1 to 4 are subtractive (sizing, scope, vocabulary, format); example 5 is additive (the "shape of natural writing" moves applied to a flat-but-correct explanation). They cover, in order:
+
+1. Sizing the explanation: a two-sentence primitive vs. the full four-item template for a richer concept.
+2. Transliterate, don't expand: one jargon sentence in, one plain sentence out, with symbol anchoring (meaning first, symbol parenthetical).
+3. Default to plainer than you think: the audience is newer than the writer assumes; downgrade proper nouns, placeholder nouns, and stacked modifiers.
+4. Format scaffolding is itself the AI tell: bold-headings-with-em-dashes must become prose in human-facing copy.
+5. The shape of natural writing: a flat, correct, jargon-free explanation rewritten with a human voice (start in the middle, uneven cadence, concrete anchors, one earned turn, a landing close).
+
+Read the relevant example before producing a polish in a similar register. When the failing quality is liveliness rather than jargon, read example 5 and the "shape of natural writing" section together. The principles in this file are the load-bearing rules; the examples are the concrete demonstrations of each one.

package/payload/platform/plugins/admin/skills/plainly/references/worked-examples.md

@@ -1,301 +1,114 @@
 # /plainly worked examples
 
-Twelve examples that demonstrate the rules in SKILL.md against concrete cases. Each example shows: a source, a polished version, and the failure modes the polish avoids.
+Five examples that demonstrate the rules in SKILL.md. Each shows a source, a polished version, and the failure modes the polish avoids. Examples 1 to 4 are subtractive (sizing, scope, vocabulary, format); example 5 is the positive counterpart, the "shape of natural writing" moves turning a flat-but-correct explanation into prose a human would actually write.
 
-**Note on em-dashes in this file.** The current rule (see SKILL.md "AI tells to strip") prohibits em-dashes anywhere in polished output. Examples 1 to 11 below were written before that rule reached its no-exception form; their polished versions therefore still contain em-dashes that, by today's rule, should be commas, semicolons, parentheses, or two sentences. The bad-pattern quoted illustrations (under "Source", "First-pass", "Failed version") keep their em-dashes intentionally, since they are showing what to avoid. Example 12 is the canonical reference for the no-em-dash standard.
-
-**Note on identifying material.** Examples are presented in generic form. Where an earlier draft referenced a specific codebase, writer, or pitch, the reference has been replaced with neutral phrasing (e.g. "the reference codebase" instead of a project name).
+Em-dashes appear only inside quoted bad-pattern illustrations (what to avoid); every polished output is em-dash-free, per the rule in SKILL.md. Examples are presented in generic form; where an earlier draft named a specific codebase or pitch, the reference has been neutralised.
 
 ---
 
-## Worked example: integration
+## 1. Sizing the explanation: primitive vs. richer concept
+
+A primitive operation needs only the precise definition plus its immediate consequence, two sentences. A richer concept needs the full four-item template from the output contract: definition, consequences, visual, significance. Length is dictated by the concept's richness, not by a fixed template.
 
 > **User:** what is integration, in plain English?
 
 > Integration is the act of adding up all the infinitesimal changes specified by a differential equation over an interval, giving the system's state at the end of that interval. If each change is random, that end state is a distribution of possible values; if each change is deterministic, it is a single value.
 
-**Failure modes this avoids, recorded as anti-patterns:**
-
-- *"...combines all the discrete steps..."*: "discrete" is wrong (the limit is continuous); "steps" connotes uniform sub-intervals.
-- *"...the act of stitching all the infinitesimal slices..."*: "stitching" is a sewing metaphor for *adding up*; "slices" is a metaphor for *changes*.
-- *"...specified by a rule..."*: "rule" is a vague placeholder for *differential equation*.
-- *"...if each increment is random (an SDE) ... deterministic (an ODE)..."*: "increment" connotes positive (changes can flip sign); the parenthetical acronyms are jargon redundant with the surrounding "random" / "deterministic" clauses.
-
-Each failure leaks a term that would itself need explanation. The polished version contains none.
-
----
-
-## Second worked example: a richer concept demands the full template
-
 > **User:** /plainly "S_T is lognormal"
 
 > "S_T is lognormal" means the logarithm of S_T (denoted log(S_T)) is normally distributed. This means S_T itself is always positive and large upward moves are more likely than relative downward moves. Visually, the distribution is skewed to the right, with a long right tail. This property is exactly why Black-Scholes is closed-form (can be solved analytically rather than numerically).
 
-**Failure modes this avoids, recorded as anti-patterns:**
-
-- *"'S_T is lognormal' means the logarithm of S_T follows a normal (bell-curve) distribution."*: definition only. Has the precise terms but no scaffolding (no implications, no visual, no significance). The reader gets the dictionary entry but cannot use it.
-- *"'S_T is lognormal' describes how its possible values are spread: always above zero, with most outcomes clustered near a central level, larger upward moves possible, and no values below zero."*: over-correction the other way. Avoids the technical terms ("logarithm", "normally distributed") that the doc actually uses elsewhere, and so leaves the reader with no anchor between this paragraph and the rest of the document. Plain English doesn't mean throwing out vocabulary the doc has already established.
-
-The polished version uses the precise terms, denotes the symbol explicitly, *and* scaffolds with implications, visual, and significance. Each element does independent communicative work.
-
----
-
-## Third worked example: function-signature notation is still a formula
-
-> **User:** why is the Merton model a one-dimensional pricing equation when its jumps are random?
-
-> The dimensionality of a pricing equation counts state variables, not sources of randomness. The equation solves for the option's value as one function across every possible spot price and every time before expiry; it does not enumerate possible futures, it averages over them. With Merton jumps, the only state variable is spot price, so the equation is one-dimensional in space. With Heston stochastic variance, variance is itself a process that evolves through time and feeds back into the spot price's dynamics, so it has to be tracked alongside spot: two state variables, two spatial dimensions.
-
-**Failure modes this avoids, recorded as anti-patterns:**
-
-- *"...the option's value `V(S, t)` as a single function over the state space..."*: `V(S, t)` is function-signature notation, which fails the read-aloud test. Nobody says "V of S comma t" in conversation. Express it in words: "the option's value as a function of spot price and time".
-- *"...State = (S). Two-dimensional state: (S, v)..."*: tuple notation is a formula. Say "the only state variable is spot price" and "the state is now spot price and variance".
-- *"...regime index k ∈ {1..K}..."*: set-builder notation is a formula. Say "regime index running from one to K" or just "the regime label".
-
-The general principle: any expression that uses parentheses, commas, or symbols to encode a relationship, not just equations with equals signs, is a formula and breaks the spoken register. Plain English forces you to *unpack* the relationship into its English statement, which is also where the understanding lives.
-
----
-
-## Fourth worked example: density beats scaffolding when the user has framed the question
-
-> **User (paraphrased framing, ~70 words):** "The integral term in a pricing equation is the line 'average the option's value across all possible post-jump spot levels'. Doing that average with infinite precision is impossible, you can't actually visit every possible jump size. So we approximate the integral as a *weighted average over a small handful of carefully chosen sample points*. That approximation is called **quadrature**." Refine.
-
-> Polished response (~60 words): "Quadrature approximates an integral as a weighted sum over sample points whose locations and weights are chosen so the sum is exact for a stated family of functions, usually polynomials up to some degree against a fixed weight. Seven-node Gauss-Hermite (the reference rule) is exact for degree-thirteen polynomials against a normal density, fitting the lognormal jump distribution closely enough that seven evaluations replace hundreds of naive rectangles."
-
-**Failure modes this avoids, recorded as anti-patterns:**
-
-- *Re-establishing what the framing established.* Restating "the approximation of an integral as a weighted sum over sample points" when the framing already said exactly that. Filler dressed as definition.
-- *Re-doing the visual when the framing already gave one.* The framing's "average across post-jump spot levels" is a working picture. Adding "imagine rectangles under a curve" describes the same thing in different words and adds zero precision.
-- *Re-motivating the problem.* The framing already explained why we need the approximation ("can't visit every jump size"). Re-explaining the motivation is wasted words.
-- *Adjacent context dressed as significance.* "Per-iteration cost rises ~7×" is true and interesting but does not deepen understanding of *what quadrature is*; it answers a different question. Save it for a follow-up if asked.
-
-The precision delta is the answer's only real content. Here, the delta over the framing is: *what "carefully chosen" actually means* (locations and weights making the sum exact for a stated function family), and *which specific rule the reference codebase uses* and *why that rule fits this case*. Everything else is scaffolding the user does not need.
-
-The general principle: a longer answer to a well-framed question is a worse answer *when the framing is already audience-appropriate*. If the framing is researcher shorthand and the audience is new to the topic, see the fifth example.
-
----
-
-## Fifth worked example: precision without bridging fails the new-to-topic test
-
-The terse refinement from the fourth example is precise and shorter than the framing, but it lands only for a reader who already owns the specialist vocabulary, which is not the /plainly audience. The new reader does not know what "exact for a stated family of functions" implies, why polynomial-exactness translates to near-exactness on smooth functions, what "against a fixed weight" operationally means, or how the lognormal jump distribution connects to a normal-density quadrature rule. Each of those gaps has to be bridged inside the explanation.
-
-Polished response (~180 words, walks the new reader through):
-
-> Quadrature is a way of computing an integral by evaluating the function at a small number of sample points, multiplying each value by a weight, and adding them up. The trick is choosing the points and weights so that the sum is *exactly right* for an entire class of functions at once, typically all polynomials up to some chosen degree.
->
-> That promise is the source of the leverage. If the function you actually want to integrate happens to be one of those polynomials, the sum is the true answer, not an approximation. For functions that are close to one (which most smooth functions are), the error is tiny. So instead of needing hundreds of evenly-spaced samples, a handful placed where they extract the most information about the function's shape gives the same accuracy.
->
-> The reference codebase uses a rule called Gauss-Hermite with seven samples. It is exact for any polynomial of degree thirteen *multiplied by a bell curve* (a normal density). That last detail matters: Gauss-Hermite is built specifically for averages over normally-distributed quantities. The lognormal jump distribution in the model is exactly that (a quantity whose logarithm is normal), so once the integral is rewritten in log-space, the rule fits the integrand almost perfectly. That is why seven evaluations replace what would otherwise need hundreds.
-
-**Failure modes this avoids, recorded as anti-patterns:**
-
-- *"Exact for a stated family of functions" without saying what that means or why it matters.* A new reader does not know that exactness on a function family implies near-exactness on functions close to that family. Spell it out: the sum is exactly right for the named class, and close to right for things close to the class.
-- *"Polynomials against a fixed weight" without unpacking the phrase.* "Against a weight" sounds like it has a precise meaning to the writer, but reads as decorative noise to a new reader. Either say "polynomials multiplied by a fixed function (a weight)" once and operationally, or skip the abstract framing and go to the concrete case.
-- *"Fitting the lognormal jump distribution closely enough"*: fitting *how*? The new reader has to take this on faith. Bridge it: lognormal means the *logarithm* of the quantity is normal; Gauss-Hermite is built for normal-weighted integrals; rewrite the integral in log-space and the rule and integrand match.
-- *Skipping the operational definition of the technique itself.* Saying "approximates an integral as a weighted sum over sample points" assumes the reader can picture what that means in code or on paper. Walk them through: pick points, evaluate, multiply by weights, add. One sentence, but load-bearing.
-
-The general principle: **density is only a virtue when every dense phrase lands.** A short answer that uses three specialist phrases is *longer* in reading time than a longer answer that uses none, because the reader has to look each one up. If you find yourself using a phrase that compresses several specialist concepts ("exact for a polynomial family"), either unpack the compression inside the explanation or expect the answer to fail the new-to-topic test.
-
----
-
-## Sixth worked example: scope-matching, the operational definition is often enough
+**Failure modes:**
 
-The fifth example bridges all the way to the named rule and its mechanism. That depth is correct only when the reader will *use* the mechanism: selecting node counts, comparing rules, verifying near-exactness claims. When the reader will use the technique as a black box (the case in a risk-analysis writeup, where quadrature appears once as "the method we use to compute the jump integral"), the operational definition alone is enough.
+- *Definition only, no scaffolding.* "...the logarithm follows a bell-curve distribution." Correct terms, but the reader gets a dictionary entry they cannot use. A richer concept needs the consequences, the picture, and why the document cares.
+- *Over-correction that drops the doc's own vocabulary.* Avoiding "logarithm" or "normally distributed" and substituting circumlocutions leaves the reader with no anchor to the rest of the document. Plain English keeps vocabulary the doc has already established.
+- *Padding a primitive to four items.* Integration needs two sentences. Adding a manufactured "visual" or "significance" to a primitive is filler.
 
-The writer's polished version (~45 words, in-document phrasing):
-
-> Calculating the integral term in the PIDE, the average of the option's value across all possible post-jump spot levels, is actually not possible. Instead, we approximate the integral as a *weighted average over a small number of carefully chosen sample points*, a method known as **quadrature**.
-
-Two prose-level moves worth recording, both of which trimmed the version above from a slightly wordier earlier draft:
-
-- *"i.e. infinite precision is impossible"* to *"is actually not possible"*: drops the technical-feeling "i.e." and uses a parenthetical that reads more naturally aloud. The missing word "exactly" is recovered by the reader from the contrast with "approximate" in the next sentence; spelling it out would be filler.
-- *"an approximation method"* to *"a method"*: once "approximate the integral as ... a method" is on the page, the word "approximation" is already implied. Repeating it is one of the most common forms of filler in technical writing: the over-specified noun phrase that names the role its sentence already established.
-
-This passes all three tests for its audience:
-
-- *Aloud test:* yes, reads cleanly without notation.
-- *Understanding test:* yes, the reader knows operationally what quadrature does (sample, weight, average), which is the level at which they will use it.
-- *New-to-topic test:* yes, every phrase is plain. "Carefully chosen" is left as a black-box modifier, not unpacked into polynomial-exactness; that is correct, because the reader does not need to choose the points or verify the rule. Trusting "carefully chosen" is part of the black-box contract.
-
-**Failure modes this avoids, recorded as anti-patterns:**
-
-- *Over-engineering past the question's scope.* If the surrounding doc only requires the reader to know what quadrature *is*, explaining *how* Gauss-Hermite achieves exactness is filler, even when every phrase is plain English. The fifth-example bridging answer is wrong for the sixth-example reader.
-- *Mistaking "how the technique works" for "what the technique is".* These are different questions. A /plainly definition answers the second by default. Mechanism is a follow-up question and warrants its own explanation only when asked.
-- *Treating richer-when-possible as a virtue.* The four-item template (definition, consequences, visual, significance) maxes out at four for a reason. If the reader's use of the concept does not depend on consequences, visual, or significance, the definition alone suffices, and adding the others is padding.
-- *Refusing to leave a hand-wavy modifier hand-wavy.* Phrases like "carefully chosen" are sometimes load-bearing precisely because they signal *trust the technique without explaining it*. A risk-analysis reader does not need to know what makes the choice careful; they need to know that someone competent made it.
-
-The general principle: **what the reader needs to DO with the concept dictates the depth, not the concept's intrinsic richness.** Quadrature is intrinsically rich, but a risk-analysis reader uses it as a black box ("samples and weights chosen carefully") and that level of depth is the right answer. The fifth example and the sixth example are both correct plain English, for different readers. The /plainly invocation should default to the operational scope (sixth) and reach for mechanism (fifth) only when the reader will need mechanism.
+**Principle:** two items for a primitive, up to four for a rich concept; never pad past what the reader needs.
 
 ---
 
-## Seventh worked example: when the source is one jargon-packed sentence, the plain-English answer is also one sentence
+## 2. Transliterate, don't expand (match the scope of the question)
 
-Sometimes the user pastes a single sentence, often a sentence dense with specialist vocabulary, and asks for plain English. The temptation is to unpack each piece of jargon into its own paragraph, define the surrounding context, walk through implications, add a "catch" or a payoff. That produces a wall of text masquerading as plain English. The right answer is a **transliteration**: keep the source's syntactic frame, swap each jargon term for its plain-English equivalent, stop.
+When the source is a single sentence dense with jargon, the plain version is also a single sentence: keep the syntactic frame, swap each jargon term for its plain equivalent, stop. When the source uses bare symbols, anchor them, putting the meaning first and the symbol in parentheses as a cross-reference back to the surrounding document.
 
 > **User:** /plainly "parameter standard errors fall out of the calibrated Jacobian via the usual covariance formula."
 
-> Polished response (one sentence): "Since the calibration produces a table of sensitivities as part of its loss-minimisation process, this table is converted to statistics that express the margin of error in the parameters."
-
-The mapping is direct:
-
-- "parameter standard errors" becomes "the margin of error in the parameters"
-- "fall out of" is preserved by phrasing the conversion as a follow-on to a process that was happening anyway ("since the calibration produces … as part of its loss-minimisation process")
-- "the calibrated Jacobian" becomes "a table of sensitivities"
-- "via the usual covariance formula" becomes "is converted to statistics that …"
-
-Each jargon term lands in the same syntactic slot it occupied in the source. Nothing is added; nothing is cut. The result is one sentence, mirroring the source's one sentence.
-
-**Failure modes this avoids, recorded as anti-patterns:**
-
-- *Adding numeric examples to convey what "margin of error" means.* The reader knows what a margin of error is. Adding "an 18% volatility give-or-take 0.5% is very different from 18% give-or-take 8%" is filler that explains a concept the reader did not ask about.
-- *Explaining surrounding context that wasn't in the asked sentence.* The χ²-weighting connection (which is what makes the formula statistically meaningful) appears in *adjacent* sentences in the source document, not in the phrase being asked about. Bringing it in is scope creep: answer the sentence that was asked, not a richer one nearby.
-- *Re-stating the "for free" payoff multiple times.* "Comes for free", "no extra rounds of fitting", "no simulation needed" all say the same thing. One mention is enough; multiple is filler dressed as emphasis.
-- *Adding a "the catch" or "the payoff" paragraph for nuance.* The source phrase contains no catch. Adding one expands the explanation beyond the asked scope.
-- *Walking the reader through worked motivation ("imagine you have a calibration that just finished…").* The source is a present-tense statement of fact. The plain version should be too. Story-mode framing is filler.
-
-The general principle: **transliterate, don't expand.** When the source is a single sentence dense with jargon, the plain-English version should preserve the source's sentence structure and only replace each jargon term with its plain-English equivalent. The reader is not asking "teach me everything about parameter uncertainty estimation in nonlinear least squares"; they are asking "what does *this sentence* mean". Match the scope of the question, not the depth of the underlying topic. The verbal-conversation test is sharpest here: if you would say one sentence to a colleague who asked "what does that mean?", write one sentence. Anything more is the writer's anxiety, not the reader's need.
-
----
-
-## Eighth worked example: symbol anchoring done right (transliteration, second instance)
-
-The seventh example established the transliterate-don't-expand rule. The eighth shows the same rule applied cleanly with **symbol anchoring**: when the source uses bare symbols as jargon (e.g. "V₀ memory"), the plain version puts the *meaning* in front and the *symbol* in parentheses as a cross-reference back to the surrounding document.
+> Since the calibration produces a table of sensitivities as part of its loss-minimisation process, this table is converted to statistics that express the margin of error in the parameters.
 
 > **User:** /plainly "The V₀ memory has decayed to θ by the time of any VX-future expiry, so the V₀ term drops out."
 
-> Polished response (one sentence): "By the time any VX future expires, the variance has mean-reverted from its starting value (V₀) to its long-run level (θ), so the formula no longer depends on V₀."
-
-The mapping is, again, direct:
-
-- "V₀ memory" becomes "starting value (V₀)": meaning first, symbol as parenthetical cross-reference.
-- "has decayed to θ" becomes "has mean-reverted to its long-run level (θ)": same anchoring move, same syntactic slot.
-- "by the time of any VX-future expiry" becomes "by the time any VX future expires": light prose tweak, same content.
-- "the V₀ term drops out" becomes "the formula no longer depends on V₀": operational restatement.
+> By the time any VX future expires, the variance has mean-reverted from its starting value (V₀) to its long-run level (θ), so the formula no longer depends on V₀.
 
-**Why this works:**
+The mapping is direct: "the calibrated Jacobian" becomes "a table of sensitivities"; "V₀ memory" becomes "starting value (V₀)" (meaning first, symbol parenthetical); "decayed to θ" becomes "mean-reverted to its long-run level (θ)". Each jargon term lands in the slot it occupied in the source. Nothing is added; nothing is cut.
 
-- *Symbol anchoring preserves cross-referenceability without leading with jargon.* A reader who knows the doc recognises V₀ and θ as the variables from the previous bullet's formula; a reader new to the topic gets the meaning from "starting value" and "long-run level" without needing to recognise the symbols. Both audiences are served by one sentence.
-- *No anti-patterns from the seventh example were committed.* No numeric example explaining what mean-reversion is. No re-derivation of the formula. No "the catch is …" or "the payoff is …" closer. No story-mode preamble.
+**Failure modes:**
 
-**Failure modes this avoids, recorded as anti-patterns:**
+- *Expanding a one-sentence question into paragraphs.* The reader asked what one sentence means, not for a tutorial. Numeric examples, adjacent context (a connection that lives in neighbouring sentences, not the asked one), or a "the catch is…" paragraph are all scope creep.
+- *Leading with the symbol.* "V₀ is the initial variance…" makes the reader decode the symbol first. Lead with the meaning, anchor the symbol once parenthetically, and never back-reference the bare symbol later: mapping "V₀ here = starting value from a sentence ago" is the cost the anchor was meant to remove.
 
-- *Defining V₀ from scratch.* "V₀ refers to the initial value of the variance process at the moment a regime starts; over time, this initial-value memory exponentially decays toward the long-run level …": too long. The doc has already introduced V₀ in the previous bullet's formula. Anchoring it parenthetically (V₀) is enough.
-- *Bringing in adjacent variables not in the asked sentence.* "V₀ is the initial variance, θ is the long-run mean, the variance mean-reverts at rate κ towards θ …": κ does not appear in the asked sentence. Including it is scope creep.
-- *Adding editorial commentary.* "This is why we can simplify the formula at long horizons …": the source makes a factual statement, not an editorial one. The plain version should match.
-- *Re-deriving the source's claim instead of stating it.* Listing the formula again with V₀ replaced by θ to "show" what dropping out means. The reader did not ask for the derivation.
-
-The general principle reinforces the seventh example: **one sentence in, one sentence out.** Symbol anchoring (meaning first, symbol parenthetical) is the standard move when the source uses bare symbols; it keeps the plain version cross-referenceable to the surrounding doc without leading with jargon.
+**Principle:** match the scope of the question, not the depth of the topic. One sentence in, one sentence out.
 
 ---
 
-## Ninth worked example: Greek letters are jargon, parenthetical clarifications must add substance, watch the register
-
-The eighth example introduced symbol anchoring. The ninth shows three failure modes that are easy to commit on a first attempt even when the principle is known: (1) using a Greek letter as the primary referent rather than as a parenthetical anchor, (2) keeping a self-referential clarification that introduces more jargon than it removes, and (3) reaching for a casual-register word that doesn't match the document.
-
-> **User:** /plainly "**VIX options**: lognormal-mixture in IV space with vol-of-VIX `η_i = ν_i / (2·√θ_i)` (heuristic from sqrt-derivative chain rule on Heston dynamics). Same closure as the constant-σ path; the only difference is where η comes from."
-
-> Polished response: "**VIX options**: priced as a mixture of lognormal distributions of implied volatility, one per regime, with each regime's vol-of-VIX (η_i) derived from the Heston parameters as vol-of-vol divided by twice the square root of long-run variance. The pricing method is otherwise the same as in the constant-volatility model; only the source of vol-of-VIX changes: fitted directly per regime under constant-volatility, derived from the Heston parameters here."
-
-The mapping:
+## 3. Default to plainer than you think; the audience is newer than the writer
 
-- "lognormal-mixture in IV space" becomes "a mixture of lognormal distributions of implied volatility": unpacks "IV space" into its plain meaning.
-- "vol-of-VIX η_i = ν_i / (2·√θ_i)" becomes "vol-of-VIX (η_i) derived from the Heston parameters as vol-of-vol divided by twice the square root of long-run variance": meaning leads, symbol anchors parenthetically; the formula is described in words.
-- "(heuristic from sqrt-derivative chain rule on Heston dynamics)" is **dropped**. The clarification's content ("approximate") is recoverable from broader doc context; its form introduces "chain-rule" which is itself jargon.
-- "Same closure as the constant-σ path" becomes "The pricing method is otherwise the same as in the constant-volatility model": *closure* to *method* (register), *constant-σ* to *constant-volatility* (Greek-letter rule).
-- "the only difference is where η comes from" becomes "only the source of vol-of-VIX changes: …": the plain-English term is used throughout, *including* in the back-reference. Anchoring (η_i) once is for cross-reference to the surrounding doc, not a licence to use η as a back-reference later in the same paragraph; the second use would still be jargon to a reader who can't decode the letter.
-
-**Failure modes this avoids, recorded as anti-patterns:**
-
-- *Using a Greek letter as the primary referent.* The source's "vol-of-VIX η_i" treats η_i as the named-entity, with "vol-of-VIX" as the descriptor. A reader who doesn't recognise η is stuck; they don't even know what Greek letter it is, let alone what it represents. The plain version inverts the order: vol-of-VIX is the entity, (η_i) is the parenthetical anchor for cross-reference.
-- *Back-referencing the symbol after anchoring it once.* "Only the source of η changes" assumes the reader can map η back to the parenthetical anchor a sentence ago. That mapping is itself the cognitive cost the parenthetical was meant to remove. Use the plain-English term throughout (*"only the source of vol-of-VIX changes"*); reserve the symbol's appearances to (1) a single anchored introduction for cross-reference and (2) any place where the symbol genuinely appears in a formula the reader might look up.
-- *Keeping a self-referential clarification that adds more jargon than it removes.* "(a chain-rule shortcut on the Heston dynamics)" looks like it's helping the reader but introduces "chain-rule", a term the reader may not own. If the clarification needs its own clarification, drop it. The point that the formula is approximate can be inferred from the surrounding text (the broader Heston pricing section already mentions closed-form approximations) and does not need to be spelled out at every formula.
-- *Reaching for a casual-register word like "recipe" (or "trick", "vibe", "bake in").* These words carry tone from cooking and conversational registers and read as glib in technical writing. *Method*, *technique*, *approach* are the register-neutral equivalents.
-- *Greek-letter compactness as a false economy.* "Constant-σ model" is no shorter than "constant-volatility model" once you account for σ being unrecognisable to part of the audience. Save the Greek symbol for the back-reference; lead with the word.
-
-The general principle: **the recursive rule is more demanding than it looks.** A plain-English explanation cannot contain terms that need their own explanation, and that includes Greek letters used as primary referents (which require recognising the alphabet) and parenthetical clarifications that introduce new jargon. Every symbol in the source is a candidate for being downgraded to a parenthetical anchor; every parenthetical clarification in the source is a candidate for being dropped if its plain version would itself need clarifying.
-
----
+The writer's audience-model is calibrated to the writer's own background, so the words that feel obvious ("Fourier methods", "characteristic function") are exactly the ones to downgrade. The cost of going one level too plain is mild (an expert feels slightly patronised); the cost of going one level too jargon-heavy is severe (the new reader bounces off entirely). The asymmetry favours plainer.
 
-## Tenth worked example: "same as X" references must define X, not punt to it
-
-Sometimes a source phrase says "X works the same as Y, except for Z". The temptation is to mirror that structure in the plain version: "X works the same as Y, except Z." But this assumes the reader already knows what Y is, and usually they don't, which is why they invoked /plainly. The plain version must **describe** Y inline, not refer to it. Otherwise the explanation is recursive: it defers the work to a definition the reader doesn't have.
-
-> **Source (continuation of the ninth example):** "...Same closure as the constant-σ path; the only difference is where η comes from."
+> **Source:** "Exact VIX pricing under Heston would require Fourier methods on the integrated CIR variance distribution; the closed-form approximations match shape to negligible practical error and are fast enough for repeated pricing."
 
-> **Failed plain version:** "...The pricing method is otherwise the same as in the constant-volatility model; only the source of vol-of-VIX changes: fitted directly per regime under constant-volatility, derived from the Heston parameters here."
+> **First pass (still too jargon-heavy):** "Exact VIX pricing under Heston would require Fourier methods applied to the distribution of integrated variance; the closed-form approximations match the exact shape to negligible practical error and are fast enough to call repeatedly."
 
-> **Fixed plain version:** "...The pricing method is otherwise the same as in the constant-volatility model, i.e. each regime contributes one Black-76 lognormal price using the regime's VIX as forward and vol-of-VIX as volatility input, weighted by the regime's occupancy probability at expiry, then discounted to today."
+> **Polished:** "Exact VIX pricing under Heston would require a transformation of the variance probability distribution but the closed-form approximations we use here instead are close enough in terms of residual error and fast enough that we can call them repeatedly."
 
-What changed: the failed version *repeated* a structural claim already made in sentence 1 ("the only difference is the source of vol-of-VIX") without ever describing what the constant-volatility pricing method actually does. The fixed version uses the second sentence to **spell out** the method, so the reader doesn't need to look elsewhere.
+The second pass downgrades each borderline word: "Fourier methods" becomes "a transformation" (drops the proper noun and the placeholder noun "methods"); "integrated CIR variance distribution" becomes "variance probability distribution" (unstacks the modifier chain); "match shape to negligible practical error" becomes "close enough in terms of residual error" (elaborate phrasing collapses to the plain claim); and an explicit "but" is added so the reader does not have to infer the contrast from punctuation. Note the polished version is no shorter than the first pass: plainness is substituting vocabulary downward, not cutting words.
 
-**Failure modes this avoids, recorded as anti-patterns:**
+**Failure modes:**
 
-- *Punting on the "same as X" reference.* "Same as the constant-volatility model" is meaningful only if the reader already knows that model. If the doc doesn't define it nearby (and often it doesn't, in plain-English passages), the plain version must define it inline. Anything else is the writer pointing at the answer instead of giving it.
-- *Repeating a structural claim instead of substituting content.* "Same except for Y" is a *structural* statement; it tells you the shape of the comparison, not the substance. If sentence 1 already established Y, then sentence 2's only remaining job is to describe X. Repeating "the only difference is Y" is filler that pretends to be content.
-- *Trusting the surrounding doc to do the work.* The reader of a /plainly explanation may not have read (or remembered) the surrounding section that defines X. The plain version should be self-contained at the bullet/sentence level. If a definition is needed, inline it.
+- *Treating proper nouns as low-cost.* A reader need not know who Fourier was to understand a transformation. Keep a proper noun only where it is load-bearing as a citation the reader might look up.
+- *Placeholder nouns and stacked modifiers.* "methods / techniques / approaches" name a category without naming the operation; three modifiers on one noun ("integrated CIR variance distribution") cannot be parsed in sequence by a new reader.
+- *Precision without bridging.* A short answer using three specialist phrases is *longer* in reading time than a longer answer using none, because the reader has to look each one up. If a phrase compresses several specialist ideas ("exact for a polynomial family"), unpack it inside the explanation or expect the new reader to bounce.
 
-The general principle: **plain English must contain the content the reader needs, not point to it.** A "same as X except Y" construction qualifies as plain English only if X is defined nearby in language the reader already has. If X is itself a piece of doc-internal vocabulary, replace the reference with the definition. The shorthand of "same as X" is a writer's economy, not a reader's, and plain English exists for the reader.
+**Principle:** default plainer than feels necessary; restore precision only where it would otherwise be lost. If a word feels obvious, that is evidence to drop it, not keep it.
 
 ---
 
-## Eleventh worked example: when in doubt, go simpler, the audience is less experienced than the writer thinks
+## 4. Format scaffolding is itself the AI tell
 
-The seventh-through-tenth examples established transliteration discipline for jargon-dense single sentences. The eleventh adds a meta-principle: when the writer thinks "this audience can handle 'Fourier methods' / 'characteristic function' / 'integrated variance distribution'", the writer is overestimating. The /plainly audience is genuinely new to the topic. Specialist proper nouns ("Fourier", "Carr-Madan"), placeholder nouns ("methods", "techniques"), stacked-modifier noun phrases ("integrated CIR variance distribution"), and elaborate phrasings for plain claims ("match shape to negligible practical error") should all default to their plainer equivalents. The cost of going one level too plain is mild (an experienced reader feels patronised); the cost of going one level too jargon-heavy is severe (the new reader bounces off entirely). The asymmetry favours plainer.
-
-> **Source:** "Exact VIX pricing under Heston would require Fourier methods on the integrated CIR variance distribution; the closed-form approximations match shape to negligible practical error and are fast enough for repeated pricing."
+Some sources arrive in the heading-and-bullet format AI defaults to in marketing copy: bold-tag headings, em-dash separators, stacked one-liners, a signpost line, a closing tricolon. The polish must question the *format*, not just refine the words inside it. In human-facing copy, prose almost always does the same job better, and the heading-and-em-dash format is the visual signature of an AI marketing page regardless of how plain the words are.
 
-> **First-pass plain version (still too jargon-heavy):** "Exact VIX pricing under Heston would require Fourier methods applied to the distribution of integrated variance; the closed-form approximations used here match the exact shape to negligible practical error and are fast enough to call repeatedly."
+> **Source:** A consultancy pitch presenting three offerings as `**Bold Heading** — description` blocks, introduced by a signpost line ("Three ways I work with clients:") and closed with a tricolon of three parallel-shape sentences ("I [verb] the [noun].").
 
-> **Polished plain version:** "Exact VIX pricing under Heston would require a transformation of the variance probability distribution but the closed-form approximations we use here instead are close enough in terms of residual error and fast enough that we can call them repeatedly."
+> **Failed polish (kept the format):** Same headings, same em-dash separators, tricolon merged to one sentence with three verbs. Word-level tells were caught; the visual scaffold was preserved, so it still reads as AI marketing copy.
 
-The second-pass mapping (first-pass to polished):
+> **Gold standard (prose):** Three offerings folded into running prose, each opened by a verb the writer would actually say. No bold headings. No em-dashes (the separator becomes a comma, or a hyphen with spaces if needed). The signpost line is deleted. The closing tricolon is removed entirely, not collapsed. Any closing sequence becomes a single conditional invitation: "If you have recognised X and understand Y, then I can help you put Z into practice."
 
-- "Fourier methods" becomes "a transformation": drops the proper noun (*Fourier*); drops the placeholder noun (*methods*); names the actual operation.
-- "applied to the distribution of integrated variance" becomes "of the variance probability distribution": unstacks the modifier chain (drops *integrated* as a load-bearing concept the reader doesn't need at this scope).
-- "match the exact shape to negligible practical error" becomes "are close enough in terms of residual error": collapses the elaborate phrasing into the basic claim (*close enough*).
-- "fast enough to call repeatedly" becomes "fast enough that we can call them repeatedly": slightly more conversational.
-- *Added* "but" / "we use here instead": makes the contrast structure explicit so the reader doesn't have to construct it.
+**Failure modes:**
 
-Two observations worth recording:
+- *Treating the heading-and-em-dash format as a feature of the source rather than a constraint to question.* For three short offerings, prose with conversational lead-verbs reads faster than a heading-bulleted list.
+- *Collapsing a rhetorical tricolon instead of removing it.* If a closing adds no new content, only strong-form repetition, cut it; the reader has read the offerings and does not need a chant of the verbs.
+- *Specific-sounding numbers the writer cannot source.* "a 1-2 year head start", "30% faster" read as authoritative; if you cannot defend the bound, "a limited head start", "noticeably faster" express the same shape without false confidence.
 
-- **Plainness is not shortness.** The first-pass version was 36 words; the polished is 39. The polishing did not compress, it *substituted vocabulary*. Each technical word was downgraded one or two levels of specialism without changing the sentence's length or shape.
-- **The first pass felt plain to the writer because the writer is comfortable with "Fourier methods" and "integrated variance distribution".** That comfort is precisely the problem: the writer's audience-model is calibrated to the writer's own background, not to the new reader's. The fix is a deliberate downward bias on every borderline word.
-
-**Failure modes this avoids, recorded as anti-patterns:**
-
-- *Treating proper nouns as low-cost vocabulary.* "Fourier methods", "Carr-Madan", "Heston-style", "Black-76". The proper noun names a person or paper; the reader does not need to know who Fourier was to understand a transformation. Drop the proper noun and name the operation. Keep it only where it's genuinely load-bearing as a citation.
-- *Using placeholder nouns ("methods", "techniques", "approaches") where the operation can be named.* "Fourier methods" becomes "a transformation". "An approximation method" becomes "an approximation". "A numerical technique" becomes the named technique if you can. The category-name is rarely the level of abstraction the reader actually needs.
-- *Keeping stacked-modifier noun phrases intact.* "Integrated CIR variance distribution" stacks three modifiers on one noun. A new-to-topic reader cannot parse this in sequence. Unstack into a phrase: "the variance probability distribution", "the distribution of variance over time". Each modifier you keep must earn its place.
-- *Elaborate verb-noun phrasing for claims that "close enough" expresses plainly.* "Match shape to negligible practical error", "preserve fidelity within tolerance", "exhibit convergence under the metric": these are fancy ways of saying "are close enough", "match closely", "converge". When the elaborate phrasing doesn't add precision the reader needs at that scope, downgrade.
-- *Leaving the reader to infer rhetorical relationships from punctuation.* The source's semicolon hides an implicit "but"; the second clause is offered *instead of* the first. Plain English makes the contrast explicit with the connective word ("but", "though", "instead").
-- *Calibrating the audience model to the writer's own background.* If "Fourier" feels obvious, that's evidence it should be dropped, not kept. The writer is the wrong baseline. The new reader is a baseline two or three levels below the writer's intuition.
-
-The general principle: **default to plainer than you think necessary; restore precision only when it would otherwise be lost.** Three or four passes through a /plainly answer is normal, and each pass surfaces one more layer of vocabulary the writer was unconsciously treating as plain. The precision-pass at the end of the skill's "Rules" section is not a single check; it is an iterated downward search for the level at which every word lands for the genuinely new reader.
+**Principle:** the AI-tells catalogue applies to format as much as to vocabulary. When the source is in heading-and-bullet format, the precision pass must ask whether prose would do the same job; in human-facing copy the answer is almost always yes.
 
 ---
 
-## Twelfth worked example: format scaffolding is itself the AI tell
-
-The first eleven examples were about word-level and sentence-level AI tells. The twelfth covers a higher-order failure: when the source presents itself in the heading-and-bullet format AI defaults to in marketing copy, the polish must question the format itself, not just refine the prose inside it. Bold-tag headings followed by em-dash separators followed by stacked one-liners read as AI marketing-page output even when every individual word is plain.
+## 5. The shape of natural writing (the positive counterpart)
 
-> **Source:** A consultancy pitch presenting three offerings as `**Bold Heading** — description` blocks, preceded by a signpost line introducing them as a numbered set ("Three ways I work with clients:"), and closed with a tricolon of three short parallel-shape sentences in the form "I [verb] the [noun]."
+The first four examples are subtractive: they remove jargon, notation, and format tells from text that was trying to be a definition. The fifth is additive. The source here is not wrong and has no obvious jargon to strip; it is simply lifeless, technically correct and recognisably machine-made. The job is to make it read like a person wrote it, using the five moves from the "shape of natural writing" section.
 
-> **Failed polish (kept the format intact):** Same headings, same em-dash separators between heading and description, closing tricolon collapsed to one sentence with three verbs. Word-level AI tells were caught; format-level ones were not. The result still reads as AI marketing copy because the visual scaffold is preserved.
+> **User:** /plainly "what is a database index?"
 
-> **Gold-standard polish (prose):** Three offerings folded into running prose, each introduced by a verb the writer would actually say in conversation. No bold headings. No em-dashes (the separator becomes a comma or hyphen-with-spaces if needed). The signpost line is deleted. The closing tricolon is removed entirely, not collapsed. Any closing rhetorical sequence becomes a single conditional invitation to the reader, on the pattern "If you have recognised X and understand Y, then I can help you put Z into practice."
+> **Flat source (the default machine answer):** "A database index is a data structure that improves the speed of data retrieval operations on a database table at the cost of additional writes and storage space to maintain the index data structure. Indexes are used to quickly locate data without having to scan every row in a table each time the table is queried."
 
-**Failure modes this avoids, recorded as anti-patterns:**
+> **Polished:** "Think of the index at the back of a book. Without it, finding every mention of caching means turning all four hundred pages. With it, you read one line and jump straight to page 212. A database index is that back-of-the-book list, kept for a column you search on a lot, so the database can find the rows it wants without reading the whole table. The cost is real. Every time you add a row, the index has to be updated too, and it takes its own space on disk. So you don't index everything. You index the columns you actually look things up by, and let the rest be read the slow way."
 
-- *Treating heading-and-em-dash format as a feature of the source rather than a constraint to question.* In marketing copy aimed at human readers, prose almost always does the same job better. The heading-and-bullet format itself signals "AI marketing page", regardless of the words inside it.
-- *Collapsing a rhetorical tricolon instead of removing it.* The previous example showed the tricolon could be merged into one sentence to satisfy the cadence rule. The gold standard goes further: if a rhetorical close adds no new content, just strong-form repetition, remove it. The reader has read the offerings and does not need a chant of the verbs.
-- *Preserving signposting prose (e.g. "Three ways I work with clients:") after removing the headings it signposted.* Once the format is prose, the signpost is double-bookkeeping.
-- *Keeping em-dashes in the polish even after the rule was already in the catalogue.* This is the writer's instinct for "the strong-break exception" overriding the discipline. The exception has now been removed; the rule is: never an em-dash.
-- *Treating a specific-sounding number as load-bearing precision when the writer cannot actually source it.* Specific numbers ("a 1-2 year head start", "30% faster", "10x cheaper") read as authoritative, but if the writer cannot defend the bound, a plain qualifier ("a limited head start", "noticeably faster", "much cheaper") expresses the same shape without false confidence.
-- *Inserting structure that creates work for the reader without creating value.* Bold headings make the page scannable but force the reader to integrate three separate sections instead of following one flow. For three short offerings, prose with conversational lead-verbs reads faster than a heading-bulleted list.
+Each move did its work: a dropped-in concrete open (the book the reader already pictures), uneven cadence ("The cost is real." between two long sentences), abstractions anchored to things you can see (four hundred pages, page 212, space on disk), one earned turn (the index sounds free, then the write-time cost is the hinge), and a landing close that hands the reader something to do rather than a recap.
 
-The general principle: **the AI-tells catalogue applies to format as much as to vocabulary.** Bold headings followed by em-dash separators followed by parallel one-liners is the visual signature of AI marketing-page output. When the source is in that format, the precision pass must ask whether prose would do the same job, and in human-facing copy the answer is almost always yes.
+**Failure modes:**
 
-Two meta-observations from this case worth recording:
+- *Restating the same claim twice.* The flat source says "improves the speed of data retrieval" then "quickly locate data without scanning every row": one fact, twice, in category language. The book picture carries it once.
+- *Even cadence and no anchor.* Two ~30-word sentences in a row is the machine march; "data structure" is correct and weightless, leaving the reader picturing nothing.
+- *Manufacturing a turn, or closing with a summary.* This concept has one genuine hinge (the write-time cost); do not stack more, and do not end with "In summary, an index trades write cost for read speed."
 
-- **Lenience after a partial fix is the dominant failure mode.** The polish caught most word-level tells, then declared victory. The format itself was an unaudited surface. A strict pass requires asking, at every level (word, sentence, paragraph, format), whether the source's choice was the writer's or AI's default.
-- **Specific carve-outs in the rules become loopholes.** The "strong break" exception for em-dashes was the failure point: the writer's instinct rationalised every em-dash as a strong break. Rules with no exceptions are easier to honor than rules with one defensible exception, because the defensible exception swallows the rule.
+**Principle:** plain English is not only the absence of jargon; it is the presence of a human voice. A correct, jargon-free explanation still fails if it is evenly paced, anchored to nothing, and ends by repeating itself.

package/payload/platform/plugins/admin/skills/platform-architecture/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: platform-architecture
 description: Use when grounding any documented-surface claim about what Maxy ships — plugins, skills, specialists, install/deploy flows, internals. This is the install catalogue, not evidence of what is enabled on the current account. For install state on this account, call `capabilities-here`; for documented surface, cite the `Source:` URL inline.
-content-hash: sha256:0536d599c193b028cf47a9172677b87814e3e7af2e244051ede138fba340a40b
+content-hash: sha256:2002a63079af7332d583e86fd68fe798a5736452310f3412e20b99320194b383
 brand: maxy-code
 product-name: Maxy
 ---
@@ -402,6 +402,7 @@ There is no per-account purchase record; the brand decides the shipping set.
 | `real-agent` | Bundle (13 sub-plugins) | UK estate agency skills — sales, listings, vendor management, buyer management, lead generation, coaching, business operations, teaching, Loop CRM (five value pillars: auto-respond, viewing lifecycle, pipeline mining, listings prospecting, maintenance & preferences), PropertyData market analytics (valuation, sold prices, £/sqft baselines, £/sqft growth, demand-rent, area risk, planning precedent, UPRN matching, property-type distribution), gov.uk EPC floor-area lookup, property brochures, social-share image cards, A4 market reports, and single-address preval packs (full UK address → 4-page A4 PDF covering valuation, area, and demand). 3 specialist roles (negotiator, valuer, compliance) | 4 sub-plugins (estate-sales, buyers, estate-coaching, estate-teaching) |
 | `writer-craft` | Skills + Agent | Manuscript review and writing craft — story architecture, reader engagement, prose craft, editorial practice, and multi-level review | No — writing craft serves the author |
 | `venture-studio` | Skills + Agent | Founding-a-business workflow — office-hours discovery, brand pack, zero-to-prototype validation, and the full investor data room (business plan, prospectus, term sheet, deck blueprint, A4 print pipeline). Pre-seeds a `Project` with one `Task` per artefact so nothing gets forgotten. | No — founder-facing only |
+| `management-consulting` | Skills | 21 MBB-style strategy skills for client engagements — situation assessment, growth-barrier and assumption diagnosis, market mapping, competitive intel, segmentation, profit-pool analysis, strategic options, pricing, business cases, portfolio review, operating-model design, initiative prioritization, transformation roadmaps, war-gaming, risk registers, KPI design, value realization, stakeholder alignment, executive narrative, and decision memos. No MCP server. | No — consultant-facing only |
 
 **How it works:** Every boot Maxy delivers the brand's premium plugins from staging into `platform/plugins/` and stamps `enabledPlugins` against what is actually on disk. No conversation needed — the brand's full set is active from the first turn after install. Updates and reinstalls re-deliver from staging.
 

package/payload/platform/plugins/docs/references/plugins-guide.md

@@ -90,6 +90,7 @@ There is no per-account purchase record; the brand decides the shipping set.
 | `real-agent` | Bundle (13 sub-plugins) | UK estate agency skills — sales, listings, vendor management, buyer management, lead generation, coaching, business operations, teaching, Loop CRM (five value pillars: auto-respond, viewing lifecycle, pipeline mining, listings prospecting, maintenance & preferences), PropertyData market analytics (valuation, sold prices, £/sqft baselines, £/sqft growth, demand-rent, area risk, planning precedent, UPRN matching, property-type distribution), gov.uk EPC floor-area lookup, property brochures, social-share image cards, A4 market reports, and single-address preval packs (full UK address → 4-page A4 PDF covering valuation, area, and demand). 3 specialist roles (negotiator, valuer, compliance) | 4 sub-plugins (estate-sales, buyers, estate-coaching, estate-teaching) |
 | `writer-craft` | Skills + Agent | Manuscript review and writing craft — story architecture, reader engagement, prose craft, editorial practice, and multi-level review | No — writing craft serves the author |
 | `venture-studio` | Skills + Agent | Founding-a-business workflow — office-hours discovery, brand pack, zero-to-prototype validation, and the full investor data room (business plan, prospectus, term sheet, deck blueprint, A4 print pipeline). Pre-seeds a `Project` with one `Task` per artefact so nothing gets forgotten. | No — founder-facing only |
+| `management-consulting` | Skills | 21 MBB-style strategy skills for client engagements — situation assessment, growth-barrier and assumption diagnosis, market mapping, competitive intel, segmentation, profit-pool analysis, strategic options, pricing, business cases, portfolio review, operating-model design, initiative prioritization, transformation roadmaps, war-gaming, risk registers, KPI design, value realization, stakeholder alignment, executive narrative, and decision memos. No MCP server. | No — consultant-facing only |
 
 **How it works:** Every boot {{productName}} delivers the brand's premium plugins from staging into `platform/plugins/` and stamps `enabledPlugins` against what is actually on disk. No conversation needed — the brand's full set is active from the first turn after install. Updates and reinstalls re-deliver from staging.
 

package/payload/platform/templates/agents/admin/IDENTITY.md

@@ -20,7 +20,7 @@ When a request needs a skill and you do not already know its exact slug, resolve
 
 You may not act on a request until you know what is being asked, what is in scope and what is out, and what rules apply. When the operator's words are precise, all three are obvious and you act. When any is imprecise, stop and ask. Insist on the operator being precise and concise.
 
-Your roster of installed specialists is loaded alongside this file as part of your first-turn reconnaissance. The test for any deliverable is whether an installed specialist owns its type, not whether you judge the work short or single-step. A request to author or produce a document, report, marketing or other public-facing copy, or a published page is owned by content-producer when it is installed; dispatch it with the Agent tool and the matching subagent_type, and never write it inline from this seat while content-producer is installed. Other deliverable types route the same way to whichever specialist's dispatch rule names them. Writing or editing files directly from this seat is reserved for work no installed specialist's dispatch rule covers.
+Your roster of installed specialists is loaded alongside this file as part of your first-turn reconnaissance. The test for any deliverable is whether an installed specialist owns its type, not whether you judge the work short or single-step. A request to author or produce a document, report, marketing or other public-facing copy, or a published page is owned by content-producer when it is installed; dispatch it with the Agent tool and the matching subagent_type, and never write it inline from this seat while content-producer is installed. Ownership covers origination, not just the final render. You may not draft the copy here and then hand content-producer only the formatting, the voice pass, or the PDF step; the words themselves originate in the specialist. The brief you hand it states the outcome and the binding constraints, never the finished prose. Other deliverable types route the same way to whichever specialist's dispatch rule names them. Writing or editing files directly from this seat is reserved for work no installed specialist's dispatch rule covers.
 
 The canonical dispatch routes you should reach for first: graph writes (creating or trashing nodes, batch property changes across nodes) go to the specialist that owns graph writes; arbitrary file edits, shell work, and code changes go to coding-assistant or content-producer depending on whether the artifact is code or prose; web research and outside lookups go to research-assistant. The reason is context economy and tool specialization, not platform refusal; the platform stopped blocking these tools from this seat, so the bias has to come from you. A one-line property update against a node already in context, or a single Read against a file you need for routing the next dispatch, are the only in-context exceptions; everything more goes to a specialist.
 
@@ -62,7 +62,7 @@ The skill is the authority for the precision pass. The inline rules above under
 
 ## Writing in the operator's voice
 
-When prose will go out under the operator's name (a document, public-facing copy, anything they will send onward), the operator's voice profile is applied before the first sentence is written, not as a second pass after they object. Run `skill-load skillName=voice-mirror` to retrieve the profile and condition the draft on it. When you author the prose yourself, condition it before you return it; when a specialist authors it, the voice condition is part of the brief you hand them. This is the operator's own authorial voice, used for work written in their name; it is separate from your voice file above, which is how you sound when you speak as yourself.
+When prose will go out under the operator's name (a document, public-facing copy, anything they will send onward), the operator's voice profile is applied before the first sentence is written, not as a second pass after they object. Run `skill-load skillName=voice-mirror` to retrieve the profile and condition the draft on it. When content-producer or another specialist owns the deliverable, the voice condition is part of the brief you hand them, never a draft you pre-write and pass on. Authoring the prose yourself and conditioning it before you return it is reserved for the case no installed specialist owns, the same boundary the dispatch rule above draws. This is the operator's own authorial voice, used for work written in their name; it is separate from your voice file above, which is how you sound when you speak as yourself.
 
 ## Access