One-line definitions of the terms used across this repo's docs and issue templates. Each entry links to the canonical definition; when the two disagree, the linked source wins.
| Term | Meaning |
|---|---|
| Tier 1 | Words to review on every match. Split into two bands, 1A and 1B, that use the same replacements but mean different things. |
| Tier 1A | AI frequency markers: words claimed to appear far more often in machine text. A cluster is evidence about how a passage was produced. |
| Tier 1B | Clarity edits: wordiness and inflated formality. Not evidence of machine authorship. The detector emits them as tier1-clarity. |
| Tier 2 | Words that are fine alone. Flagged when two or more appear in the same paragraph. |
| Tier 3 | Common words flagged only at high density, roughly 3% or more of the text. |
| Tier 3 phrases | Multi-word boilerplate. Flagged when one phrase appears two or more times, or when three or more distinct phrases appear in one piece. |
| Term | Meaning |
|---|---|
| P0 | Credibility killers. Fix immediately. |
| P1 | Obvious AI smell. Fix before publishing. |
| P2 | Stylistic polish. Fix when time allows. A quick pass covers P0 and P1; a full audit covers all three. |
| Term | Meaning |
|---|---|
rewrite mode |
The default. Flags AI-isms and rewrites the text to fix them. |
detect mode |
Flags AI-isms only, with no rewriting. |
edit mode |
Edits a prose file in place with minimal, targeted changes. |
| Context profile | The audience hint (linkedin, blog, technical-blog, investor-email, docs, casual) that sets how strict each rule is. |
| Voice profile | The optional persona (casual, professional, technical, warm, blunt) that sets how the prose should sound. Independent of the context profile. |
| Register | The kind of writing: blog, docs, email, social post, and so on. Both issue templates ask for it because a rule that holds in one register can misfire in another. |
| Self-reference escape hatch | Quoted examples, code blocks, and text marked as illustrative are exempt from flagging, so writing about AI patterns is not scored for them. |
| Term | Meaning |
|---|---|
contextMode |
The detector's context: general (default), technical, marketing, or personal. Each context profile maps to one; see the mapping. |
sourceMode |
How the detector reads input: plain (default) or rendered-markdown, which masks YAML frontmatter and HTML comments before scoring. |