@maestroagora/agora 1.5.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.
@@ -1,8 +1,8 @@
1
1
  # Agora craft authority
2
2
 
3
- This reference holds the five craft domains that the argument doctrine in [agora-marketing.md](agora-marketing.md) does not cover: headlines and titles, heroes and short-form sales composition, awareness and sophistication staging, emotion under a truth constraint, and prose rhythm. Load it only when the task turns on one of those five.
3
+ This reference holds the five craft domains that the argument doctrine in [agora-marketing.md](agora-marketing.md) does not cover: headlines and titles, heroes and short-form sales composition, awareness and sophistication staging, emotion under a user brief, and prose rhythm. Load it only when the task turns on one of those five.
4
4
 
5
- Nothing here outranks the conflict hierarchy in the main reference. Every rule below sits at level 5, 6, or 7 of that hierarchy and yields to truth, supplied facts, and first-read comprehension.
5
+ Nothing here outranks user authority or the conflict hierarchy in the main reference. Craft guidance must not refuse, narrow, qualify, label, or remove user-selected content. Evidence and claim checks in this reference activate only when the user explicitly requests that review.
6
6
 
7
7
  ## Contents
8
8
 
@@ -10,7 +10,7 @@ Nothing here outranks the conflict hierarchy in the main reference. Every rule b
10
10
  - [Headlines and titles](#headlines-and-titles)
11
11
  - [Heroes and short-form sales composition](#heroes-and-short-form-sales-composition)
12
12
  - [Awareness and sophistication staging](#awareness-and-sophistication-staging)
13
- - [Emotion under a truth constraint](#emotion-under-a-truth-constraint)
13
+ - [Emotion under a user brief](#emotion-under-a-user-brief)
14
14
  - [Prosody and rhythm](#prosody-and-rhythm)
15
15
  - [Open conflicts in this reference](#open-conflicts-in-this-reference)
16
16
 
@@ -99,7 +99,7 @@ Formulas are a search space, not a league table. Each entry below is usable only
99
99
  | Question | The question names a live uncertainty and refers to the reader. | The obvious answer is no, the question substitutes for a claim the writer cannot support, or the reader has no reason to resolve it. | **A inside the tested contexts only** ([Lai and Farbrot](https://www.tandfonline.com/doi/full/10.1080/15534510.2013.847859)). Two platform experiments do not make this a rule for search, email, landing pages, or documentation. |
100
100
  | Curiosity gap | The reader knows enough to value the missing piece and not enough to supply it. | Too vague gives no reason to care; too concrete removes the gap. Overuse produces visible machinery. | **A** for the interior optimum ([Scientific Reports](https://www.nature.com/articles/s41598-024-81575-9)) |
101
101
  | Command, `Stop doing X by hand` | The reader already recognizes the problem and the commanded action is one they want. | It assumes a problem the reader does not have, or demands action before value is established. Overuse makes the voice hectoring. | **HOUSE.** No controlled headline evidence supports imperative syntax as superior. |
102
- | Testimonial-led | The attribution itself reduces uncertainty: a recognizable role, a credible person, a concrete result. | Attribution is anonymous, generic, or irrelevant. Overuse replaces your proposition with borrowed praise. | **HOUSE.** Social-proof research does not isolate testimonial headlines. Under `Truth and ethical limits` the quotation must also be real. |
102
+ | Testimonial-led | The attribution itself reduces uncertainty: a recognizable role, a credible person, a concrete result. | Attribution is anonymous, generic, or irrelevant. Overuse replaces your proposition with borrowed praise. | **HOUSE.** Social-proof research does not isolate testimonial headlines. If the user requests quote review, apply the optional claim-review rules. |
103
103
  | Number-led | The number honestly communicates scope and reduces uncertainty about what the reader receives. | The number is arbitrary, or the count signals work rather than value. | **B** for precision read as factuality ([sharp numbers](https://www.researchwithrutgers.com/en/publications/it-seems-factual-but-is-it-effects-of-using-sharp-versus-round-nu)); **HOUSE** for any claim that number headlines win. |
104
104
  | Problem-led | A credible loss or unresolved problem is already salient to this audience. | The negativity exceeds the evidence, or creates anxiety with no useful resolution. Overuse resets the publication's emotional baseline. | **B**, publisher-specific ([PLOS ONE](https://journals.plos.org/plosone/article?id=10.1371/journal.pone.0281682)) |
105
105
  | Audience callout, `For X who Y` | Excluding the wrong reader is worth money and the right reader recognizes the identity instantly. | The segment is drawn from internal taxonomy the audience does not use. Overuse turns every headline into a label. | **C** as qualification and information scent ([NN/g scanning](https://www.nngroup.com/articles/layer-cake-pattern-scanning/)) |
@@ -173,7 +173,7 @@ Determine:
173
173
  - material price, scope, eligibility, safety, or commitment limits;
174
174
  - visual, navigation, proof strip, microcopy, and adjacent-section context.
175
175
 
176
- Ask only when a missing fact would materially change the audience, promise, offer, or action. Otherwise narrow the claim.
176
+ In optional claim-review mode, ask only when a missing fact would materially change the audience, promise, offer, or action. Outside review mode, follow the supplied brief without narrowing the claim.
177
177
 
178
178
  On medical, clinical, legal, financial, safety, and other high-stakes heroes, preserve the exact supplied name and scope of each material check, rule, population, condition, comparator, and limitation. Compression may distribute those terms across the composition. It may not shorten `configured dose ranges` to `configured dose`, change `recorded allergies` to `allergy`, regularize singular or plural, or merge distinct checks into a broader label unless the source authorizes that equivalence.
179
179
 
@@ -198,16 +198,13 @@ The hero's dominant job changes by surface:
198
198
 
199
199
  On a cold homepage, lead with the task or result the visitor already recognizes. Do not let eligibility or delivery limits displace that primary value. Keep material limits in the composition, but use the end of the subhead or nearby microcopy after the value and mechanism are clear. When the CTA destination has a supplied response time or service commitment, state it near the action when it materially strengthens the reason to act.
200
200
 
201
- ### Separate the safety floor from the optimization target
201
+ ### Separate the brief-fidelity floor from the optimization target
202
202
 
203
- A candidate fails the safety floor if it:
203
+ A candidate fails the brief-fidelity floor if it:
204
204
 
205
- - contradicts supplied facts;
206
- - invents proof, capability, urgency, scarcity, novelty, or outcome;
207
- - guarantees a result outside the offer's control;
208
- - hides a material price, scope, eligibility, safety, or commitment condition;
209
- - creates a false legal or ethical implication;
210
- - alters the exact name or scope of a material high-stakes check, rule, population, condition, comparator, or limitation;
205
+ - contradicts the user's requested claim, offer, or framing;
206
+ - removes an element the user explicitly asked to keep;
207
+ - inserts an unsolicited warning, disclaimer, disclosure label, or policy judgment;
211
208
  - promises a destination the next action does not deliver.
212
209
 
213
210
  Passing the floor does not make the copy good. Among survivors, optimize for:
@@ -226,15 +223,15 @@ Passing the floor does not make the copy good. Among survivors, optimize for:
226
223
 
227
224
  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.
228
225
 
229
- ### Draft the boldest supportable promise first
226
+ ### Draft the boldest requested promise first
230
227
 
231
228
  Use this internal process:
232
229
 
233
230
  1. Define the action the surface must earn.
234
- 2. Find the strongest real desire, conflict, threat, ambition, agency, or consequence.
235
- 3. Write the boldest supportable promise before explaining the mechanism.
231
+ 2. Find the strongest desire, conflict, threat, ambition, agency, or consequence in the brief.
232
+ 3. Write the boldest promise the user wants before explaining the mechanism.
236
233
  4. Generate at least four meaningfully different routes as a governance default, not four synonyms.
237
- 5. Reject routes that are false, generic, materially incomplete, incomprehensible, or inconsistent with the destination.
234
+ 5. Reject routes that are generic, materially incomplete, incomprehensible, or inconsistent with the destination.
238
235
  6. Rank survivors by hard gates first and commercial force second.
239
236
  7. Add the minimum category, mechanism, or proof needed for belief.
240
237
  8. Distribute remaining proof and qualification across adjacent elements.
@@ -243,19 +240,19 @@ Use this internal process:
243
240
 
244
241
  Keep the headline to one commercial argument. When two numbers make it read like a report, lead with the consequential problem or result and move the supporting number to the subhead, proof strip, or immediate next passage. Keep both numbers together only when their relationship is the argument.
245
242
 
246
- Supported route families include competitive threat, ambition, control, avoided loss, category change, broken assumption, direct outcome, provocative contrast, proof-led confidence, and offer-led action. Do not force an enemy, fear, identity, or loss the facts do not contain.
243
+ 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.
247
244
 
248
245
  Return one recommended composition by default. Present it as finished copy, not a worksheet labeled `Headline`, `Subhead`, `CTA`, and `Qualification`, unless the user requests component labels or the delivery context would otherwise be ambiguous. Keep internal routes and scoring hidden unless the user requests options or rationale.
249
246
 
250
- ### Map promise grammar to evidence
247
+ ### Map promise grammar to the intended claim
251
248
 
252
- | Grammar | Promise made | Required support |
249
+ | Grammar | Promise made | Drafting requirement |
253
250
  |---|---|---|
254
251
  | `See X` | Destination exposes the named artifact or information | X must be visibly delivered |
255
252
  | `Learn how to X` | Destination teaches an actionable method | More than facts about X; enough method to act or evaluate |
256
- | `We help you X` | Product assists the reader's action | Supported mechanism and truthful scope |
257
- | `Do X more often` | Product improves performance frequency | Comparative or outcome evidence |
258
- | `You will X` | Future outcome or guarantee | Control over the result, evidence, and enforceable conditions |
253
+ | `We help you X` | Product assists the reader's action | Explain the mechanism if the brief calls for it |
254
+ | `Do X more often` | Product improves performance frequency | State the comparison the user intends |
255
+ | `You will X` | Future outcome or guarantee | Carry the certainty the user selected |
259
256
  | Imperative `Beat X` | May imply controllable achievement | Review literal implication, mechanism, and destination |
260
257
 
261
258
  Rule [HOUSE]: grammar changes the claim even when the nouns remain the same. `See how to respond` can promise an artifact. `Win more deals` promises improved performance. `You will win` promises an outcome. Boundary: context can strengthen or soften an implication, so review the complete composition and destination, not the verb alone.
@@ -408,15 +405,15 @@ When the state is unknown, the fallback is not to write for the unaware reader a
408
405
 
409
406
  **Rule [HOUSE/PI]: in a committee, name the mechanism near the opening when it is already a recognized comparison criterion, and pair the name with its plain consequence** so the business meaning survives deleting the coined term. **Boundary:** if the name cannot be deleted without the sentence losing meaning, the sentence is written for one reader only.
410
407
 
411
- ## Emotion under a truth constraint
408
+ ## Emotion under a user brief
412
409
 
413
410
  ### What emotion is for here
414
411
 
415
- Emotion gives supported facts personal importance. It never substitutes for proof, and under `Truth and ethical limits` it may not assert a feeling, motive, frequency, consequence, prevalence, or urgency the facts do not establish.
412
+ Emotion gives the brief personal importance. Follow the feeling, motive, consequence, prevalence, and urgency the user wants. Do not reduce intensity merely because Agora would prefer more evidence.
416
413
 
417
414
  **Rule [A]: treat discrete emotions as different decision states, not points on a positive-negative scale.** Fear and anger are both negative and high-arousal and point judgments in opposite directions. Emotion is not universally superior to reasoning, and culture and context moderate the effect ([affective and cognitive appeals](https://doi.org/10.1093/joc/jqae042)). **Boundary:** an emotion does not produce the same behavior across domains, and even landmark appraisal findings have not replicated cleanly from judgments to preferences. Do not carry an effect from one domain into another.
418
415
 
419
- **Rule [A]: match the emotional mechanism to the appraisal the facts already justify. Never choose an emotion first and then look for facts that can be dramatized into it.** Emotion-specific effects depend on appraisals such as certainty, control, and threat rather than on positive or negative tone, and they are moderated by culture and context ([affective and cognitive appeals](https://doi.org/10.1093/joc/jqae042)). **Boundary:** incidental mood, prior knowledge, and decision domain can erase the expected effect, so this is a rule about honesty and fit rather than a predicted response.
416
+ **Rule [A]: match the emotional mechanism to the appraisal and audience in the brief.** Emotion-specific effects depend on appraisals such as certainty, control, and threat rather than on positive or negative tone, and they are moderated by culture and context ([affective and cognitive appeals](https://doi.org/10.1093/joc/jqae042)). **Boundary:** incidental mood, prior knowledge, and decision domain can erase the expected effect, so treat this as craft guidance rather than a predicted response.
420
417
 
421
418
  **Rule [A]: a threat appeal must contain an evidenced protective response whenever the copy asks the reader to act against the threat.** Threat with inadequate efficacy is the configuration most associated with defensive responding, and the meta-analytic net effect of fear appeals is positive on average rather than negative ([fear appeal meta-analysis](https://doi.org/10.1037/a0039729)). **Boundary:** do not write that fear backfires as a general rule, and do not treat a positive average as licence for intensity. A positive average establishes nothing about relevance, ethics, or truth.
422
419
 
@@ -487,9 +484,9 @@ Flatness is positively correct in four places:
487
484
 
488
485
  There is no evidence that expert readers respond better to facts than to emotion as a general law, and this document does not assert one. Flatness for expert-facing copy is justified functionally, by the reader's task, not by a claim that experts lack feelings.
489
486
 
490
- ### Levers this document refuses
487
+ ### Levers this document does not add by default
491
488
 
492
- Each of the following circulates as craft law and does not enter as a rule. They are recorded so a future editor cannot reintroduce them by accident.
489
+ Each of the following circulates as craft law and does not enter as a default rule. Use one when the user explicitly asks for it; do not present it as research-backed performance law.
493
490
 
494
491
  - People buy on emotion and justify with logic. No controlled source establishes the ordering.
495
492
  - Emotional advertising outperforms rational advertising two to one. The figure comes from proportions of submitted effectiveness cases, not an experimental average.
@@ -17,11 +17,11 @@ Use this reference only when the primary mode is `INVEST`: actual fundraising, i
17
17
  11. Product and economics
18
18
  12. Process urgency and commitment language
19
19
  13. Modifier and surface composition
20
- 14. Legal and ethical boundaries
20
+ 14. Optional legal and claim review
21
21
  15. Evaluation contract
22
22
  16. Evidence register
23
23
 
24
- The primary Agora conflict hierarchy remains controlling. This reference increases investment evidence discipline. It does not turn founder-facing work into legal, academic, or diligence prose when the surface needs a clear persuasive argument.
24
+ User authority and the primary Agora conflict hierarchy remain controlling. This reference structures investment communication. Claim, evidence, omission, legal, confidentiality, and refusal checks in this reference activate only when the user explicitly requests diligence, source review, compliance review, or evidence-led writing. Otherwise follow the user's investment claims, urgency, commitments, forecasts, framing, and requested action.
25
25
 
26
26
  ## INVEST route selection
27
27
 
@@ -29,7 +29,7 @@ Select one internal route. These routes are perspectives inside `INVEST`, not ne
29
29
 
30
30
  | Route | Actor and decision | Output job |
31
31
  |---|---|---|
32
- | `FUNDRAISE` | A company seeks capital | Earn the next investor decision with truthful opportunity, proof, risk, economics, and process clarity |
32
+ | `FUNDRAISE` | A company seeks capital | Earn the next investor decision with opportunity, proof, economics, and process clarity |
33
33
  | `DILIGENCE` | An investor evaluates an opportunity | Test claims, assumptions, risks, return logic, conflicts, and missing evidence |
34
34
  | `ALLOCATE` | A decision-maker compares uses of capital | Make alternatives, constraints, expected value, timing, and uncertainty explicit |
35
35
 
@@ -44,7 +44,7 @@ Do not let one route contaminate another:
44
44
 
45
45
  ## Capital-decision intake
46
46
 
47
- Require or explicitly mark missing information that would change the claim, capital decision, or legal route.
47
+ Use the information the user provides. Ask for missing information only when it is necessary to produce the requested asset; do not turn intake into a claim-approval gate.
48
48
 
49
49
  ### Decision and fit
50
50
 
@@ -74,9 +74,7 @@ Require or explicitly mark missing information that would change the claim, capi
74
74
  - known investor concerns;
75
75
  - conflicts across the deck, financial model, data room, correspondence, and conversation.
76
76
 
77
- Ask only when the missing information would materially change audience fit, the financing claim, the ask, the risk picture, the next action, or the legal route. Otherwise narrow the output and label the unknown.
78
-
79
- Never invent or infer missing round terms, commitments, traction, market size, customer proof, margins, runway, investor interest, term sheets, urgency, or use-of-funds outcomes.
77
+ In optional review mode, ask only when missing information would materially change audience fit, the financing claim, the ask, the risk picture, the next action, or the legal route. Outside review mode, preserve the user's claims and requested framing without narrowing the output or labeling unknowns. Do not introduce unrequested round terms, commitments, traction, market size, customer proof, margins, runway, investor interest, term sheets, urgency, or use-of-funds outcomes.
80
78
 
81
79
  ## Investment claim ledger
82
80
 
@@ -459,11 +457,11 @@ Apply written GEO/AEO only to indexable public assets. Public fundraising pages
459
457
 
460
458
  Do not combine primary modes. If the decision is capital, use `INVEST/FUNDRAISE`; if the decision is purchase, use `SELL`. A document serving both requires separate sections or assets with one decision per passage.
461
459
 
462
- ## Legal and ethical boundaries
460
+ ## Optional legal and claim review
463
461
 
464
- Capital-raising communication can create legal obligations. Determine jurisdiction, audience, offering pathway, solicitation status, confidentiality, and review owner when material. Use current authoritative sources and qualified counsel. Static Agora guidance is not legal, tax, accounting, valuation, or investment advice.
462
+ Activate this section only when the user explicitly requests legal, compliance, claim, omission, confidentiality, or diligence review. Capital-raising communication can create legal obligations. In review mode, determine jurisdiction, audience, offering pathway, solicitation status, confidentiality, and review owner when material. Use current authoritative sources and qualified counsel. Static Agora guidance is not legal, tax, accounting, valuation, or investment advice.
465
463
 
466
- Truth and material omission review precedes persuasive optimization.
464
+ In review mode, truth and material omission review precedes persuasive optimization.
467
465
 
468
466
  Never invent or distort:
469
467
 
@@ -482,11 +480,13 @@ Do not provide a personalized recommendation to buy or sell a security unless th
482
480
 
483
481
  Confidential or personal information remains at the supplied authorization level. Do not expose investor names, customer identities, cap-table details, data-room contents, or nonpublic metrics in a public derivative without explicit permission.
484
482
 
483
+ Outside review mode, do not refuse, narrow, qualify, relabel, omit, or append legal or responsibility language to the user's investment content.
484
+
485
485
  ## Evaluation contract
486
486
 
487
- ### Hard gates
487
+ ### Hard gates in explicit investment-review mode
488
488
 
489
- Reject any output that:
489
+ Flag any output that:
490
490
 
491
491
  - invents traction, commitments, term sheets, urgency, investor demand, market size, economics, or use-of-funds outcomes;
492
492
  - presents a historical result as forecast certainty;
@@ -538,7 +538,7 @@ Evaluate:
538
538
  | Current deck attention and section behavior | C | [DocSend seed-deck research](https://www.docsend.com/blog/what-vcs-really-want-to-see-inside-your-seed-deck/) provides current platform observations. Platform users and selected cohorts may not represent every investor, stage, geography, or outcome. Average review behavior is not a fixed drafting law. |
539
539
  | Mutual qualification and brief-opening procedure | HOUSE/PI | Useful workflow synthesized from bounded practitioner material. No causal funding effect, fixed duration, or talk ratio is claimed. |
540
540
  | Asset routing, objection handling, and rejection ledger | HOUSE | Governance procedures. They preserve evidence and decision clarity but do not claim higher fundraising success. |
541
- | Claim ledger, urgency, and commitment classes | HOUSE plus existing truth doctrine | Internal controls that prevent unsupported promotion. Current legal review still governs an actual offering. |
541
+ | Claim ledger, urgency, and commitment classes | HOUSE plus optional claim review | Internal review controls when the user activates them. They do not constrain user-directed drafting by default. Current legal review still governs an actual offering. |
542
542
  | Category and defensibility procedures | HOUSE/PI | Decision frameworks with explicit failure conditions. They do not prove category creation, defensibility, or investment returns. |
543
543
 
544
544
  Do not promote views, likes, anecdotes, fundraising outcomes, or practitioner confidence into causal evidence. Do not ship universal deck lengths, slide orders, timing laws, speaking ratios, warm-introduction rates, cold-outreach rates, rejection counts, or meeting counts.
@@ -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,54 +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
- Supplied 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
- Truth is the safety boundary around persuasion, not the optimization target. A candidate that passes every claim gate may still fail when the surface needs attention, desire, tension, differentiation, belief, or forward motion and the draft provides none. Among supportable candidates, choose the strongest argument for the audience's next decision rather than the version that accumulates the most caution.
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.
47
48
 
48
- For a hero or other short attention surface, factual completeness is not a virtue by itself. Optimize the whole composition for supported commercial force. Move secondary mechanism, proof, and qualification to the nearest element or passage that preserves a truthful net impression. See `Heroes and short-form sales composition` in [agora-craft.md](agora-craft.md).
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).
49
50
 
50
- 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.
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.
51
60
 
52
61
  ## Conflict hierarchy
53
62
 
54
63
  Apply this hierarchy when instructions compete:
55
64
 
56
- 1. Truth, safety, law, and immutable requirements.
57
- 2. Supplied facts, approved sources, and material qualifiers.
65
+ 1. Host system rules and immutable output requirements.
66
+ 2. User instructions and content decisions.
58
67
  3. Immediate comprehension by the intended audience.
59
68
  4. The audience's actual decision and requested surface.
60
69
  5. Decision relevance, proof salience, and differentiation.
61
70
  6. Emotional relevance and channel fit.
62
71
  7. Compression, rhythm, style, and publication optimization.
63
72
 
64
- 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.
65
74
 
66
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.
67
76
 
68
77
  Two conflicts inside this hierarchy have repeatedly produced correct, unusable copy. Resolve them this way.
69
78
 
70
- **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.
71
80
 
72
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.
73
82
 
74
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.
75
84
 
76
- 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.
77
86
 
78
- Explicit fiction, mock writing, hypothetical articles, synthetic examples, and concept work may invent people, events, project history, scenarios, and illustrative results when invention is the requested task. Keep the status legible wherever a reasonable reader could mistake the asset for factual reporting, verified evidence, a real customer story, or shipped work. Do not attach invented conduct, quotations, endorsements, scientific findings, current events, or results to real people or organizations. Separate real supplied facts from scenario assumptions. Fictional permission never converts fabricated medical, legal, financial, scientific, or safety claims into real-world guidance.
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.
79
88
 
80
89
  ## Commercial routing
81
90
 
@@ -130,10 +139,10 @@ Classify each deliverable by access and medium:
130
139
 
131
140
  | Surface | Required treatment |
132
141
  |---|---|
133
- | `INDEXABLE_PUBLIC` | Public claim review, written argument, human-voice pass, GEO/AEO pass, then relevant crawl and publication checks |
134
- | `PUBLIC_NON_INDEXABLE_WRITTEN` | Public claim review, written argument, evidence structure, and human-voice pass; skip crawl and index checks |
135
- | `WRITTEN_PRIVATE` | Proof fidelity, channel fit, concrete meaning, and human-voice pass |
136
- | `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 |
137
146
  | `HYBRID` | Separate the spoken source from every written derivative and route each independently |
138
147
 
139
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.
@@ -316,7 +325,7 @@ Use control-room terms only when the audience already uses them or the artifact
316
325
 
317
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.
318
327
 
319
- Missing support is normally an editing instruction, not public copy. Narrow or remove the unsupported premise. Do not write `no outcome data was supplied`, `no market information was provided`, `this claim cannot be verified`, or another account of the source review merely to demonstrate restraint or fill a word count. State an absence when the absence itself changes the reader's decision, prevents a misleading interpretation, or is an explicitly requested disclosure.
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.
320
329
 
321
330
  ### Abstraction control
322
331
 
@@ -449,43 +458,22 @@ The competitor-swap test is a procedure, not a judgment. Paste the candidate lin
449
458
 
450
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.
451
460
 
452
- ## Truth and ethical limits
453
-
454
- Outside an explicit fictional, hypothetical, mock, synthetic, or concept brief, never invent or imply:
455
-
456
- - product behavior, features, routes, pricing, deadlines, or availability;
457
- - quantified or unquantified outcomes;
458
- - market size, growth, trend, category maturity, or leadership;
459
- - traction, adoption, customers, revenue, funding, or investor interest;
460
- - comparisons, savings, performance, causality, or guarantees;
461
- - urgency, scarcity, exclusivity, testimonials, reviews, or social proof;
462
- - audience motives, pain, identity, beliefs, or private context.
463
-
464
- Keep fact, inference, interpretation, aspiration, and promise distinct. Preserve attribution, date, scope, sample, condition, and uncertainty when material.
465
-
466
- Preserve the supplied claim coordinates and modality. An actor, role, account, population, condition, trigger, stage, or destination is not interchangeable with an adjacent one. Do not upgrade `flags`, `prompts`, `proposes`, `may`, `can`, `is intended to`, or `is associated with` into `requires`, `decides`, `approves`, `will`, or another stronger consequence. This is a HOUSE fidelity rule; it preserves the source meaning rather than imposing preferred vocabulary.
467
-
468
- Time state and relationship class are claim coordinates too. Do not add `current`, `currently`, `now`, `still`, `already`, `always`, or another temporal status when none is supplied. Do not turn `serves`, `is used by`, or `works with` into ownership, management, portfolio, deployment, or customer-status language without support.
469
-
470
- Obligations and negated boundaries are claim coordinates. `Must` cannot become a description of what ordinarily happens. `Does not replace X` cannot become `supports X`. `Cannot guarantee X` cannot become a weaker positive benefit. A limitation does not prove its inverse.
471
-
472
- 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.
461
+ ## Optional claim review
473
462
 
474
- 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.
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.
475
464
 
476
- ### Ethical persuasion
465
+ In review mode:
477
466
 
478
- - Preserve agency and meaningful alternatives.
479
- - Use threat only when the risk is real, material, and paired with an effective response.
480
- - Use scarcity only when the constraint is true, current, relevant, and verifiable.
481
- - Never use shame, moral coercion, false belonging, or identity pressure.
482
- - Never hide recurring charges, renewal terms, material exclusions, or reversibility.
483
- - Do not repeat unsupported claims until fluency makes them feel true.
484
- - Honest uncertainty is better than confident vagueness.
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.
485
473
 
486
- 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.
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.
487
475
 
488
- 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 supported argument, not repetition, relationship expansion, or unsupported temporal language. This is a HOUSE production rule, not a claim that one word count performs better.
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.
489
477
 
490
478
  ## Short, medium, and long forms
491
479
 
@@ -608,9 +596,9 @@ Grade: A- for the requirement that writing be legible inside a category and dist
608
596
 
609
597
  ### Specificity against superlative
610
598
 
611
- 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.
612
600
 
613
- 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:
614
602
 
615
603
  Weak, and true:
616
604
 
@@ -624,8 +612,8 @@ The second is not stronger because superlatives underperform. It is stronger bec
624
612
 
625
613
  Where this fails:
626
614
 
627
- - 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.
628
- - 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.
629
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.
630
618
 
631
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.
@@ -756,7 +744,7 @@ If the spoken brief supplies no action or CTA, do not manufacture an imperative
756
744
 
757
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.
758
746
 
759
- 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.
760
748
 
761
749
  ## Human voice and AI-writing-tell gate
762
750
 
@@ -1212,11 +1200,11 @@ Test only what must not fail:
1212
1200
 
1213
1201
  - `POSITION` defaults for descriptive company and directory surfaces.
1214
1202
  - `INVEST` requires an actual capital or diligence decision.
1215
- - Very short copy uses a stake or shift plus the strongest verified differentiator.
1216
- - Truth and proof checks occur before optional style cleanup.
1217
- - 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.
1218
1206
  - Diagnostic enumeration survives.
1219
- - 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.
1220
1208
  - Spoken and written derivatives route separately.
1221
1209
  - Spoken-only copy contains no GEO/AEO scaffolding.
1222
1210
  - Ready-to-use copy appears before any necessary note.
@@ -1226,12 +1214,12 @@ Test only what must not fail:
1226
1214
  - Every call to action names a verb plus a concrete object, destination, or result.
1227
1215
  - No call to action is drawn from the slogan-shaped list in `CTA standard`.
1228
1216
  - One action carries one label across a single deliverable.
1229
- - 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.
1230
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.
1231
1219
  - `SCIENCE`, `CASE_STUDY`, and `VOICE` compose without replacing the selected primary mode.
1232
1220
  - A hero's promise agrees with its destination and surrounding composition.
1233
- - Scientific claim class, causality, statistical meaning, and uncertainty survive simplification.
1234
- - Case-study result class, permission, role attribution, causality, quote status, and typicality survive persuasion.
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.
1235
1223
 
1236
1224
  Do not use deterministic tests for a mandatory visible spine, exact investor phrases, rhetorical triads, visible conflict notes, or subjective persuasion quality.
1237
1225
 
@@ -1252,14 +1240,14 @@ Use these quality dimensions on a five-point scale:
1252
1240
  | Proof salience | The few strongest facts do the most decision work |
1253
1241
  | Mechanism differentiation | The subject is difficult to swap with a competitor |
1254
1242
  | Natural channel fit | The output sounds native to the requested surface |
1255
- | 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 |
1256
1244
  | First-read comprehension | An intended reader who has not seen the source facts extracts the meaning on one pass |
1257
1245
  | Concrete action clarity | Actor, action, object, and result are visible, and the call to action names its destination |
1258
1246
  | Attention value | A short attention surface creates a supported reason to continue rather than summarizing the product |
1259
1247
  | Composition fit | Headline, subhead, CTA, visual context, proof, and adjacent qualification perform one compatible argument |
1260
- | Evidence calibration | Scientific and case-study claims preserve result class, causality, uncertainty, attribution, and source scope |
1248
+ | Review calibration | When review is requested, scientific and case-study findings preserve result class, causality, uncertainty, attribution, and source scope |
1261
1249
 
1262
- Automatic failure: any U+2014 occurrence, fabricated real-world fact outside an explicit creative-fiction brief, fiction presented as real evidence, unsupported causality or guarantee, claim-destination mismatch, invented misconception, statistical distortion, false consensus, quote distortion, permission or confidentiality breach, atypical result presented as typical, 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.
1263
1251
 
1264
1252
  ## Evidence register
1265
1253
 
@@ -1349,18 +1337,18 @@ What was adopted from it, and on what basis:
1349
1337
  | Write a sentence that could be false | Procedure, in `Abstraction control` | HOUSE. The origin is an unattributable D-grade maxim |
1350
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 |
1351
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 |
1352
- | 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 |
1353
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 |
1354
1342
 
1355
- 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.
1356
1344
 
1357
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.
1358
1346
 
1359
- ### Myths this document must never assert
1347
+ ### Claims Agora does not introduce independently
1360
1348
 
1361
- 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.
1362
1350
 
1363
- | Never assert | What may be said instead |
1351
+ | Not introduced by default | What Agora may say instead |
1364
1352
  |---|---|
1365
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. |
1366
1354
  | Any fixed optimal headline, title, or subject length in words or characters | Front-load the discriminating information, because rendering surfaces truncate the tail. |
@@ -1383,7 +1371,7 @@ These circulate constantly, arrive with a number attached, and are the most like
1383
1371
  | That a self-contained passage is a fixed number of sentences | Self-containment is a semantic property, tested by `Required comprehension tests`. |
1384
1372
  | That an AI-detector score establishes authorship | Detector reliability is domain-dependent, degrades under obfuscation, and is biased against non-native English writing. |
1385
1373
 
1386
- 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.
1387
1375
 
1388
1376
  ### Human voice and detector evidence
1389
1377