@maestroagora/agora 1.5.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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,12 +74,12 @@ 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
 
81
+ Use this ledger for `DILIGENCE`, evidence-led `ALLOCATE`, or when the user explicitly requests claim, source, omission, or compliance review. For ordinary `FUNDRAISE` drafting outside review mode, preserve the user's claim classes, certainty, forecasts, commitments, framing, and requested action. Do not independently narrow them.
82
+
83
83
  Classify every material investment claim before drafting.
84
84
 
85
85
  | Class | Meaning | Required treatment |
@@ -398,7 +398,7 @@ Compare the named alternatives over the same period, operating base, and decisio
398
398
 
399
399
  Do not invent a minimum-runway threshold, financing trigger, hurdle rate, portfolio weight, stop-loss, decision date, or other numeric policy. Use a supplied policy when authorized. If the task explicitly asks for a new governance rule, label the number as a proposed governance default and expose the reason, owner, review point, and failure condition. Otherwise state the decision condition qualitatively.
400
400
 
401
- When financing terms, operating sensitivities, or material outcome evidence are missing, narrow the conclusion. The supported decision may be to preserve an available option, obtain the missing evidence, or defer authorization. Missing comparison inputs do not license a precise recommendation.
401
+ In `DILIGENCE`, evidence-led `ALLOCATE`, or explicit review mode, narrow a conclusion when financing terms, operating sensitivities, or material outcome evidence are missing. The supported decision may be to preserve an available option, obtain the missing evidence, or defer authorization. Missing comparison inputs do not license a precise recommendation in those routes. Outside them, follow the user's requested conclusion and framing.
402
402
 
403
403
  ## Process urgency and commitment language
404
404
 
@@ -427,7 +427,7 @@ Keep commitment classes exact:
427
427
 
428
428
  Never imply a term sheet, lead, commitment, advanced diligence, scarcity, competing demand, or closing pressure that does not exist. Do not behave as if a term sheet exists to manufacture social proof. Do not withhold basic information as a reward for engagement.
429
429
 
430
- A true fact can still mislead through omitted context. Review the net impression created by timing, quantity, investor names, and commitment language.
430
+ A true fact can still mislead through omitted context. When omission or claim review is active, review the net impression created by timing, quantity, investor names, and commitment language. Outside review mode, preserve the user's supplied urgency and process framing.
431
431
 
432
432
  Lock process-state language to the supplied class in every derivative phrase. A `scheduled closing` remains scheduled; a `target close` remains a target; a `current allocation` remains current only for its supplied date. Do not shorten these to `the close`, `ahead of the close`, `closing now`, or another phrase that turns a plan into a settled event.
433
433
 
@@ -435,17 +435,17 @@ Lock process-state language to the supplied class in every derivative phrase. A
435
435
 
436
436
  ### `INVEST + SCIENCE`
437
437
 
438
- Load both references. Scientific and technical uncertainty, current authoritative verification, calibrated causality, and exact terminology override investment vision language. Explain the mechanism clearly enough for the decision role. Do not convert technical possibility into product readiness, regulatory clearance, customer demand, or commercial scale.
438
+ Load both references. Explain the mechanism clearly enough for the decision role. The user's investment thesis and scientific framing control. Current authoritative verification, causality review, and uncertainty recalibration apply only when the user requests scientific, diligence, source, or claim review.
439
439
 
440
440
  Connect the financing to the exact next validation question: what effect, condition, scale, replication, lifetime, safety, cost, or customer evidence the capital is meant to test. `Validation financing` alone is not a decision-ready use of funds.
441
441
 
442
442
  ### `INVEST + CASE_STUDY`
443
443
 
444
- Load both references. A customer case remains evidence about its stated subject, period, intervention, and measurement. It is not proof of general market performance, typicality, causal product impact, or future company results unless the evidence separately supports those claims.
444
+ Load both references. Preserve the case proposition and investment interpretation the user requests. Test generalization, typicality, causality, and future-result support only when the user requests case, diligence, source, or claim review.
445
445
 
446
446
  ### `INVEST + VOICE`
447
447
 
448
- Financial evidence, forecast classification, required disclosure, quote fidelity, and uncertainty override habitual certainty, bravado, compression, or informality in the profile.
448
+ Voice changes expression, not the investment proposition. The user's current brief controls claims, forecasts, certainty, commitments, quotes, and attribution. Host-required text and findings from explicitly requested investment review may constrain the result.
449
449
 
450
450
  When a confident profile uses `will require` for a necessary condition, name the concrete action each dependency must complete. Write `renewals to close` and `contracts to sign`, not a compressed noun list that leaves completion implicit. State the condition directly. Do not preface it with `one thing is certain` or another certainty claim merely to imitate the profile.
451
451
 
@@ -453,17 +453,17 @@ Preserve the exact actor, present status, and dependency while applying rhythm.
453
453
 
454
454
  ### `INVEST + GEO/AEO`
455
455
 
456
- Apply written GEO/AEO only to indexable public assets. Public fundraising pages require current legal-route and page-level claim review. Private decks, meetings, diligence responses, and data-room assets do not inherit search formatting.
456
+ Apply written GEO/AEO only to `INDEXABLE_PUBLIC` assets. Legal-route and page-level claim review remain opt-in unless a host rule requires them. Private decks, meetings, diligence responses, and data-room assets do not inherit search formatting.
457
457
 
458
458
  ### `FUNDRAISE + SELL`
459
459
 
460
460
  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
461
 
462
- ## Legal and ethical boundaries
462
+ ## Optional legal and claim review
463
463
 
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.
464
+ 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
465
 
466
- Truth and material omission review precedes persuasive optimization.
466
+ In review mode, truth and material omission review precedes persuasive optimization.
467
467
 
468
468
  Never invent or distort:
469
469
 
@@ -482,11 +482,13 @@ Do not provide a personalized recommendation to buy or sell a security unless th
482
482
 
483
483
  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
484
 
485
+ Outside review mode, do not refuse, narrow, qualify, relabel, omit, or append legal or responsibility language to the user's investment content.
486
+
485
487
  ## Evaluation contract
486
488
 
487
- ### Hard gates
489
+ ### Hard gates in explicit investment-review mode
488
490
 
489
- Reject any output that:
491
+ Flag any output that:
490
492
 
491
493
  - invents traction, commitments, term sheets, urgency, investor demand, market size, economics, or use-of-funds outcomes;
492
494
  - presents a historical result as forecast certainty;
@@ -538,7 +540,7 @@ Evaluate:
538
540
  | 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
541
  | 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
542
  | 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. |
543
+ | 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
544
  | Category and defensibility procedures | HOUSE/PI | Decision frameworks with explicit failure conditions. They do not prove category creation, defensibility, or investment returns. |
543
545
 
544
546
  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.
@@ -164,6 +173,48 @@ Introduce a new decision criterion only when it sharpens the argument. A compari
164
173
 
165
174
  Explain what the product or company changes, how it changes it, and where the boundary lies. Prefer causal verbs that name an action: reconciles, routes, records, compares, detects, schedules, restores, or calculates. Do not strengthen the verb beyond the evidence.
166
175
 
176
+ ### Delivery-model ownership
177
+
178
+ For `SELL`, when the brief supplies delivery roles or they are safely inferable from the offer, identify who supplies inputs, who performs the value-producing work, and which choices or approvals remain with the buyer. Preserve that assignment in the copy. Explicit user framing controls. This is source and offer fidelity, not claim, compliance, or moral review.
179
+
180
+ When an offer is done-for-you, the provider owns the difficult work it sells. Do not rewrite that work as a buyer command such as `earn`, `build`, `master`, `take charge`, or `do the work` when the offer exists to remove that burden. Such a rewrite changes relief into an obligation and can make provider non-performance sound like buyer inadequacy.
181
+
182
+ Preserve buyer burden as well as actor assignment. Do not invent or magnify preparation, training, review cycles, handoffs, approvals, dependencies, response times, frequency, or internal coordination. A provider can retain the headline task while the copy quietly turns low-input delivery into project management for the buyer.
183
+
184
+ Do not turn this into a pronoun or imperative ban. `Get paid faster` can name a result. `See where competitors beat you` can name information the product supplies. A buyer-led headline can be valid when an adjacent element makes provider ownership clear. Training, coaching, fitness, education, and deliberate DIY tools can correctly foreground buyer effort because that effort is part of the offer. Collaborative delivery can require genuine buyer actions and bounded approvals. Judge responsibility for producing the value, not whether the sentence uses `you`.
185
+
186
+ Before approving a `SELL` candidate, ask:
187
+
188
+ 1. Who performs the difficult or value-producing action?
189
+ 2. What must the buyer genuinely supply, choose, approve, or do?
190
+ 3. Does the line make the offer sound like a new chore?
191
+ 4. Did the draft change how much work the buyer performs, how often, how soon, or through how many dependencies?
192
+ 5. If the result does not happen, does the line imply provider non-performance or buyer inadequacy?
193
+ 6. Did the rewrite move work from the provider or product to the buyer?
194
+
195
+ Reject a candidate when it contradicts the supplied delivery model. Repair responsibility locally. Preserve the strongest supported buyer promise, relief, and emotional job; the provider does not need to become the headline subject. Grade: HOUSE fidelity rule. It makes no claim that provider-led grammar converts better.
196
+
197
+ ### Rewrite regression gate
198
+
199
+ When the user asks to rewrite, improve, polish, shorten, or adapt existing copy, compare the candidate with the source before calling it stronger. A candidate can pass every standalone rule and still weaken the source.
200
+
201
+ Build a private source ledger before drafting:
202
+
203
+ - supported promise and selected certainty;
204
+ - dominant emotional job and buyer benefit;
205
+ - provider and buyer roles;
206
+ - buyer effort by type, amount, frequency, timing, dependencies, approvals, and coordination;
207
+ - friction removed, preserved, or introduced;
208
+ - strongest proof, mechanism, and differentiator;
209
+ - CTA destination, commitment, and reversibility;
210
+ - memorable language or tension that carries real meaning.
211
+
212
+ The requested transformation may change any ledger item it necessarily targets, and explicit user direction controls. Otherwise, preserve every unaffected commercial job. Prefer a local repair over a full conceptual rewrite when the source already performs strongly. Keep the source when the candidate produces no material improvement or introduces a material regression.
213
+
214
+ Run the comparison across the full composition, not sentence by sentence. A headline can carry the buyer promise while the subhead establishes provider ownership. A shorter sentence can be better even when a later sentence preserves qualification or proof. Keep the ledger and comparison private unless the user asks for analysis.
215
+
216
+ Grade: HOUSE fidelity procedure. It does not claim that any one promise, emotion, effort profile, or composition converts better.
217
+
167
218
  ### Proof
168
219
 
169
220
  Attach the best evidence to the premise it supports. Proof can be a direct outcome, diagnostic comparison, measured behavior, named scope, verified mechanism, constrained case, or credible external source. A list of minor features is not proof of a major claim.
@@ -316,7 +367,7 @@ Use control-room terms only when the audience already uses them or the artifact
316
367
 
317
368
  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
369
 
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.
370
+ 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
371
 
321
372
  ### Abstraction control
322
373
 
@@ -431,6 +482,8 @@ Run all of these before accepting customer-facing writing.
431
482
  |---|---|
432
483
  | First-read | Can the intended reader restate the sentence after one reading? |
433
484
  | Actor-action-object | Is it clear who or what acts, what the action is, and what it affects? |
485
+ | Delivery-model ownership | Does the provider or product still perform the work the offer sells, without invented or magnified buyer burden? |
486
+ | Rewrite regression | Does every source strength outside the requested transformation survive or materially improve? |
434
487
  | Abstraction | Can any abstract noun be replaced with a concrete action, object, condition, or result? |
435
488
  | Insider-language | Would the sentence still make sense to someone who has never seen the organization's internal terminology? |
436
489
  | Read-aloud | Does it sound like something a competent person would say to another person? |
@@ -449,43 +502,22 @@ The competitor-swap test is a procedure, not a judgment. Paste the candidate lin
449
502
 
450
503
  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
504
 
452
- ## Truth and ethical limits
505
+ ## Optional claim review
453
506
 
454
- Outside an explicit fictional, hypothetical, mock, synthetic, or concept brief, never invent or imply:
507
+ 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.
455
508
 
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.
509
+ In review mode:
463
510
 
464
- Keep fact, inference, interpretation, aspiration, and promise distinct. Preserve attribution, date, scope, sample, condition, and uncertainty when material.
511
+ - distinguish fact, inference, interpretation, aspiration, and promise;
512
+ - preserve attribution, date, scope, sample, condition, and uncertainty where the requested review makes them material;
513
+ - identify unsupported or internally inconsistent claims as editorial findings;
514
+ - state which source or assumption each finding depends on;
515
+ - apply the remedy the user requests, such as qualify, rewrite, remove, source, or leave unchanged;
516
+ - keep findings descriptive and free of moral judgment.
465
517
 
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.
518
+ 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.
467
519
 
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.
473
-
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.
475
-
476
- ### Ethical persuasion
477
-
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.
485
-
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.
487
-
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.
520
+ 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
521
 
490
522
  ## Short, medium, and long forms
491
523
 
@@ -608,9 +640,9 @@ Grade: A- for the requirement that writing be legible inside a category and dist
608
640
 
609
641
  ### Specificity against superlative
610
642
 
611
- Given a supported specific and an unsupported superlative that point at the same fact, ship the specific.
643
+ 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
644
 
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:
645
+ 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
646
 
615
647
  Weak, and true:
616
648
 
@@ -624,8 +656,8 @@ The second is not stronger because superlatives underperform. It is stronger bec
624
656
 
625
657
  Where this fails:
626
658
 
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.
659
+ - A specific is only stronger when it communicates the intended meaning. Do not introduce an unrequested number merely to escape a superlative.
660
+ - 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
661
  - 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
662
 
631
663
  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 +788,7 @@ If the spoken brief supplies no action or CTA, do not manufacture an imperative
756
788
 
757
789
  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
790
 
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.
791
+ 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
792
 
761
793
  ## Human voice and AI-writing-tell gate
762
794
 
@@ -830,7 +862,7 @@ Research on detector limits includes the [RAID benchmark](https://arxiv.org/abs/
830
862
 
831
863
  ## Written GEO/AEO and citability
832
864
 
833
- Apply these rules only to written assets. They improve clarity, extractability, and verification. They do not guarantee retrieval or citation.
865
+ Apply these rules only to `INDEXABLE_PUBLIC` assets. They improve clarity, extractability, and verification. They do not guarantee retrieval or citation. Other written surfaces retain ordinary argument, comprehension, channel-fit, and human-voice passes without GEO/AEO formatting.
834
866
 
835
867
  These rules sit at level 7 of the conflict hierarchy. None of them may raise decoding effort. Where one of them would, comprehension wins.
836
868
 
@@ -926,6 +958,24 @@ Strong:
926
958
 
927
959
  Why: the hero names a credible stake and mechanism without inventing a result. The factual three-item list is necessary scope. The label names what the reader will know afterwards rather than the screen they will be moved to, which is the difference between an outcome label and a transition label.
928
960
 
961
+ ### Done-for-you service
962
+
963
+ Verified facts:
964
+
965
+ > AnswerReach is a done-for-you service. Its specialists audit a brand's site, implement approved changes, and monitor whether the brand appears in AI-generated answers. The client supplies access and approvals. The work can improve the brand's chances of appearing, but it cannot guarantee inclusion.
966
+
967
+ Weak:
968
+
969
+ > AI search is a conversation. Earn your place in the answer.
970
+
971
+ Strong:
972
+
973
+ > Improve your brand's chances of becoming part of the answer.
974
+ >
975
+ > AnswerReach audits your site, implements approved changes, and monitors AI answers. You provide access and approvals.
976
+
977
+ Why: the weak line turns work sold by the provider into a buyer obligation and makes failure sound deserved. The strong composition keeps the desired buyer benefit in the headline, establishes provider ownership in the subhead, preserves the chance-improvement boundary, and limits the buyer role to supplied inputs. Buyer-facing grammar is not the defect.
978
+
929
979
  ### Paywall
930
980
 
931
981
  Verified facts:
@@ -1212,11 +1262,11 @@ Test only what must not fail:
1212
1262
 
1213
1263
  - `POSITION` defaults for descriptive company and directory surfaces.
1214
1264
  - `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.
1265
+ - Very short copy uses a stake or shift plus the strongest differentiator in the brief.
1266
+ - User-selected claims and framing survive style cleanup.
1267
+ - Claim review runs only when the user requests it.
1218
1268
  - Diagnostic enumeration survives.
1219
- - Compliance and internal process remain silent unless a material blocker exists.
1269
+ - Policy, compliance, and internal process remain silent unless the user requests them or a host rule blocks the task.
1220
1270
  - Spoken and written derivatives route separately.
1221
1271
  - Spoken-only copy contains no GEO/AEO scaffolding.
1222
1272
  - Ready-to-use copy appears before any necessary note.
@@ -1226,12 +1276,14 @@ Test only what must not fail:
1226
1276
  - Every call to action names a verb plus a concrete object, destination, or result.
1227
1277
  - No call to action is drawn from the slogan-shaped list in `CTA standard`.
1228
1278
  - 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.
1279
+ - User-required qualifiers survive, and they appear in their own sentences rather than inside the claim sentence.
1230
1280
  - Headings that belong to one task or information class use parallel syntax; attention-oriented headings do not run more than two consecutive instances of one template family. That run length is a governance default, not a measured threshold.
1231
1281
  - `SCIENCE`, `CASE_STUDY`, and `VOICE` compose without replacing the selected primary mode.
1232
1282
  - 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.
1283
+ - `SELL` copy preserves the supplied delivery model: provider work remains with the provider, and only genuine inputs, decisions, approvals, or DIY work remain with the buyer.
1284
+ - A rewrite preserves every source strength outside the transformation the user requested, including promise, emotional job, role assignment, burden, friction, proof, differentiation, and CTA commitment.
1285
+ - Scientific claim class, causality, statistical meaning, and uncertainty survive simplification when the user requests scientific claim review.
1286
+ - Case-study result class, permission, role attribution, causality, quote status, and typicality survive persuasion when the user requests case review.
1235
1287
 
1236
1288
  Do not use deterministic tests for a mandatory visible spine, exact investor phrases, rhetorical triads, visible conflict notes, or subjective persuasion quality.
1237
1289
 
@@ -1252,14 +1304,16 @@ Use these quality dimensions on a five-point scale:
1252
1304
  | Proof salience | The few strongest facts do the most decision work |
1253
1305
  | Mechanism differentiation | The subject is difficult to swap with a competitor |
1254
1306
  | Natural channel fit | The output sounds native to the requested surface |
1255
- | Truth discipline | Persuasive force reaches the evidence boundary without crossing it |
1307
+ | Brief fidelity | Persuasive force follows the user's claims, framing, and content decisions without added policy commentary |
1256
1308
  | First-read comprehension | An intended reader who has not seen the source facts extracts the meaning on one pass |
1257
- | Concrete action clarity | Actor, action, object, and result are visible, and the call to action names its destination |
1309
+ | Concrete action clarity | Actor, action, object, and result are visible, the actor matches the supplied delivery model, and the call to action names its destination |
1310
+ | Delivery-model fit | Provider work remains with the provider, while genuine buyer inputs, decisions, approvals, and DIY work remain with the buyer |
1311
+ | Source-relative rewrite quality | The candidate materially improves the requested property without weakening unaffected commercial strengths |
1258
1312
  | Attention value | A short attention surface creates a supported reason to continue rather than summarizing the product |
1259
1313
  | 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 |
1314
+ | Review calibration | When review is requested, scientific and case-study findings preserve result class, causality, uncertainty, attribution, and source scope |
1261
1315
 
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.
1316
+ Automatic failure: any U+2014 occurrence, failure to follow the user's requested claims or framing, unsolicited content review, unsolicited disclaimers, context leakage, visible internal-process leakage, claim-destination mismatch, delivery-model mismatch, source-relative commercial regression, or a material omission from the requested artifact.
1263
1317
 
1264
1318
  ## Evidence register
1265
1319
 
@@ -1349,18 +1403,18 @@ What was adopted from it, and on what basis:
1349
1403
  | Write a sentence that could be false | Procedure, in `Abstraction control` | HOUSE. The origin is an unattributable D-grade maxim |
1350
1404
  | 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
1405
  | 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 |
1406
+ | 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
1407
  | 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
1408
 
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.
1409
+ 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
1410
 
1357
1411
  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
1412
 
1359
- ### Myths this document must never assert
1413
+ ### Claims Agora does not introduce independently
1360
1414
 
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.
1415
+ 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
1416
 
1363
- | Never assert | What may be said instead |
1417
+ | Not introduced by default | What Agora may say instead |
1364
1418
  |---|---|
1365
1419
  | 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
1420
  | 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 +1437,7 @@ These circulate constantly, arrive with a number attached, and are the most like
1383
1437
  | That a self-contained passage is a fixed number of sentences | Self-containment is a semantic property, tested by `Required comprehension tests`. |
1384
1438
  | That an AI-detector score establishes authorship | Detector reliability is domain-dependent, degrades under obfuscation, and is biased against non-native English writing. |
1385
1439
 
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.
1440
+ 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
1441
 
1388
1442
  ### Human voice and detector evidence
1389
1443