@maestroagora/agora 1.3.0 → 1.5.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maestroagora/agora",
-  "version": "1.3.0",
-  "description": "Install Maestro: Agora for argument-first buyer, investor, positioning, editorial, interface, and spoken copy grounded in verified facts.",
+  "version": "1.5.0",
+  "description": "Install Maestro: Agora for persuasive writing, scientific and technical explanation, case studies, fundraising, and investment analysis.",
   "type": "module",
   "bin": {
     "agora": "scripts/install.mjs",
@@ -23,10 +23,13 @@
     "skills/agora"
   ],
   "scripts": {
-    "check": "npm run validate && npm test && npm run pack:check",
+    "check": "npm run validate && npm test && npm run pack:check && npm run hygiene:check",
+    "hygiene:check": "node scripts/release-hygiene.mjs",
     "pack:check": "node scripts/pack-check.mjs",
-    "prepublishOnly": "npm run check",
-    "test": "node --test tests/behavior-contract.test.mjs tests/install.test.mjs tests/voice-measure.test.mjs",
+    "prepack": "npm run release:check",
+    "prepublishOnly": "npm run release:check",
+    "release:check": "npm run check",
+    "test": "node --test tests/behavior-contract.test.mjs tests/hero-contract.test.mjs tests/science-contract.test.mjs tests/case-study-contract.test.mjs tests/invest-contract.test.mjs tests/blind-summary.test.mjs tests/release-hygiene.test.mjs tests/install.test.mjs tests/voice-measure.test.mjs",
     "validate": "node scripts/validate.mjs"
   },
   "engines": {
@@ -50,6 +53,12 @@
     "maestro",
     "marketing",
     "copywriting",
+    "science-communication",
+    "technical-writing",
+    "case-studies",
+    "fundraising",
+    "investor-communications",
+    "pitch-decks",
     "codex",
     "claude-code",
     "cursor",

package/scripts/install.mjs

@@ -247,7 +247,12 @@ async function verifySource() {
   const required = [
     "SKILL.md",
     "agents/openai.yaml",
+    "references/agora-case-studies.md",
+    "references/agora-craft.md",
+    "references/agora-invest.md",
     "references/agora-marketing.md",
+    "references/agora-science.md",
+    "references/agora-voice.md",
   ];
   for (const file of required) {
     if (!(await exists(join(SOURCE_DIR, file)))) {

package/skills/agora/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agora
-description: Write, rewrite, shorten, critique, or plan truthful argument-first persuasion. Use when invoked as `/agora` or for marketing and sales copy; investor, funding, pitch, company-profile, category, or brand descriptions; CTAs and microcopy; landing, product, and comparison pages; email and direct outreach; mobile onboarding, upgrade, and paywall screens; ads and social posts; editorial or educational content; and spoken audio/video scripts plus written derivatives such as titles, descriptions, transcripts, captions, show notes, and companion pages.
+description: Write, rewrite, shorten, critique, or plan truthful argument-first persuasion, scientific and technical explanation, case studies, and investment communication. Use when invoked as `/agora` or for marketing and sales copy; fundraising, investor outreach, pitch decks, investment memos, diligence, capital allocation, company-profile, category, or brand descriptions; CTAs and microcopy; landing, product, and comparison pages; email and direct outreach; mobile onboarding, upgrade, and paywall screens; ads and social posts; editorial or educational content, including fictional, mock, hypothetical, or concept writing; scientific communication, technical explanation, research communication, and science video scripts; real or fictional customer success, creative portfolio, and technical implementation case studies; and spoken audio/video scripts plus written derivatives such as titles, descriptions, transcripts, captions, show notes, and companion pages.
 ---
 
 # Maestro: Agora
@@ -30,9 +30,10 @@ Use [references/agora-marketing.md](references/agora-marketing.md) as the canoni
 
 Locate the named headings and read those sections only. Do not load the entire reference unless the task genuinely spans most of it.
 
-[references/agora-craft.md](references/agora-craft.md) is a second, narrower authority covering four domains the first one does not. Load it only for the job it covers:
+[references/agora-craft.md](references/agora-craft.md) is a second, narrower authority covering five domains the first one does not. Load it only for the job it covers:
 
 - `Headlines and titles` for any headline, subheading, page title, search title, social title, subject line, video title, or a set of headings written for one deliverable.
+- `Heroes and short-form sales composition` for a homepage hero, campaign hero, pricing hero, short ad, subject line, sales opening, or another attention-led `SELL` surface.
 - `Awareness and sophistication staging` when the brief states or implies what the reader already knows, when deciding whether to name a mechanism, or when routing one fact set across several reader states.
 - `Emotion under a truth constraint` when choosing the emotional job, and whenever the supplied facts contain no outcome data, testimonials, or market claims.
 - `Prosody and rhythm` when rewriting for cadence, when a draft reads as machine-uniform, or when applying an authorized voice profile.
@@ -41,6 +42,12 @@ Do not load it for routine drafting, claim review, compliance questions, or work
 
 [references/agora-voice.md](references/agora-voice.md) governs `VOICE`. Load it only when the task builds a voice profile, writes with `--voice`, inspects a profile, or checks a draft against one. Do not load it for ordinary human-voice cleanup, which the tell gate already covers.
 
+[references/agora-science.md](references/agora-science.md) governs `SCIENCE`. Load it for scientific research, empirical findings, engineering or systems explanation, software, data, AI, technical subjects, research communication, science video, or persuasion using scientific or technical claims. Do not load it merely because a product is called technical.
+
+[references/agora-case-studies.md](references/agora-case-studies.md) governs `CASE_STUDY`. Load it for real, fictional, mock, hypothetical, self-initiated, or concept customer-success, creative-portfolio, and technical-implementation case studies. Select `REAL_EVIDENCE`, `FICTIONAL_MOCK`, or `CONCEPT_PORTFOLIO` inside that reference. Academic and clinical case reports are outside this modifier. Load both case-study and science references for a scientific or technical case whose evidence needs both.
+
+[references/agora-invest.md](references/agora-invest.md) governs `INVEST`. Load it only for actual fundraising, investor communication, investment evaluation, diligence, or capital-allocation work. Select `FUNDRAISE`, `DILIGENCE`, or `ALLOCATE` internally. Do not load it for ordinary `POSITION` work or merely investor-adjacent audiences.
+
 Treat source material supplied in the current task as the available product truth. Do not import facts, claim rules, or release controls from another task, repository, company, or example. Examples teach structure, never facts.
 
 ## Resolve conflicts
@@ -62,6 +69,7 @@ Two specific conflicts resolve as follows, because both have produced accurate b
 - **Qualification against comprehension.** Level 2 requires preserving scope, date, condition, and uncertainty. It does not require carrying every qualifier inside every sentence. Qualify at the passage or section level. A sentence that carries its full qualification set inline reads as a compliance memo and fails level 3.
 - **Citability against comprehension.** Written GEO/AEO asks for passages that stay accurate when quoted alone. That rule governs the passage, not the sentence. Do not compress a paragraph of context into one self-sufficient sentence. Self-containment is achieved by keeping a short passage together, not by loading one clause.
 - **Voice against everything above it.** An active voice profile enters at level 6. It never licenses a claim the facts do not support, never overrides required or legal phrasing, and never overrides the U+2014 ban. Where an author's habitual certainty exceeds the evidence, the evidence wins and the profile yields for that sentence.
+- **Measured vocabulary against the tell gate.** When a production profile supplies owned vocabulary and at least one owned word can state a supplied fact without changing its scope, use at least one. The generic vocabulary ban cannot remove it. Do not force a word that would add a benefit, quality judgment, capability, or position the brief does not support.
 
 When soft rules conflict, preserve the strongest truthful argument that the reader can follow on the first pass. Ask only when missing information would materially change the audience, offer, claim, or action. Otherwise narrow or omit the unsupported point.
 
@@ -77,7 +85,13 @@ Select one primary mode. An explicit mode wins unless it would require factual d
 | `INFORM` | Editorial or educational work |
 | `TRANSACT` | Buttons, confirmations, alerts, forms, or utility microcopy |
 
-`VOICE` is the exception to selecting one mode. It is a modifier, not a job: `--voice <name>` loads a measured author profile on top of whichever mode was already chosen, and `voice build`, `voice list`, and `voice check` are its own operations. Profiles are stored at `~/.agora/voices/`, never inside the skill directory, because the documented update path replaces that directory and would destroy them.
+When the mode is `INVEST`, select one internal perspective after loading the investment reference: `FUNDRAISE` for a company seeking capital, `DILIGENCE` for an investor evaluating an opportunity, or `ALLOCATE` for comparing uses of capital. These routes do not replace the mode and are not public flags.
+
+`SCIENCE`, `CASE_STUDY`, and `VOICE` are modifiers, not primary jobs. Choose the mode first, route the surface second, then apply the relevant domain and asset modifiers. Apply `VOICE` afterward at conflict level 6. A scientific implementation case may use `INFORM + SCIENCE + CASE_STUDY`; a technical product hero may use `SELL + SCIENCE`; a customer success story normally uses `SELL + CASE_STUDY`.
+
+For `CASE_STUDY`, select evidence status separately from family. `REAL_EVIDENCE` prohibits filling missing history or proof. `FICTIONAL_MOCK` permits invention inside an explicitly fictional, mock, synthetic, demo, or sample brief. `CONCEPT_PORTFOLIO` permits a self-initiated or speculative scenario while prohibiting an implied real client, commission, shipped state, research record, or measured outcome. Disclose fictional or concept status when a reader could mistake the work for factual evidence.
+
+`--voice <name>` loads a measured author profile on top of whichever mode was already chosen, and `voice build`, `voice list`, and `voice check` are its own operations. Profiles are stored at `~/.agora/voices/`, never inside the skill directory, because the documented update path replaces that directory and would destroy them.
 
 Apply the default profile to every mode. When `~/.agora/voices/index.json` names a default and the request carries no voice instruction, load that profile for `POSITION`, `SELL`, `INVEST`, `INFORM`, and `TRANSACT` alike:
 
@@ -106,6 +120,33 @@ Do not confuse mode with surface. Classify each deliverable:
 | `SPOKEN_ONLY` | Proof fidelity, breath, rhythm, timing, and listener comprehension; skip GEO/AEO formatting |
 | `HYBRID` | Route spoken delivery and each written derivative separately |
 
+## Select persuasion treatment internally
+
+For commercial work, select one internal treatment. Do not expose the label unless the user asks for the reasoning.
+
+| Treatment | Default use | Objective |
+|---|---|---|
+| `INFORMATIONAL` | Documentation, methodology, audit, legal, safety, and utility states | Accurate understanding |
+| `PERSUASIVE_EXPLANATORY` | Product sections, comparisons, buyer guides, case studies, and mid-funnel pages | Supported belief through mechanism and proof |
+| `COMMERCIALLY_ASSERTIVE` | Homepage and campaign heroes, ads, subject lines, and sales openings | Attention, desire, distinction, and continuation |
+| `PROMOTIONAL` | Warm launches and limited campaigns with supplied urgency, novelty, availability, or outcome evidence | Decisive action |
+
+`SELL` plus an attention surface defaults to `COMMERCIALLY_ASSERTIVE`. Mid-funnel `SELL` defaults to `PERSUASIVE_EXPLANATORY`. `PROMOTIONAL` requires explicit campaign context and verified support. Missing support lowers the treatment. No treatment weakens truth, safety, offer, qualification, or destination fidelity.
+
+For a hero or other attention-led `SELL` composition, do not spend the subhead inventorying inputs, features, outputs, or methodology omitted from the headline. Use it for one reader-owned bridge from promise to belief: the minimum category, mechanism, difference, or proof needed to trust the next step. Compress multiple data feeds into the relation they establish. Move remaining scope below the hero. The canonical procedure and boundary are in `Heroes and short-form sales composition`.
+
+For `HERO + SCIENCE`, keep the first screen persuasive and comprehensible while preserving material uncertainty close enough to prevent a false net impression. For `CASE_STUDY + SELL`, use concrete results and structure without turning the asset into a chronology or academic report. For `SCIENCE + VOICE`, calibrated certainty and required terminology override the profile.
+
+For `SCIENCE + CASE_STUDY`, use scan-ready headings for implementation, validation result, limitation, role, and next decision when those elements are supplied. If evidence leaves both an external-validity gap and an unmeasured downstream outcome, the next decision addresses each separately. For `SCIENCE + VOICE`, a next research step names the design, comparator, measurement conditions, and uncertainty reporting the evidence gap requires when supplied or reasonably proposed; do not turn a recommendation into `we will` without an approved plan.
+
+For a high-stakes hero, controlled commercial force comes from the inspectable operational decision or human agency, not a generic capability label or escalated fear. Preserve the exact named checks, quantifiers, obligations, human-review step, and material limitations across the composition.
+
+For `INVEST + SCIENCE`, technical uncertainty and current authoritative verification override vision language. For `INVEST + CASE_STUDY`, a customer case stays bounded to its subject, period, intervention, and measurement rather than proving general market performance. For `INVEST + VOICE`, financial records, forecast class, required disclosure, and uncertainty override habitual certainty or bravado. In every `INVEST` route, keep distinct absence states separate: no term sheet, no stated amount, and no formal diligence cannot become the umbrella claim `no investment terms`. Apply GEO/AEO to public investment assets only, never automatically to private decks, meetings, or diligence.
+
+For a one-paragraph `INVEST` summary, give the result, material limit, interpretation, and capital use separate sentence jobs. Do not compress them into a `rather than ... but ...` clause stack. Do not call something a `wedge` unless the source or authorized strategy names it that way.
+
+Do not discount an investment limit with `but`. Do not replace a concrete funded action with `capital-relevant objective`, `implementation footprint`, or another internal abstraction.
+
 ## Build the argument with variable depth
 
 Start from the decision the audience faces. Build an internal path from:
@@ -126,8 +167,12 @@ For `POSITION`, make the company legible, consequential, and distinct without pi
 
 For a very short `POSITION` asset with no supplied trend or outcome, draft a trigger-first sentence before any category sentence: `When [verified condition], [subject] [mechanism].` Keep that shape when it sounds natural. It creates tension from the supplied workflow without inventing impact.
 
+In that trigger-first shape, retain the subject's primary supplied operation. A condition-led opening may reorder the workflow, but it may not reduce the company to an error state or downstream action when the core verb carries the distinction. This is a HOUSE fidelity rule; it does not require every minor workflow step.
+
 For very short `SELL` work with no outcome proof, name the exact supplied constraint, conflict, threshold, or blocked action. Do not weaken it into generic words such as `complexity`, `challenges`, or `constraints` when the facts are more specific.
 
+For any short word-bounded asset, do not fill the range by restating the same mechanism in a closing sentence.
+
 ## Rank proof before drafting
 
 Rank candidate facts by decision relevance, differentiation, verifiability, specificity, compression value, and omission risk.
@@ -135,6 +180,8 @@ Rank candidate facts by decision relevance, differentiation, verifiability, spec
 - Keep the few facts that do the most decision work.
 - Prefer evidence that resolves the biggest live doubt over impressive but decorative facts.
 - Preserve named scope, counts, coverage, entities, qualifications, and material limits when they carry the argument.
+- When the brief marks every limit as material, state each limit explicitly. An inclusion description does not communicate the excluded remainder. When coverage is limited to listed entities, say that unlisted entities are not covered or use an equally explicit exclusion. `Each listed entity` alone does not state the boundary.
+- A supplied start date does not state whether earlier records are unavailable. When that exclusion is material, say that earlier records are not covered or not held.
 - Keep factual enumerations when the list qualifies, compares, states scope, supports a decision, or prevents a misleading omission.
 - Remove feature volume that buries the stake, mechanism, or strongest differentiator.
 
@@ -178,6 +225,14 @@ If any answer is no, replace the term or define it in place. Every term the read
 
 Treat a noun the organization coined as a term the reader has no reason to know. Naming an internal method, stage, score, record type, or framework in customer-facing copy requires the reader to gain something from learning it. Otherwise state what happens and drop the name.
 
+### Keep control-room vocabulary backstage
+
+Agora may use `evidence`, `proof`, `verified`, `claim discipline`, `source scope`, and `evidentiary boundary` internally. Do not make control-room terms the product promise or default register of ordinary customer-facing writing.
+
+Name the concrete result, finding, number, quote, source, report, study, test, project record, observed change, or unknown instead. Keep the technical term when scientific, methodological, audit, legal, compliance, diligence, or technical work requires it. Translate according to the material, not one preferred synonym.
+
+Missing support is an editing instruction unless the absence changes the reader's decision, prevents a misleading interpretation, or is a required disclosure. Narrow or omit the premise. Never fill public copy or a word count by narrating the source review.
+
 ### Prefer actor, action, object, result
 
 Answer these before drafting a sentence: who or what acts, what it does, what it acts on, and what changes for the reader.
@@ -216,9 +271,9 @@ The team's own fatigue with a line is not a reader-side signal. The people who w
 
 A call to action names an action, not a mood. It tells the reader what happens after they choose it.
 
-Use `clear verb + concrete object, destination, or result`. Match the commitment to the destination and to the evidence the copy has actually delivered. Do not put a dramatic or high-commitment label on an informational destination.
+Use `clear verb + concrete object, destination, or result`. Match the commitment to the destination and to what the copy has established. Do not put a dramatic or high-commitment label on an informational destination.
 
-Workable shapes include `View the report`, `Compare plans`, `Check eligibility`, `See the recommended fixes`, `Review the evidence`, `Book a product demo`, `Start the assessment`, `Download the guide`, `Contact the sales team`, and `Retry the payment`.
+Workable shapes include `View the report`, `Compare plans`, `Check eligibility`, `See the recommended fixes`, `Review the results`, `Open the study`, `Book a product demo`, `Start the assessment`, `Download the guide`, `Contact the sales team`, and `Retry the payment`.
 
 Reject slogan-shaped labels such as `Take control`, `Move with confidence`, `Fix what matters`, `See the difference`, `Unlock your potential`, `Transform your results`, `Start your journey`, `Make it count`, and `Get clarity`. Reject them for operational ambiguity, because the reader cannot tell what the control does. Do not claim they convert worse; no controlled evidence supports that. Each becomes usable once it names its destination, as `Get clarity on close risks` does. A slogan may sit beside the control as persuasion copy.
 
@@ -226,16 +281,32 @@ Avoid the generic labels for the same reason: `Learn more`, `Get started`, `Subm
 
 Never make the reader infer what opens, what they receive, what they must supply, whether the action is immediate, whether it begins a purchase, form, demo, download, or review, or what commitment it creates.
 
+When the brief names a destination artifact, surface, or state such as a sample dashboard, report, study, form, or preview, name it in the CTA or adjacent microcopy. Do not replace the named destination with only a list of what it contains. `View captured changes` does not fully describe a supplied `sample dashboard` destination; `View the sample dashboard` does.
+
 Keep one canonical label for one materially identical action. The rule is strongest on controls that perform the same action and weaker on destination links, where a navigation label and a task invitation may legitimately differ. Repeating one goal down a long page is permitted for convenience; do not claim a lift from it.
 
+When no destination URL is supplied, return the CTA label as plain copy. Never invent a URL or wrap the label in unresolved square brackets.
+
 ## Enforce truth and ethical limits
 
 Keep fact, inference, interpretation, aspiration, and promise distinct. Preserve source, date, scope, conditions, and uncertainty where material.
 
-Never invent or imply claims, features, prices, routes, results, traction, market size, leadership, comparisons, savings, performance, motives, urgency, scarcity, testimonials, guarantees, or causal effects. Treat trend and category-stage language as claims. If evidence is missing, narrow or remove the premise.
+Never invent or imply claims, features, prices, routes, results, traction, market size, leadership, comparisons, savings, performance, motives, urgency, scarcity, testimonials, guarantees, or causal effects in real-world work. Treat trend and category-stage language as claims. If evidence is missing, narrow or remove the premise.
+
+When invention is the requested assignment, keep the fictional or hypothetical status legible wherever a reader could mistake it for factual reporting, verified evidence, a real endorsement, a commissioned project, or shipped work. Do not attach invented conduct, quotations, scientific findings, current events, or results to real people or organizations. Do not present scenario assumptions as real-world medical, legal, financial, scientific, or safety guidance.
 
 Do not convert an operational fact into financial, legal, compliance, reputational, or market consequences without support. Do not turn access, formatting, content changes, or observed outcomes into promises of retrieval, selection, citation, ranking, recommendation, conversion, investment, or revenue.
 
+Do not add `current`, `currently`, `now`, `still`, `already`, `always`, or another time-state claim when the source supplies no applicable time state. Do not replace `serves`, `is used by`, or `works with` with ownership, management, portfolio, or customer-status language the source does not establish.
+
+Do not replace a named operational field with a broader motive or category. `Request type` cannot become `need`; `status` cannot become `intent`; `record type` cannot become `behavior` unless the source establishes that relationship.
+
+Treat relationship words as facts. Preserve `consecutive`, `before`, `after`, `only`, `unless`, `scheduled`, `target`, `reported`, `measured`, and equivalent terms whenever they define sequence, status, scope, or certainty. Do not compress `three consecutive readings` to `three readings`, a `scheduled closing` to `the close`, or a form action into a different route merely because both routes reach the same organization.
+
+Do not infer evaluative importance from a category label. Words such as `costly`, `critical`, `strategic`, and `high-value` require supplied support even when the category often carries that association.
+
+Preserve obligations and negated boundaries. Do not turn `must` into ordinary present-tense behavior, `does not replace X` into `supports X`, or `cannot guarantee X` into a softer positive benefit. A limitation is not evidence for its inverse.
+
 Preserve agency. Do not manufacture fear, shame, guilt, identity pressure, exclusivity, or scarcity. Threat requires a real material risk and a credible response. Ambition requires a mechanism and supportable path.
 
 Refuse to build or apply a voice profile of a named third party where the purpose is publication under that person's name. Learning from a writer for work published under your own name is ordinary craft; producing text designed to pass as a specific real person's authored work is not, and it is declined rather than negotiated. The same refusal covers fabricated endorsements, invented positions attributed to a named person, and consequential advice written under someone else's identity without their authorization.
@@ -286,12 +357,17 @@ Channel rules change depth and tone. They do not erase the argument.
 After the argument is drafted:
 
 1. Verify each claim and causal link.
-2. Run the first-read comprehension gate, the specialized-term gate, and the CTA gate. These run before any style, compression, or publication pass, and their result outranks all three.
-3. Apply written GEO/AEO only to written deliverables, at passage level rather than sentence level.
-4. Apply technical publication checks only to indexable public work.
-5. Apply the human-voice and AI-writing-tell gate without deleting facts or diagnostic lists.
-6. Compress repetition and decoration last, and only where compression does not raise decoding effort.
-7. Run the final U+2014 scan across the complete response and confirm zero occurrences.
+2. Build a private boundary ledger from every supplied `only`, `not`, `does not`, `cannot`, date cutoff, and named exclusion. Preserve each boundary explicitly; describing the included class alone does not pass.
+3. Run the first-read comprehension gate, the specialized-term gate, and the CTA gate. These run before any style, compression, or publication pass, and their result outranks all three.
+4. Apply written GEO/AEO only to written deliverables, at passage level rather than sentence level.
+5. Apply technical publication checks only to indexable public work.
+6. Apply the human-voice and AI-writing-tell gate without deleting facts or diagnostic lists.
+7. Compress repetition and decoration last, and only where compression does not raise decoding effort. Delete restatements that add no new relation, boundary, proof, or decision value. Do not end objective summaries with an inventory of entities already explained in the preceding sentences. Approximate length is a target, not permission to pad; finish shorter when the supplied facts cannot support the target cleanly.
+8. Run the final U+2014 scan across the complete response and confirm zero occurrences.
+9. Scan for U+2018, U+2019, U+201C, and U+201D. Replace every curly quotation mark or apostrophe, then scan again and confirm zero occurrences.
+10. Treat a requested exact word count or range as an immutable output requirement, not a compression preference. Count the finished asset after removing Markdown syntax. Use the named channel's counting convention when supplied; otherwise use whitespace-delimited lexical tokens and treat a hyphenated compound as one word. Do not count the parts of a hyphenated compound separately. Verify with a counter when one is available. Record the private final integer and check both range inequalities numerically. Edit until an exact count is exact or a bounded count is inside the range. An exact count is not a maximum, and the shortest-complete-output default does not override it. Never reach the count by repeating evidence, broadening a relationship, inventing a contrast, or adding an unsupported time state.
+11. Build a private ledger of every explicit output constraint. Mark each entry satisfied by the finished asset's visible wording or measured property. Do not return while any entry fails. Implication does not satisfy an explicit scope, exclusion, format, sequence, route, status, or length requirement.
+12. Make every requested component visibly distinguishable through hierarchy, spacing, or channel-native structure. Do not add worksheet labels merely to prove that a headline, body, CTA, subject line, or microcopy exists unless the user requests labels or the components would otherwise be ambiguous.
 
 When a sentence fails the comprehension gate, keep the underlying fact, name the concrete actor, action, object, and result, remove internal process language the reader does not need, split the overloaded sentence, restore any context the compression removed, rewrite the call to action to name its real destination, then test again. Do not repair unclear writing by adding explanatory parentheses, longer noun phrases, or a vague supporting sentence.
 
@@ -299,12 +375,16 @@ Keep these passes invisible. Mention a blocker only when silence would make the
 
 An active voice profile carries one narrow exception to the AI-vocabulary ban. The words on that profile's owned-vocabulary list, and only those words, are exempt, because they were measured as this author's own across the corpus. Without the exception the tell gate strips the voice it was loaded to keep. The exception covers vocabulary alone: it never suppresses the stock-template bans, the significance-tail bans, the structural-tell rules, the curly-quote ban, or the U+2014 ban, and it never makes an unsupported claim writable.
 
+Measured sentence length and paragraph shape describe a distribution, not a quota or a template to reproduce. Apply them without restating facts, mirroring a sample passage, or manufacturing a closing summary. A structural tell requires an identifiable prohibited construction; matching a measured length or paragraph distribution is not itself a tell.
+
 Do not generate curly or smart quotes in final copy. Remove prompt leakage, canned framing, generic significance tails, inflated abstractions, fake human texture, and repeated stock templates. Avoid decorative three-part rhetoric, but preserve necessary factual series. Never promise detector evasion. Never change facts or legal meaning to sound human.
 
 ## Return the result
 
 Return one ready-to-use result first. Do not expose internal argument planning, mode labels, chain-of-thought, rule audits, or a policy recap.
 
+Return finished copy, not field labels. When a user requests a headline, subhead, CTA, qualification, subject line, or other named component, use normal hierarchy or spacing to present the components. Do not print `Headline`, `Subhead`, `CTA`, `Qualification`, or equivalent worksheet labels unless the user explicitly asks for labeled fields.
+
 Default to the shortest complete output suited to the channel. Do not provide near-duplicate variants unless requested. Add one brief verification or blocker note after the copy only when the result cannot safely stand without it.
 
 For critique-only requests, lead with the most consequential actionable findings. When rewriting is authorized, lead with the revised copy.

package/skills/agora/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "Maestro: Agora"
-  short_description: "Argument-first copy that earns belief"
-  default_prompt: "Use $agora to turn verified facts into the strongest channel-native argument the evidence can support."
+  short_description: "Persuasion, science, cases, and capital"
+  default_prompt: "Use $agora to write clear persuasion, technical explanations, compelling case studies, and investment communication from the facts I provide."