@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.
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +7 -7
- package/DISCLAIMER.md +42 -0
- package/PRIVACY.md +54 -0
- package/README.md +66 -61
- package/package.json +5 -2
- package/scripts/voice/profile.mjs +2 -2
- package/skills/agora/SKILL.md +106 -82
- package/skills/agora/agents/openai.yaml +1 -1
- package/skills/agora/references/agora-case-studies.md +26 -16
- package/skills/agora/references/agora-conversion.md +202 -0
- package/skills/agora/references/agora-craft.md +32 -30
- package/skills/agora/references/agora-invest.md +21 -19
- package/skills/agora/references/agora-marketing.md +130 -76
- package/skills/agora/references/agora-science.md +20 -12
- package/skills/agora/references/agora-voice.md +15 -22
|
@@ -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.
|
|
20
|
+
14. Optional legal and claim review
|
|
21
21
|
15. Evaluation contract
|
|
22
22
|
16. Evidence register
|
|
23
23
|
|
|
24
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
-
|
|
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
|
|
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
|
-
##
|
|
462
|
+
## Optional legal and claim review
|
|
463
463
|
|
|
464
|
-
Capital-raising communication can create legal obligations.
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
- [
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
43
|
+
6. Make the next step proportionate to the audience and offer.
|
|
43
44
|
|
|
44
|
-
Supplied
|
|
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
|
-
|
|
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,
|
|
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.
|
|
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.
|
|
57
|
-
2.
|
|
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
|
|
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.**
|
|
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
|
|
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
|
|
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` |
|
|
134
|
-
| `PUBLIC_NON_INDEXABLE_WRITTEN` |
|
|
135
|
-
| `WRITTEN_PRIVATE` |
|
|
136
|
-
| `SPOKEN_ONLY` |
|
|
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
|
-
|
|
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
|
-
##
|
|
505
|
+
## Optional claim review
|
|
453
506
|
|
|
454
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
628
|
-
-
|
|
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
|
|
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
|
|
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
|
|
1216
|
-
-
|
|
1217
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
1234
|
-
-
|
|
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
|
-
|
|
|
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
|
-
|
|
|
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,
|
|
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
|
|
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
|
|
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
|
-
###
|
|
1413
|
+
### Claims Agora does not introduce independently
|
|
1360
1414
|
|
|
1361
|
-
These circulate constantly
|
|
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
|
-
|
|
|
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
|
|
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
|
|