@maestroagora/agora 1.6.0 → 1.7.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.
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/README.md +12 -5
- package/package.json +3 -2
- package/skills/agora/SKILL.md +49 -17
- package/skills/agora/references/agora-case-studies.md +13 -5
- package/skills/agora/references/agora-conversion.md +202 -0
- package/skills/agora/references/agora-craft.md +7 -2
- package/skills/agora/references/agora-invest.md +8 -6
- package/skills/agora/references/agora-marketing.md +69 -3
- package/skills/agora/references/agora-science.md +9 -3
- package/skills/agora/references/agora-voice.md +2 -2
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "maestro-agora",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.7.0",
|
|
4
4
|
"displayName": "Maestro: Agora",
|
|
5
5
|
"description": "Use /agora for persuasive writing, technical explanation, compelling case studies, fundraising, investment analysis, and spoken or written copy.",
|
|
6
6
|
"author": {
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "maestro-agora",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.7.0",
|
|
4
4
|
"description": "Maestro: Agora writes clear persuasion, technical explanations, compelling case studies, and investment communication to the user's brief.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Mark Laursen",
|
package/README.md
CHANGED
|
@@ -295,11 +295,11 @@ Read [User Responsibility and Disclaimer](DISCLAIMER.md) and [Privacy Notice](PR
|
|
|
295
295
|
|
|
296
296
|
## Written GEO/AEO boundaries
|
|
297
297
|
|
|
298
|
-
For
|
|
298
|
+
For indexable public assets, Agora answers the reader's question early when the format calls for it, names entities and scope, keeps supporting details and qualifications beside claims, exposes supplied provenance, and builds useful passages that remain accurate when quoted alone.
|
|
299
299
|
|
|
300
300
|
For indexable public pages, it can flag relevant crawlability, canonical, sitemap, metadata, structured-data, accessibility, and delivery checks. These practices may improve eligibility and citability. They cannot promise retrieval, selection, quotation, citation, ranking, recommendation, referral, conversion, or revenue.
|
|
301
301
|
|
|
302
|
-
GEO/AEO applies to coherent
|
|
302
|
+
GEO/AEO applies to coherent passages on indexable public pages, not every sentence. It does not automatically apply to private, non-indexable, or spoken work, and it cannot force article-style density into a hero, case-study opening, or short CTA.
|
|
303
303
|
|
|
304
304
|
## Package architecture
|
|
305
305
|
|
|
@@ -329,6 +329,7 @@ skills/agora/
|
|
|
329
329
|
- `agora-craft.md` adds headlines, heroes, awareness and sophistication, emotion, and prose rhythm.
|
|
330
330
|
- `agora-science.md` adds empirical and technical explanation plus optional scientific claim review.
|
|
331
331
|
- `agora-case-studies.md` adds case structure, results, and optional attribution, permission, and confidentiality review.
|
|
332
|
+
- `agora-conversion.md` adds bounded conversion priors, outcome matching, self-serve and enterprise route design, pricing decision contracts, decision-adjacent proof, contradiction handling, and experiment interpretation for funnel surfaces.
|
|
332
333
|
- `agora-invest.md` adds fundraising, diligence, allocation, and optional claim-review procedures.
|
|
333
334
|
- `agora-voice.md` adds measured voice profiles and user-controlled profile use.
|
|
334
335
|
|
|
@@ -338,25 +339,31 @@ Research informed Agora, but research custody is separate from distribution.
|
|
|
338
339
|
|
|
339
340
|
The public repository and npm package must not contain raw or corrected transcripts, caption files, supplied PDFs or office documents, audio, video, private source identities, model-output scratch, research working files, local paths, or assigned secrets.
|
|
340
341
|
|
|
341
|
-
`npm run check`
|
|
342
|
+
`npm run check` runs validation, deterministic tests, the exact package allowlist, and release hygiene. `npm run release:check` repeats that complete distributable validation. `npm pack` and `npm publish` run it through `prepack` and `prepublishOnly`.
|
|
342
343
|
|
|
343
|
-
The versioned `evals/blind
|
|
344
|
+
The versioned directories under `evals/blind/` are public pairwise-release artifacts, not permanently secret holdouts. `v1.2.0`, `v1.4.0`, `v1.5.0`, and `v1.7.0` are frozen by exact tree hashes in `evals/releases/locks.json`; validation fails on additions, deletions, or edits.
|
|
345
|
+
|
|
346
|
+
`evals/prospective/conversion-context-v1.0.0/` remains the development source for conversion-context cases. Earlier fixture sets are preserved under `evals/regression/` for regression analysis and historical reproducibility. `evals/blind/v1.7.0/` contains 25 independently authored conversion scenarios with versioned judging and reduction tooling.
|
|
347
|
+
|
|
348
|
+
Deterministic tests verify instruction structure, routing contracts, static invariants, and evaluation-record shape. Versioned blind-evaluation tooling remains available for repeatable development analysis without turning model preference into a universal conversion claim.
|
|
344
349
|
|
|
345
350
|
## Verify
|
|
346
351
|
|
|
347
352
|
```sh
|
|
348
353
|
npm run check
|
|
349
354
|
npm run release:check
|
|
355
|
+
node scripts/eval-locks.mjs
|
|
350
356
|
npm pack --dry-run --json
|
|
351
357
|
npx -y @maestroagora/agora --dry-run
|
|
352
358
|
```
|
|
353
359
|
|
|
354
|
-
The release gate checks skill structure, routing contracts, user-authority boundaries, modifiers, typography, metadata, reference links, full-tree installer parity, exact npm contents,
|
|
360
|
+
The release gate checks skill structure, routing contracts, user-authority boundaries, modifiers, typography, metadata, reference links, full-tree installer parity, exact npm contents, frozen evaluation-tree locks, and public-tree hygiene.
|
|
355
361
|
|
|
356
362
|
## Change record
|
|
357
363
|
|
|
358
364
|
| Version | What changed |
|
|
359
365
|
|---|---|
|
|
366
|
+
| 1.7.0 | Adds a progressively loaded conversion-context reference with bounded conversion priors, downstream outcome matching, self-serve and enterprise route design, pricing decision contracts, proof placement, and contradiction handling. Tightens closed-world fact preservation and limits written GEO/AEO requirements to indexable public work. |
|
|
360
367
|
| 1.6.0 | Expands user control across every writing mode. User-selected claims, fiction, urgency, attribution, profile use, and publication choices now control the draft. Claim, evidence, permission, disclosure, confidentiality, diligence, and compliance review are opt-in. Adds a user-responsibility disclaimer and an accurate privacy notice. |
|
|
361
368
|
| 1.5.0 | Hardens `INVEST` across fundraising, diligence, and capital allocation. Adds an investment claim ledger, metric separations, asset-specific procedures, decision-led questions, objection handling, defensibility analysis, truthful urgency and commitment language, modifier composition, and current-verification boundaries. Separates real projects from fictional mock and concept-portfolio routes, and permits clearly disclosed invention for mock and hypothetical articles. Adds a customer-language boundary that keeps internal checking terms out of ordinary public copy while preserving them where scientific, methodological, audit, legal, compliance, diligence, or technical work needs them. Expands the blind corpus from 60 to 86 cases. Adds a mandatory public-tree and package hygiene gate that blocks research, transcripts, supplied private documents, raw model outputs, local paths, secrets, unexpected binaries, and private source identities. |
|
|
362
369
|
| 1.4.0 | Adds stronger hero and short-form sales composition plus the composable `SCIENCE` and `CASE_STUDY` capabilities. Heroes now separate truth gates from persuasive optimization and treat the complete first-screen composition as one argument. Scientific and technical work preserves claim class, causality, statistics, uncertainty, analogy limits, and source limits. Case studies add result classes, causality, permissions, confidentiality, role attribution, quote, typicality, and visual-support gates. The blind corpus contains 60 cases. |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@maestroagora/agora",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.7.0",
|
|
4
4
|
"description": "Install Maestro: Agora for persuasive writing, scientific and technical explanation, case studies, fundraising, and investment analysis.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -30,8 +30,9 @@
|
|
|
30
30
|
"pack:check": "node scripts/pack-check.mjs",
|
|
31
31
|
"prepack": "npm run release:check",
|
|
32
32
|
"prepublishOnly": "npm run release:check",
|
|
33
|
+
"eval:release": "node scripts/release-evidence-check.mjs",
|
|
33
34
|
"release:check": "npm run check",
|
|
34
|
-
"test": "node --test tests/behavior-contract.test.mjs tests/hero-contract.test.mjs tests/science-contract.test.mjs tests/case-study-contract.test.mjs tests/invest-contract.test.mjs tests/blind-summary.test.mjs tests/release-hygiene.test.mjs tests/install.test.mjs tests/voice-measure.test.mjs",
|
|
35
|
+
"test": "node --test tests/behavior-contract.test.mjs tests/hero-contract.test.mjs tests/conversion-context-contract.test.mjs tests/science-contract.test.mjs tests/case-study-contract.test.mjs tests/invest-contract.test.mjs tests/blind-summary.test.mjs tests/blind-judge-prompt.test.mjs tests/blind-judge-materialize.test.mjs tests/blind-judgment-ingest.test.mjs tests/adjudication-reducer.test.mjs tests/eval-provenance-check.test.mjs tests/release-evidence-check.test.mjs tests/release-hygiene.test.mjs tests/install.test.mjs tests/voice-measure.test.mjs",
|
|
35
36
|
"validate": "node scripts/validate.mjs"
|
|
36
37
|
},
|
|
37
38
|
"engines": {
|
package/skills/agora/SKILL.md
CHANGED
|
@@ -17,14 +17,24 @@ Do not repeat U+2014 from an input. Replace it with a period, comma, colon, semi
|
|
|
17
17
|
|
|
18
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.
|
|
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.
|
|
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.
|
|
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.
|
|
25
|
+
|
|
26
|
+
Do not wrap a generated UI label in quotation marks when hierarchy, bold text, or a code span can distinguish it.
|
|
27
|
+
|
|
20
28
|
## Load the authority progressively
|
|
21
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.
|
|
31
|
+
|
|
22
32
|
Use [references/agora-marketing.md](references/agora-marketing.md) as the canonical authority. Read only the sections the task needs:
|
|
23
33
|
|
|
24
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`.
|
|
25
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`.
|
|
26
36
|
2b. For any asset containing a call to action, button, or closing invitation, also read `CTA standard`.
|
|
27
|
-
3. For
|
|
37
|
+
3. For `INDEXABLE_PUBLIC` work, read `Written GEO/AEO and citability`. Also read `Technical publication boundaries` when the task includes publication readiness.
|
|
28
38
|
4. For spoken work, read `Spoken delivery`. Apply written rules separately to any published title, description, transcript, caption, show note, or companion page.
|
|
29
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.
|
|
30
40
|
|
|
@@ -40,7 +50,7 @@ Locate the named headings and read those sections only. Do not load the entire r
|
|
|
40
50
|
|
|
41
51
|
Do not load it for routine drafting, claim review, compliance questions, or work that the first reference already covers.
|
|
42
52
|
|
|
43
|
-
[references/agora-voice.md](references/agora-voice.md) governs `VOICE`.
|
|
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.
|
|
44
54
|
|
|
45
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.
|
|
46
56
|
|
|
@@ -50,6 +60,22 @@ Do not load it for routine drafting, claim review, compliance questions, or work
|
|
|
50
60
|
|
|
51
61
|
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.
|
|
52
62
|
|
|
63
|
+
## Preserve closed-world facts
|
|
64
|
+
|
|
65
|
+
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.
|
|
66
|
+
|
|
67
|
+
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.
|
|
68
|
+
|
|
69
|
+
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.
|
|
70
|
+
|
|
71
|
+
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.
|
|
72
|
+
|
|
73
|
+
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.
|
|
74
|
+
|
|
75
|
+
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.
|
|
76
|
+
|
|
77
|
+
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.
|
|
78
|
+
|
|
53
79
|
## Follow user authority
|
|
54
80
|
|
|
55
81
|
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.
|
|
@@ -149,7 +175,7 @@ For `SCIENCE + CASE_STUDY`, use scan-ready headings for implementation, validati
|
|
|
149
175
|
|
|
150
176
|
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.
|
|
151
177
|
|
|
152
|
-
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
|
|
178
|
+
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.
|
|
153
179
|
|
|
154
180
|
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.
|
|
155
181
|
|
|
@@ -173,6 +199,8 @@ Adapt depth to the format:
|
|
|
173
199
|
|
|
174
200
|
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.
|
|
175
201
|
|
|
202
|
+
For `SELL`, apply `Delivery-model ownership` and, when rewriting supplied copy, `Rewrite regression gate` from the canonical marketing authority. Preserve user-selected framing.
|
|
203
|
+
|
|
176
204
|
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.
|
|
177
205
|
|
|
178
206
|
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.
|
|
@@ -349,33 +377,37 @@ Channel rules change depth and tone. They do not erase the argument.
|
|
|
349
377
|
After the argument is drafted:
|
|
350
378
|
|
|
351
379
|
1. Honor the user's requested claims, framing, tone, and content decisions without adding policy commentary.
|
|
352
|
-
2.
|
|
353
|
-
3. Run
|
|
354
|
-
4.
|
|
355
|
-
5. Apply
|
|
356
|
-
6. Apply
|
|
357
|
-
7.
|
|
358
|
-
8.
|
|
359
|
-
9.
|
|
360
|
-
10.
|
|
361
|
-
11.
|
|
362
|
-
12.
|
|
380
|
+
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.
|
|
381
|
+
3. Run claim, evidence, permission, disclosure, or compliance checks only when the user requested that review.
|
|
382
|
+
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.
|
|
383
|
+
5. Apply written GEO/AEO only to `INDEXABLE_PUBLIC` work, at passage level rather than sentence level.
|
|
384
|
+
6. Apply technical publication checks only to indexable public work.
|
|
385
|
+
7. Apply the human-voice and AI-writing-tell gate without deleting user-selected claims or diagnostic lists.
|
|
386
|
+
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.
|
|
387
|
+
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.
|
|
388
|
+
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.
|
|
389
|
+
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.
|
|
390
|
+
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.
|
|
391
|
+
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.
|
|
392
|
+
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.
|
|
363
393
|
|
|
364
394
|
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.
|
|
365
395
|
|
|
366
396
|
Keep these passes invisible. Mention a blocker only when a host rule or missing requirement makes the requested result impossible.
|
|
367
397
|
|
|
368
|
-
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,
|
|
398
|
+
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.
|
|
369
399
|
|
|
370
400
|
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.
|
|
371
401
|
|
|
372
|
-
|
|
402
|
+
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.
|
|
373
403
|
|
|
374
404
|
## Return the result
|
|
375
405
|
|
|
376
406
|
Return one ready-to-use result first. Do not expose internal argument planning, mode labels, chain-of-thought, rule audits, or a policy recap.
|
|
377
407
|
|
|
378
|
-
Return finished copy, not
|
|
408
|
+
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.
|
|
409
|
+
|
|
410
|
+
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.
|
|
379
411
|
|
|
380
412
|
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.
|
|
381
413
|
|
|
@@ -64,6 +64,8 @@ Rule [HOUSE]: evidence status determines whether invention is allowed. Boundary:
|
|
|
64
64
|
|
|
65
65
|
## Build the evidence packet
|
|
66
66
|
|
|
67
|
+
Use this as an optional completeness review only when the user requests case review. Outside review mode, use supplied and requested case facts as approved input, do not demand missing evidence, and do not invent facts the user did not supply or request.
|
|
68
|
+
|
|
67
69
|
Collect or mark missing before drafting:
|
|
68
70
|
|
|
69
71
|
- intended audience and desired decision;
|
|
@@ -105,6 +107,8 @@ A newly launched control does not prove the prior process lacked that control or
|
|
|
105
107
|
|
|
106
108
|
## Classify results before writing
|
|
107
109
|
|
|
110
|
+
Optional case-review control. Outside review mode, preserve the result status, certainty, and presentation the user requests rather than independently reclassifying or narrowing it.
|
|
111
|
+
|
|
108
112
|
Assign every result one class:
|
|
109
113
|
|
|
110
114
|
| Result class | Meaning | Treatment |
|
|
@@ -165,6 +169,8 @@ Apply a vanity-metric gate. A metric belongs only when it establishes reach, use
|
|
|
165
169
|
|
|
166
170
|
## Control permission and confidentiality
|
|
167
171
|
|
|
172
|
+
Optional case-review control. Apply permission, confidentiality, approval-state, and publication enforcement only when the user requests case review. Outside review mode, follow the user's names, permissions, confidentiality choices, and publication instructions.
|
|
173
|
+
|
|
168
174
|
Assign each publishable element one state:
|
|
169
175
|
|
|
170
176
|
| State | Meaning | Output rule |
|
|
@@ -186,6 +192,8 @@ Anonymization must protect identity without laundering the claim. Preserve the i
|
|
|
186
192
|
|
|
187
193
|
## Handle quotes and testimonials
|
|
188
194
|
|
|
195
|
+
Optional case-review control. Check source, permission, typicality, material connection, and quote status only when the user requests case review. Outside review mode, follow the quotations, attribution, and treatment the user supplies or requests.
|
|
196
|
+
|
|
189
197
|
Record for each quote:
|
|
190
198
|
|
|
191
199
|
- speaker and role;
|
|
@@ -207,7 +215,7 @@ Never:
|
|
|
207
215
|
|
|
208
216
|
Rule [A]: applicable consumer endorsements must reflect honest experience, avoid unsupported implied claims, and disclose material connections when needed to prevent deception. See the current [FTC Endorsement Guides](https://www.ecfr.gov/current/title-16/chapter-I/subchapter-B/part-255) and [FTC reviews and testimonials Q&A](https://www.ftc.gov/business-guidance/resources/consumer-reviews-testimonials-rule-questions-answers). Boundary: those authorities do not automatically govern every B2B, employment, creative, or internal case. Use them where applicable and use their truth principles as a conservative editorial floor elsewhere without making a legal claim.
|
|
209
217
|
|
|
210
|
-
Agora's U+2014
|
|
218
|
+
Agora's U+2014 ban still applies. Curly-quote normalization yields to exact, immutable, legal, technical, or user-required text. Never silently alter a quotation and retain an exact-quote label.
|
|
211
219
|
|
|
212
220
|
## Build a structured argument
|
|
213
221
|
|
|
@@ -299,19 +307,19 @@ Use the CTA standard in [agora-marketing.md](agora-marketing.md). `See the diffe
|
|
|
299
307
|
|
|
300
308
|
### `SCIENCE + CASE_STUDY`
|
|
301
309
|
|
|
302
|
-
Load [agora-science.md](agora-science.md).
|
|
310
|
+
Load [agora-science.md](agora-science.md). When explicit scientific or case review is active, keep observed result, mechanism, interpretation, recommendation, and unknowns distinct. Otherwise preserve the user's requested scientific and case framing.
|
|
303
311
|
|
|
304
312
|
### `SELL + CASE_STUDY`
|
|
305
313
|
|
|
306
|
-
Write the strongest buyer-relevant argument the
|
|
314
|
+
Write the strongest buyer-relevant argument the user's brief requests. Structure does not require chronological or academic prose. Apply result-boundary and evidence checks only when explicit case review is active.
|
|
307
315
|
|
|
308
316
|
### `VOICE + CASE_STUDY`
|
|
309
317
|
|
|
310
|
-
Voice may change rhythm and vocabulary. It may not change quote wording,
|
|
318
|
+
Voice may change rhythm, syntax, and measured vocabulary. It may not change the proposition, quote wording, roles, metrics, certainty, or attribution supplied in the user's current brief. Host-required text and findings from explicitly requested case review may constrain the result.
|
|
311
319
|
|
|
312
320
|
### `GEO/AEO + CASE_STUDY`
|
|
313
321
|
|
|
314
|
-
|
|
322
|
+
For `INDEXABLE_PUBLIC` cases, make project snapshot, role, method, result, period, and limitation legible in coherent passages. Expose supplied dates, sources, authorship, and evidence. Do not load the opening with every method detail or turn headings into keyword variants. Other written surfaces do not inherit GEO/AEO formatting.
|
|
315
323
|
|
|
316
324
|
## Maintain the case
|
|
317
325
|
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
# Agora conversion context
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
Use this reference when the user asks Agora to improve conversion, design a funnel experiment, compare variants, or write for a landing page, product page, pricing page, paywall, checkout, form, upgrade, or onboarding flow where a measurable action matters.
|
|
6
|
+
|
|
7
|
+
Treat conversion patterns as contextual priors, not laws. This reference does not create a primary mode or modifier. It operates inside `SELL` or `TRANSACT` and preserves user authority. Never treat an offer, KPI, field, permission, proof item, or claim as a supplied fact when it is not. Propose one only when the user asks for recommendations or the deliverable requires it.
|
|
8
|
+
|
|
9
|
+
## Route the decision before drafting
|
|
10
|
+
|
|
11
|
+
Identify these variables from the brief:
|
|
12
|
+
|
|
13
|
+
1. The decision surface and funnel stage.
|
|
14
|
+
2. The action and commitment the reader is considering.
|
|
15
|
+
3. The business outcome the user wants to change.
|
|
16
|
+
4. The largest live uncertainty or perceived effort at that decision.
|
|
17
|
+
5. The audience's awareness, involvement, and reason for choosing.
|
|
18
|
+
6. The proof, terms, reversibility, and risk information available.
|
|
19
|
+
|
|
20
|
+
Do not substitute a nearby metric for the stated objective. A click is not activation, a completed form is not a qualified lead, purchase intent is not a purchase, checkout completion is not retained revenue, and revenue is not profit.
|
|
21
|
+
|
|
22
|
+
When no performance objective is supplied, optimize the requested writing for comprehension, decision fit, and the named next action. Do not invent a company KPI or claim a likely lift.
|
|
23
|
+
|
|
24
|
+
## Use patterns as bounded priors
|
|
25
|
+
|
|
26
|
+
### Clear action and destination
|
|
27
|
+
|
|
28
|
+
Keep CTA wording concrete and predictable under `CTA standard`. This is an operational-clarity rule, not a claim that one label converts better in every context.
|
|
29
|
+
|
|
30
|
+
### Closed-world conversion briefs
|
|
31
|
+
|
|
32
|
+
When the user supplies a closed fact set, every factual conversion proposition must come from that set or a necessary entailment. Do not fill ordinary page slots with plausible industry defaults. Track facts at the level of actor, action, object, status, timing, scope, qualifier, evidence form, route, destination, permission, consent, price, term, and limitation. Support for one field does not supply an adjacent field.
|
|
33
|
+
|
|
34
|
+
Apply these non-inference classes across categories:
|
|
35
|
+
|
|
36
|
+
- A named provider, route, interface, or capability does not establish its mechanics, security properties, field layout, service level, staffing, follow-up, or outcome.
|
|
37
|
+
- A price, billing period, renewal, trial, cancellation right, or absence of an offer does not establish collection timing, automatic billing, access timing, refund behavior, cancellation mechanics, or an alternative offer.
|
|
38
|
+
- A permission or consent choice does not establish a fallback, skipped path, later result, extra data use, message category, cadence, delivery artifact, or withdrawal mechanism. Preserve its required or optional status and supplied scope.
|
|
39
|
+
- A result does not become a quotation, causal claim, customer identity, segment result, or plan-specific result without separate support.
|
|
40
|
+
- A named role, plan, review, or process does not establish a different role name, approval, ownership, deliverable, authority, schedule, coverage, or result. Preserve the exact stage and designation.
|
|
41
|
+
- A stated exclusion does not establish the unnamed alternative. A supplied sensory property does not establish sequence, persistence, audience effect, or product performance.
|
|
42
|
+
|
|
43
|
+
These limits prohibit invented vendor facts, not useful buyer-side interpretation. Translate a supplied capability into the actor who can use or review it, the decision or uncertainty it directly addresses, and any supplied boundary. Do not add product behavior or an outcome to make that connection. Avoid tautological noun repetition such as saying a review feature enables review or a control capability provides control; name the supported buyer action or leave the capability concrete.
|
|
44
|
+
|
|
45
|
+
Prefer the action verb supplied by the brief when it precisely names the task. Necessary entailments and direct, bounded buyer interpretations are allowed. Do not invent an intermediate operation, vendor behavior, or outcome to make the argument flow.
|
|
46
|
+
|
|
47
|
+
Use this private conversion procedure: identify the strongest supported reader decision; plan the requested components as implementation recommendations, visible copy, or both; map each material supplied relationship as `parties | action | object | scope | conditions | timing | modality | state | route or next state` to its first carrying component; draft; compare every relationship and operator with the source; correct unsupported changes; then rerun the contract and hierarchy checks. Preserve requested controls and states in literal, channel-native form; prose does not substitute for them. Keep editorial directions outside ready-to-use copy. If completing a component requires invention, use accurate structure instead. Do not append omission rationale unless requested.
|
|
48
|
+
|
|
49
|
+
### Benefit-first composition
|
|
50
|
+
|
|
51
|
+
Use a benefit-first opening as a strong candidate when a practical audience arrives with a defined job or problem. Keep emotion-first, identity-first, curiosity-first, mechanism-first, and proof-first openings available when the brief, audience, awareness, or category makes one of them stronger. Never make benefit-first structure universal.
|
|
52
|
+
|
|
53
|
+
### Decision-adjacent proof
|
|
54
|
+
|
|
55
|
+
Place the strongest relevant supplied proof near the uncertainty it resolves when the user asks for page composition. Trust signals belong near a consequential or risky action only when they answer the reader's live concern. Social proof must match the audience, use case, and decision. Do not scatter decorative badges, invent trust marks, or impose a fixed seal count.
|
|
56
|
+
|
|
57
|
+
For a commitment area, make the final action, material terms, and relevant supplied proof scannable at the decision they qualify. Do not force a universal element count or fixed order. Give each component one incremental decision job: orient, explain the commitment, collect an input, resolve an uncertainty, disclose a boundary, or enable the action. Remove repetition without reducing material coverage. Repeat only material terms or boundaries that must remain decision-adjacent when a component or variant can be encountered independently.
|
|
58
|
+
|
|
59
|
+
For parallel options, each primary decision unit must carry its supported route type, exclusivity status, material commitment, and action or destination. An FAQ may reinforce the route distinction, but it cannot be the first component that supplies it. Do not imply an unsupplied route or exclusivity status.
|
|
60
|
+
|
|
61
|
+
Every checklist or readiness item must add a distinct verification, dependency, consequence, or preparation action grounded in supplied facts. Do not use `review` or `confirm` merely to restate a claim from an earlier section. Direct, bounded buyer implications are allowed; unsupplied vendor behavior and outcomes are not.
|
|
62
|
+
|
|
63
|
+
When the user asks for both visible composition and placement or implementation instructions, make them describe the same interface state. State explicit remove, retain, relocate, replace, or rewrite actions for named defects. Keep those actions outside the ready copy and do not count them as interface elements.
|
|
64
|
+
|
|
65
|
+
### Field effort and qualification
|
|
66
|
+
|
|
67
|
+
When the user authorizes form or flow changes, ask only for inputs the current step genuinely needs. Preserve qualification fields, required permissions, and deliberate friction when they serve the stated business objective. Explain an extra field or permission at the point of decision when the brief supplies a truthful reason. Never claim that fewer fields always produce a better business result.
|
|
68
|
+
|
|
69
|
+
### Commitment staging
|
|
70
|
+
|
|
71
|
+
Match copy, detail, reassurance, and proof to the commitment being requested. A low-commitment download should not sound like an application. A purchase, payment, data connection, or annual contract should not hide terms, work, reversibility, or the next operational step supplied in the brief.
|
|
72
|
+
|
|
73
|
+
The conversion overlay never waives the canonical CTA standard. Label the supported buyer commitment and its object or destination, not a later possibility. If the only supported fact is an interface transition to an unknown next destination, use neutral continuation language and explain the known transition in adjacent microcopy. Do not invent checkout, review, scheduling, delivery, payment, account, or confirmation behavior.
|
|
74
|
+
|
|
75
|
+
Trace a primary-action spine across every multi-step flow: entry action, required prerequisites, supplied activation event or terminal commitment, then optional post-event actions. Also trace `present state -> control -> immediate effect -> next visible state -> conditional later state`; keep unsupplied states unknown. A permission, setup screen, or review prerequisite cannot replace activation. An optional action after the event remains secondary. Confirmations state only the status reached, preserve conditional next steps as conditional, and preserve explicit non-events or funnel boundaries. Optional consent remains visually and semantically separate from the primary action.
|
|
76
|
+
|
|
77
|
+
For parallel choices or variants, keep every material price, unit, timing, charge, renewal, cancellation, access, trial, permission, and limitation needed to understand each choice. Do not copy every fact into every component. Repeat only terms and boundaries needed beside that component's decision.
|
|
78
|
+
|
|
79
|
+
### Activation-aware onboarding
|
|
80
|
+
|
|
81
|
+
When the user supplies an activation event, write onboarding toward that event rather than permission acceptance, screen completion, or feature exposure alone. Use progressive disclosure and explain required permissions where the decision occurs. Do not turn an analytics objective into customer-facing copy. The name of an event establishes only that the event occurred, not the mechanism, subsequent state, setup completion, automation, persistence, notification, or user outcome. Under a closed fact set, neutral action framing is stronger than an unsupported benefit.
|
|
82
|
+
|
|
83
|
+
### Downstream evaluation
|
|
84
|
+
|
|
85
|
+
When the user requests an experiment plan, match the primary measure to the business decision and name guardrails that prevent a local win from hiding a downstream loss. Pricing and paywall tests may need revenue per visitor, retained revenue, refunds, or plan mix. Lead-generation tests may need qualified opportunities, cost per qualified lead, or revenue rather than raw completions. Use only metrics relevant to the supplied model and data.
|
|
86
|
+
|
|
87
|
+
Scale experiment-plan detail to the requested depth, but preserve enough structure to interpret the named business outcome. Define the eligible population and outcome denominator consistently. Use stable assignment when repeat exposure could cross variants. Specify an unchanged comparator and an isolated treatment from available inputs. Preserve supplied measurement horizons and wait until downstream outcomes are observable. Separate the primary outcome from guardrails and diagnostics. Analyze by original assignment when assignment defines exposure. Use direction-neutral hypotheses and symmetrical decisions for benefit, harm, null, and uncertainty. Concision compresses phrasing, not interpretability.
|
|
88
|
+
|
|
89
|
+
Present population, measurement, sample-size, interval, exclusion, duration, and stopping methods as proposed procedures when the requested decision requires them. Do not imply current instrumentation or invent business metrics, financial adjustments, identifiers, thresholds, or decision policies. A named measure does not authorize unnamed components. When reviewing a rule about a class of interface actions, distinguish commitment actions from navigation and informational controls, then test at the narrowest point that actually represents the disputed decision.
|
|
90
|
+
|
|
91
|
+
## Build product-led and enterprise buying paths
|
|
92
|
+
|
|
93
|
+
### Separate routes by work required
|
|
94
|
+
|
|
95
|
+
When the brief supplies both self-serve and enterprise routes, make both routes legible without pretending they perform the same job. Give the self-serve buyer the available direct commitment. Give the enterprise buyer the supplied request or review action for organizational complexity. Name each action by the buyer commitment and object or destination, with adjacent transition copy when the destination alone is not enough. Do not promote a supplied role, service, or deployment option into a broader ownership or delivery claim.
|
|
96
|
+
|
|
97
|
+
Do not treat the absence of a sales team as a conversion ideal or an eligibility test. Mature product-led businesses can use self-serve for adoption and sales for organizational complexity. When the product is genuinely sales-led, do not invent a signup, trial, public price, or instant-purchase route. When it is genuinely self-serve, do not force a sales conversation between the reader and the available action.
|
|
98
|
+
|
|
99
|
+
For each supplied route, make the CTA and adjacent microcopy state the supported commitment, object or destination, and known immediate consequence. The absence of self-serve, a trial, instant purchase, or public price does not establish the absence of a standard configuration, package, or deployment. A request or review route does not authorize field contents, variability rationales, consultation coverage, follow-up, or a result of review.
|
|
100
|
+
|
|
101
|
+
### Make pricing a decision contract
|
|
102
|
+
|
|
103
|
+
Treat a pricing page as a complete buying decision, not a tariff. Use the applicable supplied information:
|
|
104
|
+
|
|
105
|
+
- who each plan is for;
|
|
106
|
+
- the visible entry price and billing period;
|
|
107
|
+
- usage, seat, capacity, or feature boundaries;
|
|
108
|
+
- trial length and card requirement;
|
|
109
|
+
- contract, renewal, cancellation, and implementation terms;
|
|
110
|
+
- what materially changes for enterprise;
|
|
111
|
+
- the action available for each route;
|
|
112
|
+
- proof that resolves a doubt at that decision.
|
|
113
|
+
|
|
114
|
+
Do not hide a supplied public price merely because a custom enterprise route also exists. Do not publish a private price, invent a discount, or add a public self-serve offer the user did not supply. When the brief intentionally withholds price, make the actual quoting or scoping process clear instead.
|
|
115
|
+
|
|
116
|
+
Keep destination microcopy adjacent to each action when the label alone cannot carry the supported route consequence. Show a combined amount under a timing label only when every included amount shares that supplied timing. Arithmetic can establish a total, not shared collection timing. Otherwise state each amount with only its own supplied timing. Do not infer when a subscription, fee, access period, or later process begins.
|
|
117
|
+
|
|
118
|
+
Run a temporal audit across collection, access, and start language. When their sequence is absent, keep the known terms in separate clauses or sentences. Do not connect them with `after`, `before`, `then`, or `until`; those words create an unsupplied order.
|
|
119
|
+
|
|
120
|
+
### Explain enterprise value through operational requirements
|
|
121
|
+
|
|
122
|
+
Lead with the outcome the enterprise buyer is trying to achieve. Then use only applicable supplied facts about scale, security, compliance, governance, administration, support, migration, onboarding, implementation, procurement, or professional services. Connect each fact to the uncertainty it resolves.
|
|
123
|
+
|
|
124
|
+
Do not use `enterprise-grade` as the sole explanation. Name what the product or service does differently for the larger organization. Do not invent certifications, service levels, deployment models, integrations, residency options, support promises, or implementation capacity.
|
|
125
|
+
|
|
126
|
+
Connect supplied capabilities to recognizable organizational requirements without assigning unsupplied product behavior. Prefer a concrete sentence with the supported actor, action, object, or review decision over an abstract capability synonym. Preserve exact capability names, regions, role names, availability windows, document status, access conditions, and exclusions. Do not upgrade a supplied artifact or process with adjectives that imply documentation, ownership, completeness, or implementation. Do not infer a positive delivery model from an excluded one. Keep internal calibration logic out of customer copy unless the limitation itself belongs on the page.
|
|
127
|
+
|
|
128
|
+
Do not let enterprise claim safety flatten the argument into an evaluation checklist. Lead with the strongest supported organizational job or operational decision, then organize supplied capabilities as reasons tied to recognizable requirements. A reader job is not a product category, plan-selection instruction, evaluation process, CTA destination, or capability inventory. When no performance outcome is supplied, use the concrete task or decision enabled by the facts and do not invent a business result. Preserve exact capability names, limitations, route consequences, and qualification terms inside that argument. Put the primary action near the point where its purpose becomes clear; repeat it later only when the requested composition needs another decision point.
|
|
129
|
+
|
|
130
|
+
### Put commitment and proof beside the decision
|
|
131
|
+
|
|
132
|
+
Place trial duration, card requirement, billing period, annual commitment, renewal, cancellation, usage limits, and required implementation charges beside the action they qualify. Do not bury a material term in a distant FAQ or load every term into the button label.
|
|
133
|
+
|
|
134
|
+
Place proof where it resolves the live doubt. Scale proof can support capacity, a relevant customer case can support adoption, and a quantified result can support the result it actually measured. A large customer count does not prove implementation ease. A brand logo does not prove security. When no supplied proof answers the uncertainty, do not make decorative proof carry that claim.
|
|
135
|
+
|
|
136
|
+
For a multi-route composition, establish the strongest supported shared job before distinguishing buying routes. Avoid headlines that merely tell the reader to choose a plan, describe the buying process, or repeat the product category. Make each route's fit, material terms, action, and immediate destination legible without hiding the other route. Place each supplied proof item where its attribution and scope answer the live uncertainty without implying that it belongs to a route, plan, segment, or result the brief did not name. Preserve an inclusion as an inclusion; do not rewrite it as a maximum.
|
|
137
|
+
|
|
138
|
+
When the brief supplies operational support but says target performance is unmeasured, present the support and evidence gap as separate facts. A supplied plan, role, process, or review is not proof of duration, downtime, control, completion, or success. Do not rename the role or assign any action, authority, timing, or effect the brief does not supply.
|
|
139
|
+
|
|
140
|
+
Risk specificity can be contextual without becoming causal. When the buyer's only supplied requirement is a named concern, state that concern, place the supplied capability beside it, and state the evidence gap. Do not invent mechanics to create a stronger connection.
|
|
141
|
+
|
|
142
|
+
Do not turn a supplied result into a testimonial quote. Do not assign it to a pricing tier, product configuration, or customer segment that the brief did not name.
|
|
143
|
+
|
|
144
|
+
Preserve proof form, attribution specificity, qualifiers, and causal status. Use quotation marks only for verbatim wording supplied by the user. A summary of what someone said supplies meaning, not exact speech; render it as an attributed paraphrase when visible proof is requested. If an attribution class is supplied without the identifier needed to name it, preserve the supported specificity without inventing an identifier or downgrading it. A backstage implementation note cannot replace a causal limitation or qualifier that the visible proof needs.
|
|
145
|
+
|
|
146
|
+
When composing around a practical job, lead with that supported job when it is the strongest reader orientation, then distribute supplied operational facts across components according to their decision jobs. Do not repeat one easy fact while omitting another material qualifier, limitation, compatibility condition, interval, quantity, or action.
|
|
147
|
+
|
|
148
|
+
### Identity-led openings without invented provenance
|
|
149
|
+
|
|
150
|
+
Identity-led framing may invite a supported reader self-conception or aesthetic recognition, but it may not turn aesthetic direction into product provenance, creation circumstances, audience behavior, or product effect. Sensory writing may connect supplied materials through concrete texture, temperature, weight, or contrast. Do not invent progression, persistence, mood, attraction, noticeability, performance, or effects on the reader. Let each opening component add a different decision-relevant job, and label the CTA from the supplied commitment and destination rather than a category default.
|
|
151
|
+
|
|
152
|
+
### Preserve architecture, not competitor language
|
|
153
|
+
|
|
154
|
+
Use successful pages to study orientation, decision order, route separation, proof placement, and commitment disclosure. Do not copy a competitor's headline formula, current category fashion, or AI language merely because the company is successful. Current wording may postdate the growth, depend on brand familiarity, or serve a different audience.
|
|
155
|
+
|
|
156
|
+
## Calibrate research-derived guidance
|
|
157
|
+
|
|
158
|
+
For evidence-led or research-backed guidance, classify each conclusion internally before using it:
|
|
159
|
+
|
|
160
|
+
- `OBSERVED_COMMON`: present across the reviewed sample, with no causal claim;
|
|
161
|
+
- `CONTEXTUAL`: useful only under named audience, offer, stage, price, commitment, or delivery conditions;
|
|
162
|
+
- `HYPOTHESIS_TO_TEST`: plausible enough to compare, but not established for the user's business;
|
|
163
|
+
- `NOT_INFERABLE`: unsupported by the available measurement, such as conversion lift from public revenue, customer count, or page presence.
|
|
164
|
+
|
|
165
|
+
Keep these labels backstage unless the user asks for the research reasoning or decision record. Never turn cross-sectional page frequency into an expected effect size. Do not infer an optimal signup form from pages whose rendered fields were not observed.
|
|
166
|
+
|
|
167
|
+
## Resolve contradictions
|
|
168
|
+
|
|
169
|
+
When credible examples point in opposite directions, retain the moderator instead of choosing a universal winner. Compare the cases by audience, offer, funnel stage, commitment, price, traffic source, device, implementation, measurement window, and measured outcome.
|
|
170
|
+
|
|
171
|
+
When direction is unknown, state a non-directional hypothesis such as `may change`, not `will increase`. Match the proposed intervention to the scope of the rule being evaluated, or state and justify the narrower scope without pretending it tests the broader claim.
|
|
172
|
+
|
|
173
|
+
For an evidence-led recommendation, separate:
|
|
174
|
+
|
|
175
|
+
- observed result from proposed mechanism;
|
|
176
|
+
- intention from behavior;
|
|
177
|
+
- immediate action from downstream value;
|
|
178
|
+
- isolated wording from bundled UX changes;
|
|
179
|
+
- source context from the user's context.
|
|
180
|
+
|
|
181
|
+
Treat top-performing sites as composition references only. Performance rank does not identify which element caused the result. Treat vendor and practitioner cases as experiment seeds. Do not transport their effect sizes into another business.
|
|
182
|
+
|
|
183
|
+
Outside explicit review mode, preserve the user's supplied claims and framing. Only apply source grading, causal review, or effect-transfer limits when the user requests evidence review, research-backed guidance, or experiment interpretation.
|
|
184
|
+
|
|
185
|
+
## Evidence basis
|
|
186
|
+
|
|
187
|
+
| Grade | Source | Bounded implication |
|
|
188
|
+
|---|---|---|
|
|
189
|
+
| B | [Ozpolat et al., randomized assurance-seal field experiment](https://digitalcommons.uri.edu/cba_facpubs/326/) | A supplied third-party seal increased purchase likelihood in one retailer context. It does not establish a universal trust treatment. |
|
|
190
|
+
| B | [Ozpolat and Jank, multi-retailer trust-seal field data](https://digitalcommons.uri.edu/cba_facpubs/44/) | Seal effects varied with retailer size, shopper experience, cart value, stage, and number of seals. The reported threshold remains an ecommerce-specific prior. |
|
|
191
|
+
| B | [Reeck et al., app-adoption experiments](https://journals.sagepub.com/doi/10.1177/00222429221141066) | Wording, color, and integrated choices changed app adoption in bounded interfaces. These choice-architecture effects do not become general copy laws. |
|
|
192
|
+
| B | [Creative product-description experiments](https://pmc.ncbi.nlm.nih.gov/articles/PMC8287523/) | Creative descriptions produced small, moderated changes in purchase intention. Intent is not observed purchase behavior. |
|
|
193
|
+
| C | [Baymard checkout research](https://baymard.com/research/checkout-usability) | Qualitative usability and benchmark findings identify checkout friction hypotheses. The combined improvement estimate is not a causal copy-treatment effect. |
|
|
194
|
+
| C | [Shorter lead-form case](https://marketingexperiments.com/lead-generation/lead-generation-testing-form-field-length-reduces-cost-per-lead-by-10-66) and [complex-form case](https://marketingexperiments.com/conversion-marketing/optimizing-web-forms-2) | Practitioner tests point in different directions. Field decisions must follow commitment, qualification needs, and the downstream objective. |
|
|
195
|
+
| C | [Dropbox self-serve disclosure](https://www.sec.gov/Archives/edgar/data/1467623/000146762326000008/dbx-20251231.htm), [Twilio channel disclosure](https://www.sec.gov/Archives/edgar/data/1447669/000144766926000021/twlo-20251231.htm), [MongoDB annual report](https://www.sec.gov/Archives/edgar/data/0001441816/000144181625000101/mdb2025annualreport.pdf), and [Zapier's upmarket account](https://zapier.com/blog/zapier-sales-team-upmarket/) | Official records show that self-serve adoption and enterprise sales can coexist. They do not identify a website element that caused growth. Reviewed 2026-08-11. |
|
|
196
|
+
| D | [Keap pricing](https://keap.com/pricing), [Customer.io pricing](https://customer.io/pricing), [Clay pricing](https://www.clay.com/pricing), and [Holistics pricing](https://www.holistics.io/pricing/?region=us) | Current high-ticket pages show that visible entry prices, trials, and custom or sales routes can coexist. Their presence is a composition reference, not a measured conversion effect. Reviewed 2026-08-11. |
|
|
197
|
+
|
|
198
|
+
## Evaluation contract
|
|
199
|
+
|
|
200
|
+
A conversion-context response fails when it replaces the stated business outcome with a nearby metric, converts a contextual prior into a universal law, transfers a reported effect size across contexts during requested review, invents proof or data-use reasons, changes required commitment or qualification without authorization, hides supplied prices, terms, or permissions, invents a route or enterprise capability, collapses materially different self-serve and enterprise actions into one ambiguous path, uses generic enterprise language instead of the supplied operational difference, separates proof from the uncertainty it resolves, or optimizes one element while weakening the full composition.
|
|
201
|
+
|
|
202
|
+
Evaluate outcome fit, funnel-stage fit, route fit, pricing-decision fit, enterprise-risk fit, proof-to-uncertainty fit, commitment fit, prior calibration, contradiction handling, first-read comprehension, concrete action clarity, brief fidelity, and composition fit.
|
|
@@ -168,6 +168,7 @@ Determine:
|
|
|
168
168
|
- traffic source and upstream promise;
|
|
169
169
|
- one commercial action the hero must earn;
|
|
170
170
|
- actual CTA destination and commitment;
|
|
171
|
+
- delivery model, including what the provider performs and what the buyer must genuinely supply, decide, or approve;
|
|
171
172
|
- offer facts and mechanism;
|
|
172
173
|
- strongest proof;
|
|
173
174
|
- material price, scope, eligibility, safety, or commitment limits;
|
|
@@ -223,6 +224,8 @@ Passing the floor does not make the copy good. Among survivors, optimize for:
|
|
|
223
224
|
|
|
224
225
|
Rule [HOUSE]: do not award extra quality merely because a safe candidate contains more evidence language. Once the hard gates pass, additional proof or qualification helps only when it improves belief, orientation, or the next decision.
|
|
225
226
|
|
|
227
|
+
For rewrites, run `Rewrite regression gate` from [agora-marketing.md](agora-marketing.md) before generating new routes. For `SELL`, apply `Delivery-model ownership` from the same authority. These are source-fidelity checks; user-selected framing remains controlling.
|
|
228
|
+
|
|
226
229
|
### Draft the boldest requested promise first
|
|
227
230
|
|
|
228
231
|
Use this internal process:
|
|
@@ -242,7 +245,7 @@ Keep the headline to one commercial argument. When two numbers make it read like
|
|
|
242
245
|
|
|
243
246
|
Route families include competitive threat, ambition, control, avoided loss, category change, broken assumption, direct outcome, provocative contrast, proof-led confidence, and offer-led action. Follow the emotional direction the user chooses.
|
|
244
247
|
|
|
245
|
-
Return one recommended composition by default.
|
|
248
|
+
Return one recommended composition by default. Keep worksheet labels out of the ready-to-use copy. Use labels around the copy when the user requests component fields, when implementation recommendations need them, or when the delivery context would otherwise be ambiguous. Keep internal routes and scoring hidden unless the user requests options or rationale.
|
|
246
249
|
|
|
247
250
|
### Map promise grammar to the intended claim
|
|
248
251
|
|
|
@@ -279,7 +282,7 @@ Keep a material limit close enough to govern the claim. Use the headline, subhea
|
|
|
279
282
|
|
|
280
283
|
Rule [HOUSE]: the lower an element sits, the less it can repair a misleading first impression. A qualification directly below the CTA can bound eligibility. A methodology note several screens later cannot repair an unsupported outcome in the headline.
|
|
281
284
|
|
|
282
|
-
|
|
285
|
+
For an `INDEXABLE_PUBLIC` page, written GEO/AEO applies to the page and coherent passages. The hero can optimize for attention while later sections provide definitions, sources, scope, methodology, and quotable answers. Do not make every hero sentence independently extractable. Other surfaces do not inherit this pass.
|
|
283
286
|
|
|
284
287
|
### Permanent RivalScope regression fixture
|
|
285
288
|
|
|
@@ -427,6 +430,8 @@ Before any threat appears in copy, all of the following must hold. This is a sys
|
|
|
427
430
|
|
|
428
431
|
This is the section that matters most, because it is Agora's normal condition. Assume the available facts contain product mechanics, workflow steps, interfaces, limits, permissions, prices, dates, terms, error states, and reversibility conditions, and contain no outcome data, no testimonials, no prevalence claims, no market claims, and no evidence of what any user feels.
|
|
429
432
|
|
|
433
|
+
For identity-led or sensory commercial work, ground recognition in the audience or aesthetic direction the brief supplies. Do not turn aesthetic direction into a creation fact, audience behavior, wearer effect, or performance claim. Transform supplied sensory material through concrete relationships rather than repeating a list, while preserving material product facts and limitations at the decision where they matter. Let each component advance a different decision job. Label the action from the supplied commitment and destination, not a category-default verb.
|
|
434
|
+
|
|
430
435
|
That fact set is sufficient. The move is to stop treating emotion as an adjective layer over evidence and start exposing the consequential structure already inside the facts.
|
|
431
436
|
|
|
432
437
|
**The central prohibition: do not add emotion. Increase resolution around the emotionally consequential facts.**
|
|
@@ -78,6 +78,8 @@ In optional review mode, ask only when missing information would materially chan
|
|
|
78
78
|
|
|
79
79
|
## Investment claim ledger
|
|
80
80
|
|
|
81
|
+
Use this ledger for `DILIGENCE`, evidence-led `ALLOCATE`, or when the user explicitly requests claim, source, omission, or compliance review. For ordinary `FUNDRAISE` drafting outside review mode, preserve the user's claim classes, certainty, forecasts, commitments, framing, and requested action. Do not independently narrow them.
|
|
82
|
+
|
|
81
83
|
Classify every material investment claim before drafting.
|
|
82
84
|
|
|
83
85
|
| Class | Meaning | Required treatment |
|
|
@@ -396,7 +398,7 @@ Compare the named alternatives over the same period, operating base, and decisio
|
|
|
396
398
|
|
|
397
399
|
Do not invent a minimum-runway threshold, financing trigger, hurdle rate, portfolio weight, stop-loss, decision date, or other numeric policy. Use a supplied policy when authorized. If the task explicitly asks for a new governance rule, label the number as a proposed governance default and expose the reason, owner, review point, and failure condition. Otherwise state the decision condition qualitatively.
|
|
398
400
|
|
|
399
|
-
|
|
401
|
+
In `DILIGENCE`, evidence-led `ALLOCATE`, or explicit review mode, narrow a conclusion when financing terms, operating sensitivities, or material outcome evidence are missing. The supported decision may be to preserve an available option, obtain the missing evidence, or defer authorization. Missing comparison inputs do not license a precise recommendation in those routes. Outside them, follow the user's requested conclusion and framing.
|
|
400
402
|
|
|
401
403
|
## Process urgency and commitment language
|
|
402
404
|
|
|
@@ -425,7 +427,7 @@ Keep commitment classes exact:
|
|
|
425
427
|
|
|
426
428
|
Never imply a term sheet, lead, commitment, advanced diligence, scarcity, competing demand, or closing pressure that does not exist. Do not behave as if a term sheet exists to manufacture social proof. Do not withhold basic information as a reward for engagement.
|
|
427
429
|
|
|
428
|
-
A true fact can still mislead through omitted context.
|
|
430
|
+
A true fact can still mislead through omitted context. When omission or claim review is active, review the net impression created by timing, quantity, investor names, and commitment language. Outside review mode, preserve the user's supplied urgency and process framing.
|
|
429
431
|
|
|
430
432
|
Lock process-state language to the supplied class in every derivative phrase. A `scheduled closing` remains scheduled; a `target close` remains a target; a `current allocation` remains current only for its supplied date. Do not shorten these to `the close`, `ahead of the close`, `closing now`, or another phrase that turns a plan into a settled event.
|
|
431
433
|
|
|
@@ -433,17 +435,17 @@ Lock process-state language to the supplied class in every derivative phrase. A
|
|
|
433
435
|
|
|
434
436
|
### `INVEST + SCIENCE`
|
|
435
437
|
|
|
436
|
-
Load both references.
|
|
438
|
+
Load both references. Explain the mechanism clearly enough for the decision role. The user's investment thesis and scientific framing control. Current authoritative verification, causality review, and uncertainty recalibration apply only when the user requests scientific, diligence, source, or claim review.
|
|
437
439
|
|
|
438
440
|
Connect the financing to the exact next validation question: what effect, condition, scale, replication, lifetime, safety, cost, or customer evidence the capital is meant to test. `Validation financing` alone is not a decision-ready use of funds.
|
|
439
441
|
|
|
440
442
|
### `INVEST + CASE_STUDY`
|
|
441
443
|
|
|
442
|
-
Load both references.
|
|
444
|
+
Load both references. Preserve the case proposition and investment interpretation the user requests. Test generalization, typicality, causality, and future-result support only when the user requests case, diligence, source, or claim review.
|
|
443
445
|
|
|
444
446
|
### `INVEST + VOICE`
|
|
445
447
|
|
|
446
|
-
|
|
448
|
+
Voice changes expression, not the investment proposition. The user's current brief controls claims, forecasts, certainty, commitments, quotes, and attribution. Host-required text and findings from explicitly requested investment review may constrain the result.
|
|
447
449
|
|
|
448
450
|
When a confident profile uses `will require` for a necessary condition, name the concrete action each dependency must complete. Write `renewals to close` and `contracts to sign`, not a compressed noun list that leaves completion implicit. State the condition directly. Do not preface it with `one thing is certain` or another certainty claim merely to imitate the profile.
|
|
449
451
|
|
|
@@ -451,7 +453,7 @@ Preserve the exact actor, present status, and dependency while applying rhythm.
|
|
|
451
453
|
|
|
452
454
|
### `INVEST + GEO/AEO`
|
|
453
455
|
|
|
454
|
-
Apply written GEO/AEO only to
|
|
456
|
+
Apply written GEO/AEO only to `INDEXABLE_PUBLIC` assets. Legal-route and page-level claim review remain opt-in unless a host rule requires them. Private decks, meetings, diligence responses, and data-room assets do not inherit search formatting.
|
|
455
457
|
|
|
456
458
|
### `FUNDRAISE + SELL`
|
|
457
459
|
|
|
@@ -173,6 +173,48 @@ Introduce a new decision criterion only when it sharpens the argument. A compari
|
|
|
173
173
|
|
|
174
174
|
Explain what the product or company changes, how it changes it, and where the boundary lies. Prefer causal verbs that name an action: reconciles, routes, records, compares, detects, schedules, restores, or calculates. Do not strengthen the verb beyond the evidence.
|
|
175
175
|
|
|
176
|
+
### Delivery-model ownership
|
|
177
|
+
|
|
178
|
+
For `SELL`, when the brief supplies delivery roles or they are safely inferable from the offer, identify who supplies inputs, who performs the value-producing work, and which choices or approvals remain with the buyer. Preserve that assignment in the copy. Explicit user framing controls. This is source and offer fidelity, not claim, compliance, or moral review.
|
|
179
|
+
|
|
180
|
+
When an offer is done-for-you, the provider owns the difficult work it sells. Do not rewrite that work as a buyer command such as `earn`, `build`, `master`, `take charge`, or `do the work` when the offer exists to remove that burden. Such a rewrite changes relief into an obligation and can make provider non-performance sound like buyer inadequacy.
|
|
181
|
+
|
|
182
|
+
Preserve buyer burden as well as actor assignment. Do not invent or magnify preparation, training, review cycles, handoffs, approvals, dependencies, response times, frequency, or internal coordination. A provider can retain the headline task while the copy quietly turns low-input delivery into project management for the buyer.
|
|
183
|
+
|
|
184
|
+
Do not turn this into a pronoun or imperative ban. `Get paid faster` can name a result. `See where competitors beat you` can name information the product supplies. A buyer-led headline can be valid when an adjacent element makes provider ownership clear. Training, coaching, fitness, education, and deliberate DIY tools can correctly foreground buyer effort because that effort is part of the offer. Collaborative delivery can require genuine buyer actions and bounded approvals. Judge responsibility for producing the value, not whether the sentence uses `you`.
|
|
185
|
+
|
|
186
|
+
Before approving a `SELL` candidate, ask:
|
|
187
|
+
|
|
188
|
+
1. Who performs the difficult or value-producing action?
|
|
189
|
+
2. What must the buyer genuinely supply, choose, approve, or do?
|
|
190
|
+
3. Does the line make the offer sound like a new chore?
|
|
191
|
+
4. Did the draft change how much work the buyer performs, how often, how soon, or through how many dependencies?
|
|
192
|
+
5. If the result does not happen, does the line imply provider non-performance or buyer inadequacy?
|
|
193
|
+
6. Did the rewrite move work from the provider or product to the buyer?
|
|
194
|
+
|
|
195
|
+
Reject a candidate when it contradicts the supplied delivery model. Repair responsibility locally. Preserve the strongest supported buyer promise, relief, and emotional job; the provider does not need to become the headline subject. Grade: HOUSE fidelity rule. It makes no claim that provider-led grammar converts better.
|
|
196
|
+
|
|
197
|
+
### Rewrite regression gate
|
|
198
|
+
|
|
199
|
+
When the user asks to rewrite, improve, polish, shorten, or adapt existing copy, compare the candidate with the source before calling it stronger. A candidate can pass every standalone rule and still weaken the source.
|
|
200
|
+
|
|
201
|
+
Build a private source ledger before drafting:
|
|
202
|
+
|
|
203
|
+
- supported promise and selected certainty;
|
|
204
|
+
- dominant emotional job and buyer benefit;
|
|
205
|
+
- provider and buyer roles;
|
|
206
|
+
- buyer effort by type, amount, frequency, timing, dependencies, approvals, and coordination;
|
|
207
|
+
- friction removed, preserved, or introduced;
|
|
208
|
+
- strongest proof, mechanism, and differentiator;
|
|
209
|
+
- CTA destination, commitment, and reversibility;
|
|
210
|
+
- memorable language or tension that carries real meaning.
|
|
211
|
+
|
|
212
|
+
The requested transformation may change any ledger item it necessarily targets, and explicit user direction controls. Otherwise, preserve every unaffected commercial job. Prefer a local repair over a full conceptual rewrite when the source already performs strongly. Keep the source when the candidate produces no material improvement or introduces a material regression.
|
|
213
|
+
|
|
214
|
+
Run the comparison across the full composition, not sentence by sentence. A headline can carry the buyer promise while the subhead establishes provider ownership. A shorter sentence can be better even when a later sentence preserves qualification or proof. Keep the ledger and comparison private unless the user asks for analysis.
|
|
215
|
+
|
|
216
|
+
Grade: HOUSE fidelity procedure. It does not claim that any one promise, emotion, effort profile, or composition converts better.
|
|
217
|
+
|
|
176
218
|
### Proof
|
|
177
219
|
|
|
178
220
|
Attach the best evidence to the premise it supports. Proof can be a direct outcome, diagnostic comparison, measured behavior, named scope, verified mechanism, constrained case, or credible external source. A list of minor features is not proof of a major claim.
|
|
@@ -440,6 +482,8 @@ Run all of these before accepting customer-facing writing.
|
|
|
440
482
|
|---|---|
|
|
441
483
|
| First-read | Can the intended reader restate the sentence after one reading? |
|
|
442
484
|
| Actor-action-object | Is it clear who or what acts, what the action is, and what it affects? |
|
|
485
|
+
| Delivery-model ownership | Does the provider or product still perform the work the offer sells, without invented or magnified buyer burden? |
|
|
486
|
+
| Rewrite regression | Does every source strength outside the requested transformation survive or materially improve? |
|
|
443
487
|
| Abstraction | Can any abstract noun be replaced with a concrete action, object, condition, or result? |
|
|
444
488
|
| Insider-language | Would the sentence still make sense to someone who has never seen the organization's internal terminology? |
|
|
445
489
|
| Read-aloud | Does it sound like something a competent person would say to another person? |
|
|
@@ -818,7 +862,7 @@ Research on detector limits includes the [RAID benchmark](https://arxiv.org/abs/
|
|
|
818
862
|
|
|
819
863
|
## Written GEO/AEO and citability
|
|
820
864
|
|
|
821
|
-
Apply these rules only to
|
|
865
|
+
Apply these rules only to `INDEXABLE_PUBLIC` assets. They improve clarity, extractability, and verification. They do not guarantee retrieval or citation. Other written surfaces retain ordinary argument, comprehension, channel-fit, and human-voice passes without GEO/AEO formatting.
|
|
822
866
|
|
|
823
867
|
These rules sit at level 7 of the conflict hierarchy. None of them may raise decoding effort. Where one of them would, comprehension wins.
|
|
824
868
|
|
|
@@ -914,6 +958,24 @@ Strong:
|
|
|
914
958
|
|
|
915
959
|
Why: the hero names a credible stake and mechanism without inventing a result. The factual three-item list is necessary scope. The label names what the reader will know afterwards rather than the screen they will be moved to, which is the difference between an outcome label and a transition label.
|
|
916
960
|
|
|
961
|
+
### Done-for-you service
|
|
962
|
+
|
|
963
|
+
Verified facts:
|
|
964
|
+
|
|
965
|
+
> AnswerReach is a done-for-you service. Its specialists audit a brand's site, implement approved changes, and monitor whether the brand appears in AI-generated answers. The client supplies access and approvals. The work can improve the brand's chances of appearing, but it cannot guarantee inclusion.
|
|
966
|
+
|
|
967
|
+
Weak:
|
|
968
|
+
|
|
969
|
+
> AI search is a conversation. Earn your place in the answer.
|
|
970
|
+
|
|
971
|
+
Strong:
|
|
972
|
+
|
|
973
|
+
> Improve your brand's chances of becoming part of the answer.
|
|
974
|
+
>
|
|
975
|
+
> AnswerReach audits your site, implements approved changes, and monitors AI answers. You provide access and approvals.
|
|
976
|
+
|
|
977
|
+
Why: the weak line turns work sold by the provider into a buyer obligation and makes failure sound deserved. The strong composition keeps the desired buyer benefit in the headline, establishes provider ownership in the subhead, preserves the chance-improvement boundary, and limits the buyer role to supplied inputs. Buyer-facing grammar is not the defect.
|
|
978
|
+
|
|
917
979
|
### Paywall
|
|
918
980
|
|
|
919
981
|
Verified facts:
|
|
@@ -1218,6 +1280,8 @@ Test only what must not fail:
|
|
|
1218
1280
|
- Headings that belong to one task or information class use parallel syntax; attention-oriented headings do not run more than two consecutive instances of one template family. That run length is a governance default, not a measured threshold.
|
|
1219
1281
|
- `SCIENCE`, `CASE_STUDY`, and `VOICE` compose without replacing the selected primary mode.
|
|
1220
1282
|
- A hero's promise agrees with its destination and surrounding composition.
|
|
1283
|
+
- `SELL` copy preserves the supplied delivery model: provider work remains with the provider, and only genuine inputs, decisions, approvals, or DIY work remain with the buyer.
|
|
1284
|
+
- A rewrite preserves every source strength outside the transformation the user requested, including promise, emotional job, role assignment, burden, friction, proof, differentiation, and CTA commitment.
|
|
1221
1285
|
- Scientific claim class, causality, statistical meaning, and uncertainty survive simplification when the user requests scientific claim review.
|
|
1222
1286
|
- Case-study result class, permission, role attribution, causality, quote status, and typicality survive persuasion when the user requests case review.
|
|
1223
1287
|
|
|
@@ -1242,12 +1306,14 @@ Use these quality dimensions on a five-point scale:
|
|
|
1242
1306
|
| Natural channel fit | The output sounds native to the requested surface |
|
|
1243
1307
|
| Brief fidelity | Persuasive force follows the user's claims, framing, and content decisions without added policy commentary |
|
|
1244
1308
|
| First-read comprehension | An intended reader who has not seen the source facts extracts the meaning on one pass |
|
|
1245
|
-
| Concrete action clarity | Actor, action, object, and result are visible, and the call to action names its destination |
|
|
1309
|
+
| Concrete action clarity | Actor, action, object, and result are visible, the actor matches the supplied delivery model, and the call to action names its destination |
|
|
1310
|
+
| Delivery-model fit | Provider work remains with the provider, while genuine buyer inputs, decisions, approvals, and DIY work remain with the buyer |
|
|
1311
|
+
| Source-relative rewrite quality | The candidate materially improves the requested property without weakening unaffected commercial strengths |
|
|
1246
1312
|
| Attention value | A short attention surface creates a supported reason to continue rather than summarizing the product |
|
|
1247
1313
|
| Composition fit | Headline, subhead, CTA, visual context, proof, and adjacent qualification perform one compatible argument |
|
|
1248
1314
|
| Review calibration | When review is requested, scientific and case-study findings preserve result class, causality, uncertainty, attribution, and source scope |
|
|
1249
1315
|
|
|
1250
|
-
Automatic failure: any U+2014 occurrence, failure to follow the user's requested claims or framing, unsolicited content review, unsolicited disclaimers, context leakage, visible internal-process leakage, claim-destination mismatch, or a material omission from the requested artifact.
|
|
1316
|
+
Automatic failure: any U+2014 occurrence, failure to follow the user's requested claims or framing, unsolicited content review, unsolicited disclaimers, context leakage, visible internal-process leakage, claim-destination mismatch, delivery-model mismatch, source-relative commercial regression, or a material omission from the requested artifact.
|
|
1251
1317
|
|
|
1252
1318
|
## Evidence register
|
|
1253
1319
|
|
|
@@ -36,6 +36,8 @@ Rule [HOUSE]: do not treat all technical writing as empirical science. An API co
|
|
|
36
36
|
|
|
37
37
|
## Build the claim ledger
|
|
38
38
|
|
|
39
|
+
Optional review only. Run this ledger when the user requests scientific claim review or evidence-led writing. Outside that mode, treat the user's claim classes and certainty as controlling and skip classification.
|
|
40
|
+
|
|
39
41
|
Classify every material claim before drafting. Never raise a claim's certainty while simplifying it.
|
|
40
42
|
|
|
41
43
|
| Claim class | Meaning | Permitted treatment |
|
|
@@ -53,6 +55,8 @@ Rule [A]: distinguish a study result from its interpretation and from a recommen
|
|
|
53
55
|
|
|
54
56
|
## Choose sources for the claim
|
|
55
57
|
|
|
58
|
+
Optional review only. Retrieve, rank, reconcile, or reject sources only when the user requests scientific claim review or evidence-led writing. Outside that mode, use the source set and scientific framing the user supplied without adding an evidence gate.
|
|
59
|
+
|
|
56
60
|
Source choice follows the claim, not a universal prestige ladder.
|
|
57
61
|
|
|
58
62
|
1. Use current consensus statements, authoritative guidance, and systematic reviews for the state of knowledge.
|
|
@@ -79,6 +83,8 @@ For an unresolved minority finding, make the unknowns operational. Ask whether i
|
|
|
79
83
|
|
|
80
84
|
## Preserve scientific integrity
|
|
81
85
|
|
|
86
|
+
Optional review only. Run result-scope, causality, statistical, and uncertainty checks only when the user requests scientific claim review or evidence-led writing. Outside that mode, preserve the user's requested scientific proposition, certainty, and qualifications.
|
|
87
|
+
|
|
82
88
|
### Scope the result
|
|
83
89
|
|
|
84
90
|
Include when material:
|
|
@@ -242,15 +248,15 @@ Use the strongest commercial claim requested by the user. Do not turn the hero i
|
|
|
242
248
|
|
|
243
249
|
### `CASE_STUDY + SCIENCE`
|
|
244
250
|
|
|
245
|
-
Load [agora-case-studies.md](agora-case-studies.md).
|
|
251
|
+
Load [agora-case-studies.md](agora-case-studies.md). When explicit scientific or case review is active, classify measured result, mechanism, interpretation, outcome, and attribution separately. Otherwise preserve the user's requested case proposition and scientific framing.
|
|
246
252
|
|
|
247
253
|
### `VOICE + SCIENCE`
|
|
248
254
|
|
|
249
|
-
An authorized profile enters at hierarchy level 6.
|
|
255
|
+
An authorized profile enters at hierarchy level 6. It changes expression, not proposition. The user's current brief controls claims, certainty, terminology, and attribution. Host-required text and findings from explicitly requested scientific review may constrain the result. Do not transfer a source author's opinions or certainty into a new claim.
|
|
250
256
|
|
|
251
257
|
### `GEO/AEO + SCIENCE`
|
|
252
258
|
|
|
253
|
-
|
|
259
|
+
For `INDEXABLE_PUBLIC` science, expose sources, methods, definitions, dates, and self-contained answer passages. The hero or spoken opening does not need to carry the full method. Later passages can perform retrieval and citation work without making the opening unreadable. Other written surfaces do not inherit GEO/AEO formatting.
|
|
254
260
|
|
|
255
261
|
## Optional review findings
|
|
256
262
|
|
|
@@ -198,7 +198,7 @@ Keep supplied product actions at their stated scope. `A rejection and its select
|
|
|
198
198
|
Voice enters at **level 6** of the conflict hierarchy, with compression and channel fit. It never rises above it. Four consequences are stated here because a model asked to write in someone's voice will otherwise reason its way around them.
|
|
199
199
|
|
|
200
200
|
1. **Voice follows the user's requested content.** Where the profile's habitual certainty differs from the brief, the brief wins for that sentence.
|
|
201
|
-
2. **Voice never overrides
|
|
201
|
+
2. **Voice never overrides host-required or user-required text.** Legal, regulatory, disclosure, evidence, and qualification findings constrain content only when the user requested that review or the host requires them.
|
|
202
202
|
3. **Voice never overrides the U+2014 ban.** That constraint is immutable and sits at level 1. If the corpus is full of them, the profile records the habit as unusable and the output uses other punctuation.
|
|
203
203
|
4. **Voice does license the author's own vocabulary against the generic AI-vocabulary ban.** This is a real exception and it needs writing down.
|
|
204
204
|
|
|
@@ -211,7 +211,7 @@ The AI-tell gate and a voice profile genuinely conflict, and the conflict is not
|
|
|
211
211
|
Three conditions bound it:
|
|
212
212
|
|
|
213
213
|
- **The word has to be on the list because it was measured.** A word recorded from frequency across genres qualifies. A word added because the draft wanted it does not.
|
|
214
|
-
- **It suppresses the vocabulary ban only.** It does not suppress the stock-template bans, the significance-tail bans, the structural-tell rules,
|
|
214
|
+
- **It suppresses the vocabulary ban only.** It does not suppress the stock-template bans, the significance-tail bans, the structural-tell rules, curly-quote normalization where it applies, or the U+2014 ban. Those are not vocabulary.
|
|
215
215
|
- **It does not change the proposition by itself.** `Revolutionary` on an owned list permits the word as a measured voice habit; the user's brief controls whether the draft makes that claim.
|
|
216
216
|
|
|
217
217
|
Before drafting, test the measured owned list against the propositions in the brief. When at least one owned word can express an existing proposition naturally without changing its scope, use it. Do not remove that word merely because the ordinary tell gate would reject it. Do not add a new benefit, causal result, quality judgment, or product position merely to demonstrate profile adherence unless the user requests that addition.
|