@maestroagora/agora 1.3.0 → 1.6.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.
@@ -5,6 +5,7 @@ This reference combines the original Agora argument-first doctrine with research
5
5
  ## Contents
6
6
 
7
7
  - [Core doctrine](#core-doctrine)
8
+ - [User authority](#user-authority)
8
9
  - [Conflict hierarchy](#conflict-hierarchy)
9
10
  - [Commercial routing](#commercial-routing)
10
11
  - [Surface routing](#surface-routing)
@@ -12,7 +13,7 @@ This reference combines the original Agora argument-first doctrine with research
12
13
  - [Emotion as consequential meaning](#emotion-as-consequential-meaning)
13
14
  - [Proof salience](#proof-salience)
14
15
  - [Plain language and first-read comprehension](#plain-language-and-first-read-comprehension)
15
- - [Truth and ethical limits](#truth-and-ethical-limits)
16
+ - [Optional claim review](#optional-claim-review)
16
17
  - [Short, medium, and long forms](#short-medium-and-long-forms)
17
18
  - [Channel architecture](#channel-architecture)
18
19
  - [Mechanism and differentiation](#mechanism-and-differentiation)
@@ -28,48 +29,62 @@ This reference combines the original Agora argument-first doctrine with research
28
29
 
29
30
  ## Core doctrine
30
31
 
31
- Build the supportable argument first. Then make it feel consequential through channel-fit emotion, mechanism clarity, and the smallest proof set that reduces the next real uncertainty. Never let wording outrun proof.
32
+ Build the strongest argument the user's brief calls for. Then make it consequential through channel-fit emotion, mechanism clarity, and the smallest detail set that reduces the next real uncertainty.
32
33
 
33
- Agora does not mean "logic instead of emotion." It means deciding what the audience should conclude and why that conclusion is supportable before spending rhetorical energy. Emotion gives supported facts personal importance. Narrative can carry an argument. Neither can replace the argument.
34
+ Agora does not mean "logic instead of emotion." It means deciding what the audience should conclude and why before spending rhetorical energy. Emotion gives the brief personal importance. Narrative can carry an argument. Neither can replace the argument.
34
35
 
35
36
  The working sequence is:
36
37
 
37
38
  1. Identify the real decision and the audience's role in it.
38
- 2. Find the true situation, shift, or blocked job that makes the decision matter.
39
+ 2. Find the situation, shift, or blocked job that makes the decision matter.
39
40
  3. Explain the causal mechanism that changes the situation.
40
- 4. Select the proof that resolves the most expensive live uncertainty.
41
+ 4. Select the detail or reason to believe that resolves the most expensive live uncertainty.
41
42
  5. Interpret the proof in human terms such as relief, control, progress, avoided waste, credible upside, or reduced uncertainty.
42
- 6. Preserve agency and make the next step proportionate to the evidence.
43
+ 6. Make the next step proportionate to the audience and offer.
43
44
 
44
- Verified facts are raw material for premises, not ready-made copy. A draft can be factually correct and still fail if it reads like taxonomy, documentation, or a feature ledger.
45
+ Supplied material is raw material for premises, not ready-made copy. A draft can repeat every input and still fail if it reads like taxonomy, documentation, or a feature ledger.
45
46
 
46
- Persuasion outcomes are not interchangeable. Attention, recall, attitude, intent, behavior, retention, and sales can move differently. Never describe one as if it proves another. Copy can improve a decision path without guaranteeing purchase, investment, citation, conversion, or revenue.
47
+ User direction is the optimization target. Agora follows the user's content decisions and does not independently narrow, qualify, remove, label, or reject requested claims. Choose the strongest argument for the audience's next decision rather than the version that accumulates the most caution.
48
+
49
+ For a hero or other short attention surface, input completeness is not a virtue by itself. Optimize the whole composition for commercial force. Move secondary mechanism, reasons to believe, and requested qualification to the nearest element or passage. See `Heroes and short-form sales composition` in [agora-craft.md](agora-craft.md).
50
+
51
+ Persuasion outcomes are not interchangeable. Attention, recall, attitude, intent, behavior, retention, and sales can move differently. Keep those distinctions when the user requests performance analysis or claim review.
52
+
53
+ ## User authority
54
+
55
+ Agora is a writing system, not a content approval layer. Claims, scenarios, opinions, product statements, commercial positions, fictional elements, attributions, urgency, tone, and framing supplied or requested by the user are author-approved input for the draft.
56
+
57
+ 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.
58
+
59
+ Apply claim, evidence, permission, disclosure, attribution, or compliance review only when the user explicitly requests it. All review instructions elsewhere in this reference and the domain references are conditional on that request. Outside review mode, the user owns content decisions and publication responsibility. Host system rules and provider policies still apply independently of Agora.
47
60
 
48
61
  ## Conflict hierarchy
49
62
 
50
63
  Apply this hierarchy when instructions compete:
51
64
 
52
- 1. Truth, safety, law, and immutable requirements.
53
- 2. Supplied facts, approved sources, and material qualifiers.
65
+ 1. Host system rules and immutable output requirements.
66
+ 2. User instructions and content decisions.
54
67
  3. Immediate comprehension by the intended audience.
55
68
  4. The audience's actual decision and requested surface.
56
69
  5. Decision relevance, proof salience, and differentiation.
57
70
  6. Emotional relevance and channel fit.
58
71
  7. Compression, rhythm, style, and publication optimization.
59
72
 
60
- Higher levels always win. A style cleanup may not delete a material fact. Compression may not turn a bounded claim into certainty. GEO/AEO may not displace the argument. A channel convention may limit tone, but it may not force a false or inert description.
73
+ Higher levels always win. A style cleanup may not delete a user-selected claim. GEO/AEO may not displace the argument. A channel convention may not override the requested tone.
61
74
 
62
75
  Comprehension sits above decision relevance, proof, differentiation, emotion, compression, and citability. Precision that the reader cannot decode is not precision delivered. Copy that is accurate and unreadable has failed.
63
76
 
64
77
  Two conflicts inside this hierarchy have repeatedly produced correct, unusable copy. Resolve them this way.
65
78
 
66
- **Qualification against comprehension.** Level 2 requires preserving source, date, scope, condition, and uncertainty where material. It does not require carrying that qualification set inside every sentence. Qualify at the passage or section level, in a sentence whose job is qualification. A sentence that carries its own scope, condition, and limit inline stops being a sentence and becomes a clause stack, which fails level 3.
79
+ **Qualification against comprehension.** When the user asks for qualification, preserve source, date, scope, condition, and uncertainty at passage level. A sentence that carries its own scope, condition, and limit inline stops being a sentence and becomes a clause stack, which fails level 3.
67
80
 
68
81
  **Citability against comprehension.** `Written GEO/AEO and citability` asks for passages that remain accurate when quoted alone. The unit is the passage, not the sentence. Self-containment is achieved by keeping the passage together, not by compressing a paragraph of context into one self-sufficient clause. No sentence count defines a passage; its size is whatever the claim needs to stay true. When those two rules pull against each other, comprehension wins and the passage carries the context.
69
82
 
70
83
  Level 5 contains its own trap. Differentiation rewards naming the mechanism precisely, and naming the mechanism precisely is how internal method names arrive in customer copy. Precision about what the product does is required. Exposing the name the organization gave that method is not.
71
84
 
72
- Use only source material supplied or approved in the current context. Do not import facts, controls, terminology, or release rules from another project. Examples in this reference are fictional and teach structure only.
85
+ Use only material supplied or approved in the current context. Do not import content decisions, terminology, or release rules from another project. Examples in this reference teach structure only.
86
+
87
+ Explicit fiction, mock writing, hypothetical articles, synthetic examples, and concept work may invent people, events, project history, scenarios, and illustrative results. Label or separate them only when the user asks for that treatment or activates claim review.
73
88
 
74
89
  ## Commercial routing
75
90
 
@@ -92,12 +107,14 @@ Let commercial or investor relevance emerge from those facts. Do not announce it
92
107
 
93
108
  Use `SELL` for marketing, sales, landing pages, ads, product pages, comparisons, email, outreach, upgrades, onboarding, and paywalls.
94
109
 
95
- The job is to connect a live buyer situation to a supported mechanism, make the outcome consequential, reduce the next uncertainty, and offer the correct next action. Do not assume that the strongest action is always a purchase or meeting. A demo, evidence review, reply, trial, comparison, or saved item may be the natural next step.
110
+ The job is to connect a live buyer situation to a supported mechanism, make the outcome consequential, reduce the next uncertainty, and offer the correct next action. Do not assume that the strongest action is always a purchase or meeting. A demo, report review, reply, trial, comparison, or saved item may be the natural next step.
96
111
 
97
112
  ### INVEST
98
113
 
99
114
  Use `INVEST` only for an actual capital decision: a fundraising deck, investor pitch, investment memo, diligence summary, capital-allocation analysis, or fundraising email.
100
115
 
116
+ Route the perspective separately: `FUNDRAISE` for a company seeking capital, `DILIGENCE` for an investor evaluating an opportunity, and `ALLOCATE` for comparing uses of capital. Load `agora-invest.md` for the detailed claim ledger, asset procedures, risk, economics, urgency, and legal boundaries. Founder persuasion must not contaminate diligence or allocation.
117
+
101
118
  The job is to earn investment relevance through:
102
119
 
103
120
  - a consequential change or market timing;
@@ -122,10 +139,10 @@ Classify each deliverable by access and medium:
122
139
 
123
140
  | Surface | Required treatment |
124
141
  |---|---|
125
- | `INDEXABLE_PUBLIC` | Public claim review, written argument, human-voice pass, GEO/AEO pass, then relevant crawl and publication checks |
126
- | `PUBLIC_NON_INDEXABLE_WRITTEN` | Public claim review, written argument, evidence structure, and human-voice pass; skip crawl and index checks |
127
- | `WRITTEN_PRIVATE` | Proof fidelity, channel fit, concrete meaning, and human-voice pass |
128
- | `SPOKEN_ONLY` | Proof fidelity, cadence, breath, timing, listener orientation, and no GEO/AEO formatting |
142
+ | `INDEXABLE_PUBLIC` | Written argument, human-voice pass, GEO/AEO pass, then relevant crawl and publication checks; add claim review only when requested |
143
+ | `PUBLIC_NON_INDEXABLE_WRITTEN` | Written argument and human-voice pass; skip crawl and index checks; add claim review only when requested |
144
+ | `WRITTEN_PRIVATE` | Channel fit, concrete meaning, and human-voice pass; add claim review only when requested |
145
+ | `SPOKEN_ONLY` | Cadence, breath, timing, listener orientation, and no GEO/AEO formatting; add claim review only when requested |
129
146
  | `HYBRID` | Separate the spoken source from every written derivative and route each independently |
130
147
 
131
148
  A private PDF and a public web page can use the same commercial mode but need different publication handling. A video script is spoken. Its title, description, captions, transcript, show notes, and companion page are written derivatives.
@@ -296,6 +313,20 @@ Treat any noun the organization coined as a term the reader has no reason to kno
296
313
 
297
314
  The same rule applies to a distinction the organization finds important. An internal distinction between two of its own concepts is not automatically a distinction the reader needs. If the copy has to teach the distinction before the sentence makes sense, the distinction belongs in a later paragraph or not at all.
298
315
 
316
+ Preserve relationship words that carry the facts. `Consecutive`, `before`, `after`, `only`, `unless`, `scheduled`, `target`, `reported`, and `measured` are not removable qualifiers when they define sequence, status, scope, or certainty. `Three readings` does not preserve `three consecutive readings`; `the close` does not preserve `a scheduled closing`; and a physical-sample route does not satisfy a supplied photo-and-size form flow.
317
+
318
+ ### Keep control-room vocabulary backstage
319
+
320
+ Agora uses internal terms such as `evidence`, `proof`, `verified`, `claim discipline`, `source scope`, and `evidentiary boundary` to run its own checks. Those terms are not the default language of customers. Do not present the control system as the product benefit.
321
+
322
+ For ordinary marketing, product copy, customer stories, fundraising copy, company descriptions, and CTAs, name the concrete object the reader can understand or inspect: a result, finding, number, customer quote, source, report, study, test, demonstration, project record, observed change, or remaining unknown. Translate from the actual material. Do not run a mechanical synonym replacement.
323
+
324
+ Use control-room terms only when the audience already uses them or the artifact requires the distinction, including scientific research, methodology, audit, legal, compliance, diligence, and technical evaluation. Even on those surfaces, choose the concrete object when it says more. `Review the results` identifies an action and object. `Review the evidence` often makes the reader translate an internal category before acting.
325
+
326
+ This rule does not weaken verification. It separates work Agora performs backstage from language the reader sees. A customer-facing line fails the first-read gate when it foregrounds the checking system instead of the reader's problem, result, source, decision, or next action.
327
+
328
+ Source review stays backstage unless the user asks to expose it. Do not narrow or remove a user-selected claim because Agora considers its support incomplete. Do not write `no outcome data was supplied`, `no market information was provided`, `this claim cannot be verified`, or another account of source review unless the user requests that note.
329
+
299
330
  ### Abstraction control
300
331
 
301
332
  Abstract nouns are not banned. They fail when they conceal something the reader needs.
@@ -427,35 +458,22 @@ The competitor-swap test is a procedure, not a judgment. Paste the candidate lin
427
458
 
428
459
  Where the search-paste test fails: a long, specific, or newly published line returns nothing, and a zero-result search is not evidence that the line is good. The test detects borrowed language, not weak language, and it cannot run at all on a sentence built from supplied facts. Fall back to the literal-meaning and falsifiability tests there. Grade: HOUSE procedure. The maxim behind it is practitioner folklore at Grade D and is not asserted as a finding.
429
460
 
430
- ## Truth and ethical limits
461
+ ## Optional claim review
431
462
 
432
- Never invent or imply:
463
+ Activate this section only when the user explicitly requests fact checking, source review, claim substantiation, due diligence, compliance review, permission review, or evidence-led writing. It is not a default output filter.
433
464
 
434
- - product behavior, features, routes, pricing, deadlines, or availability;
435
- - quantified or unquantified outcomes;
436
- - market size, growth, trend, category maturity, or leadership;
437
- - traction, adoption, customers, revenue, funding, or investor interest;
438
- - comparisons, savings, performance, causality, or guarantees;
439
- - urgency, scarcity, exclusivity, testimonials, reviews, or social proof;
440
- - audience motives, pain, identity, beliefs, or private context.
465
+ In review mode:
441
466
 
442
- Keep fact, inference, interpretation, aspiration, and promise distinct. Preserve attribution, date, scope, sample, condition, and uncertainty when material.
467
+ - distinguish fact, inference, interpretation, aspiration, and promise;
468
+ - preserve attribution, date, scope, sample, condition, and uncertainty where the requested review makes them material;
469
+ - identify unsupported or internally inconsistent claims as editorial findings;
470
+ - state which source or assumption each finding depends on;
471
+ - apply the remedy the user requests, such as qualify, rewrite, remove, source, or leave unchanged;
472
+ - keep findings descriptive and free of moral judgment.
443
473
 
444
- Treat words such as `growing`, `rising`, `emerging`, `established`, `leading`, `fastest`, `best`, `crowded`, `large`, `accelerating`, or `surging` as claims. A future aspiration may be ambitious, but it must be labeled as future-facing and supported by a plausible present mechanism.
474
+ Outside review mode, do not run these checks, narrow claims, demand proof, add disclosure labels, refuse content, or append responsibility language. Treat user-supplied claims and requested framing as approved writing inputs.
445
475
 
446
- Do not convert an observed task issue into financial loss, legal exposure, compliance failure, reputational damage, or market risk without evidence. Do not convert crawler access, schema, publication, observed mentions, or content changes into promises of retrieval, citation, ranking, recommendation, conversion, or revenue.
447
-
448
- ### Ethical persuasion
449
-
450
- - Preserve agency and meaningful alternatives.
451
- - Use threat only when the risk is real, material, and paired with an effective response.
452
- - Use scarcity only when the constraint is true, current, relevant, and verifiable.
453
- - Never use shame, moral coercion, false belonging, or identity pressure.
454
- - Never hide recurring charges, renewal terms, material exclusions, or reversibility.
455
- - Do not repeat unsupported claims until fluency makes them feel true.
456
- - Honest uncertainty is better than confident vagueness.
457
-
458
- If proof is missing, narrow or omit the premise. Add a concise blocker note only when omission would make the delivered asset misleading, legally unusable, or operationally unshippable. Do not append generic release notes or internal claim-review commentary.
476
+ When the user requires an exact word count or bounded range, count the finished asset after removing Markdown syntax. Follow a supplied channel convention; otherwise count whitespace-delimited lexical tokens and treat a hyphenated compound as one word. Verify with a counter when one is available. Make an exact count exact and keep a range inside both bounds. An exact count is not a maximum; returning fewer words is a constraint failure. Meet the budget through useful argument, not repetition. This is a HOUSE production rule, not a claim that one word count performs better.
459
477
 
460
478
  ## Short, medium, and long forms
461
479
 
@@ -465,6 +483,10 @@ Length is a channel constraint, not a persuasion doctrine. The three word counts
465
483
 
466
484
  Use a compelling market shift, felt stake, live consequence, or verified trigger condition plus the strongest verified mechanism or differentiator. When no outcome evidence exists, use the exact condition the product acts on. Do not retreat to a feature list. Compress the mechanism into the differentiator when syntax permits. Do not force objection handling, a full proof stack, a decision criterion, or visible investor relevance.
467
485
 
486
+ In a short bounded company description, give each sentence a distinct job. Use category orientation once and mechanism once. Do not add a final sentence that merely restates the actor, classification fields, or routing relation to satisfy the length floor.
487
+
488
+ When a mechanism uses two or more named input fields, name the fields once. Refer to `the pair`, `the combination`, or the resulting assignment afterward instead of repeating every field name.
489
+
468
490
  For a hard character limit, count characters exactly. Preserve the strongest fact, not the greatest number of facts.
469
491
 
470
492
  ### Medium: about 36 to 120 words (governance default)
@@ -483,6 +505,8 @@ Short forms are compressed decisions, not miniature essays. Long forms are not p
483
505
 
484
506
  Assume low context and fragile attention. Name one recognizable situation or stake. Show one meaningful difference. Offer one dominant next step unless the surface is explicitly a branching flow.
485
507
 
508
+ State a material fit or exclusion boundary in a complete sentence with its subject and condition. Do not compress it into an orphan fragment merely to keep the first screen short.
509
+
486
510
  Give the reader a category they already own before or inside the first differentiating claim, then say what is different about this one. See `Mechanism and differentiation > Orientation against taxonomy`. Do not open with a product taxonomy, a classification tree, or an all-in-one claim.
487
511
 
488
512
  ### Product pages
@@ -572,9 +596,9 @@ Grade: A- for the requirement that writing be legible inside a category and dist
572
596
 
573
597
  ### Specificity against superlative
574
598
 
575
- Given a supported specific and an unsupported superlative that point at the same fact, ship the specific.
599
+ Given a specific and a superlative that point at the same fact, prefer the specific when it communicates more useful meaning. Preserve the superlative when the user selects it.
576
600
 
577
- A superlative is a rank claim. `Fastest`, `most accurate`, `leading`, `best-in-class`, and `number one` assert a position against a field, so under `Truth and ethical limits` they need field evidence and a stated basis before they can be written at all. The checkable fact usually says more and costs less:
601
+ A superlative is a rank claim. `Fastest`, `most accurate`, `leading`, `best-in-class`, and `number one` assert a position against a field. During optional claim review, assess field evidence and the stated basis. Outside review mode, use the user's selected rank language without adding a support warning. A checkable specific often says more and costs less:
578
602
 
579
603
  Weak, and true:
580
604
 
@@ -588,8 +612,8 @@ The second is not stronger because superlatives underperform. It is stronger bec
588
612
 
589
613
  Where this fails:
590
614
 
591
- - A specific is only stronger when it is supplied and verified. Never manufacture a number to escape a superlative. Narrow the claim or drop it.
592
- - A superlative with a stated basis, a date, and a publishable source is a claim like any other and may be used. The rule is about unsupported rank claims, not about the grammatical form.
615
+ - A specific is only stronger when it communicates the intended meaning. Do not introduce an unrequested number merely to escape a superlative.
616
+ - In review mode, a superlative with a stated basis, a date, and a publishable source is assessed like any other claim. Outside review mode, the user's wording controls.
593
617
  - Precision has a cost. A specific that is accurate but irrelevant to the decision is worse than a general statement that is relevant. Rank by decision relevance first, then by specificity.
594
618
 
595
619
  Grade: HOUSE, resting on the truth rules above it. Do not assert that superlatives destroy credibility or that specifics convert better. The practitioner source for this pair asserts both and measured neither.
@@ -615,7 +639,11 @@ Every CTA tells the reader what will happen after they select it. The working sh
615
639
 
616
640
  `clear verb + concrete object, destination, or result`
617
641
 
618
- Workable labels name the thing on the other side: `View the report`, `Compare plans`, `Check eligibility`, `See the recommended fixes`, `Review the evidence`, `Book a product demo`, `Start the assessment`, `Download the guide`, `Contact the sales team`, `Retry the payment`.
642
+ Workable labels name the thing on the other side: `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`, `Retry the payment`.
643
+
644
+ When a working destination is supplied but its literal URL is not, return the action label as copy. Do not invent `#`, `example.com`, a route, or a dummy href. Destination fidelity governs the claim; fabricating link syntax does not make a CTA more complete.
645
+
646
+ Return a CTA label as plain copy unless the user requests markup or supplies the destination URL. Do not wrap a label in square brackets without a destination; bracket-only text reads as an unresolved link rather than a ready control.
619
647
 
620
648
  Name the outcome the reader ends up with, not the motion the interface performs. A label that describes what the product will display is weaker than one that describes what the reader will then have. Prefer the artifact or answer over the transition to it.
621
649
 
@@ -671,10 +699,14 @@ Grade: HOUSE procedure, from a practitioner teardown at Grade C with no method r
671
699
 
672
700
  If the destination is a form, the label should imply a form. If the destination is a document, the label should name the document. If the action begins a paid commitment, the label should not read like a preview.
673
701
 
702
+ When the brief names a destination artifact, surface, or state such as a sample dashboard, report, study, form, or preview, preserve that name in the CTA or adjacent microcopy. Do not replace the named destination with only the contents it displays. `View captured changes` leaves out a supplied sample-dashboard state; `View the sample dashboard` tells the reader what opens. This is destination fidelity, not a preferred phrase.
703
+
704
+ Match the route as well as the destination. When the supplied action begins with a form, upload, comparison, trial, reply, sample request, or physical delivery, do not substitute another available path. Two routes can lead to the same organization while asking different things from the reader.
705
+
674
706
  ### Match commitment to readiness and to destination
675
707
 
676
708
  - Early attention: learn, compare, see, review, or save.
677
- - Active evaluation: inspect evidence, try a workflow, calculate fit, or ask a focused question.
709
+ - Active evaluation: review results, inspect the source material, try a workflow, calculate fit, or ask a focused question.
678
710
  - Ready action: start, buy, subscribe, book, submit, or upgrade.
679
711
  - Utility: continue, return, restore, confirm, cancel, or retry.
680
712
 
@@ -704,9 +736,15 @@ Spoken copy is heard once in sequence. Optimize for breath, rhythm, memory, and
704
736
  - Omit implementation-status facts such as route availability unless the listener is asked to act on that route.
705
737
  - End on one supported consequence, decision, or form of agency rather than a product-status sentence or a stack of adjacent action verbs.
706
738
 
739
+ Do not restate the opening situation in the close. Once the mechanism and evidence have answered the opening, use the final line for the supported inspection, decision, or next action.
740
+
741
+ Do not invent what the listener currently does, remembers, believes, or struggles with to create a closing beat. Agency must come from the supplied action or evidence.
742
+
743
+ If the spoken brief supplies no action or CTA, do not manufacture an imperative close. End after the supported mechanism, evidence, or consequence instead of stacking viewing commands.
744
+
707
745
  For hybrid work, write the script for listening. Build titles, descriptions, captions, transcripts, show notes, and companion pages as separate written assets. Rank facts separately for each asset. Do not force every supplied fact into both. Omit low-salience implementation status and internal workflow labels when a plain action carries the meaning.
708
746
 
709
- Treat an existence-only route, screen, page, preview, or report as action availability when the brief supplies no differentiated function for it. Express that availability through the CTA or final invitation. Do not turn it into a body-copy claim.
747
+ Treat an existence-only route, screen, page, preview, or report as action availability when the brief supplies no differentiated function for it. Express that availability through the CTA or final invitation unless the user wants it emphasized in body copy.
710
748
 
711
749
  ## Human voice and AI-writing-tell gate
712
750
 
@@ -794,6 +832,8 @@ These rules sit at level 7 of the conflict hierarchy. None of them may raise dec
794
832
  - Keep visible and machine-readable facts consistent.
795
833
  - Preserve necessary enumerations when they define a product, comparison, or scope.
796
834
 
835
+ Treat search, retrieval, and citation quality as properties of the page and coherent passages. A hero may optimize for human attention while the following sections carry explicit definitions, proof, scope, sources, and quotable answers. Do not force article-style self-containment into every first-screen sentence.
836
+
797
837
  Do not stuff keywords, write miniature conclusions under every heading, fragment prose for imagined answer engines, or add unsupported statistics for apparent authority.
798
838
 
799
839
  ## Technical publication boundaries
@@ -1160,11 +1200,11 @@ Test only what must not fail:
1160
1200
 
1161
1201
  - `POSITION` defaults for descriptive company and directory surfaces.
1162
1202
  - `INVEST` requires an actual capital or diligence decision.
1163
- - Very short copy uses a stake or shift plus the strongest verified differentiator.
1164
- - Truth and proof checks occur before optional style cleanup.
1165
- - Unsupported facts and causal links never appear.
1203
+ - Very short copy uses a stake or shift plus the strongest differentiator in the brief.
1204
+ - User-selected claims and framing survive style cleanup.
1205
+ - Claim review runs only when the user requests it.
1166
1206
  - Diagnostic enumeration survives.
1167
- - Compliance and internal process remain silent unless a material blocker exists.
1207
+ - Policy, compliance, and internal process remain silent unless the user requests them or a host rule blocks the task.
1168
1208
  - Spoken and written derivatives route separately.
1169
1209
  - Spoken-only copy contains no GEO/AEO scaffolding.
1170
1210
  - Ready-to-use copy appears before any necessary note.
@@ -1174,8 +1214,12 @@ Test only what must not fail:
1174
1214
  - Every call to action names a verb plus a concrete object, destination, or result.
1175
1215
  - No call to action is drawn from the slogan-shaped list in `CTA standard`.
1176
1216
  - One action carries one label across a single deliverable.
1177
- - Material qualifiers survive, and they appear in their own sentences rather than inside the claim sentence.
1217
+ - User-required qualifiers survive, and they appear in their own sentences rather than inside the claim sentence.
1178
1218
  - 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
+ - `SCIENCE`, `CASE_STUDY`, and `VOICE` compose without replacing the selected primary mode.
1220
+ - A hero's promise agrees with its destination and surrounding composition.
1221
+ - Scientific claim class, causality, statistical meaning, and uncertainty survive simplification when the user requests scientific claim review.
1222
+ - Case-study result class, permission, role attribution, causality, quote status, and typicality survive persuasion when the user requests case review.
1179
1223
 
1180
1224
  Do not use deterministic tests for a mandatory visible spine, exact investor phrases, rhetorical triads, visible conflict notes, or subjective persuasion quality.
1181
1225
 
@@ -1196,11 +1240,14 @@ Use these quality dimensions on a five-point scale:
1196
1240
  | Proof salience | The few strongest facts do the most decision work |
1197
1241
  | Mechanism differentiation | The subject is difficult to swap with a competitor |
1198
1242
  | Natural channel fit | The output sounds native to the requested surface |
1199
- | Truth discipline | Persuasive force reaches the evidence boundary without crossing it |
1243
+ | Brief fidelity | Persuasive force follows the user's claims, framing, and content decisions without added policy commentary |
1200
1244
  | First-read comprehension | An intended reader who has not seen the source facts extracts the meaning on one pass |
1201
1245
  | Concrete action clarity | Actor, action, object, and result are visible, and the call to action names its destination |
1246
+ | Attention value | A short attention surface creates a supported reason to continue rather than summarizing the product |
1247
+ | Composition fit | Headline, subhead, CTA, visual context, proof, and adjacent qualification perform one compatible argument |
1248
+ | Review calibration | When review is requested, scientific and case-study findings preserve result class, causality, uncertainty, attribution, and source scope |
1202
1249
 
1203
- Automatic failure: any U+2014 occurrence, fabricated fact, unsupported causality, context leakage, visible compliance leakage, or a material omission that makes the result misleading.
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.
1204
1251
 
1205
1252
  ## Evidence register
1206
1253
 
@@ -1290,18 +1337,18 @@ What was adopted from it, and on what basis:
1290
1337
  | Write a sentence that could be false | Procedure, in `Abstraction control` | HOUSE. The origin is an unattributable D-grade maxim |
1291
1338
  | Objection-built microcopy under a control | Procedure, in `CTA standard > Microcopy under the control` | HOUSE, alongside the link-purpose evidence that supports the label rules |
1292
1339
  | A team's boredom with its own copy is not a defect | Warning, in `Corpus-level variance` | HOUSE. Practitioner observation at C, no method |
1293
- | Prefer a checkable specific to an unsupported superlative | Rule, in `Specificity against superlative` | HOUSE, resting on the truth rules. The practitioner claim that superlatives destroy credibility is D and is not asserted |
1340
+ | Prefer a checkable specific to a superlative when it communicates more useful meaning | Rule, in `Specificity against superlative` | HOUSE. Optional claim review can assess rank support. The practitioner claim that superlatives destroy credibility is D and is not asserted |
1294
1341
  | An over-narrow control label excludes readers it did not name | Boundary, in `The required shape` | HOUSE. One teardown, Grade D, no effect claimed |
1295
1342
 
1296
- What was refused and stays refused: every vendor-reported split-test figure in that pass, the claim that one CTA wording doubles conversions, the claim that superlatives destroy credibility, the rule that a comma signals a sentence needing to be broken, the read-aloud-in-a-false-accent variant, the customer-interview count offered as a sufficiency threshold, and category creation as a strategy. None of these may be written as a rule here.
1343
+ What was not adopted as Agora doctrine: every vendor-reported split-test figure in that pass, the claim that one CTA wording doubles conversions, the claim that superlatives destroy credibility, the rule that a comma signals a sentence needing to be broken, the read-aloud-in-a-false-accent variant, the customer-interview count offered as a sufficiency threshold, and category creation as a strategy. Agora does not introduce these as universal rules. User-selected content remains controlling.
1297
1344
 
1298
1345
  Two conflicts from that pass are open and stay open. Practitioners in the pass reject question-form subheadings outright, while a direct observation in this project found question headings reading better than abstract noun-stack statement headings on the same page; the untested hypothesis is that questions beat noun stacks and lose to concrete answers. Separately, the practitioner position favouring uniformly short, choppy sentences on scanned commercial surfaces conflicts with the sentence-length variance targets from the research pass. Neither side of either conflict is graded above D. Do not resolve either by writing a rule.
1299
1346
 
1300
- ### Myths this document must never assert
1347
+ ### Claims Agora does not introduce independently
1301
1348
 
1302
- These circulate constantly, arrive with a number attached, and are the most likely things a future editor reintroduces by accident. None of them may be written as a rule here, in any reference, or in generated copy. Each is refused because the popular form has no method behind it, not because the underlying idea is worthless; the surviving narrow form, where one exists, is named.
1349
+ These circulate constantly and often arrive with a number attached. Agora does not independently introduce them as universal rules. When the user supplies or requests one, preserve it outside review mode. In optional review mode, report the source limitation without rewriting the user's content unless requested.
1303
1350
 
1304
- | Never assert | What may be said instead |
1351
+ | Not introduced by default | What Agora may say instead |
1305
1352
  |---|---|
1306
1353
  | A fixed share of readers reads the headline and not the body, in any ratio | Nothing. No sampling frame or study travels with any version of it. |
1307
1354
  | Any fixed optimal headline, title, or subject length in words or characters | Front-load the discriminating information, because rendering surfaces truncate the tail. |
@@ -1324,7 +1371,7 @@ These circulate constantly, arrive with a number attached, and are the most like
1324
1371
  | That a self-contained passage is a fixed number of sentences | Self-containment is a semantic property, tested by `Required comprehension tests`. |
1325
1372
  | That an AI-detector score establishes authorship | Detector reliability is domain-dependent, degrades under obfuscation, and is biased against non-native English writing. |
1326
1373
 
1327
- The full block list, with lineage and adjudication for each entry, is maintained outside the published skill. Before adding any rule that sounds familiar, check it there first.
1374
+ The full reference list, with lineage and adjudication for each entry, is maintained outside the published skill. Before Agora introduces any universal rule independently, check it there first. User-selected claims remain controlling.
1328
1375
 
1329
1376
  ### Human voice and detector evidence
1330
1377