Home Sitemap

v0.1 · 2026-04-30

Precision

Precision is the discipline applied to every word the firm chooses for its referent, fixed system-wide at one value. Exacting precision pairs every numerical claim with its unit and rejects vague quantifiers.

What precision is

Precision is the discipline applied to every word the firm chooses for its referent. The single value the parameter takes is exacting — the precision of a well-edited research publication. Exacting precision requires the noun and verb that fit the observation, every numerical claim carrying its unit, every reference naming its antecedent, and no vague quantifiers. The same precision applies to a memo, a working paper, an alert, and a documentation page without softening.

One value, exacting

The parameter takes exactly one value across the system, and the typed module rejects any other string at parse time. The fixed value carries an invariance: exacting precision applies to every surface, and the validator runs the same closed rule set against each source file. Tone and audience do not relax the value, because neither is a parameter of the voice.

Sub-properties

Precision declares 18 sub-properties in its typed source, grouped along the lexical, numeric, and referential axes the parameter governs. Lexical sub-properties cover verb specificity, noun specificity, and vague quantifiers. Numeric sub-properties cover quantity-and-unit pairing, significant-figure discipline, ranges, and dimensional consistency. Referential sub-properties cover time references, place references, named benchmarks, and actor specificity. The remaining sub-properties carry technical terms, abbreviations on first use, and placeholder language.

Of the 18 sub-properties, 11 are backed by 12 typed rules in the validator. Eleven of those rules run during validation; the parse rule that pairs every numerical claim with its unit remains pending implementation. The other seven sub-properties are specified in Voice-Addendum.md and are not yet backed by typed rules.

Typed rules

The first exhibit below renders the 12 typed rules read directly from @vaquum/voice/parameters/precision. Each row carries the sub-property the rule guards, the rule’s prose description, the mechanism the validator uses, and the declared severity. The 11 implemented rules run against every voice-bearing surface in the repository. The remaining rule — parse mechanism, editorial severity — remains pending implementation.

Mechanisms

Precision carries three mechanisms in its typed rule set, drawn from the closed set of four — regex, dictionary, parse, and editorial — declared at the validator level. Nine rules are dictionaries; the second exhibit below renders the tokens each rule catches, grouped by sub-property and declared severity. Two rules are regex patterns: one rejects tilde approximation in front of a numeral, and the other rejects a hyphen-minus joining two integers in a numeric range. The remaining rule is a parse-mechanism check that pairs every numerical claim with its unit.

How a violation reads

A precision violation in source prose returns a typed report from the validator. The report names the rule that fired with an identifier such as precision.vague-quantifiers, points to the source section in Voice-Addendum.md, and carries the offending text span. Every report attaches one of three severity values drawn from a closed set: fail, flag, or editorial. A fail blocks the build; a flag surfaces in the validator output without blocking; an editorial result waits for review.

Table 1. Precision declares 12 typed rules: 9 dictionary, 2 regex, and 1 parse. The 11 implemented rules emit 6 at fail and 5 at flag; one rule remains pending.
Table column range
Sub-property Description Mechanism Severity
vague-quantifiersvague quantifiers are forbiddendictionaryfail
benchmarksbenchmarks must be named explicitly (VWAP, TWAP, empirical distribution)dictionaryflag
time-referencestime references must be specific; "recently", "soon" are forbiddendictionaryfail
place-referencesplace references must be specific; "elsewhere" is forbiddendictionaryfail
actor-referencesactor references must name a role or entitydictionaryflag
verb-specificityuse a verb that most precisely names the actiondictionaryflag
noun-specificityuse a noun that most precisely names the thingdictionaryflag
placeholder-languageplaceholder language is forbidden in body textdictionaryfail
approximation-markersapproximation markers are permitted only when approximation is substantive; each flagged for reviewdictionaryflag
rangestilde approximation is forbidden; state explicit bounds with en dashregexfail
rangeshyphen-minus in numeric range is forbidden; use en dash (U+2013)regexfail
quantitiesevery numerical claim carries its unitparseeditorial

Source: Voice-Addendum.md § Precision

Table 2. Precision's 9 typed dictionaries declare 55 tokens; 26 tokens emit a fail and 29 tokens emit a flag.
Table column range
Token Sub-property Severity
manyvague-quantifiersfail
severalvague-quantifiersfail
a fewvague-quantifiersfail
a number ofvague-quantifiersfail
mostvague-quantifiersfail
somevague-quantifiersfail
variousvague-quantifiersfail
numerousvague-quantifiersfail
a lot ofvague-quantifiersfail
plenty ofvague-quantifiersfail
the benchmarkbenchmarksflag
the expected rangebenchmarksflag
the standardbenchmarksflag
recentlytime-referencesfail
soontime-referencesfail
shortlytime-referencesfail
a while agotime-referencesfail
not long agotime-referencesfail
the other daytime-referencesfail
latelytime-referencesfail
elsewhereplace-referencesfail
another marketplace-referencesfail
somewhereplace-referencesfail
a different venueplace-referencesfail
someoneactor-referencesflag
peopleactor-referencesflag
folksactor-referencesflag
happenedverb-specificityflag
occurredverb-specificityflag
took placeverb-specificityflag
wentverb-specificityflag
gotverb-specificityflag
didverb-specificityflag
madeverb-specificityflag
ranverb-specificityflag
thingnoun-specificityflag
situationnoun-specificityflag
issuenoun-specificityflag
matternoun-specificityflag
itemnoun-specificityflag
stuffnoun-specificityflag
activitynoun-specificityflag
eventnoun-specificityflag
something likeplaceholder-languagefail
that kind of thingplaceholder-languagefail
or similarplaceholder-languagefail
and so onplaceholder-languagefail
etc.placeholder-languagefail
aboutapproximation-markersflag
roughlyapproximation-markersflag
aroundapproximation-markersflag
approximatelyapproximation-markersflag
circaapproximation-markersflag
give-or-takeapproximation-markersflag
ballparkapproximation-markersflag

Source: @vaquum/voice/dictionaries/precision