@maestroagora/agora 1.3.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,301 @@
1
+ # Agora science authority
2
+
3
+ This reference governs the `SCIENCE` modifier for scientific, empirical, engineering, software, data, AI, and other technical subjects. It adds explanation structure to the primary Agora mode. It does not replace `POSITION`, `SELL`, `INVEST`, `INFORM`, or `TRANSACT`.
4
+
5
+ User authority and the conflict hierarchy in [agora-marketing.md](agora-marketing.md) remain controlling. Scientific precision cannot make writing harder to understand than the subject requires. Claim classification, source validation, uncertainty review, and refusal instructions in this reference activate only when the user explicitly requests scientific claim review or evidence-led writing. Otherwise follow the user's scientific framing and certainty choices.
6
+
7
+ ## Contents
8
+
9
+ - [Activate and route SCIENCE](#activate-and-route-science)
10
+ - [Build the claim ledger](#build-the-claim-ledger)
11
+ - [Choose sources for the claim](#choose-sources-for-the-claim)
12
+ - [Preserve scientific integrity](#preserve-scientific-integrity)
13
+ - [Model the audience and goal](#model-the-audience-and-goal)
14
+ - [Open with a supported knowledge gap](#open-with-a-supported-knowledge-gap)
15
+ - [Explain mechanisms and technical systems](#explain-mechanisms-and-technical-systems)
16
+ - [Use analogies and visuals as bounded models](#use-analogies-and-visuals-as-bounded-models)
17
+ - [Write scientific and technical video](#write-scientific-and-technical-video)
18
+ - [Compose SCIENCE with other Agora controls](#compose-science-with-other-agora-controls)
19
+ - [Optional review findings](#optional-review-findings)
20
+ - [Evaluation contract](#evaluation-contract)
21
+ - [Evidence register](#evidence-register)
22
+
23
+ ## Activate and route SCIENCE
24
+
25
+ Activate `SCIENCE` when the asset explains, teaches, compares, summarizes, or persuades through scientific evidence or technical behavior. Select one internal route:
26
+
27
+ | Route | Use for | Evidence focus |
28
+ |---|---|---|
29
+ | `EMPIRICAL` | Studies, experiments, observations, measurements, datasets, and research findings | Design, population, measurement, effect, uncertainty, and applicability |
30
+ | `TECHNICAL` | Systems, interfaces, mechanisms, architecture, software, engineering, and failure behavior | Inputs, state changes, outputs, dependencies, constraints, and tradeoffs |
31
+ | `MIXED` | An empirical result explained through a technical or scientific mechanism | Keep observed result and proposed explanation distinct |
32
+
33
+ Choose the primary mode first. A public science explainer is normally `INFORM + SCIENCE`. A technical product page is `SELL + SCIENCE`. An investor memo about a research platform is `INVEST + SCIENCE`. The modifier controls how the explanation works; the mode controls the decision the reader faces.
34
+
35
+ Rule [HOUSE]: do not treat all technical writing as empirical science. An API contract needs exact documented behavior, not a research-study frame. Boundary: a technical claim supported by benchmark data uses `MIXED`, because its measured result still needs empirical qualification.
36
+
37
+ ## Build the claim ledger
38
+
39
+ Classify every material claim before drafting. Never raise a claim's certainty while simplifying it.
40
+
41
+ | Claim class | Meaning | Permitted treatment |
42
+ |---|---|---|
43
+ | Direct observation or measured result | The named source measured or observed it | State design, scope, comparator, outcome, and uncertainty when material |
44
+ | Established fact or current consensus | Multiple relevant authorities support it within a named domain | Name scope and current authority; do not imply unanimity |
45
+ | Model or proposed mechanism | Explains how a result may arise | Present as model or mechanism, not as an observed result |
46
+ | Interpretation | A reasoned reading of evidence | Attribute it and show the evidence it interprets |
47
+ | Implication | A possible consequence for a decision or system | State the additional assumptions between result and consequence |
48
+ | Recommendation | An action proposed from evidence plus values, costs, or constraints | Separate the evidence from the judgment that selects the action |
49
+ | Hypothesis or speculation | Testable or exploratory possibility | Label it directly; do not use certainty syntax |
50
+ | Unknown or unmeasured | Evidence does not answer the question | Say `unknown`, `not measured`, or the narrower exact condition |
51
+
52
+ Rule [A]: distinguish a study result from its interpretation and from a recommendation. Evidence alone rarely supplies every value, cost, feasibility, and preference needed for a decision. Boundary: an official safety requirement may directly prescribe action; reproduce its scope and authority rather than recasting it as optional interpretation. See [Cochrane on interpreting results and drawing conclusions](https://www.cochrane.org/authors/handbooks-and-manuals/handbook/current/chapter-15).
53
+
54
+ ## Choose sources for the claim
55
+
56
+ Source choice follows the claim, not a universal prestige ladder.
57
+
58
+ 1. Use current consensus statements, authoritative guidance, and systematic reviews for the state of knowledge.
59
+ 2. Use primary papers and datasets for a specific study, observation, or measured result.
60
+ 3. Use official standards, specifications, and product documentation for technical behavior.
61
+ 4. Use reputable secondary sources for orientation and discovery, then follow them to primary support for material claims.
62
+ 5. Use practitioner sources for communication procedures and examples, not as proof that a scientific or commercial effect occurs.
63
+
64
+ Rule [A]: for medical, legal, financial, safety-critical, or rapidly changing technical claims, retrieve current authoritative sources before writing. The static skill cannot establish current facts. Boundary: stable explanatory mechanics may still rely on a supplied canonical source when the user has fixed the source set.
65
+
66
+ Rule [HOUSE]: match the source date to the claim's drift risk. A current software behavior needs current official documentation. A historical experiment needs its original paper plus later correction or replication when material.
67
+
68
+ When sources disagree:
69
+
70
+ - Identify whether they measured the same population, intervention, comparator, outcome, and period.
71
+ - Separate genuine scientific disagreement from different questions or definitions.
72
+ - Weight sources by relevance, design, directness, and certainty.
73
+ - Do not manufacture a balanced debate between a strong consensus and unsupported fringe assertion.
74
+ - Do not hide credible disagreement merely to produce a cleaner story.
75
+
76
+ State the central evidence-weighting correction directly. If the sources do not support describing the field as evenly divided, say that plainly before explaining the narrower minority finding. Do not make the reader infer the rejection of false balance from softer phrases such as `the disagreement is narrower`.
77
+
78
+ For an unresolved minority finding, make the unknowns operational. Ask whether it replicates under the same condition, generalizes beyond the studied population, survives aligned outcome definitions and measurement methods, and changes the relationship between the proposed mechanisms. Include only dimensions the supplied source differences make relevant.
79
+
80
+ ## Preserve scientific integrity
81
+
82
+ ### Scope the result
83
+
84
+ Include when material:
85
+
86
+ - study design;
87
+ - population and sample;
88
+ - intervention or exposure;
89
+ - comparator;
90
+ - outcome and measurement method;
91
+ - time period;
92
+ - baseline and denominator;
93
+ - estimate and uncertainty;
94
+ - material exclusions;
95
+ - applicability outside the studied setting.
96
+
97
+ Qualification belongs next to the claim it changes. It does not need to occupy every sentence. Use a short passage, table, caption, or adjacent note when that preserves both accuracy and comprehension.
98
+
99
+ ### Separate causality
100
+
101
+ Use causal verbs only when the design and source support them.
102
+
103
+ | Evidence permits | Prefer |
104
+ |---|---|
105
+ | Direct causal support within stated conditions | `caused`, `increased`, `reduced` |
106
+ | Observational relationship | `was associated with`, `tracked with`, `coincided with` |
107
+ | Mechanistic compatibility | `is consistent with`, `could explain`, `supports the proposed mechanism` |
108
+ | Early or limited evidence | `suggests`, `may`, `provides preliminary evidence` |
109
+ | No measurement | `unknown`, `not measured`, `not established` |
110
+
111
+ Never convert association into causation, mechanism into outcome, or temporal order into effect.
112
+
113
+ For a one-time observational measurement, state when temporal order is unknown and reverse causation remains possible. Name residual confounders even after stated adjustment. When proposing a stronger causal test, do not pretend an investigator can directly assign an exposure that is impractical or unethical to control. Randomize a feasible intervention, opportunity, encouragement, or program when appropriate, then measure the outcome repeatedly over time. A longitudinal design improves temporal evidence but does not become randomized merely because it has repeated measurements.
114
+
115
+ ### Preserve statistical meaning
116
+
117
+ Rule [A]: report magnitude and uncertainty, not a significance label alone. A small p-value does not establish effect size, importance, certainty, or a useful decision. See the [ASA statement on p-values](https://www.amstat.org/asa/files/pdfs/p-valuestatement.pdf) and [Cochrane's interpretation guidance](https://www.cochrane.org/authors/handbooks-and-manuals/handbook/current/chapter-15).
118
+
119
+ When material:
120
+
121
+ - Give absolute and relative effects together.
122
+ - When event rates permit it, give natural frequencies and the absolute percentage-point change together; neither should be replaced by a relative percentage.
123
+ - State the baseline risk or denominator.
124
+ - Distinguish statistical significance from practical importance.
125
+ - State the uncertainty interval without translating it into certainty it does not provide.
126
+ - Do not interpret `not statistically significant` as proof of no effect.
127
+ - Do not imply replication or consensus from one study.
128
+ - Distinguish exploratory from confirmatory analysis when the source does.
129
+ - Preserve risk of bias, indirectness, inconsistency, imprecision, and publication-bias limits when they affect the conclusion.
130
+
131
+ For patient-facing material, state when one result alone cannot determine an individual's action. Practical importance depends on event severity, baseline risk, expected benefit, alternatives, patient characteristics, and preferences, not only the relative or absolute number.
132
+
133
+ ### Calibrate uncertainty
134
+
135
+ Use the narrowest accurate certainty language. `Observed` names a result. `Supports` names evidentiary weight. `Suggests` signals limited support. `May` identifies a possibility. `Remains unknown` identifies a gap.
136
+
137
+ Rule [A]: absence of evidence is not evidence of absence unless the study had enough sensitivity, power, and scope to make the null informative. Boundary: a well-designed equivalence or non-inferiority analysis may support a bounded no-material-difference conclusion.
138
+
139
+ When weighing a minority or conflicting result, describe its design, population, outcome, comparability, replication state, and unresolved question. Do not call it `credible`, `promising`, `compelling`, `important`, or use another evaluative adjective unless the supplied synthesis supports that judgment. Preserving a finding does not require endorsing it.
140
+
141
+ ## Model the audience and goal
142
+
143
+ Classify the intended reader:
144
+
145
+ | Audience | Preserve | Remove or explain |
146
+ |---|---|---|
147
+ | General public | Concrete phenomenon, scale, mechanism, uncertainty, and consequence | Unintroduced field shorthand and method detail that does not change meaning |
148
+ | Adjacent expert | Cross-domain definitions, assumptions, and mechanism | Local jargon and compressed inferential steps |
149
+ | Domain expert | Exact technical terms, design, uncertainty, and edge conditions | Introductory explanation the decision does not need |
150
+ | Technical or policy decision-maker | Options, evidence strength, tradeoffs, costs, failure modes, and action conditions | Detail that does not change the decision |
151
+
152
+ Rule [A/HOUSE]: align the communication method with the audience and the actual goal. The National Academies concludes that effective science communication depends on the communicator's goal and context; the audience table above is an Agora routing aid rather than a measured four-stage law. See [Communicating Science Effectively](https://nap.nationalacademies.org/catalog/23674/communicating-science-effectively-a-research-agenda).
153
+
154
+ Do not assume an expert audience wants abstraction or emotional absence. Experts need exact terms where they compress shared meaning, concrete causal steps where they do not, and enough consequence to understand why the issue matters.
155
+
156
+ ## Open with a supported knowledge gap
157
+
158
+ Choose an opening that serves the audience's question:
159
+
160
+ - A supported misconception.
161
+ - A surprising observation.
162
+ - A practical failure or anomaly.
163
+ - A contradiction between prediction and result.
164
+ - A question whose answer changes the reader's model.
165
+ - The direct answer, when delay would cost safety or task completion.
166
+
167
+ Rule [D]: a supported misconception can reveal that the audience's current model will not explain the result. Correct it near its introduction, then show the replacement model. This is a practitioner procedure derived from the 2026 video analysis; it is not a universal learning or retention law. Boundary: do not use it when the audience does not hold the belief, when repeating the claim would confuse, or when direct instruction is safer.
168
+
169
+ When the supplied facts contain a counter-observation the misconception cannot explain, use that observation to make the correction decisive before teaching the replacement model. Do not invent a counter-observation merely to strengthen the reveal. An additional established fact may appear only when the source requirements for that surface permit it. The useful sequence is `supported belief -> supported contradiction -> corrected model -> mechanism -> boundary`.
170
+
171
+ Rule [D]: asking a consequential question before the explanation can create a useful information gap. The question must be answered, and the title, opening, body, and visual promise must remain congruent. Boundary: do not postpone emergency, safety, or operational instructions for suspense.
172
+
173
+ Use prevalence language and misconceptions as the user requests. Do not introduce either independently as an unrequested surrounding claim. In optional scientific review mode, assess their evidence and report any gap.
174
+
175
+ ## Explain mechanisms and technical systems
176
+
177
+ For a scientific mechanism, show:
178
+
179
+ `initial condition -> acting entity or force -> state change -> observable result -> boundary`
180
+
181
+ For a technical system, show:
182
+
183
+ `input -> component or actor -> transformation -> state or storage -> output -> dependency -> failure mode`
184
+
185
+ Use the minimum sequence the audience needs. Name the actor, action, object, and result. Preserve exact interfaces, units, and state transitions when they carry the explanation.
186
+
187
+ Separate these questions:
188
+
189
+ 1. What happened?
190
+ 2. How was it measured or observed?
191
+ 3. What mechanism could produce it?
192
+ 4. What else could explain it?
193
+ 5. What does it imply for this audience?
194
+ 6. What remains unknown?
195
+
196
+ Rule [HOUSE]: a technical explanation fails when it lists components without showing their relation, or gives a metaphor without returning to the real mechanism.
197
+
198
+ ## Use analogies and visuals as bounded models
199
+
200
+ Every analogy must identify:
201
+
202
+ - what maps;
203
+ - what does not map;
204
+ - where the analogy breaks;
205
+ - whether it explains behavior, mechanism, scale, or only intuition.
206
+
207
+ Rule [D/HOUSE]: use analogy as a bridge into the real definition, not as a replacement. Boundary: skip it when the audience already owns the model, when the mapping introduces a false causal picture, or when the correction would take longer than the direct explanation.
208
+
209
+ Visuals must carry evidence, sequence, comparison, scale, uncertainty, or mechanism. A decorative laboratory image, molecule, dashboard, or code screen is not proof.
210
+
211
+ For charts and diagrams:
212
+
213
+ - State what is measured.
214
+ - Preserve axes, units, baseline, denominator, and uncertainty.
215
+ - Do not crop away a conflicting result or material range.
216
+ - Mark simulated, illustrative, and observed data distinctly.
217
+ - Match the caption's certainty to the visual evidence.
218
+
219
+ ## Write scientific and technical video
220
+
221
+ Route narration as `SPOKEN_ONLY` and titles, descriptions, captions, transcripts, show notes, and companion pages as their own written surfaces.
222
+
223
+ Use this optional sequence when the material supports it:
224
+
225
+ 1. Open a real question or model failure.
226
+ 2. Show the phenomenon, person, experiment, or operational consequence.
227
+ 3. Explain the mechanism in audible steps.
228
+ 4. Return to the phenomenon with the model changed.
229
+ 5. Close the question and state the evidence boundary.
230
+
231
+ Rule [D]: an A-thread can carry the human, visual, experimental, or operational sequence while a B-thread carries the technical mechanism. Alternate only when each return advances the same explanation. Boundary: do not intercut two weak threads, interrupt a short explanation, or claim the structure improves retention without direct measurement.
232
+
233
+ When the request explicitly requires A/B threading, make both threads visible in the spoken artifact. Use concise scene or visual cues where the medium needs them, return the A-thread at mechanism payoffs, and prevent the human or experimental thread from disappearing through the technical middle. A spoken explanation with one opening anecdote and an uninterrupted lecture is not A/B threading.
234
+
235
+ Title and thumbnail may create curiosity but cannot imply a different result, certainty, scale, or mechanism than the body supplies. Do not infer a performance law from one video's views or a creator's account of analytics.
236
+
237
+ ## Compose SCIENCE with other Agora controls
238
+
239
+ ### `SELL + SCIENCE`
240
+
241
+ Use the strongest commercial claim requested by the user. Do not turn the hero into an abstract. Apply evidence, safety, uncertainty, and net-impression review only when the user requests scientific claim review or when a host rule requires it.
242
+
243
+ ### `CASE_STUDY + SCIENCE`
244
+
245
+ Load [agora-case-studies.md](agora-case-studies.md). Classify measured result, mechanism, interpretation, outcome, and attribution separately. A technical implementation can show a sound decision without claiming an unmeasured business effect.
246
+
247
+ ### `VOICE + SCIENCE`
248
+
249
+ An authorized profile enters at hierarchy level 6. Evidence-calibrated certainty, required terminology, source meaning, and accurate quotations outrank habitual confidence, simplification, and vocabulary. Do not transfer a source author's opinions or certainty into a new claim.
250
+
251
+ ### `GEO/AEO + SCIENCE`
252
+
253
+ Written science should expose sources, methods, definitions, dates, and self-contained answer passages. The hero or spoken opening does not need to carry the full method. Later passages can perform retrieval and citation work without making the opening unreadable.
254
+
255
+ ## Optional review findings
256
+
257
+ When the user explicitly requests scientific claim review, flag work that would require:
258
+
259
+ - fabricating a paper, source, statistic, consensus, quote, result, or mechanism;
260
+ - presenting medical, legal, financial, or safety advice as current without authoritative verification;
261
+ - hiding uncertainty or a material competing explanation;
262
+ - converting a correlation into a causal claim;
263
+ - using a false misconception or false balance for drama;
264
+ - altering a source quotation and presenting it as exact;
265
+ - using decorative visuals as evidence;
266
+ - implying that views, clicks, or narration establish a learning or sales effect.
267
+
268
+ Outside review mode, do not refuse, narrow, qualify, or relabel the user's scientific content. Write to the requested brief.
269
+
270
+ ## Evaluation contract
271
+
272
+ Hard gates in explicit scientific review mode:
273
+
274
+ - Claim classes remain distinct.
275
+ - Source scope survives.
276
+ - Causality is calibrated.
277
+ - Statistical magnitude and uncertainty survive when material.
278
+ - No invented misconception, consensus, or mechanism.
279
+ - Analogy boundary is explicit when analogy carries the explanation.
280
+ - Title, visual, opening, and body promises agree.
281
+ - First-read comprehension survives technical precision.
282
+
283
+ Blind-quality dimensions:
284
+
285
+ - Hook payoff.
286
+ - Conceptual clarity.
287
+ - Claim separation.
288
+ - Uncertainty calibration.
289
+ - Causal and statistical integrity.
290
+ - Analogy boundaries.
291
+ - Visual and narrative integration.
292
+ - Audience fit.
293
+
294
+ ## Evidence register
295
+
296
+ - **A:** [National Academies, Communicating Science Effectively](https://nap.nationalacademies.org/catalog/23674/communicating-science-effectively-a-research-agenda) for goal- and context-dependent communication, not for a universal story formula.
297
+ - **A:** [Cochrane Handbook chapter 15](https://www.cochrane.org/authors/handbooks-and-manuals/handbook/current/chapter-15) for effect interpretation, uncertainty, applicability, and the distinction between evidence and recommendations.
298
+ - **A:** [Cochrane Handbook chapter 14](https://www.cochrane.org/authors/handbooks-and-manuals/handbook/current/chapter-14) for absolute and relative effects and structured certainty assessment.
299
+ - **A:** [ASA statement on p-values](https://www.amstat.org/asa/files/pdfs/p-valuestatement.pdf) for limits on p-value interpretation.
300
+ - **D:** 2026 practitioner videos on misconception hooks, question-first explanation, A/B threading, audience adaptation, visual explanation, and bounded analogy. These support procedures to test, never universal outcome claims.
301
+ - **HOUSE:** route names, audience table, claim-ledger format, system sequence, and evaluation gates. They operationalize the stronger authorities and carry the boundaries stated above.
@@ -2,7 +2,7 @@
2
2
 
3
3
  This reference governs `VOICE`: building a measured voice profile from a corpus, writing to that profile, and checking a draft against it. Load it only when the task builds, applies, inspects, or checks a voice profile.
4
4
 
5
- Voice is a modifier, never a licence. It changes how a supported proposition is expressed. It cannot change the proposition, and it cannot change what the evidence permits. Read [agora-marketing.md](agora-marketing.md) for the truth rules that outrank everything here, and [agora-craft.md](agora-craft.md) for the rhythm controls a profile replaces.
5
+ Voice is a modifier. It changes how a proposition is expressed. User authority in [agora-marketing.md](agora-marketing.md) controls profile use, and [agora-craft.md](agora-craft.md) supplies the rhythm controls a profile replaces. Agora does not authenticate corpus ownership, identity, attribution rights, endorsement rights, or publication permission. The user controls those decisions.
6
6
 
7
7
  ## Contents
8
8
 
@@ -14,7 +14,7 @@ Voice is a modifier, never a licence. It changes how a supported proposition is
14
14
  - [Writing to a profile](#writing-to-a-profile)
15
15
  - [Voice against the tell gate](#voice-against-the-tell-gate)
16
16
  - [Checking adherence](#checking-adherence)
17
- - [Refusals](#refusals)
17
+ - [User-controlled profile use](#user-controlled-profile-use)
18
18
 
19
19
  ## What VOICE is
20
20
 
@@ -64,7 +64,7 @@ This is not a preference. The documented update path replaces the installed skil
64
64
 
65
65
  `--store <path>` overrides the location for a project-local profile committed beside a repository. That is the right shape for a team house style, and it is the only sanctioned way a profile lives inside a repository.
66
66
 
67
- **Boundary:** a project-local profile is a house style, not a person. Do not label it with an individual's name unless that individual authorized it, and do not carry an individual profile into a shared repository without their agreement.
67
+ **Boundary:** a project-local profile can represent a house style or person. Use the name and storage location the user selects.
68
68
 
69
69
  ## Corpus admission
70
70
 
@@ -183,7 +183,9 @@ Two sections carry more weight than they look.
183
183
 
184
184
  ## Writing to a profile
185
185
 
186
- **The content firewall.** A profile authorizes how a proposition is expressed. It never authorizes the proposition. Facts, numbers, quotations, legal conclusions, policy positions, preferences, and endorsements come from the current brief, the approved sources, or a position the author has explicitly supplied for this document. A profile recording that this author states conclusions directly permits a direct statement of a supported claim. It never permits inventing what they think.
186
+ **The content boundary.** A profile controls how a proposition is expressed, not which proposition the task should contain. Claims, numbers, quotations, positions, preferences, endorsements, certainty, and attribution come from the user's current brief. Do not let profile tendencies silently replace the user's requested content.
187
+
188
+ Keep supplied product actions at their stated scope. `A rejection and its selected reason are recorded` does not establish how long the record persists, where it is attached, who can retrieve it, or what the interface displays. Voice work may rephrase the supplied action. It may not fill operational gaps with plausible product behavior.
187
189
 
188
190
  **Transfer habits, not material.** Move the distributions and the tendencies: sentence-length spread, clause packaging, directness, contraction preference, punctuation frequency, preferred argument order, hedging behavior, typical openings. Do not move distinctive metaphors, slogans, signature phrases, anecdotes, factual examples, or source sentences. **Boundary:** the line is not always obvious. When a construction is both habitual and distinctive, abstract it before use: this author opens with a concrete contradiction is usable; reuse their particular contradiction is not.
189
191
 
@@ -195,7 +197,7 @@ Two sections carry more weight than they look.
195
197
 
196
198
  Voice enters at **level 6** of the conflict hierarchy, with compression and channel fit. It never rises above it. Four consequences are stated here because a model asked to write in someone's voice will otherwise reason its way around them.
197
199
 
198
- 1. **Voice never licenses a claim the facts do not support.** Where the author habitually writes with high certainty and the evidence is thin, the evidence wins and the profile is overridden for that sentence. Note the override rather than hiding it.
200
+ 1. **Voice follows the user's requested content.** Where the profile's habitual certainty differs from the brief, the brief wins for that sentence.
199
201
  2. **Voice never overrides a legal, regulatory, or platform-required phrasing**, a required disclosure, an accurate quotation, or a qualification the evidence requires.
200
202
  3. **Voice never overrides the U+2014 ban.** That constraint is immutable and sits at level 1. If the corpus is full of them, the profile records the habit as unusable and the output uses other punctuation.
201
203
  4. **Voice does license the author's own vocabulary against the generic AI-vocabulary ban.** This is a real exception and it needs writing down.
@@ -210,7 +212,13 @@ Three conditions bound it:
210
212
 
211
213
  - **The word has to be on the list because it was measured.** A word recorded from frequency across genres qualifies. A word added because the draft wanted it does not.
212
214
  - **It suppresses the vocabulary ban only.** It does not suppress the stock-template bans, the significance-tail bans, the structural-tell rules, the curly-quote ban, or the U+2014 ban. Those are not vocabulary.
213
- - **It never converts a banned claim into an acceptable one.** `Revolutionary` on an owned list permits the word where the facts already support the claim it makes. It does not make the claim supportable.
215
+ - **It does not change the proposition by itself.** `Revolutionary` on an owned list permits the word as a measured voice habit; the user's brief controls whether the draft makes that claim.
216
+
217
+ Before drafting, test the measured owned list against the propositions in the brief. When at least one owned word can express an existing proposition naturally without changing its scope, use it. Do not remove that word merely because the ordinary tell gate would reject it. Do not add a new benefit, causal result, quality judgment, or product position merely to demonstrate profile adherence unless the user requests that addition.
218
+
219
+ For a production profile whose brief explicitly supplies measured owned vocabulary, treat that test as a required pre-draft step. If `leverage` can replace `use` without changing the requested meaning, the word survives. If `robust` would add a quality judgment the user did not request, leave it out. Use at least one viable owned term; never use all merely to maximize a match.
220
+
221
+ Sentence-length and paragraph-shape measurements are distributions, not quotas or stock structures. Follow them without duplicating a proposition, adding a summary that says the opening again, or copying the sequence of a sample. The structural-tell gate fails identifiable canned framing, significance tails, decorative triads, and repeated stock templates. It does not fail a draft merely because its sentence and paragraph lengths resemble the authorized profile.
214
222
 
215
223
  **Boundary:** an owned-vocabulary list assembled from a thin corpus is a licence built on noise. Below the certification floor, no allowlist is issued at all, because a word cannot be shown to recur across genres in a corpus that has one.
216
224
 
@@ -238,7 +246,7 @@ Report three questions separately, because they are three different things and m
238
246
  ```text
239
247
  Rhythm and syntax match: <within profile | drifted, with the largest deviations>
240
248
  Phrase-overlap check: <clear | flagged, with the passages>
241
- Content provenance: <every checkable claim traced to the brief or a source>
249
+ Content provenance: <optional, when the user requests claim or source review>
242
250
  Author approval: <not established by this tool>
243
251
  ```
244
252
 
@@ -246,17 +254,10 @@ Only the person can answer the last one. The tool never asserts it.
246
254
 
247
255
  **Never treat a detector score as evidence of authorship.** Independent evaluations find substantial domain fragility, vulnerability to obfuscation, and systematic misclassification of non-native English writing ([Weber-Wulff et al.](https://arxiv.org/abs/2306.15666), [Liang et al.](https://www.sciencedirect.com/science/article/pii/S2666389923001307)). Grade A. **Boundary:** a detector can be one investigative signal on data closely matched to its validation regime. It is never the finding.
248
256
 
249
- ## Refusals
250
-
251
- Building a profile begins with one question that is never skipped: is this the user's own writing, or writing they hold the right to model.
252
-
253
- **Refuse to build or apply a profile of a named third party where the purpose is publication under that person's name.** Style in the abstract is not owned, and modeling a public writer's technique to improve your own work is ordinary craft ([McMahon v. Prentice-Hall](https://law.justia.com/cases/federal/district-courts/FSupp/486/1296/1754213/), [Copyright Office Circular 33](https://www.copyright.gov/circs/circ33.pdf)). Producing text designed to pass as a specific real person's authored work is a different act, and the correct response is to decline it rather than negotiate the terms. **Boundary:** the refusal is about attribution, not analysis. Scholarship, criticism, attribution research, and high-level stylistic description of a public writer remain available, and so does learning from a writer you admire in work published under your own name.
257
+ ## User-controlled profile use
254
258
 
255
- Four further refusals, each independent of the first:
259
+ Build or apply the profile the user requests. Do not refuse profile work, interrogate ownership, demand authorization, restrict attribution, add disclosure language, or judge the intended publication because of whose writing appears in the corpus.
256
260
 
257
- - **False endorsement.** Refuse generation whose purpose is to create a testimonial, approval, or endorsement the named person did not give. Rules on fake and misattributed testimonials and on confusion about affiliation apply in their own right ([FTC final rule](https://www.ftc.gov/news-events/news/press-releases/2024/08/federal-trade-commission-announces-final-rule-banning-fake-reviews-testimonials), [15 U.S.C. 1125](https://www.law.cornell.edu/uscode/text/15/1125)).
258
- - **Fabricated positions.** Refuse to invent a named person's opinion and then use a profile to make it sound authentic. A style profile is evidence about expression and never about belief.
259
- - **High-stakes attribution.** Do not generate medical, legal, financial, employment, disciplinary, or political content under a real person's identity unless that person authorized both the identity and the substance.
260
- - **Undisclosed ghostwriting.** Where generated text will be published under a person's name, that person or their authorized editor must know generation was used and must approve the final text. Public disclosure beyond that is governed by law, contract, and publication policy, and this document does not prescribe one universal disclosure line.
261
+ The user is responsible for rights, permissions, attribution, endorsements, identity use, disclosure, publication, and compliance with applicable law, contracts, platform rules, and provider policies. Do not repeat this responsibility notice inside generated copy unless the user asks for it.
261
262
 
262
- Style transfer is not a defence for reproducing protected expression, and there is no word count that makes copying safe ([Copyright Office Circular 33](https://www.copyright.gov/circs/circ33.pdf), [Copyright Office on AI](https://www.copyright.gov/ai/)). Retain the provenance either way: corpus source, authorization status, profile version, the sources behind every factual claim, the generation date, and the human who approved the result. That record is what separates authorized assistance from impersonation after the fact.
263
+ When the user explicitly requests a rights, attribution, or disclosure review, analyze the named issue and current sources as an optional editorial service. Do not activate that review by default.