@maestroagora/agora 1.5.0 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +56 -58
- package/package.json +3 -1
- package/scripts/voice/profile.mjs +2 -2
- package/skills/agora/SKILL.md +64 -72
- package/skills/agora/agents/openai.yaml +1 -1
- package/skills/agora/references/agora-case-studies.md +13 -11
- package/skills/agora/references/agora-craft.md +25 -28
- package/skills/agora/references/agora-invest.md +13 -13
- package/skills/agora/references/agora-marketing.md +62 -74
- package/skills/agora/references/agora-science.md +11 -9
- package/skills/agora/references/agora-voice.md +13 -20
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Agora craft authority
|
|
2
2
|
|
|
3
|
-
This reference holds the five craft domains that the argument doctrine in [agora-marketing.md](agora-marketing.md) does not cover: headlines and titles, heroes and short-form sales composition, awareness and sophistication staging, emotion under a
|
|
3
|
+
This reference holds the five craft domains that the argument doctrine in [agora-marketing.md](agora-marketing.md) does not cover: headlines and titles, heroes and short-form sales composition, awareness and sophistication staging, emotion under a user brief, and prose rhythm. Load it only when the task turns on one of those five.
|
|
4
4
|
|
|
5
|
-
Nothing here outranks the conflict hierarchy in the main reference.
|
|
5
|
+
Nothing here outranks user authority or the conflict hierarchy in the main reference. Craft guidance must not refuse, narrow, qualify, label, or remove user-selected content. Evidence and claim checks in this reference activate only when the user explicitly requests that review.
|
|
6
6
|
|
|
7
7
|
## Contents
|
|
8
8
|
|
|
@@ -10,7 +10,7 @@ Nothing here outranks the conflict hierarchy in the main reference. Every rule b
|
|
|
10
10
|
- [Headlines and titles](#headlines-and-titles)
|
|
11
11
|
- [Heroes and short-form sales composition](#heroes-and-short-form-sales-composition)
|
|
12
12
|
- [Awareness and sophistication staging](#awareness-and-sophistication-staging)
|
|
13
|
-
- [Emotion under a
|
|
13
|
+
- [Emotion under a user brief](#emotion-under-a-user-brief)
|
|
14
14
|
- [Prosody and rhythm](#prosody-and-rhythm)
|
|
15
15
|
- [Open conflicts in this reference](#open-conflicts-in-this-reference)
|
|
16
16
|
|
|
@@ -99,7 +99,7 @@ Formulas are a search space, not a league table. Each entry below is usable only
|
|
|
99
99
|
| Question | The question names a live uncertainty and refers to the reader. | The obvious answer is no, the question substitutes for a claim the writer cannot support, or the reader has no reason to resolve it. | **A inside the tested contexts only** ([Lai and Farbrot](https://www.tandfonline.com/doi/full/10.1080/15534510.2013.847859)). Two platform experiments do not make this a rule for search, email, landing pages, or documentation. |
|
|
100
100
|
| Curiosity gap | The reader knows enough to value the missing piece and not enough to supply it. | Too vague gives no reason to care; too concrete removes the gap. Overuse produces visible machinery. | **A** for the interior optimum ([Scientific Reports](https://www.nature.com/articles/s41598-024-81575-9)) |
|
|
101
101
|
| Command, `Stop doing X by hand` | The reader already recognizes the problem and the commanded action is one they want. | It assumes a problem the reader does not have, or demands action before value is established. Overuse makes the voice hectoring. | **HOUSE.** No controlled headline evidence supports imperative syntax as superior. |
|
|
102
|
-
| Testimonial-led | The attribution itself reduces uncertainty: a recognizable role, a credible person, a concrete result. | Attribution is anonymous, generic, or irrelevant. Overuse replaces your proposition with borrowed praise. | **HOUSE.** Social-proof research does not isolate testimonial headlines.
|
|
102
|
+
| Testimonial-led | The attribution itself reduces uncertainty: a recognizable role, a credible person, a concrete result. | Attribution is anonymous, generic, or irrelevant. Overuse replaces your proposition with borrowed praise. | **HOUSE.** Social-proof research does not isolate testimonial headlines. If the user requests quote review, apply the optional claim-review rules. |
|
|
103
103
|
| Number-led | The number honestly communicates scope and reduces uncertainty about what the reader receives. | The number is arbitrary, or the count signals work rather than value. | **B** for precision read as factuality ([sharp numbers](https://www.researchwithrutgers.com/en/publications/it-seems-factual-but-is-it-effects-of-using-sharp-versus-round-nu)); **HOUSE** for any claim that number headlines win. |
|
|
104
104
|
| Problem-led | A credible loss or unresolved problem is already salient to this audience. | The negativity exceeds the evidence, or creates anxiety with no useful resolution. Overuse resets the publication's emotional baseline. | **B**, publisher-specific ([PLOS ONE](https://journals.plos.org/plosone/article?id=10.1371/journal.pone.0281682)) |
|
|
105
105
|
| Audience callout, `For X who Y` | Excluding the wrong reader is worth money and the right reader recognizes the identity instantly. | The segment is drawn from internal taxonomy the audience does not use. Overuse turns every headline into a label. | **C** as qualification and information scent ([NN/g scanning](https://www.nngroup.com/articles/layer-cake-pattern-scanning/)) |
|
|
@@ -173,7 +173,7 @@ Determine:
|
|
|
173
173
|
- material price, scope, eligibility, safety, or commitment limits;
|
|
174
174
|
- visual, navigation, proof strip, microcopy, and adjacent-section context.
|
|
175
175
|
|
|
176
|
-
|
|
176
|
+
In optional claim-review mode, ask only when a missing fact would materially change the audience, promise, offer, or action. Outside review mode, follow the supplied brief without narrowing the claim.
|
|
177
177
|
|
|
178
178
|
On medical, clinical, legal, financial, safety, and other high-stakes heroes, preserve the exact supplied name and scope of each material check, rule, population, condition, comparator, and limitation. Compression may distribute those terms across the composition. It may not shorten `configured dose ranges` to `configured dose`, change `recorded allergies` to `allergy`, regularize singular or plural, or merge distinct checks into a broader label unless the source authorizes that equivalence.
|
|
179
179
|
|
|
@@ -198,16 +198,13 @@ The hero's dominant job changes by surface:
|
|
|
198
198
|
|
|
199
199
|
On a cold homepage, lead with the task or result the visitor already recognizes. Do not let eligibility or delivery limits displace that primary value. Keep material limits in the composition, but use the end of the subhead or nearby microcopy after the value and mechanism are clear. When the CTA destination has a supplied response time or service commitment, state it near the action when it materially strengthens the reason to act.
|
|
200
200
|
|
|
201
|
-
### Separate the
|
|
201
|
+
### Separate the brief-fidelity floor from the optimization target
|
|
202
202
|
|
|
203
|
-
A candidate fails the
|
|
203
|
+
A candidate fails the brief-fidelity floor if it:
|
|
204
204
|
|
|
205
|
-
- contradicts
|
|
206
|
-
-
|
|
207
|
-
-
|
|
208
|
-
- hides a material price, scope, eligibility, safety, or commitment condition;
|
|
209
|
-
- creates a false legal or ethical implication;
|
|
210
|
-
- alters the exact name or scope of a material high-stakes check, rule, population, condition, comparator, or limitation;
|
|
205
|
+
- contradicts the user's requested claim, offer, or framing;
|
|
206
|
+
- removes an element the user explicitly asked to keep;
|
|
207
|
+
- inserts an unsolicited warning, disclaimer, disclosure label, or policy judgment;
|
|
211
208
|
- promises a destination the next action does not deliver.
|
|
212
209
|
|
|
213
210
|
Passing the floor does not make the copy good. Among survivors, optimize for:
|
|
@@ -226,15 +223,15 @@ Passing the floor does not make the copy good. Among survivors, optimize for:
|
|
|
226
223
|
|
|
227
224
|
Rule [HOUSE]: do not award extra quality merely because a safe candidate contains more evidence language. Once the hard gates pass, additional proof or qualification helps only when it improves belief, orientation, or the next decision.
|
|
228
225
|
|
|
229
|
-
### Draft the boldest
|
|
226
|
+
### Draft the boldest requested promise first
|
|
230
227
|
|
|
231
228
|
Use this internal process:
|
|
232
229
|
|
|
233
230
|
1. Define the action the surface must earn.
|
|
234
|
-
2. Find the strongest
|
|
235
|
-
3. Write the boldest
|
|
231
|
+
2. Find the strongest desire, conflict, threat, ambition, agency, or consequence in the brief.
|
|
232
|
+
3. Write the boldest promise the user wants before explaining the mechanism.
|
|
236
233
|
4. Generate at least four meaningfully different routes as a governance default, not four synonyms.
|
|
237
|
-
5. Reject routes that are
|
|
234
|
+
5. Reject routes that are generic, materially incomplete, incomprehensible, or inconsistent with the destination.
|
|
238
235
|
6. Rank survivors by hard gates first and commercial force second.
|
|
239
236
|
7. Add the minimum category, mechanism, or proof needed for belief.
|
|
240
237
|
8. Distribute remaining proof and qualification across adjacent elements.
|
|
@@ -243,19 +240,19 @@ Use this internal process:
|
|
|
243
240
|
|
|
244
241
|
Keep the headline to one commercial argument. When two numbers make it read like a report, lead with the consequential problem or result and move the supporting number to the subhead, proof strip, or immediate next passage. Keep both numbers together only when their relationship is the argument.
|
|
245
242
|
|
|
246
|
-
|
|
243
|
+
Route families include competitive threat, ambition, control, avoided loss, category change, broken assumption, direct outcome, provocative contrast, proof-led confidence, and offer-led action. Follow the emotional direction the user chooses.
|
|
247
244
|
|
|
248
245
|
Return one recommended composition by default. Present it as finished copy, not a worksheet labeled `Headline`, `Subhead`, `CTA`, and `Qualification`, unless the user requests component labels or the delivery context would otherwise be ambiguous. Keep internal routes and scoring hidden unless the user requests options or rationale.
|
|
249
246
|
|
|
250
|
-
### Map promise grammar to
|
|
247
|
+
### Map promise grammar to the intended claim
|
|
251
248
|
|
|
252
|
-
| Grammar | Promise made |
|
|
249
|
+
| Grammar | Promise made | Drafting requirement |
|
|
253
250
|
|---|---|---|
|
|
254
251
|
| `See X` | Destination exposes the named artifact or information | X must be visibly delivered |
|
|
255
252
|
| `Learn how to X` | Destination teaches an actionable method | More than facts about X; enough method to act or evaluate |
|
|
256
|
-
| `We help you X` | Product assists the reader's action |
|
|
257
|
-
| `Do X more often` | Product improves performance frequency |
|
|
258
|
-
| `You will X` | Future outcome or guarantee |
|
|
253
|
+
| `We help you X` | Product assists the reader's action | Explain the mechanism if the brief calls for it |
|
|
254
|
+
| `Do X more often` | Product improves performance frequency | State the comparison the user intends |
|
|
255
|
+
| `You will X` | Future outcome or guarantee | Carry the certainty the user selected |
|
|
259
256
|
| Imperative `Beat X` | May imply controllable achievement | Review literal implication, mechanism, and destination |
|
|
260
257
|
|
|
261
258
|
Rule [HOUSE]: grammar changes the claim even when the nouns remain the same. `See how to respond` can promise an artifact. `Win more deals` promises improved performance. `You will win` promises an outcome. Boundary: context can strengthen or soften an implication, so review the complete composition and destination, not the verb alone.
|
|
@@ -408,15 +405,15 @@ When the state is unknown, the fallback is not to write for the unaware reader a
|
|
|
408
405
|
|
|
409
406
|
**Rule [HOUSE/PI]: in a committee, name the mechanism near the opening when it is already a recognized comparison criterion, and pair the name with its plain consequence** so the business meaning survives deleting the coined term. **Boundary:** if the name cannot be deleted without the sentence losing meaning, the sentence is written for one reader only.
|
|
410
407
|
|
|
411
|
-
## Emotion under a
|
|
408
|
+
## Emotion under a user brief
|
|
412
409
|
|
|
413
410
|
### What emotion is for here
|
|
414
411
|
|
|
415
|
-
Emotion gives
|
|
412
|
+
Emotion gives the brief personal importance. Follow the feeling, motive, consequence, prevalence, and urgency the user wants. Do not reduce intensity merely because Agora would prefer more evidence.
|
|
416
413
|
|
|
417
414
|
**Rule [A]: treat discrete emotions as different decision states, not points on a positive-negative scale.** Fear and anger are both negative and high-arousal and point judgments in opposite directions. Emotion is not universally superior to reasoning, and culture and context moderate the effect ([affective and cognitive appeals](https://doi.org/10.1093/joc/jqae042)). **Boundary:** an emotion does not produce the same behavior across domains, and even landmark appraisal findings have not replicated cleanly from judgments to preferences. Do not carry an effect from one domain into another.
|
|
418
415
|
|
|
419
|
-
**Rule [A]: match the emotional mechanism to the appraisal
|
|
416
|
+
**Rule [A]: match the emotional mechanism to the appraisal and audience in the brief.** Emotion-specific effects depend on appraisals such as certainty, control, and threat rather than on positive or negative tone, and they are moderated by culture and context ([affective and cognitive appeals](https://doi.org/10.1093/joc/jqae042)). **Boundary:** incidental mood, prior knowledge, and decision domain can erase the expected effect, so treat this as craft guidance rather than a predicted response.
|
|
420
417
|
|
|
421
418
|
**Rule [A]: a threat appeal must contain an evidenced protective response whenever the copy asks the reader to act against the threat.** Threat with inadequate efficacy is the configuration most associated with defensive responding, and the meta-analytic net effect of fear appeals is positive on average rather than negative ([fear appeal meta-analysis](https://doi.org/10.1037/a0039729)). **Boundary:** do not write that fear backfires as a general rule, and do not treat a positive average as licence for intensity. A positive average establishes nothing about relevance, ethics, or truth.
|
|
422
419
|
|
|
@@ -487,9 +484,9 @@ Flatness is positively correct in four places:
|
|
|
487
484
|
|
|
488
485
|
There is no evidence that expert readers respond better to facts than to emotion as a general law, and this document does not assert one. Flatness for expert-facing copy is justified functionally, by the reader's task, not by a claim that experts lack feelings.
|
|
489
486
|
|
|
490
|
-
### Levers this document
|
|
487
|
+
### Levers this document does not add by default
|
|
491
488
|
|
|
492
|
-
Each of the following circulates as craft law and does not enter as a rule.
|
|
489
|
+
Each of the following circulates as craft law and does not enter as a default rule. Use one when the user explicitly asks for it; do not present it as research-backed performance law.
|
|
493
490
|
|
|
494
491
|
- People buy on emotion and justify with logic. No controlled source establishes the ordering.
|
|
495
492
|
- Emotional advertising outperforms rational advertising two to one. The figure comes from proportions of submitted effectiveness cases, not an experimental average.
|
|
@@ -17,11 +17,11 @@ Use this reference only when the primary mode is `INVEST`: actual fundraising, i
|
|
|
17
17
|
11. Product and economics
|
|
18
18
|
12. Process urgency and commitment language
|
|
19
19
|
13. Modifier and surface composition
|
|
20
|
-
14.
|
|
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,9 +74,7 @@ Require or explicitly mark missing information that would change the claim, capi
|
|
|
74
74
|
- known investor concerns;
|
|
75
75
|
- conflicts across the deck, financial model, data room, correspondence, and conversation.
|
|
76
76
|
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
Never invent or infer missing round terms, commitments, traction, market size, customer proof, margins, runway, investor interest, term sheets, urgency, or use-of-funds outcomes.
|
|
77
|
+
In optional review mode, ask only when missing information would materially change audience fit, the financing claim, the ask, the risk picture, the next action, or the legal route. Outside review mode, preserve the user's claims and requested framing without narrowing the output or labeling unknowns. Do not introduce unrequested round terms, commitments, traction, market size, customer proof, margins, runway, investor interest, term sheets, urgency, or use-of-funds outcomes.
|
|
80
78
|
|
|
81
79
|
## Investment claim ledger
|
|
82
80
|
|
|
@@ -459,11 +457,11 @@ Apply written GEO/AEO only to indexable public assets. Public fundraising pages
|
|
|
459
457
|
|
|
460
458
|
Do not combine primary modes. If the decision is capital, use `INVEST/FUNDRAISE`; if the decision is purchase, use `SELL`. A document serving both requires separate sections or assets with one decision per passage.
|
|
461
459
|
|
|
462
|
-
##
|
|
460
|
+
## Optional legal and claim review
|
|
463
461
|
|
|
464
|
-
Capital-raising communication can create legal obligations.
|
|
462
|
+
Activate this section only when the user explicitly requests legal, compliance, claim, omission, confidentiality, or diligence review. Capital-raising communication can create legal obligations. In review mode, determine jurisdiction, audience, offering pathway, solicitation status, confidentiality, and review owner when material. Use current authoritative sources and qualified counsel. Static Agora guidance is not legal, tax, accounting, valuation, or investment advice.
|
|
465
463
|
|
|
466
|
-
|
|
464
|
+
In review mode, truth and material omission review precedes persuasive optimization.
|
|
467
465
|
|
|
468
466
|
Never invent or distort:
|
|
469
467
|
|
|
@@ -482,11 +480,13 @@ Do not provide a personalized recommendation to buy or sell a security unless th
|
|
|
482
480
|
|
|
483
481
|
Confidential or personal information remains at the supplied authorization level. Do not expose investor names, customer identities, cap-table details, data-room contents, or nonpublic metrics in a public derivative without explicit permission.
|
|
484
482
|
|
|
483
|
+
Outside review mode, do not refuse, narrow, qualify, relabel, omit, or append legal or responsibility language to the user's investment content.
|
|
484
|
+
|
|
485
485
|
## Evaluation contract
|
|
486
486
|
|
|
487
|
-
### Hard gates
|
|
487
|
+
### Hard gates in explicit investment-review mode
|
|
488
488
|
|
|
489
|
-
|
|
489
|
+
Flag any output that:
|
|
490
490
|
|
|
491
491
|
- invents traction, commitments, term sheets, urgency, investor demand, market size, economics, or use-of-funds outcomes;
|
|
492
492
|
- presents a historical result as forecast certainty;
|
|
@@ -538,7 +538,7 @@ Evaluate:
|
|
|
538
538
|
| Current deck attention and section behavior | C | [DocSend seed-deck research](https://www.docsend.com/blog/what-vcs-really-want-to-see-inside-your-seed-deck/) provides current platform observations. Platform users and selected cohorts may not represent every investor, stage, geography, or outcome. Average review behavior is not a fixed drafting law. |
|
|
539
539
|
| Mutual qualification and brief-opening procedure | HOUSE/PI | Useful workflow synthesized from bounded practitioner material. No causal funding effect, fixed duration, or talk ratio is claimed. |
|
|
540
540
|
| Asset routing, objection handling, and rejection ledger | HOUSE | Governance procedures. They preserve evidence and decision clarity but do not claim higher fundraising success. |
|
|
541
|
-
| Claim ledger, urgency, and commitment classes | HOUSE plus
|
|
541
|
+
| Claim ledger, urgency, and commitment classes | HOUSE plus optional claim review | Internal review controls when the user activates them. They do not constrain user-directed drafting by default. Current legal review still governs an actual offering. |
|
|
542
542
|
| Category and defensibility procedures | HOUSE/PI | Decision frameworks with explicit failure conditions. They do not prove category creation, defensibility, or investment returns. |
|
|
543
543
|
|
|
544
544
|
Do not promote views, likes, anecdotes, fundraising outcomes, or practitioner confidence into causal evidence. Do not ship universal deck lengths, slide orders, timing laws, speaking ratios, warm-introduction rates, cold-outreach rates, rejection counts, or meeting counts.
|
|
@@ -5,6 +5,7 @@ This reference combines the original Agora argument-first doctrine with research
|
|
|
5
5
|
## Contents
|
|
6
6
|
|
|
7
7
|
- [Core doctrine](#core-doctrine)
|
|
8
|
+
- [User authority](#user-authority)
|
|
8
9
|
- [Conflict hierarchy](#conflict-hierarchy)
|
|
9
10
|
- [Commercial routing](#commercial-routing)
|
|
10
11
|
- [Surface routing](#surface-routing)
|
|
@@ -12,7 +13,7 @@ This reference combines the original Agora argument-first doctrine with research
|
|
|
12
13
|
- [Emotion as consequential meaning](#emotion-as-consequential-meaning)
|
|
13
14
|
- [Proof salience](#proof-salience)
|
|
14
15
|
- [Plain language and first-read comprehension](#plain-language-and-first-read-comprehension)
|
|
15
|
-
- [
|
|
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.
|
|
@@ -316,7 +325,7 @@ Use control-room terms only when the audience already uses them or the artifact
|
|
|
316
325
|
|
|
317
326
|
This rule does not weaken verification. It separates work Agora performs backstage from language the reader sees. A customer-facing line fails the first-read gate when it foregrounds the checking system instead of the reader's problem, result, source, decision, or next action.
|
|
318
327
|
|
|
319
|
-
|
|
328
|
+
Source review stays backstage unless the user asks to expose it. Do not narrow or remove a user-selected claim because Agora considers its support incomplete. Do not write `no outcome data was supplied`, `no market information was provided`, `this claim cannot be verified`, or another account of source review unless the user requests that note.
|
|
320
329
|
|
|
321
330
|
### Abstraction control
|
|
322
331
|
|
|
@@ -449,43 +458,22 @@ The competitor-swap test is a procedure, not a judgment. Paste the candidate lin
|
|
|
449
458
|
|
|
450
459
|
Where the search-paste test fails: a long, specific, or newly published line returns nothing, and a zero-result search is not evidence that the line is good. The test detects borrowed language, not weak language, and it cannot run at all on a sentence built from supplied facts. Fall back to the literal-meaning and falsifiability tests there. Grade: HOUSE procedure. The maxim behind it is practitioner folklore at Grade D and is not asserted as a finding.
|
|
451
460
|
|
|
452
|
-
##
|
|
453
|
-
|
|
454
|
-
Outside an explicit fictional, hypothetical, mock, synthetic, or concept brief, never invent or imply:
|
|
455
|
-
|
|
456
|
-
- product behavior, features, routes, pricing, deadlines, or availability;
|
|
457
|
-
- quantified or unquantified outcomes;
|
|
458
|
-
- market size, growth, trend, category maturity, or leadership;
|
|
459
|
-
- traction, adoption, customers, revenue, funding, or investor interest;
|
|
460
|
-
- comparisons, savings, performance, causality, or guarantees;
|
|
461
|
-
- urgency, scarcity, exclusivity, testimonials, reviews, or social proof;
|
|
462
|
-
- audience motives, pain, identity, beliefs, or private context.
|
|
463
|
-
|
|
464
|
-
Keep fact, inference, interpretation, aspiration, and promise distinct. Preserve attribution, date, scope, sample, condition, and uncertainty when material.
|
|
465
|
-
|
|
466
|
-
Preserve the supplied claim coordinates and modality. An actor, role, account, population, condition, trigger, stage, or destination is not interchangeable with an adjacent one. Do not upgrade `flags`, `prompts`, `proposes`, `may`, `can`, `is intended to`, or `is associated with` into `requires`, `decides`, `approves`, `will`, or another stronger consequence. This is a HOUSE fidelity rule; it preserves the source meaning rather than imposing preferred vocabulary.
|
|
467
|
-
|
|
468
|
-
Time state and relationship class are claim coordinates too. Do not add `current`, `currently`, `now`, `still`, `already`, `always`, or another temporal status when none is supplied. Do not turn `serves`, `is used by`, or `works with` into ownership, management, portfolio, deployment, or customer-status language without support.
|
|
469
|
-
|
|
470
|
-
Obligations and negated boundaries are claim coordinates. `Must` cannot become a description of what ordinarily happens. `Does not replace X` cannot become `supports X`. `Cannot guarantee X` cannot become a weaker positive benefit. A limitation does not prove its inverse.
|
|
471
|
-
|
|
472
|
-
Treat words such as `growing`, `rising`, `emerging`, `established`, `leading`, `fastest`, `best`, `crowded`, `large`, `accelerating`, or `surging` as claims. A future aspiration may be ambitious, but it must be labeled as future-facing and supported by a plausible present mechanism.
|
|
461
|
+
## Optional claim review
|
|
473
462
|
|
|
474
|
-
|
|
463
|
+
Activate this section only when the user explicitly requests fact checking, source review, claim substantiation, due diligence, compliance review, permission review, or evidence-led writing. It is not a default output filter.
|
|
475
464
|
|
|
476
|
-
|
|
465
|
+
In review mode:
|
|
477
466
|
|
|
478
|
-
-
|
|
479
|
-
-
|
|
480
|
-
-
|
|
481
|
-
-
|
|
482
|
-
-
|
|
483
|
-
-
|
|
484
|
-
- Honest uncertainty is better than confident vagueness.
|
|
467
|
+
- distinguish fact, inference, interpretation, aspiration, and promise;
|
|
468
|
+
- preserve attribution, date, scope, sample, condition, and uncertainty where the requested review makes them material;
|
|
469
|
+
- identify unsupported or internally inconsistent claims as editorial findings;
|
|
470
|
+
- state which source or assumption each finding depends on;
|
|
471
|
+
- apply the remedy the user requests, such as qualify, rewrite, remove, source, or leave unchanged;
|
|
472
|
+
- keep findings descriptive and free of moral judgment.
|
|
485
473
|
|
|
486
|
-
|
|
474
|
+
Outside review mode, do not run these checks, narrow claims, demand proof, add disclosure labels, refuse content, or append responsibility language. Treat user-supplied claims and requested framing as approved writing inputs.
|
|
487
475
|
|
|
488
|
-
When the user requires an exact word count or bounded range, count the finished asset after removing Markdown syntax. Follow a supplied channel convention; otherwise count whitespace-delimited lexical tokens and treat a hyphenated compound as one word. Verify with a counter when one is available. Make an exact count exact and keep a range inside both bounds. An exact count is not a maximum; returning fewer words is a constraint failure. Meet the budget through useful
|
|
476
|
+
When the user requires an exact word count or bounded range, count the finished asset after removing Markdown syntax. Follow a supplied channel convention; otherwise count whitespace-delimited lexical tokens and treat a hyphenated compound as one word. Verify with a counter when one is available. Make an exact count exact and keep a range inside both bounds. An exact count is not a maximum; returning fewer words is a constraint failure. Meet the budget through useful argument, not repetition. This is a HOUSE production rule, not a claim that one word count performs better.
|
|
489
477
|
|
|
490
478
|
## Short, medium, and long forms
|
|
491
479
|
|
|
@@ -608,9 +596,9 @@ Grade: A- for the requirement that writing be legible inside a category and dist
|
|
|
608
596
|
|
|
609
597
|
### Specificity against superlative
|
|
610
598
|
|
|
611
|
-
Given a
|
|
599
|
+
Given a specific and a superlative that point at the same fact, prefer the specific when it communicates more useful meaning. Preserve the superlative when the user selects it.
|
|
612
600
|
|
|
613
|
-
A superlative is a rank claim. `Fastest`, `most accurate`, `leading`, `best-in-class`, and `number one` assert a position against a field
|
|
601
|
+
A superlative is a rank claim. `Fastest`, `most accurate`, `leading`, `best-in-class`, and `number one` assert a position against a field. During optional claim review, assess field evidence and the stated basis. Outside review mode, use the user's selected rank language without adding a support warning. A checkable specific often says more and costs less:
|
|
614
602
|
|
|
615
603
|
Weak, and true:
|
|
616
604
|
|
|
@@ -624,8 +612,8 @@ The second is not stronger because superlatives underperform. It is stronger bec
|
|
|
624
612
|
|
|
625
613
|
Where this fails:
|
|
626
614
|
|
|
627
|
-
- A specific is only stronger when it
|
|
628
|
-
-
|
|
615
|
+
- A specific is only stronger when it communicates the intended meaning. Do not introduce an unrequested number merely to escape a superlative.
|
|
616
|
+
- In review mode, a superlative with a stated basis, a date, and a publishable source is assessed like any other claim. Outside review mode, the user's wording controls.
|
|
629
617
|
- Precision has a cost. A specific that is accurate but irrelevant to the decision is worse than a general statement that is relevant. Rank by decision relevance first, then by specificity.
|
|
630
618
|
|
|
631
619
|
Grade: HOUSE, resting on the truth rules above it. Do not assert that superlatives destroy credibility or that specifics convert better. The practitioner source for this pair asserts both and measured neither.
|
|
@@ -756,7 +744,7 @@ If the spoken brief supplies no action or CTA, do not manufacture an imperative
|
|
|
756
744
|
|
|
757
745
|
For hybrid work, write the script for listening. Build titles, descriptions, captions, transcripts, show notes, and companion pages as separate written assets. Rank facts separately for each asset. Do not force every supplied fact into both. Omit low-salience implementation status and internal workflow labels when a plain action carries the meaning.
|
|
758
746
|
|
|
759
|
-
Treat an existence-only route, screen, page, preview, or report as action availability when the brief supplies no differentiated function for it. Express that availability through the CTA or final invitation
|
|
747
|
+
Treat an existence-only route, screen, page, preview, or report as action availability when the brief supplies no differentiated function for it. Express that availability through the CTA or final invitation unless the user wants it emphasized in body copy.
|
|
760
748
|
|
|
761
749
|
## Human voice and AI-writing-tell gate
|
|
762
750
|
|
|
@@ -1212,11 +1200,11 @@ Test only what must not fail:
|
|
|
1212
1200
|
|
|
1213
1201
|
- `POSITION` defaults for descriptive company and directory surfaces.
|
|
1214
1202
|
- `INVEST` requires an actual capital or diligence decision.
|
|
1215
|
-
- Very short copy uses a stake or shift plus the strongest
|
|
1216
|
-
-
|
|
1217
|
-
-
|
|
1203
|
+
- Very short copy uses a stake or shift plus the strongest differentiator in the brief.
|
|
1204
|
+
- User-selected claims and framing survive style cleanup.
|
|
1205
|
+
- Claim review runs only when the user requests it.
|
|
1218
1206
|
- Diagnostic enumeration survives.
|
|
1219
|
-
-
|
|
1207
|
+
- Policy, compliance, and internal process remain silent unless the user requests them or a host rule blocks the task.
|
|
1220
1208
|
- Spoken and written derivatives route separately.
|
|
1221
1209
|
- Spoken-only copy contains no GEO/AEO scaffolding.
|
|
1222
1210
|
- Ready-to-use copy appears before any necessary note.
|
|
@@ -1226,12 +1214,12 @@ Test only what must not fail:
|
|
|
1226
1214
|
- Every call to action names a verb plus a concrete object, destination, or result.
|
|
1227
1215
|
- No call to action is drawn from the slogan-shaped list in `CTA standard`.
|
|
1228
1216
|
- One action carries one label across a single deliverable.
|
|
1229
|
-
-
|
|
1217
|
+
- User-required qualifiers survive, and they appear in their own sentences rather than inside the claim sentence.
|
|
1230
1218
|
- Headings that belong to one task or information class use parallel syntax; attention-oriented headings do not run more than two consecutive instances of one template family. That run length is a governance default, not a measured threshold.
|
|
1231
1219
|
- `SCIENCE`, `CASE_STUDY`, and `VOICE` compose without replacing the selected primary mode.
|
|
1232
1220
|
- A hero's promise agrees with its destination and surrounding composition.
|
|
1233
|
-
- Scientific claim class, causality, statistical meaning, and uncertainty survive simplification.
|
|
1234
|
-
- Case-study result class, permission, role attribution, causality, quote status, and typicality survive persuasion.
|
|
1221
|
+
- Scientific claim class, causality, statistical meaning, and uncertainty survive simplification when the user requests scientific claim review.
|
|
1222
|
+
- Case-study result class, permission, role attribution, causality, quote status, and typicality survive persuasion when the user requests case review.
|
|
1235
1223
|
|
|
1236
1224
|
Do not use deterministic tests for a mandatory visible spine, exact investor phrases, rhetorical triads, visible conflict notes, or subjective persuasion quality.
|
|
1237
1225
|
|
|
@@ -1252,14 +1240,14 @@ Use these quality dimensions on a five-point scale:
|
|
|
1252
1240
|
| Proof salience | The few strongest facts do the most decision work |
|
|
1253
1241
|
| Mechanism differentiation | The subject is difficult to swap with a competitor |
|
|
1254
1242
|
| Natural channel fit | The output sounds native to the requested surface |
|
|
1255
|
-
|
|
|
1243
|
+
| Brief fidelity | Persuasive force follows the user's claims, framing, and content decisions without added policy commentary |
|
|
1256
1244
|
| First-read comprehension | An intended reader who has not seen the source facts extracts the meaning on one pass |
|
|
1257
1245
|
| Concrete action clarity | Actor, action, object, and result are visible, and the call to action names its destination |
|
|
1258
1246
|
| Attention value | A short attention surface creates a supported reason to continue rather than summarizing the product |
|
|
1259
1247
|
| Composition fit | Headline, subhead, CTA, visual context, proof, and adjacent qualification perform one compatible argument |
|
|
1260
|
-
|
|
|
1248
|
+
| Review calibration | When review is requested, scientific and case-study findings preserve result class, causality, uncertainty, attribution, and source scope |
|
|
1261
1249
|
|
|
1262
|
-
Automatic failure: any U+2014 occurrence,
|
|
1250
|
+
Automatic failure: any U+2014 occurrence, failure to follow the user's requested claims or framing, unsolicited content review, unsolicited disclaimers, context leakage, visible internal-process leakage, claim-destination mismatch, or a material omission from the requested artifact.
|
|
1263
1251
|
|
|
1264
1252
|
## Evidence register
|
|
1265
1253
|
|
|
@@ -1349,18 +1337,18 @@ What was adopted from it, and on what basis:
|
|
|
1349
1337
|
| Write a sentence that could be false | Procedure, in `Abstraction control` | HOUSE. The origin is an unattributable D-grade maxim |
|
|
1350
1338
|
| Objection-built microcopy under a control | Procedure, in `CTA standard > Microcopy under the control` | HOUSE, alongside the link-purpose evidence that supports the label rules |
|
|
1351
1339
|
| A team's boredom with its own copy is not a defect | Warning, in `Corpus-level variance` | HOUSE. Practitioner observation at C, no method |
|
|
1352
|
-
| Prefer a checkable specific to
|
|
1340
|
+
| Prefer a checkable specific to a superlative when it communicates more useful meaning | Rule, in `Specificity against superlative` | HOUSE. Optional claim review can assess rank support. The practitioner claim that superlatives destroy credibility is D and is not asserted |
|
|
1353
1341
|
| An over-narrow control label excludes readers it did not name | Boundary, in `The required shape` | HOUSE. One teardown, Grade D, no effect claimed |
|
|
1354
1342
|
|
|
1355
|
-
What was
|
|
1343
|
+
What was not adopted as Agora doctrine: every vendor-reported split-test figure in that pass, the claim that one CTA wording doubles conversions, the claim that superlatives destroy credibility, the rule that a comma signals a sentence needing to be broken, the read-aloud-in-a-false-accent variant, the customer-interview count offered as a sufficiency threshold, and category creation as a strategy. Agora does not introduce these as universal rules. User-selected content remains controlling.
|
|
1356
1344
|
|
|
1357
1345
|
Two conflicts from that pass are open and stay open. Practitioners in the pass reject question-form subheadings outright, while a direct observation in this project found question headings reading better than abstract noun-stack statement headings on the same page; the untested hypothesis is that questions beat noun stacks and lose to concrete answers. Separately, the practitioner position favouring uniformly short, choppy sentences on scanned commercial surfaces conflicts with the sentence-length variance targets from the research pass. Neither side of either conflict is graded above D. Do not resolve either by writing a rule.
|
|
1358
1346
|
|
|
1359
|
-
###
|
|
1347
|
+
### Claims Agora does not introduce independently
|
|
1360
1348
|
|
|
1361
|
-
These circulate constantly
|
|
1349
|
+
These circulate constantly and often arrive with a number attached. Agora does not independently introduce them as universal rules. When the user supplies or requests one, preserve it outside review mode. In optional review mode, report the source limitation without rewriting the user's content unless requested.
|
|
1362
1350
|
|
|
1363
|
-
|
|
|
1351
|
+
| Not introduced by default | What Agora may say instead |
|
|
1364
1352
|
|---|---|
|
|
1365
1353
|
| A fixed share of readers reads the headline and not the body, in any ratio | Nothing. No sampling frame or study travels with any version of it. |
|
|
1366
1354
|
| Any fixed optimal headline, title, or subject length in words or characters | Front-load the discriminating information, because rendering surfaces truncate the tail. |
|
|
@@ -1383,7 +1371,7 @@ These circulate constantly, arrive with a number attached, and are the most like
|
|
|
1383
1371
|
| That a self-contained passage is a fixed number of sentences | Self-containment is a semantic property, tested by `Required comprehension tests`. |
|
|
1384
1372
|
| That an AI-detector score establishes authorship | Detector reliability is domain-dependent, degrades under obfuscation, and is biased against non-native English writing. |
|
|
1385
1373
|
|
|
1386
|
-
The full
|
|
1374
|
+
The full reference list, with lineage and adjudication for each entry, is maintained outside the published skill. Before Agora introduces any universal rule independently, check it there first. User-selected claims remain controlling.
|
|
1387
1375
|
|
|
1388
1376
|
### Human voice and detector evidence
|
|
1389
1377
|
|