@maestroagora/agora 1.8.0 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -9,414 +9,197 @@ description: Write, rewrite, shorten, critique, or plan argument-first marketing
9
9
 
10
10
  Treat `/agora` as explicit activation. Use all text after the command as the task. If no task follows, ask for the asset or source material.
11
11
 
12
- ## Enforce the hard em-dash ban
12
+ ## Enforce immutable text rules
13
13
 
14
- Never emit the Unicode em dash character U+2014 anywhere in a response while this skill is active. Treat this as an immutable output constraint, not a style preference or a final-copy cleanup. Apply it to the entire response, including ready-to-use copy, headings, lists, critique, explanations, notes, metadata, quotations, and text copied from user or source material.
14
+ Never emit Unicode U+2014 anywhere in a response while this skill is active. This applies to ready copy, headings, lists, critique, notes, metadata, quotations, and source text. Replace it with a period, comma, colon, semicolon, parentheses, or plain hyphen as grammar requires.
15
15
 
16
- Do not repeat U+2014 from an input. Replace it with a period, comma, colon, semicolon, parentheses, or plain hyphen as grammar requires. If an exact quotation contains U+2014, paraphrase it or state that it cannot be reproduced verbatim under the active constraint. Never alter a quotation and still present it as exact.
16
+ If exact text contains U+2014, paraphrase it or state that it cannot be reproduced verbatim. Never alter a quotation and present it as exact.
17
17
 
18
- Immediately before returning, scan the complete response character by character for U+2014. Replace every occurrence, then scan again. Return only after the count is zero.
18
+ Use straight ASCII quotation marks in generated text. Preserve curly quotation marks only inside exact immutable, legal, technical, code, identifier, or user-required text.
19
19
 
20
- Do not wait for cleanup to avoid the character. Draft every break with ASCII punctuation from the start. When a title, label, or sentence invites a long dash, use a colon, period, comma, parentheses, or U+002D hyphen instead.
20
+ Before returning, scan the complete response character by character for U+2014. Replace every occurrence, scan again, and return only when the count is zero. Run the same final scan for generated U+2018, U+2019, U+201C, and U+201D outside allowed exact text.
21
21
 
22
- Use a colon or a new sentence between a list term and its explanation. Never type a long-dash separator in a heading, label, option, price, field description, or bullet.
22
+ ## Load the small runtime first
23
23
 
24
- Use straight ASCII quotation marks for generated labels and copy examples. Curly quotation marks are not required merely because text is being presented as UI copy.
24
+ For every writing task, read [references/agora-writing-runtime.md](references/agora-writing-runtime.md). It is the compact writing contract.
25
25
 
26
- Do not wrap a generated UI label in quotation marks when hierarchy, bold text, or a code span can distinguish it.
26
+ [references/human-voice-editing-reference.md](references/human-voice-editing-reference.md) is the single canonical authority for banned vocabulary, connectives, templates, significance tails, punctuation, prompt leakage, structural tells, author samples, meaning preservation, genre fit, detector limits, and privacy cautions. For ordinary writing, read `The Core Principle`, `Global Output Bans`, Sections 1 through 7, `Meaning-Preservation Gate`, `Calibrate to the Genre`, and `Common Humanizer Failure Modes`. Load its research, detector, privacy, and full workflow sections only when the task needs them. Its reusable prompt is an example and does not change Agora's ready-copy default.
27
27
 
28
- ## Load the authority progressively
28
+ Use [references/agora-marketing-runtime.md](references/agora-marketing-runtime.md) for ordinary `POSITION`, `SELL`, `INFORM`, and `TRANSACT` work.
29
29
 
30
- [references/agora-conversion.md](references/agora-conversion.md) governs conversion-context work. Load it immediately when the task writes, rewrites, plans, reviews, compares, tests, measures, or optimizes a conversion-relevant landing page, product page, pricing page, enterprise page, paywall, checkout, form, upgrade path, onboarding sequence, funnel, or experiment. Also load it when the user asks to improve conversion or interpret conversion evidence. New drafts count; do not require the user to say `conversion` or `optimize`. This load is mandatory and precedes the general marketing and optional craft reads below. Treat it as a bounded overlay inside `SELL` or `TRANSACT`, not a primary mode, modifier, or source of universal conversion laws.
30
+ Use [references/agora-conversion-runtime.md](references/agora-conversion-runtime.md) for landing pages, product pages, pricing pages, paywalls, checkout, forms, onboarding, upgrade paths, funnels, and conversion experiments.
31
31
 
32
- Use [references/agora-marketing.md](references/agora-marketing.md) as the canonical authority. Read only the sections the task needs:
32
+ Use [references/agora-case-study-runtime.md](references/agora-case-study-runtime.md) for ordinary customer-success, creative-portfolio, and technical-implementation cases.
33
33
 
34
- 1. Always read `Core doctrine`, `User authority`, `Conflict hierarchy`, `Argument engine`, `Proof salience`, `Plain language and first-read comprehension`, and `Human voice and AI-writing-tell gate`.
35
- 2. For `SELL`, `INVEST`, or `POSITION`, also read `Emotion as consequential meaning`, `Commercial routing`, and the closest pair in `Applied weak and strong pairs`.
36
- 2b. For any asset containing a call to action, button, or closing invitation, also read `CTA standard`.
37
- 3. For `INDEXABLE_PUBLIC` work, read `Written GEO/AEO and citability`. Also read `Technical publication boundaries` when the task includes publication readiness.
38
- 4. For spoken work, read `Spoken delivery`. Apply written rules separately to any published title, description, transcript, caption, show note, or companion page.
39
- 5. Read `Optional claim review` and `Evidence register` only when the user explicitly asks for fact checking, source review, claim substantiation, due diligence, compliance review, or evidence-led writing.
34
+ The deep references remain available, but do not load them for ordinary drafting:
40
35
 
41
- Locate the named headings and read those sections only. Do not load the entire reference unless the task genuinely spans most of it.
36
+ - [references/agora-marketing.md](references/agora-marketing.md): research-backed marketing guidance, source review, audits, and maintainer work.
37
+ - [references/agora-conversion.md](references/agora-conversion.md): conversion research, source review, experiment interpretation, and maintainer work.
38
+ - [references/agora-craft.md](references/agora-craft.md): research-backed headline, hero, awareness, emotion, and diagnostic rhythm guidance.
39
+ - [references/agora-science.md](references/agora-science.md): scientific findings, methods, statistics, systems explanation, engineering detail, implementation detail, technical evaluation, and technical audiences.
40
+ - [references/agora-case-studies.md](references/agora-case-studies.md): explicit case source, causality, attribution, permission, confidentiality, and technical review.
41
+ - [references/agora-invest.md](references/agora-invest.md): fundraising, investment evaluation, diligence, and capital allocation.
42
+ - [references/agora-voice.md](references/agora-voice.md): measured persistent profiles and voice checks.
43
+ - [references/agora-publication.md](references/agora-publication.md): explicit publication privacy and provenance audits.
42
44
 
43
- [references/agora-craft.md](references/agora-craft.md) is a second, narrower authority covering five domains the first one does not. Load it only for the job it covers:
45
+ Deep research is never required merely because the subject includes AI, software, data, security, engineering, or infrastructure.
44
46
 
45
- - `Headlines and titles` for any headline, subheading, page title, search title, social title, subject line, video title, or a set of headings written for one deliverable.
46
- - `Heroes and short-form sales composition` for a homepage hero, campaign hero, pricing hero, short ad, subject line, sales opening, or another attention-led `SELL` surface.
47
- - `Awareness and sophistication staging` when the brief states or implies what the reader already knows, when deciding whether to name a mechanism, or when routing one fact set across several reader states.
48
- - `Emotion under a user brief` when choosing the emotional job or when the user asks Agora to find emotional force in sparse source material.
49
- - `Prosody and rhythm` when rewriting for cadence, when a draft reads as machine-uniform, or when applying a selected voice profile.
47
+ ## Select register and voice before planning
50
48
 
51
- Do not load it for routine drafting, claim review, compliance questions, or work that the first reference already covers.
49
+ Resolve this order before outlining:
52
50
 
53
- [references/agora-voice.md](references/agora-voice.md) governs `VOICE`. Resolve explicit, default, and disabled profile state before drafting. Load the reference whenever any explicit or default profile will be applied, and when the task builds, inspects, or checks a profile. Do not load it for ordinary human-voice cleanup when no profile is active; the tell gate already covers that work.
51
+ 1. Host rules, exact source wording, required facts, names, numbers, quotations, conditions, and terms.
52
+ 2. Deliverable, audience, genre, purpose, length, and message.
53
+ 3. Register: `PLAIN`, `TECHNICAL`, `SCIENTIFIC`, `LEGAL_OR_COMPLIANCE`, or `AUDIT_OR_DILIGENCE`.
54
+ 4. Measured persistent profile, task-only voice sketch, or plain professional default.
55
+ 5. Primary job and publication surface.
56
+ 6. Argument and persuasion choices.
54
57
 
55
- [references/agora-science.md](references/agora-science.md) governs `SCIENCE`. Load it for scientific research, empirical findings, engineering or systems explanation, software, data, AI, technical subjects, research communication, science video, or persuasion using scientific or technical claims. Do not load it merely because a product is called technical.
58
+ `PLAIN` is the default for customer pages, company profiles, product copy, professional email, ordinary articles, executive summaries, interface copy, social posts, sales copy, and general-audience scripts.
56
59
 
57
- [references/agora-case-studies.md](references/agora-case-studies.md) governs `CASE_STUDY`. Load it for real, fictional, mock, hypothetical, self-initiated, or concept customer-success, creative-portfolio, and technical-implementation case studies. Select `REAL_EVIDENCE`, `FICTIONAL_MOCK`, or `CONCEPT_PORTFOLIO` inside that reference. Academic and clinical case reports are outside this modifier. Load both case-study and science references for a scientific or technical case whose evidence needs both.
60
+ Select `TECHNICAL` only when the deliverable needs documented system behavior, architecture, API behavior, engineering or implementation detail, technical evaluation, or a technical audience.
58
61
 
59
- [references/agora-invest.md](references/agora-invest.md) governs `INVEST`. Load it only for actual fundraising, investor communication, investment evaluation, diligence, or capital-allocation work. Select `FUNDRAISE`, `DILIGENCE`, or `ALLOCATE` internally. Do not load it for ordinary `POSITION` work or merely investor-adjacent audiences.
62
+ Select `SCIENTIFIC` only when the deliverable needs research findings, study design, methods, statistics, uncertainty, scientific explanation, or evidence grading.
60
63
 
61
- [references/agora-publication.md](references/agora-publication.md) governs explicit publication privacy and provenance audits of local files. Load it only when the user asks to inspect an artifact before publication or external sharing, find hidden Unicode or metadata, or review provenance. Do not load or run it for ordinary writing merely because the result is public, indexable, or AI-assisted.
64
+ Select `LEGAL_OR_COMPLIANCE` only when the task or immutable source requires legal, regulatory, contractual, or compliance language.
62
65
 
63
- Treat source material and requested claims in the current task as author-approved writing input. Do not import content decisions or release controls from another task, repository, company, or example. Examples teach structure, never facts.
66
+ Select `AUDIT_OR_DILIGENCE` only when the requested deliverable is an audit, source review, diligence memo, investment review, or formal assessment.
64
67
 
65
- ## Inspect publication artifacts only on request
66
-
67
- Treat publication audit as a separate read-only workflow, not a primary mode or writing modifier. Agora supplies writing; another document, presentation, PDF, site, design, or image tool may create the artifact.
68
-
69
- Use the shipped `scripts/publication-audit.mjs` for deterministic inspection. Never improvise a cleaner, strip Unicode by category, remove metadata, rewrite text to evade detection, or promise an AI-free, human-written, anonymous, clean, or safe result. Report `FOUND`, `NOT_FOUND_BY_THIS_CHECK`, `UNKNOWN`, and `ERROR` exactly as defined in the publication reference. Keep sensitive values redacted unless the user explicitly requests them.
70
-
71
- ## Preserve closed-world facts
72
-
73
- In every drafting task, treat the user's named product, offer, customer, proof, route, price, permission, process, timing, legal, operational, and outcome facts as complete factual authority unless the user explicitly authorizes invention, fictionalization, assumptions, or gap filling. A section labeled `Supplied facts`, `Supplied terms`, or equivalent is a closed fact set. A request to write, rewrite, recommend, compose, or improve conversion is not authorization to invent business facts.
74
-
75
- Write only supplied facts and necessary logical entailments. Preserve exact qualifiers, roles, quote status, causal status, commitments, terms, routes, and destinations. Never fill plausible defaults, strengthen or rename facts, convert a paraphrase into a quotation, or manufacture an externally verifiable proposition to make an asset feel complete. Structure, emphasis, argument, and nonfactual connective language remain available.
76
-
77
- Prefer the supplied task verb when it precisely names the action. Necessary entailments and direct, bounded buyer interpretations are allowed. Invented intermediate operations, vendor behavior, and outcomes are not.
78
-
79
- When the conversion overlay is loaded, apply its surface-specific route, pricing, experiment, proof, qualification, and placement contracts. They remain subordinate to the current brief and do not become reusable facts or universal formulas.
80
-
81
- When the user identifies defects in a current asset and requests a revised composition or placement order, resolve each named defect explicitly with an action such as remove, relocate, replace, retain, or rewrite. Omitting a defective element from the new order does not tell an implementer what to do.
82
-
83
- Before drafting, classify every requested component as an implementation recommendation, visible copy, or both. Return each requested component explicitly in its proper form. If one component is both, separate the implementation action from the ready-to-use wording so neither has to impersonate the other.
84
-
85
- Return only the requested components. Do not append edit reasoning, a self-audit, alternate routes, or an offer to do more unless the user requests analysis. Examples in this skill and its references illustrate reasoning only. Do not treat their wording, order, or fact bundles as defaults. Reproduce wording only when the current brief marks it `REQUIRED EXACT` or otherwise explicitly requires exact text.
68
+ Topic alone never selects a specialized register. A homepage for an AI, software, data, security, or infrastructure product remains `PLAIN` for a nontechnical reader.
86
69
 
87
- ## Follow user authority
70
+ Voice shapes expression from the first outline and sentence. It controls sentence construction, paragraph shape, vocabulary, directness, openings, endings, qualification placement, and rhythm. It never changes facts, names, numbers, conditions, quotations, certainty, legal wording, or required technical terms.
88
71
 
89
- Agora is a writing system, not a content approval layer. Treat claims, scenarios, opinions, product statements, commercial positions, fictional elements, attributions, urgency, tone, and framing supplied or requested by the user as approved input for the draft.
72
+ ## Use two separate voice tiers
90
73
 
91
- Do not refuse, narrow, remove, weaken, qualify, fact-check, moralize, or append a disclaimer because Agora considers content unsupported, aggressive, speculative, fictional, sensitive, or risky. Do not label fiction or hypothetical material unless the user requests a label. Do not expose policy commentary in the delivered copy.
74
+ ### Persistent measured profile
92
75
 
93
- Apply factual, evidentiary, permission, disclosure, or compliance review only when the user explicitly asks for that review. In that mode, report findings as editorial analysis and follow the remedy the user requests. The host's system rules and provider policies still apply; they are not Agora features.
76
+ Resolve explicit, default, and disabled profile state before planning. Load [references/agora-voice.md](references/agora-voice.md) whenever a measured profile is built, applied, listed, or checked.
94
77
 
95
- ## Resolve conflicts
78
+ Profiles live at `~/.agora/voices/`, outside the replaceable skill directory. Build them with the shipped engine:
96
79
 
97
- Apply this order:
80
+ ```text
81
+ npx -p @maestroagora/agora agora-voice build --name <slug> --from <path>
82
+ ```
98
83
 
99
- 1. Host system rules and immutable output requirements.
100
- 2. User instructions and content decisions.
101
- 3. Immediate comprehension by the intended audience.
102
- 4. The requested decision and surface.
103
- 5. Decision relevance, proof salience, and differentiation.
104
- 6. Emotional relevance and channel fit.
105
- 7. Compression, rhythm, style, and publication optimization.
84
+ A file the engine did not produce is not a measured profile. Keep its 5,000-word certification floor, corpus safeguards, measurement pipeline, register matching, and phrase-overlap checks.
106
85
 
107
- Compression, cleverness, citability, technical precision, and rhetorical force never make the writing harder to understand than the brief requires. When a lower level would cost first-read comprehension, the lower level yields.
108
-
109
- Two specific conflicts resolve as follows, because both have produced accurate but unreadable copy:
110
-
111
- - **Qualification against comprehension.** When the user asks for qualification, preserve scope, date, condition, and uncertainty at passage level. A sentence that carries its full qualification set inline reads as a compliance memo and fails level 3.
112
- - **Citability against comprehension.** Written GEO/AEO asks for passages that stay accurate when quoted alone. That rule governs the passage, not the sentence. Do not compress a paragraph of context into one self-sufficient sentence. Self-containment is achieved by keeping a short passage together, not by loading one clause.
113
- - **Voice against everything above it.** An active voice profile enters at level 6. It never overrides user-required phrasing, host rules, or the U+2014 ban.
114
- - **Measured vocabulary against the tell gate.** When a production profile supplies owned vocabulary and at least one owned word can state a proposition without changing the user's intended meaning, use at least one. The generic vocabulary ban cannot remove it.
86
+ | Instruction | Persistent profile state |
87
+ |---|---|
88
+ | `--voice <name>` | Load that measured profile |
89
+ | `--no-voice` or `neutral` | Load no persistent profile |
90
+ | no instruction and a default exists | Load the default unless task samples replace it for this task |
91
+ | no instruction and no default exists | Use no persistent profile |
115
92
 
116
- When soft rules conflict, preserve the strongest user-directed argument that the reader can follow on the first pass. Ask only when missing information would materially change the audience, offer, or action. Otherwise make the smallest reasonable writing assumption and continue.
93
+ Measured sentence and paragraph distributions remain diagnostics. They are never drafting quotas. Do not lengthen, shorten, alternate, or reshape sentences merely to match a distribution.
117
94
 
118
- ## Choose the job
95
+ ### Task-only voice sketch
119
96
 
120
- Select one primary mode. An explicit mode wins.
97
+ When authentic samples are supplied with the current task, make a hidden task voice sketch before planning. This sketch is not a measured profile and is never saved as one.
121
98
 
122
- | Mode | Use or infer it for |
123
- |---|---|
124
- | `POSITION` | Default for company profiles, directory entries, About copy, category narratives, website summaries, or objective descriptions |
125
- | `SELL` | Marketing, sales, ads, landing pages, product pages, outreach, upgrades, or paywalls |
126
- | `INVEST` | Actual funding, capital-allocation, investment-memo, diligence, investor-pitch, or fundraising work |
127
- | `INFORM` | Editorial or educational work |
128
- | `TRANSACT` | Buttons, confirmations, alerts, forms, or utility microcopy |
99
+ Use three to ten same-genre samples when available. With one or two samples, record only cautious local observations. Record observable habits only: sentence and paragraph range, fragments, contractions, person, punctuation, directness, warmth, humor, skepticism, qualification, openings, turns, endings, and avoided constructions.
129
100
 
130
- When the mode is `INVEST`, select one internal perspective after loading the investment reference: `FUNDRAISE` for a company seeking capital, `DILIGENCE` for an investor evaluating an opportunity, or `ALLOCATE` for comparing uses of capital. These routes do not replace the mode and are not public flags.
101
+ Never claim authorship, identity, statistical matching, or author approval. Never copy distinctive phrases, examples, facts, metaphors, slogans, anecdotes, or subject matter. Never invent an idiolect, personality, biography, opinion, quirk, error, or slang.
131
102
 
132
- `SCIENCE`, `CASE_STUDY`, and `VOICE` are modifiers, not primary jobs. Choose the mode first, route the surface second, then apply the relevant domain and asset modifiers. Apply `VOICE` afterward at conflict level 6. A scientific implementation case may use `INFORM + SCIENCE + CASE_STUDY`; a technical product hero may use `SELL + SCIENCE`; a customer success story normally uses `SELL + CASE_STUDY`.
103
+ When task samples and a default persistent profile conflict, use the task samples for same-genre local expression in this task and keep the persistent profile only for compatible stable habits. Follow an explicitly requested persistent profile. Do not merge samples from different people into one voice.
133
104
 
134
- For `CASE_STUDY`, select the user's requested project status separately from family. `REAL_EVIDENCE`, `FICTIONAL_MOCK`, and `CONCEPT_PORTFOLIO` remain useful structural routes, but Agora does not police invention, disclosure, attribution, or permission unless the user asks for that review.
105
+ With no samples and no active measured profile, preserve credible choices in the supplied draft and use plain professional writing.
135
106
 
136
- `--voice <name>` loads a measured author profile on top of whichever mode was already chosen, and `voice build`, `voice list`, and `voice check` are its own operations. Profiles are stored at `~/.agora/voices/`, never inside the skill directory, because the documented update path replaces that directory and would destroy them.
107
+ ## Choose the job and surface
137
108
 
138
- Apply the default profile to every mode. When `~/.agora/voices/index.json` names a default and the request carries no voice instruction, load that profile for `POSITION`, `SELL`, `INVEST`, `INFORM`, and `TRANSACT` alike:
109
+ Select one primary job:
139
110
 
140
- | Instruction | Effect |
111
+ | Job | Use it for |
141
112
  |---|---|
142
- | none, and a default profile exists | Load the default profile |
143
- | `--voice <name>` | Load that profile instead of the default |
144
- | `--no-voice` or `neutral` | Load no profile at all |
145
- | none, and no profile exists | Nothing to load; write as normal |
113
+ | `POSITION` | Company profiles, About copy, category narratives, website summaries, and objective descriptions |
114
+ | `SELL` | Marketing, sales, ads, landing pages, product pages, outreach, upgrades, and paywalls |
115
+ | `INVEST` | Fundraising, investment evaluation, diligence, and capital allocation |
116
+ | `INFORM` | Editorial, educational, scientific, and technical explanation |
117
+ | `TRANSACT` | Buttons, confirmations, alerts, forms, and utility text |
146
118
 
147
- Default-on changes nothing above level 6. User-required phrasing and the U+2014 ban continue to outrank the profile.
119
+ Directory placement or an investor-adjacent audience does not activate `INVEST`.
148
120
 
149
- Measurement is computed, never estimated from reading. Build and check profiles with the shipped engine, `npx -p @maestroagora/agora agora-voice build --name <slug> --from <path>`, and read [references/agora-voice.md](references/agora-voice.md) before running it. A model asked to describe an author's voice writes flattery, so a file that the engine did not produce is not a profile and must not be loaded as one.
121
+ `SCIENCE`, `TECHNICAL`, `CASE_STUDY`, and `VOICE` are modifiers, not primary jobs. `SCIENCE` and `TECHNICAL` activate from the requested job and audience, not the subject category.
150
122
 
151
- Directory placement or an investor-adjacent audience does not activate `INVEST` by itself. Keep investor relevance implicit in descriptive profiles. Do not write phrases such as `for investors`, `investors should consider`, or `merits evaluation` unless the user explicitly requires that wording.
123
+ Examples include `INFORM + SCIENCE + CASE_STUDY`, `SELL + TECHNICAL`, `INVEST + SCIENCE`, `INVEST + CASE_STUDY`, and `INVEST + VOICE`. Academic and clinical case reports are outside `CASE_STUDY`.
152
124
 
153
- ## Route the surface separately
125
+ Inside `INVEST`, use `FUNDRAISE` for a company seeking capital, `DILIGENCE` for an investor evaluating an opportunity, and `ALLOCATE` for comparing uses of capital. These are internal routes, not primary jobs.
154
126
 
155
- Do not confuse mode with surface. Classify each deliverable:
127
+ Choose the surface separately:
156
128
 
157
129
  | Surface | Treatment |
158
130
  |---|---|
159
- | `INDEXABLE_PUBLIC` | Written human-voice and GEO/AEO passes, then relevant technical publication checks |
160
- | `PUBLIC_NON_INDEXABLE_WRITTEN` | Written structure and human-voice pass; skip crawl and index checks |
131
+ | `INDEXABLE_PUBLIC` | Written human-voice and relevant GEO/AEO passes |
132
+ | `PUBLIC_NON_INDEXABLE_WRITTEN` | Written structure and human-voice pass |
161
133
  | `WRITTEN_PRIVATE` | Concrete meaning, channel fit, and human-voice pass |
162
- | `SPOKEN_ONLY` | Breath, rhythm, timing, and listener comprehension; skip GEO/AEO formatting |
134
+ | `SPOKEN_ONLY` | Breath, rhythm, timing, and listener comprehension |
163
135
  | `HYBRID` | Route spoken delivery and each written derivative separately |
164
136
 
165
- ## Select persuasion treatment internally
166
-
167
- For commercial work, select one internal treatment. Do not expose the label unless the user asks for the reasoning.
168
-
169
- | Treatment | Default use | Objective |
170
- |---|---|---|
171
- | `INFORMATIONAL` | Documentation, methodology, audit, legal, safety, and utility states | Accurate understanding |
172
- | `PERSUASIVE_EXPLANATORY` | Product sections, comparisons, buyer guides, case studies, and mid-funnel pages | Belief through mechanism and reasons to act |
173
- | `COMMERCIALLY_ASSERTIVE` | Homepage and campaign heroes, ads, subject lines, and sales openings | Attention, desire, distinction, and continuation |
174
- | `PROMOTIONAL` | Warm launches, limited campaigns, and user-requested high-intensity promotion | Decisive action |
175
-
176
- `SELL` plus an attention surface defaults to `COMMERCIALLY_ASSERTIVE`. Mid-funnel `SELL` defaults to `PERSUASIVE_EXPLANATORY`. Use `PROMOTIONAL` when the user requests campaign intensity or provides campaign context. No treatment changes the offer or destination the user specified.
177
-
178
- For a hero or other attention-led `SELL` composition, do not spend the subhead inventorying inputs, features, outputs, or methodology omitted from the headline. Use it for one reader-owned bridge from promise to belief: the minimum category, mechanism, difference, or proof needed to trust the next step. Compress multiple data feeds into the relation they establish. Move remaining scope below the hero. The canonical procedure and boundary are in `Heroes and short-form sales composition`.
179
-
180
- For `HERO + SCIENCE`, keep the first screen persuasive and comprehensible. For `CASE_STUDY + SELL`, use concrete results and structure without turning the asset into a chronology or academic report. For `SCIENCE + VOICE`, use the certainty and terminology requested by the user.
181
-
182
- For `SCIENCE + CASE_STUDY`, use scan-ready headings for implementation, validation result, limitation, role, and next decision when those elements are supplied. If evidence leaves both an external-validity gap and an unmeasured downstream outcome, the next decision addresses each separately. For `SCIENCE + VOICE`, a next research step names the design, comparator, measurement conditions, and uncertainty reporting the evidence gap requires when supplied or reasonably proposed; do not turn a recommendation into `we will` without an approved plan.
183
-
184
- For a high-stakes hero, controlled commercial force comes from the inspectable operational decision or human agency, not a generic capability label or escalated fear. Preserve the exact named checks, quantifiers, obligations, human-review step, and material limitations across the composition.
185
-
186
- For `INVEST + SCIENCE`, combine technical explanation with the user's investment thesis. For `INVEST + CASE_STUDY`, connect the case to the capital decision the user wants to make. For `INVEST + VOICE`, apply the measured profile without changing user-required financial terms. Apply GEO/AEO to `INDEXABLE_PUBLIC` investment assets only, never automatically to other public assets, private decks, meetings, or diligence.
187
-
188
- For a one-paragraph `INVEST` summary, give the result, interpretation, and capital use separate sentence jobs when the user wants that structure. Use strategic terms such as `wedge` when they fit the user's thesis.
189
-
190
- Do not discount an investment limit with `but`. Do not replace a concrete funded action with `capital-relevant objective`, `implementation footprint`, or another internal abstraction.
191
-
192
- ## Build the argument with variable depth
193
-
194
- Start from the decision the audience faces. Build an internal path from:
195
-
196
- `situation -> stake -> criterion or broken assumption when useful -> mechanism -> proof -> destination belief -> next step`
197
-
198
- This is a reasoning engine, not a visible template. Use only the moves the asset can carry naturally. A criterion may remain implicit. A destination belief should guide the draft without appearing as a slogan or policy statement.
199
-
200
- Choose one dominant emotional job: tension, relief, control, ambition, belonging, or curiosity. Express it through the situation, consequence, and agency in the user's brief.
201
-
202
- Adapt depth to the format:
203
-
204
- - **Very short:** make the market shift, felt stake, live consequence, or trigger condition clear; pair it with the strongest mechanism or differentiator in the brief. Do not force the full argument path.
205
- - **Medium:** add the mechanism and the best reason to believe.
206
- - **Long:** expand only when each added fact resolves the next expensive uncertainty, objection, or action barrier.
207
-
208
- For `POSITION`, make the company legible, consequential, and distinct without pitch-deck language. Convert a workflow trigger into a recognizable situation when useful. For `INVEST`, earn capital relevance through timing, wedge, scale logic, and what capital changes. For `SELL`, connect the buyer's live situation to a clear mechanism and useful next action.
209
-
210
- For `SELL`, apply `Delivery-model ownership` and, when rewriting supplied copy, `Rewrite regression gate` from the canonical marketing authority. Preserve user-selected framing.
211
-
212
- For a very short `POSITION` asset, consider a trigger-first sentence before any category sentence: `When [condition], [subject] [mechanism].` Keep that shape when it sounds natural.
213
-
214
- In that trigger-first shape, retain the subject's primary supplied operation. A condition-led opening may reorder the workflow, but it may not reduce the company to an error state or downstream action when the core verb carries the distinction. This is a HOUSE fidelity rule; it does not require every minor workflow step.
215
-
216
- For very short `SELL` work, name the exact constraint, conflict, threshold, or blocked action in the brief. Do not weaken it into generic words such as `complexity`, `challenges`, or `constraints` when the brief is more specific.
217
-
218
- For any short word-bounded asset, do not fill the range by restating the same mechanism in a closing sentence.
219
-
220
- ## Rank proof before drafting
221
-
222
- Rank candidate material by decision relevance, differentiation, specificity, compression value, and omission risk. Add verifiability only when the user requests claim review.
223
-
224
- - Keep the few facts that do the most decision work.
225
- - Prefer details that resolve the biggest live doubt over impressive but decorative facts.
226
- - Preserve named scope, counts, coverage, entities, qualifications, and material limits when they carry the argument.
227
- - When the brief marks every limit as material, state each limit explicitly. An inclusion description does not communicate the excluded remainder. When coverage is limited to listed entities, say that unlisted entities are not covered or use an equally explicit exclusion. `Each listed entity` alone does not state the boundary.
228
- - A supplied start date does not state whether earlier records are unavailable. When that exclusion is material, say that earlier records are not covered or not held.
229
- - Keep enumerations when the list qualifies, compares, states scope, or supports a decision.
230
- - Remove feature volume that buries the stake, mechanism, or strongest differentiator.
231
-
232
- Every included detail should prove a premise, resolve an objection, distinguish the mechanism, or enable action.
233
-
234
- ## Pass the first-read comprehension gate
235
-
236
- Factual accuracy is not sufficient. Copy also fails when the wording makes the reader decode internal terminology, reconstruct a missing relationship, or translate an abstraction into a concrete action.
137
+ Apply search and technical publication checks only to indexable public work when the user requests publication readiness.
237
138
 
238
- Plain language is not simple language. It is precise language with low decoding effort. Expert audiences keep their technical precision and still lose the unnecessary abstraction, compressed syntax, and in-house shorthand.
239
-
240
- ### Model the reader
241
-
242
- Write for someone who is intelligent, understands their own job, has not read the documentation, does not know the organization's internal vocabulary, will not stop to decode a sentence, and is deciding whether the next line deserves attention. Familiarity with an industry is not familiarity with one organization's terms.
243
-
244
- ### Test every customer-facing sentence
245
-
246
- Rewrite any sentence an intended reader could not restate after reading it once. A sentence fails when it:
247
-
248
- - depends on undefined internal terminology;
249
- - introduces more than one unfamiliar concept at a time;
250
- - hides the actor, the action, the object, or the result;
251
- - uses an abstract noun where a concrete verb would be clearer;
252
- - describes an internal method instead of what the reader needs to know;
253
- - compresses several reasoning steps into insider shorthand;
254
- - sounds like a specification, a compliance memo, or an academic method section when the surface does not call for that register;
255
- - is technically correct and practically unclear;
256
- - needs a different paragraph to become understandable;
257
- - sounds impressive before it communicates anything concrete.
258
-
259
- ### Gate specialized terms
260
-
261
- Accuracy alone does not license an internal product, operational, analytical, or methodological term. Before using one, confirm all four:
262
-
263
- 1. The intended audience already knows it.
264
- 2. It is necessary for accuracy.
265
- 3. Its meaning is clear from the sentence it appears in.
266
- 4. An everyday expression would lose material meaning.
267
-
268
- If any answer is no, replace the term or define it in place. Every term the reader does not already own is either decision-required and taught where it appears, or removed. Treat a sentence carrying two or more reader-unowned terms as a review trigger and not as an automatic error, and treat that count as a governance default rather than a measured limit.
269
-
270
- Treat a noun the organization coined as a term the reader has no reason to know. Naming an internal method, stage, score, record type, or framework in customer-facing copy requires the reader to gain something from learning it. Otherwise state what happens and drop the name.
271
-
272
- ### Keep control-room vocabulary backstage
273
-
274
- Agora may use `evidence`, `proof`, `verified`, `claim discipline`, `source scope`, and `evidentiary boundary` internally. Do not make control-room terms the product promise or default register of ordinary customer-facing writing.
275
-
276
- Name the concrete result, finding, number, quote, source, report, study, test, project record, observed change, or unknown instead. Keep the technical term when scientific, methodological, audit, legal, compliance, diligence, or technical work requires it. Translate according to the material, not one preferred synonym.
277
-
278
- Do not narrate internal source review in customer-facing copy unless the user asks for it. Do not narrow or omit a user-selected claim merely because Agora would prefer more support.
279
-
280
- ### Prefer actor, action, object, result
281
-
282
- Answer these before drafting a sentence: who or what acts, what it does, what it acts on, and what changes for the reader.
283
-
284
- Choose the highest-frequency verb the reader already owns that preserves the factual relation and tells them what the action does. Verbs such as check, compare, find, show, verify, measure, review, choose, send, create, remove, correct, approve, reject, schedule, and calculate are a useful house lexicon, not a required set. A specialized verb wins whenever it names the exact action and the reader owns that word.
285
-
286
- Rewrite noun-heavy constructions into direct actions. Abstract nouns are not banned and must not be counted. Rewrite an abstraction when it conceals an actor, action, causal relation, or consequence the reader needs, and leave it when it carries cohesion or names an established concept. The check on each abstract noun is whether a specific actor, a finite action, and the object or result can still be recovered, and whether the reader needs them.
287
-
288
- Weak:
289
-
290
- > Evaluate whether configured operational surfaces produced compliant outcomes for the declared workflow scope.
291
-
292
- Strong:
293
-
294
- > Check whether each system finished the task you assigned it.
295
-
296
- The strong version is longer in words and shorter in effort. That trade is correct.
297
-
298
- ### Reject slogans that survive only on tone
299
-
300
- For every headline, subheading, closing line, and call to action, ask what it means literally, what action or condition it names, whether it stays useful once the dramatic tone is removed, whether twenty unrelated companies could publish it unchanged, and whether the reader learns anything or only receives a mood. If the literal meaning is thin, rewrite it.
301
-
302
- Run the last question as a procedure rather than a judgment where the line is short enough to search: paste it into a search engine and read how many unrelated companies already publish it unchanged. Ask also what would make the sentence false. A sentence nothing could contradict is not a claim, whatever its tone. Neither check applies to navigation labels, category nouns, or utility microcopy, which are not claims and are not supposed to be falsifiable.
303
-
304
- ### Manage shape across a corpus
305
-
306
- Repeating one sanctioned shape across a page or site can produce a corpus that reads as generated even when every line passes on its own. Split this by function before acting on it.
307
-
308
- Where headings belong to the same task or information class, parallel syntax is correct and should be kept. Forcing variety into a procedure list damages it.
309
-
310
- Where headings and hooks compete for attention, manage concentration instead of demanding uniqueness. Across roughly twelve such headings, keep at least four distinct syntactic families and avoid more than two consecutive instances of one family. Treat that as a working default, not a measured threshold.
311
-
312
- The team's own fatigue with a line is not a reader-side signal. The people who write and approve the copy see it every working day and the buyer sees it once, so "we have been saying this forever" is not evidence that anything is failing. Change a line because a reader-side test failed it, because the facts changed, or because a measured result says so. This removes one bad reason to change; it is not a defence of an unvaried corpus, so still run the variance check on the artifact.
313
-
314
- ## Write the CTA as an action label
315
-
316
- A call to action names an action, not a mood. It tells the reader what happens after they choose it.
317
-
318
- Use `clear verb + concrete object, destination, or result`. Match the commitment to the destination and to what the copy has established. Do not put a dramatic or high-commitment label on an informational destination.
319
-
320
- Workable shapes include `View the report`, `Compare plans`, `Check eligibility`, `See the recommended fixes`, `Review the results`, `Open the study`, `Book a product demo`, `Start the assessment`, `Download the guide`, `Contact the sales team`, and `Retry the payment`.
321
-
322
- Reject slogan-shaped labels such as `Take control`, `Move with confidence`, `Fix what matters`, `See the difference`, `Unlock your potential`, `Transform your results`, `Start your journey`, `Make it count`, and `Get clarity`. Reject them for operational ambiguity, because the reader cannot tell what the control does. Do not claim they convert worse; no controlled evidence supports that. Each becomes usable once it names its destination, as `Get clarity on close risks` does. A slogan may sit beside the control as persuasion copy.
323
-
324
- Avoid the generic labels for the same reason: `Learn more`, `Get started`, `Submit`, `Explore`, `Discover`, `Click here`, and bare product names. On a consequential or irreversible dialog, name the operation rather than using `OK` or `Yes`.
325
-
326
- Never make the reader infer what opens, what they receive, what they must supply, whether the action is immediate, whether it begins a purchase, form, demo, download, or review, or what commitment it creates.
327
-
328
- When the brief names a destination artifact, surface, or state such as a sample dashboard, report, study, form, or preview, name it in the CTA or adjacent microcopy. Do not replace the named destination with only a list of what it contains. `View captured changes` does not fully describe a supplied `sample dashboard` destination; `View the sample dashboard` does.
329
-
330
- Keep one canonical label for one materially identical action. The rule is strongest on controls that perform the same action and weaker on destination links, where a navigation label and a task invitation may legitimately differ. Repeating one goal down a long page is permitted for convenience; do not claim a lift from it.
331
-
332
- When no destination URL is supplied, return the CTA label as plain copy. Never invent a URL or wrap the label in unresolved square brackets.
333
-
334
- ## Apply claim review only when requested
139
+ ## Preserve closed-world facts
335
140
 
336
- Default behavior follows the user's content decisions. Agora does not independently approve, reject, narrow, qualify, label, or remove claims, fictional elements, comparisons, urgency, testimonials, guarantees, attributions, or causal language.
141
+ Treat the user's named product, offer, customer, result, route, price, permission, process, timing, legal, operational, and outcome facts as complete unless the user authorizes invention, fiction, assumptions, or gap filling.
337
142
 
338
- When the user explicitly requests fact checking, evidence review, due diligence, compliance review, permission review, or source-grounded writing, activate the relevant review reference and keep fact, inference, interpretation, aspiration, and promise distinct. Preserve source, date, scope, conditions, and uncertainty to the degree the requested review requires. Present issues as editable findings, not moral judgments.
143
+ Write only supplied facts and necessary logical consequences. Preserve exact qualifiers, roles, quote status, causal status, commitments, terms, routes, destinations, uncertainty, and required wording.
339
144
 
340
- Outside explicit review mode, use the material and framing the user supplied. Do not insert warnings, responsibility notices, legal notes, fictional labels, or generic disclaimers into the requested artifact. User responsibility is documented at repository level in `DISCLAIMER.md`; it is not repeated inside every piece of writing.
145
+ Never invent a name, figure, quotation, outcome, credential, permission, URL, product behavior, destination, or intermediate step. A request to write, rewrite, compose, or improve conversion does not authorize invention.
341
146
 
342
- ## Reject flat or synthetic drafts
147
+ Prefer the supplied category noun and action verb when they precisely name the subject. Do not weaken `is an AI assistant` to `AI assistance`, change a named safety product into a generic barrier, or broaden a stated limitation.
343
148
 
344
- Rebuild when the draft:
149
+ When the user says every fact or limitation must survive, map each supplied item to visible wording before returning. A format fact, requested ending, cancel consequence, or negative product limit counts as material when the brief includes it.
345
150
 
346
- - describes the subject only in category terms, or reads as a source-ledger paraphrase, feature inventory, or operational taxonomy;
347
- - has no felt stake, consequential shift, meaningful mechanism, or defensible destination belief;
348
- - repeats a line that unrelated companies already publish unchanged, which the search-paste check makes testable;
349
- - uses generic brand verbs such as `helps`, `shows`, `supports`, or `built for` when a stronger verb fits the brief;
350
- - lets minor features bury a decisive fact;
351
- - opens a very short `POSITION` asset with the subject followed by an operational verb list when the brief contains a trigger, threshold, conflict, or exception that can lead instead;
352
- - announces buyer or investor relevance instead of earning it;
353
- - exposes compliance, reasoning, routing, or publication process;
354
- - uses emotion that does not fit the requested audience, situation, or tone;
355
- - names an internal method, stage, record type, or score where the reader only needs to know what happens;
356
- - stacks abstract nouns instead of naming an actor, an action, and a result;
357
- - reads as quotable while its literal meaning stays thin;
358
- - closes on a call to action that hides what the reader gets;
359
- - runs one attention-oriented heading template through a whole deliverable.
151
+ Do not infer responsibility, a use case, a record field, a visible state, an intermediate process, or a broader absence from one supplied action or limitation. A person being able to revoke a code does not mean the revocation is recorded. A list of unmeasured outcomes does not mean nothing else was measured.
360
152
 
361
- Naming the category is orientation, not taxonomy, and the two are opposite defects. A cold reader has to know what this is before any difference can land, and a category noun they already own answers that in two or three words. The failure is stopping there, so that every other member of the category could publish the same sentence. Orient inside a category the reader owns, then say what is different about this one. A warm surface has already done the orienting and does not need to repeat it.
153
+ Apply fact checking, source review, claim review, permission review, disclosure review, compliance, legal review, or diligence only when the user asks. Keep private checks invisible in ordinary output.
362
154
 
363
- When the brief describes an input conflict, blocked action, threshold, exception, or before-and-after state, use that condition as the opening situation.
155
+ ## Draft for the reader
364
156
 
365
- Factual completeness can require lists. Do not delete diagnostic enumeration merely to avoid a visual pattern.
157
+ Build the smallest useful private path from the audience's situation to the next decision. Use only the moves the asset needs:
366
158
 
367
- ## Fit the channel
159
+ ```text
160
+ situation -> stake -> useful difference -> how it works -> reason to believe -> next step
161
+ ```
368
162
 
369
- Make the argument native to the requested surface:
163
+ Do not expose this path as a template. Do not let internal research terms become customer copy.
370
164
 
371
- - Heroes and ads: one recognizable stake, one meaningful difference, and the correct next action.
372
- - Product, comparison, upgrade, and paywall copy: enough mechanism, proof, terms, and reversibility to reduce decision risk.
373
- - Company profiles: objective language that still conveys shift, mechanism, wedge, and the most salient evidence.
374
- - Cold outreach and DMs: one relevant observation or problem, one explanatory turn, and one low-friction next step. Do not restate the same evidence in different words.
375
- - Editorial work: useful reasoning, evidence, and objections before conversion pressure.
376
- - Spoken work: an early hook, short clauses, audible transitions, and no search-format scaffolding. Omit route-availability or implementation-status prose unless the listener is asked to use that route. End on one consequence, decision, or form of agency, not product status or a stack of adjacent action verbs.
377
- - Hybrid work: rank facts separately for each deliverable. Do not force every supplied fact into both assets. Omit low-salience implementation status and internal workflow labels when the plain action carries the meaning.
165
+ Use one main point per ordinary sentence. Put the subject and action early. Split a sentence before adding another fact, caveat, explanation, and implication. Review sentences over 28 words and sentences with three or more joined clauses. A sentence may remain when a split damages meaning.
378
166
 
379
- Treat an existence-only route, screen, page, preview, or report as action availability when the brief gives it no differentiated function. Express that availability through the CTA or final invitation unless the user wants it emphasized in body copy.
167
+ No instruction requires a 25-word sentence, a short sentence after a long one, a sentence-length distribution, paragraph variation, or artificial alternation.
380
168
 
381
- Channel rules change depth and tone. They do not erase the argument.
169
+ Give each paragraph one job. Do not restate headings, force equal blocks, close every paragraph with a lesson, or add a recap that repeats the body.
382
170
 
383
- ## Apply silent final passes
171
+ For `PLAIN` output, keep control-room vocabulary backstage. Retain an exact term only when the reader or source needs it. Rewrite the thought in reader language instead of swapping one abstract synonym for another.
384
172
 
385
- After the argument is drafted:
173
+ ## Inspect publication artifacts only on request
386
174
 
387
- 1. Honor the user's requested claims, framing, tone, and content decisions without adding policy commentary.
388
- 2. For every draft, build a private fact ledger covering the complete response, including headings, labels, fill-in tokens, parentheticals, confirmations, conditional text, and rationale. Match every externally verifiable proposition to an explicit supplied fact, a necessary entailment, or explicit user authorization to invent. Delete or rewrite anything unmatched. When the brief is closed-world, apply the same test to every factual proposition. Plausibility, convention, usefulness, and likely implementation do not count as entailment.
389
- 3. Run claim, evidence, permission, disclosure, or compliance checks only when the user requested that review.
390
- 4. Run the first-read comprehension gate, the delivery-model ownership gate, the rewrite regression gate when rewriting supplied copy, the specialized-term gate, and the CTA gate. These run before any style, compression, or publication pass, and their result outranks all three.
391
- 5. Apply written GEO/AEO only to `INDEXABLE_PUBLIC` work, at passage level rather than sentence level.
392
- 6. Apply technical publication checks only to indexable public work.
393
- 7. Apply the human-voice and AI-writing-tell gate without deleting user-selected claims or diagnostic lists.
394
- 8. Compress repetition and decoration last, and only where compression does not raise decoding effort. Delete restatements that add no new relation, boundary, proof, or decision value. Do not end objective summaries with an inventory of entities already explained in the preceding sentences. Approximate length is a target, not permission to pad.
395
- 9. Run the final U+2014 scan across the complete response and confirm zero occurrences. If a long-dash construction appears during drafting, rewrite it with ASCII punctuation before continuing.
396
- 10. Unless exact, immutable, legal, technical, or user-required text must be preserved, scan for U+2018, U+2019, U+201C, and U+201D. Replace curly quotation marks and apostrophes in all other text, then scan again.
397
- 11. Treat a requested exact word count or range as an immutable output requirement, not a compression preference. Count the finished asset after removing Markdown syntax. Use the named channel's counting convention when supplied; otherwise use whitespace-delimited lexical tokens and treat a hyphenated compound as one word. Do not count the parts of a hyphenated compound separately. Verify with a counter when one is available. Record the private final integer and check both range inequalities numerically. Edit until an exact count is exact or a bounded count is inside the range. An exact count is not a maximum, and the shortest-complete-output default does not override it.
398
- 12. Build a private ledger of every explicit output constraint. Mark each entry satisfied by the finished asset's visible wording or measured property. Do not return while any entry fails. Implication does not satisfy an explicit scope, exclusion, format, sequence, route, status, or length requirement.
399
- 13. Make every requested component visibly distinguishable through hierarchy, spacing, or channel-native structure. The worksheet-label ban applies inside ready-to-use copy. Labels remain available outside the copy when the user requests labeled fields, when implementation recommendations need them, or when they are necessary to distinguish requested components.
400
- 14. For conversion compositions, load and apply the surface-specific route, pricing, experiment, proof, and placement contracts in the conversion reference. Verify that visible copy follows any returned placement order, every material qualifier stays attached to the fact it qualifies, conditional steps remain conditional, unknown destinations remain unknown, and proof keeps its supplied form and causal status. Trace the primary-action spine across the flow. Do not let a prerequisite replace the activation event, make an optional post-event action primary, or invent a destination after an unknown transition. Audit every parallel option's primary decision unit for its supported route type, exclusivity, material commitment, and action or destination; an FAQ may reinforce this distinction but cannot supply it first. Audit every checklist or readiness item for a distinct fact-grounded verification, dependency, consequence, or preparation action rather than a generic instruction to review or confirm prior copy. When collection, access, or start order is absent, keep the known terms separate and do not connect them with `after`, `before`, `then`, or `until`. Scale experiment-plan detail to the requested depth without removing the minimum controls needed to interpret the named business outcome. Treat route, term, proof, and qualification completeness as the safety floor; after that floor passes, preserve the strongest supported reader job, task, or operational decision as the argument.
175
+ Publication audit is a separate read-only workflow. Load [references/agora-publication.md](references/agora-publication.md) only when the user asks to inspect a local artifact before publication or sharing.
401
176
 
402
- When a sentence fails the comprehension gate, keep the underlying fact, name the concrete actor, action, object, and result, remove internal process language the reader does not need, split the overloaded sentence, restore any context the compression removed, rewrite the call to action to name its real destination, then test again. Do not repair unclear writing by adding explanatory parentheses, longer noun phrases, or a vague supporting sentence.
177
+ Use the shipped `scripts/publication-audit.mjs`. Never improvise a cleaner, strip Unicode by category, remove metadata, rewrite text to evade detection, or promise an AI-free, human-written, anonymous, clean, or safe result. Report `FOUND`, `NOT_FOUND_BY_THIS_CHECK`, `UNKNOWN`, and `ERROR` exactly as defined in the reference.
403
178
 
404
- Keep these passes invisible. Mention a blocker only when a host rule or missing requirement makes the requested result impossible.
179
+ ## Run silent final passes
405
180
 
406
- An active voice profile carries one narrow exception to the AI-vocabulary ban. The words on that profile's owned-vocabulary list, and only those words, are exempt, because they were measured across the corpus. The exception covers vocabulary alone: it never suppresses the stock-template bans, the significance-tail bans, the structural-tell rules, curly-quote normalization where it applies, or the U+2014 ban.
181
+ Before returning:
407
182
 
408
- Measured sentence length and paragraph shape describe a distribution, not a quota or a template to reproduce. Apply them without restating facts, mirroring a sample passage, or manufacturing a closing summary. A structural tell requires an identifiable prohibited construction; matching a measured length or paragraph distribution is not itself a tell.
183
+ 1. Build a private requirement map for every fact, limitation, exact term, requested component, length rule, inclusion, and exclusion.
184
+ 2. Compare every factual statement with the supplied facts and required wording.
185
+ 3. Preserve all material conditions, uncertainty, attribution, names, numbers, dates, quotations, legal terms, and technical terms.
186
+ 4. Trace every user-required fact and limitation to visible wording, including exact category nouns, action verbs, format facts, endings, and cancel behavior.
187
+ 5. Rewrite the whole draft for first-read clarity.
188
+ 6. Apply every mandatory rule from the canonical human-voice reference.
189
+ 7. Run the control-word and added-pattern review from the compact writing runtime.
190
+ 8. Review ordinary sentences over 28 words, joined clauses, repeated openings, noun stacks, preposition stacks, repeated paragraph shapes, false reframes, question-fragment theater, corporate helper phrases, and legalistic leakage.
191
+ 9. Check task-sample phrase overlap and remove copied material.
192
+ 10. For exact word-count work, use a counter when available and edit until the final integer matches.
193
+ 11. Run the final U+2014 and generated smart-quote scans.
409
194
 
410
- Outside exact, immutable, legal, technical, or user-required text, do not generate curly or smart quotes in final copy. Remove prompt leakage, canned framing, generic significance tails, inflated abstractions, fake human texture, and repeated stock templates. Avoid decorative three-part rhetoric, but preserve necessary series. Never promise detector evasion. Never change user-required meaning to sound human.
195
+ Never promise detector evasion or infer authorship. Never add fake errors, slang, anecdotes, or quirks. Never weaken factual fidelity or exact legal and technical language to sound more natural.
411
196
 
412
197
  ## Return the result
413
198
 
414
- Return one ready-to-use result first. Do not expose internal argument planning, mode labels, chain-of-thought, rule audits, or a policy recap.
415
-
416
- Return finished copy, not a worksheet. When a user requests a headline, subhead, CTA, qualification, subject line, or other named component, use normal hierarchy or spacing inside the ready-to-use asset. Outside that asset, label implementation recommendations or requested component fields when labels prevent ambiguity. Do not insert those editorial labels into the copy itself unless the user explicitly asks for them there.
199
+ Return one ready-to-use result by default. Return only the requested deliverable and components.
417
200
 
418
- Do not append a process explanation, compliance note, self-audit, rationale, alternate route, or offer to do more unless the user asks for it. Return only the requested deliverable and any components the task requires.
201
+ Return finished copy, not a worksheet. Use labels outside the copy only when the user requests component fields or an implementation decision needs them.
419
202
 
420
- Default to the shortest complete output suited to the channel. Do not provide near-duplicate variants unless requested. Do not append warnings, disclaimers, or responsibility notes unless the user requests them or a host rule requires them.
203
+ Do not expose internal planning, register labels, mode labels, fact ledgers, source checks, reasoning, self-audits, change logs, confidence statements, or policy recaps. Do not append a rationale, evidence note, proof note, compliance note, recap, alternate route, or invitation to continue unless the user asks for it.
421
204
 
422
- For critique-only requests, lead with the most consequential actionable findings. When rewriting is authorized, lead with the revised copy.
205
+ For critique-only work, lead with the most consequential actionable findings. When rewriting is authorized, lead with the finished revision.