@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
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
{
|
|
10
10
|
"name": "maestro-agora",
|
|
11
11
|
"source": "./",
|
|
12
|
-
"description": "Write
|
|
12
|
+
"description": "Write user-directed commercial, technical, case-study, investment, interface, and spoken arguments that preserve the user's claims, framing, and creative choices."
|
|
13
13
|
}
|
|
14
14
|
]
|
|
15
15
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "maestro-agora",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.6.0",
|
|
4
4
|
"displayName": "Maestro: Agora",
|
|
5
5
|
"description": "Use /agora for persuasive writing, technical explanation, compelling case studies, fundraising, investment analysis, and spoken or written copy.",
|
|
6
6
|
"author": {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "maestro-agora",
|
|
3
|
-
"version": "1.
|
|
4
|
-
"description": "Maestro: Agora writes clear persuasion, technical explanations, compelling case studies, and investment communication
|
|
3
|
+
"version": "1.6.0",
|
|
4
|
+
"description": "Maestro: Agora writes clear persuasion, technical explanations, compelling case studies, and investment communication to the user's brief.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Mark Laursen",
|
|
7
7
|
"url": "https://github.com/mbanderas"
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
"interface": {
|
|
27
27
|
"displayName": "Maestro: Agora",
|
|
28
28
|
"shortDescription": "Persuasion, science, cases, and capital",
|
|
29
|
-
"longDescription": "Install Maestro: Agora in Codex for a direct /agora skill that
|
|
29
|
+
"longDescription": "Install Maestro: Agora in Codex for a direct /agora skill that follows the user's claims, framing, creative choices, and intended action across commercial arguments, technical explanations, case studies, and investment communication.",
|
|
30
30
|
"developerName": "Mark Laursen",
|
|
31
31
|
"category": "Productivity",
|
|
32
32
|
"capabilities": [
|
|
@@ -37,10 +37,10 @@
|
|
|
37
37
|
"brandColor": "#7C3AED",
|
|
38
38
|
"composerIcon": "./assets/icon.png",
|
|
39
39
|
"defaultPrompt": [
|
|
40
|
-
"/agora sell Write the strongest
|
|
41
|
-
"/agora science Explain this technical subject
|
|
42
|
-
"/agora case study Turn this
|
|
43
|
-
"/agora invest Build this fundraising asset from
|
|
40
|
+
"/agora sell Write the strongest hero from this brief and destination.",
|
|
41
|
+
"/agora science Explain this technical subject with the certainty and framing I specify.",
|
|
42
|
+
"/agora case study Turn this project material into the case study I describe.",
|
|
43
|
+
"/agora invest Build this fundraising asset from my thesis, claims, urgency, and plan."
|
|
44
44
|
]
|
|
45
45
|
}
|
|
46
46
|
}
|
package/DISCLAIMER.md
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# User Responsibility and Disclaimer
|
|
2
|
+
|
|
3
|
+
Last updated: August 10, 2026
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
|
|
7
|
+
Maestro: Agora is a general-purpose writing tool. It helps users create and edit marketing, sales, investment, scientific, technical, editorial, case-study, interface, and spoken content from instructions and material they choose.
|
|
8
|
+
|
|
9
|
+
Agora is not a content moderator, fact checker, approval system, legal reviewer, or compliance service. It does not determine whether a user's claims, creative choices, attributions, disclosures, or intended uses are appropriate.
|
|
10
|
+
|
|
11
|
+
## User responsibility
|
|
12
|
+
|
|
13
|
+
You control the instructions, source material, claims, fictional elements, tone, urgency, attribution, disclosure, publication, and use of every output. You are responsible for reviewing output before relying on it or making it public.
|
|
14
|
+
|
|
15
|
+
That responsibility includes:
|
|
16
|
+
|
|
17
|
+
- factual accuracy and completeness;
|
|
18
|
+
- advertising, consumer-protection, securities, intellectual-property, privacy, publicity, confidentiality, and other legal obligations;
|
|
19
|
+
- rights and permissions for source material, names, likenesses, logos, quotations, testimonials, endorsements, voice corpora, and confidential information;
|
|
20
|
+
- required disclosures, qualifications, approvals, and professional review;
|
|
21
|
+
- compliance with the terms, policies, and acceptable-use rules of model providers, hosting platforms, publishers, marketplaces, and other third parties;
|
|
22
|
+
- consequences arising from publication, distribution, reliance, or other use.
|
|
23
|
+
|
|
24
|
+
Agora can perform claim, evidence, permission, confidentiality, disclosure, diligence, or compliance review when explicitly requested. Such review is automated assistance, not professional advice or a guarantee that content is accurate, lawful, complete, effective, or suitable for a particular purpose.
|
|
25
|
+
|
|
26
|
+
## No monitoring or approval duty
|
|
27
|
+
|
|
28
|
+
The project maintainer does not review, approve, monitor, or control what users ask Agora to produce or how users use its output. Availability of a feature or generated result does not constitute approval, endorsement, verification, or legal clearance.
|
|
29
|
+
|
|
30
|
+
## Third-party services
|
|
31
|
+
|
|
32
|
+
Agora runs through third-party hosts, model providers, package registries, source hosts, and other services selected by the user. Those services may impose their own terms, policies, restrictions, fees, data practices, and technical limits. The Agora project does not control them.
|
|
33
|
+
|
|
34
|
+
## No professional advice or guaranteed result
|
|
35
|
+
|
|
36
|
+
Agora output is not legal, financial, investment, tax, medical, regulatory, or other professional advice. No output guarantees approval, compliance, publication, funding, conversion, ranking, citation, revenue, or any other result.
|
|
37
|
+
|
|
38
|
+
## License, warranty, and liability
|
|
39
|
+
|
|
40
|
+
The [MIT License](LICENSE) governs permission to use, copy, modify, distribute, sublicense, and sell the software. This notice does not add use restrictions to that license.
|
|
41
|
+
|
|
42
|
+
The software is provided "as is," without warranty. The warranty and liability terms in the MIT License apply.
|
package/PRIVACY.md
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# Privacy Notice
|
|
2
|
+
|
|
3
|
+
Last updated: August 10, 2026
|
|
4
|
+
|
|
5
|
+
## Scope
|
|
6
|
+
|
|
7
|
+
This notice describes the data behavior of the official Maestro: Agora source code and npm package maintained at [mbanderas/maestro-agora](https://github.com/mbanderas/maestro-agora).
|
|
8
|
+
|
|
9
|
+
Agora does not operate a hosted writing service, user-account system, analytics service, advertising system, or project-controlled telemetry endpoint.
|
|
10
|
+
|
|
11
|
+
## Local installation
|
|
12
|
+
|
|
13
|
+
The Agora installer copies the packaged skill and related files to destinations on your computer that you select. The installer does not send your installed skill files, prompts, drafts, or local documents to the Agora maintainer.
|
|
14
|
+
|
|
15
|
+
Using `npx` or npm to download Agora contacts the npm registry. npm may process registry, device, account, and network information under the [npm privacy policy](https://docs.npmjs.com/policies/privacy/).
|
|
16
|
+
|
|
17
|
+
## Prompts and generated content
|
|
18
|
+
|
|
19
|
+
Agora is a skill that runs inside a host application or model provider selected by the user. That host or provider may process, retain, review, or use prompts, source material, generated content, metadata, and account information under its own terms and privacy policy.
|
|
20
|
+
|
|
21
|
+
The Agora project does not receive prompts or generated content from those hosts unless a user separately submits that material to the maintainer, such as through a GitHub issue or pull request.
|
|
22
|
+
|
|
23
|
+
## Voice profiles
|
|
24
|
+
|
|
25
|
+
The optional `agora-voice` tool processes corpus files locally. By default, it writes profiles and measurements to `~/.agora/voices/`, or to a different local directory selected with `--store`.
|
|
26
|
+
|
|
27
|
+
Stored profile data can include:
|
|
28
|
+
|
|
29
|
+
- local source labels or user-supplied URLs;
|
|
30
|
+
- measured writing statistics and recurring vocabulary;
|
|
31
|
+
- selected corpus excerpts used for calibration;
|
|
32
|
+
- register labels, document counts, word counts, timestamps, and profile settings.
|
|
33
|
+
|
|
34
|
+
These files can contain sensitive or identifiable writing. Users control the corpus, storage location, access, backup, retention, sharing, and deletion of those files.
|
|
35
|
+
|
|
36
|
+
When a user supplies an HTTP or HTTPS URL as a corpus source, the voice tool fetches that URL from the user's computer. The remote website may receive ordinary request and network information under its own privacy policy. The fetched content and resulting profile are not sent to the Agora maintainer by the tool.
|
|
37
|
+
|
|
38
|
+
## GitHub interactions
|
|
39
|
+
|
|
40
|
+
GitHub processes information when users visit the repository, download releases, open issues, create pull requests, or otherwise use GitHub. GitHub's [General Privacy Statement](https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement) applies to that processing.
|
|
41
|
+
|
|
42
|
+
The maintainer may receive and use information a person voluntarily submits through repository interactions to respond, review contributions, investigate bugs, and maintain the project. Public issues and pull requests are public. Do not submit confidential source material, prompts, drafts, voice corpora, credentials, or sensitive personal information through a public repository interaction.
|
|
43
|
+
|
|
44
|
+
## Retention and deletion
|
|
45
|
+
|
|
46
|
+
Agora does not maintain a project-operated server containing user prompts, drafts, outputs, or voice profiles.
|
|
47
|
+
|
|
48
|
+
Users can delete locally stored Agora files and voice profiles using their operating system. Data held by npm, GitHub, a host application, a model provider, a remote website, or another third party is governed by that third party's retention and deletion process.
|
|
49
|
+
|
|
50
|
+
## Changes and contact
|
|
51
|
+
|
|
52
|
+
Material changes to this notice will be published in this file with a revised date.
|
|
53
|
+
|
|
54
|
+
Privacy questions about the Agora project can be directed to the maintainer through the contact methods available on the [maintainer's GitHub profile](https://github.com/mbanderas). Do not post sensitive personal information in a public issue.
|
package/README.md
CHANGED
|
@@ -12,22 +12,22 @@
|
|
|
12
12
|
<a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-7c3aed" /></a>
|
|
13
13
|
</p>
|
|
14
14
|
|
|
15
|
-
Agora helps you turn what your business does, knows, sells, or explains into writing people can understand and act on.
|
|
15
|
+
Agora helps you turn what your business does, knows, sells, imagines, or explains into writing people can understand and act on.
|
|
16
16
|
|
|
17
17
|
It starts with the decision behind the copy. Who must understand, believe, choose, approve, fund, or do something next? Agora finds the consequential stake, explains why the subject matters, chooses the details that move the decision, and writes for the actual channel.
|
|
18
18
|
|
|
19
|
-
Use it for landing pages, heroes, ads, product copy, sales outreach, investor communication, scientific and technical explanation, case studies, company profiles, editorial work, interface text, and spoken scripts.
|
|
19
|
+
Use it for landing pages, heroes, ads, product copy, sales outreach, investor communication, scientific and technical explanation, case studies, company profiles, editorial work, interface text, and spoken scripts. Agora follows your brief. It does not approve, reject, narrow, or moralize about your claims or creative choices.
|
|
20
20
|
|
|
21
21
|
## What Agora adds
|
|
22
22
|
|
|
23
23
|
| Capability | What it controls |
|
|
24
24
|
|---|---|
|
|
25
|
-
| Persuasion | Argument, consequence, reason to believe, CTA, channel fit, and
|
|
25
|
+
| Persuasion | Argument, consequence, reason to believe, CTA, channel fit, and rhetorical force |
|
|
26
26
|
| Heroes and short sales copy | Awareness, claim saturation, traffic source, promise grammar, destination fidelity, and the complete first-screen composition |
|
|
27
27
|
| `SCIENCE` | Scientific certainty, causal language, statistics, mechanisms, uncertainty, analogies, visuals, sources, and limits |
|
|
28
|
-
| `CASE_STUDY` | Real projects, fictional mocks, and concept portfolios
|
|
29
|
-
| `INVEST` | Fundraising, diligence, and capital-allocation communication
|
|
30
|
-
| `VOICE` | A measured
|
|
28
|
+
| `CASE_STUDY` | Real projects, fictional mocks, and concept portfolios shaped around the story and status you choose |
|
|
29
|
+
| `INVEST` | Fundraising, diligence, and capital-allocation communication shaped around your thesis, claims, urgency, and next decision |
|
|
30
|
+
| `VOICE` | A measured voice profile built from the corpus you choose |
|
|
31
31
|
| Written GEO/AEO | Clear entities, self-contained passages, source transparency, and relevant publication checks |
|
|
32
32
|
|
|
33
33
|
Agora returns one ready-to-use result by default. Alternatives, internal routes, and rationale stay out of the final copy unless requested.
|
|
@@ -92,7 +92,7 @@ The npm installer provides the broadest host coverage. Native plugin commands us
|
|
|
92
92
|
|
|
93
93
|
## Quick start
|
|
94
94
|
|
|
95
|
-
Invoke Agora directly and provide the
|
|
95
|
+
Invoke Agora directly and provide the brief, material, and claims you want it to use:
|
|
96
96
|
|
|
97
97
|
```text
|
|
98
98
|
/agora Rewrite this upgrade screen. Make the blocked action matter, state the plan difference clearly, and use one supported CTA.
|
|
@@ -102,7 +102,7 @@ Choose a primary mode when you want to override inference:
|
|
|
102
102
|
|
|
103
103
|
```text
|
|
104
104
|
/agora position Turn these business facts into a 35-word company profile.
|
|
105
|
-
/agora sell Build a homepage hero around the strongest buyer stake
|
|
105
|
+
/agora sell Build a homepage hero around the strongest buyer stake in this brief.
|
|
106
106
|
/agora invest Write a fundraising opening from the current results, risks, and purpose of the round.
|
|
107
107
|
/agora inform Explain this research finding for a public audience.
|
|
108
108
|
/agora transact Rewrite this confirmation so the state and next action are unmistakable.
|
|
@@ -111,12 +111,12 @@ Choose a primary mode when you want to override inference:
|
|
|
111
111
|
Add modifiers when the subject or asset needs them:
|
|
112
112
|
|
|
113
113
|
```text
|
|
114
|
-
/agora sell science Write a technical product hero
|
|
114
|
+
/agora sell science Write a technical product hero with this certainty and framing.
|
|
115
115
|
/agora inform science Explain this study for a general audience.
|
|
116
116
|
/agora sell case study Write a customer success case from this approved project record.
|
|
117
117
|
/agora inform science case study Explain this engineering implementation and its measured limits.
|
|
118
118
|
/agora invest science Build a deep-tech capital case from the supplied study and scale-up results.
|
|
119
|
-
/agora invest case study Use this
|
|
119
|
+
/agora invest case study Use this customer case to strengthen the investor brief.
|
|
120
120
|
/agora sell --voice house Rewrite this page in the measured house profile.
|
|
121
121
|
```
|
|
122
122
|
|
|
@@ -124,7 +124,7 @@ In Codex, `$agora` and the skills picker can also select the installed skill. Ot
|
|
|
124
124
|
|
|
125
125
|
## Routing model
|
|
126
126
|
|
|
127
|
-
Agora chooses a primary mode first, then the publication surface, then any domain or asset modifiers. `VOICE` enters afterward and
|
|
127
|
+
Agora chooses a primary mode first, then the publication surface, then any domain or asset modifiers. `VOICE` enters afterward and preserves your required language and content choices.
|
|
128
128
|
|
|
129
129
|
### Primary modes
|
|
130
130
|
|
|
@@ -142,9 +142,9 @@ Agora chooses a primary mode first, then the publication surface, then any domai
|
|
|
142
142
|
|
|
143
143
|
| Modifier | Function |
|
|
144
144
|
|---|---|
|
|
145
|
-
| `SCIENCE` | Adds empirical or technical
|
|
146
|
-
| `CASE_STUDY` | Adds case-study structure, result, attribution
|
|
147
|
-
| `VOICE` | Applies
|
|
145
|
+
| `SCIENCE` | Adds empirical or technical explanation and optional claim-review tools |
|
|
146
|
+
| `CASE_STUDY` | Adds case-study structure, result framing, and optional attribution or permission review |
|
|
147
|
+
| `VOICE` | Applies a measured voice profile from the corpus you select |
|
|
148
148
|
|
|
149
149
|
The modifiers can compose. A technical fundraising case may use `INVEST + SCIENCE + CASE_STUDY`. A founder-voiced scientific product video may use `SELL + SCIENCE + VOICE + HYBRID`.
|
|
150
150
|
|
|
@@ -152,10 +152,10 @@ The modifiers can compose. A technical fundraising case may use `INVEST + SCIENC
|
|
|
152
152
|
|
|
153
153
|
| Surface | Treatment |
|
|
154
154
|
|---|---|
|
|
155
|
-
| `INDEXABLE_PUBLIC` |
|
|
156
|
-
| `PUBLIC_NON_INDEXABLE_WRITTEN` |
|
|
157
|
-
| `WRITTEN_PRIVATE` |
|
|
158
|
-
| `SPOKEN_ONLY` |
|
|
155
|
+
| `INDEXABLE_PUBLIC` | Human-voice and GEO/AEO passes, then relevant technical publication checks |
|
|
156
|
+
| `PUBLIC_NON_INDEXABLE_WRITTEN` | Clear written structure and human-voice pass; no crawl or index checks |
|
|
157
|
+
| `WRITTEN_PRIVATE` | Channel fit, concrete meaning, and human-voice pass |
|
|
158
|
+
| `SPOKEN_ONLY` | Cadence, breath, timing, and listener comprehension; no GEO/AEO formatting |
|
|
159
159
|
| `HYBRID` | Spoken delivery and each written derivative are routed separately |
|
|
160
160
|
|
|
161
161
|
Titles, descriptions, captions, show notes, transcripts, and companion pages receive written treatment. Spoken narration stays free of search-format scaffolding.
|
|
@@ -174,7 +174,7 @@ This path is not a paragraph template.
|
|
|
174
174
|
- Medium copy adds the mechanism and the result, detail, or qualification that matters most.
|
|
175
175
|
- Long copy expands only when another fact resolves a real objection or expensive uncertainty.
|
|
176
176
|
|
|
177
|
-
Agora ranks supporting details by decision relevance, differentiation, specificity,
|
|
177
|
+
Agora ranks supporting details by decision relevance, differentiation, specificity, compression value, and omission risk. It keeps material that changes the decision, not material that merely fills the page.
|
|
178
178
|
|
|
179
179
|
## Heroes and short-form sales copy
|
|
180
180
|
|
|
@@ -188,11 +188,11 @@ A hero is one distributed argument, not a headline contest. Agora evaluates:
|
|
|
188
188
|
- Visual, demo, or result context.
|
|
189
189
|
- Immediate next section.
|
|
190
190
|
|
|
191
|
-
It distinguishes
|
|
191
|
+
It distinguishes brief fidelity from persuasive quality. Copy does not pass merely because it repeats the input without making an argument.
|
|
192
192
|
|
|
193
|
-
`SELL` on a first-attention surface normally receives a commercially assertive treatment. Mid-funnel explanation receives a persuasive-explanatory treatment. Promotional intensity
|
|
193
|
+
`SELL` on a first-attention surface normally receives a commercially assertive treatment. Mid-funnel explanation receives a persuasive-explanatory treatment. Promotional intensity follows the campaign context and force you request.
|
|
194
194
|
|
|
195
|
-
Promise grammar matters. `See X`, `Learn how to X`, `We help you X`, `Do X more often`, `You will X`, and an imperative such as `Beat X`
|
|
195
|
+
Promise grammar matters. `See X`, `Learn how to X`, `We help you X`, `Do X more often`, `You will X`, and an imperative such as `Beat X` create different expectations. CTA language must match the destination and its commitment level.
|
|
196
196
|
|
|
197
197
|
## Scientific and technical communication
|
|
198
198
|
|
|
@@ -204,11 +204,11 @@ Promise grammar matters. `See X`, `Learn how to X`, `We help you X`, `Do X more
|
|
|
204
204
|
| `TECHNICAL` | Systems, interfaces, architecture, mechanisms, dependencies, and failure behavior |
|
|
205
205
|
| `MIXED` | Measured findings plus technical mechanism |
|
|
206
206
|
|
|
207
|
-
|
|
207
|
+
When you request scientific claim review, Agora can classify material as observation, established fact or consensus, model, interpretation, implication, recommendation, hypothesis, speculation, or unknown. Without that request, it follows the certainty and framing in your brief.
|
|
208
208
|
|
|
209
|
-
Agora
|
|
209
|
+
Agora can preserve study design, population, comparator, baseline, denominator, absolute and relative effects, material uncertainty, and the difference between statistical and practical significance when your task needs that precision.
|
|
210
210
|
|
|
211
|
-
Misconception hooks, question-first explanation, analogies, visuals, and alternating narrative threads are optional tools
|
|
211
|
+
Misconception hooks, question-first explanation, analogies, visuals, and alternating narrative threads are optional tools. Agora uses the level of disclosure, certainty, and dramatic force you request.
|
|
212
212
|
|
|
213
213
|
## Case studies built around what happened
|
|
214
214
|
|
|
@@ -224,17 +224,17 @@ Case family and project status are separate:
|
|
|
224
224
|
|
|
225
225
|
| Project status | What Agora permits |
|
|
226
226
|
|---|---|
|
|
227
|
-
| Real project |
|
|
228
|
-
| Fictional mock | Invents a coherent case
|
|
229
|
-
| Concept portfolio |
|
|
227
|
+
| Real project | Builds from the history, roles, artifacts, quotes, measurements, and results you provide |
|
|
228
|
+
| Fictional mock | Invents a coherent case to the scope and realism you request |
|
|
229
|
+
| Concept portfolio | Builds a self-initiated or speculative scenario to the framing you request |
|
|
230
230
|
|
|
231
|
-
|
|
231
|
+
You choose whether a case is real, fictional, mixed, anonymous, attributed, disclosed, or presented without a status label. Agora does not police that choice.
|
|
232
232
|
|
|
233
233
|
Every result is classified before writing: measured outcome, customer-reported outcome, observed process or adoption change, supported inference, target, pending measurement, or unmeasured.
|
|
234
234
|
|
|
235
|
-
|
|
235
|
+
Agora can separate delivery activity, business impact, chronology, and causality when you request case review. Otherwise it follows the outcome framing in your brief.
|
|
236
236
|
|
|
237
|
-
Permission
|
|
237
|
+
Permission, attribution, confidentiality, quote, and disclosure review are optional. Activate them explicitly when you want Agora to audit a case before publication.
|
|
238
238
|
|
|
239
239
|
Academic and clinical case reports remain outside this capability.
|
|
240
240
|
|
|
@@ -248,19 +248,19 @@ Academic and clinical case reports remain outside this capability.
|
|
|
248
248
|
| `DILIGENCE` | Testing an investment case |
|
|
249
249
|
| `ALLOCATE` | Comparing or recommending capital allocation |
|
|
250
250
|
|
|
251
|
-
Agora
|
|
251
|
+
Agora can separate historical results, current state, contracted commitments, customer reports, forecasts, targets, model assumptions, interpretations, scenarios, and unknowns when you request diligence or claim review. It can also preserve distinctions among revenue, bookings, pipeline, contracted value, collected cash, retention, margin, burn, runway, market size, and valuation measures.
|
|
252
252
|
|
|
253
253
|
It can produce warm introductions, direct outreach, spoken openings, decks, briefs, demos, follow-ups, diligence memos, investment-committee briefs, data-room narratives, and progress updates. It does not impose a universal deck order, deck length, meeting script, talk ratio, outreach rule, or opening duration.
|
|
254
254
|
|
|
255
|
-
Strong fundraising communication makes the decision, present position,
|
|
255
|
+
Strong fundraising communication makes the decision, present position, purpose of the capital, and next milestone clear. Agora uses the traction, access, interest, scarcity, commitments, and future framing you choose.
|
|
256
256
|
|
|
257
|
-
|
|
257
|
+
When diligence is the task, Agora can keep a weakness visible until new results resolve it. In fundraising work, it follows the strategic framing you request.
|
|
258
258
|
|
|
259
|
-
|
|
259
|
+
Legal, securities, offering, solicitation, eligibility, and disclosure review is optional and must be requested explicitly.
|
|
260
260
|
|
|
261
261
|
## Measured voice profiles
|
|
262
262
|
|
|
263
|
-
`VOICE` modifies another mode rather than replacing it. Profiles are measured from
|
|
263
|
+
`VOICE` modifies another mode rather than replacing it. Profiles are measured from the corpus you select, not improvised from adjectives.
|
|
264
264
|
|
|
265
265
|
Build and inspect a profile with the shipped engine:
|
|
266
266
|
|
|
@@ -277,24 +277,21 @@ The engine reads Markdown, plain text, and HTML from files, directories, and URL
|
|
|
277
277
|
|
|
278
278
|
A profile records sentence and paragraph distributions, function words, punctuation, openings, stance, contraction behavior, and supported vocabulary. It states what the corpus was too small to measure and refuses certification below 5,000 clean author-controlled words.
|
|
279
279
|
|
|
280
|
-
Profiles live at `~/.agora/voices/`, outside the replaceable skill directory. A default profile can apply across modes. Use `--no-voice`, `neutral`, or `--voice <name>` per request.
|
|
280
|
+
Profiles live at `~/.agora/voices/`, outside the replaceable skill directory. A default profile can apply across modes. Use `--no-voice`, `neutral`, or `--voice <name>` per request. Your required wording overrides habitual profile tendencies.
|
|
281
281
|
|
|
282
|
-
|
|
282
|
+
Agora builds or applies the profile you request. You are responsible for corpus rights, identity use, attribution, endorsements, disclosure, and publication.
|
|
283
283
|
|
|
284
|
-
##
|
|
284
|
+
## User control and responsibility
|
|
285
285
|
|
|
286
|
-
Agora
|
|
286
|
+
Agora is a writing tool, not a content moderator, fact checker, approval system, or legal reviewer. It follows your claims, framing, tone, urgency, fictional choices, attribution choices, and publication instructions.
|
|
287
287
|
|
|
288
|
-
-
|
|
289
|
-
-
|
|
290
|
-
-
|
|
291
|
-
-
|
|
292
|
-
-
|
|
293
|
-
- CTAs use a clear action and a concrete destination, object, or result.
|
|
294
|
-
- One supported recommendation comes first. Near-duplicate variants appear only when requested.
|
|
295
|
-
- A hard final scan rejects U+2014 and smart-quote characters across the response.
|
|
288
|
+
- Agora does not refuse, narrow, weaken, qualify, remove, or label content because it considers a claim unsupported or a writing choice too aggressive.
|
|
289
|
+
- Agora does not append warnings, moral judgments, policy notes, or generic disclaimers to requested copy.
|
|
290
|
+
- Fact checking, source review, evidence review, permission review, confidentiality review, disclosure review, due diligence, and compliance review run only when you request them.
|
|
291
|
+
- Host platforms and model providers may still apply their own terms and safety policies.
|
|
292
|
+
- You are responsible for reviewing and using every output, including its accuracy, legality, claims, permissions, confidentiality, attribution, disclosures, and compliance with platform rules.
|
|
296
293
|
|
|
297
|
-
|
|
294
|
+
Read [User Responsibility and Disclaimer](DISCLAIMER.md) and [Privacy Notice](PRIVACY.md).
|
|
298
295
|
|
|
299
296
|
## Written GEO/AEO boundaries
|
|
300
297
|
|
|
@@ -328,12 +325,12 @@ skills/agora/
|
|
|
328
325
|
|
|
329
326
|
`SKILL.md` contains routing and the concise operating contract. Ordinary work loads only the reference sections it needs.
|
|
330
327
|
|
|
331
|
-
- `agora-marketing.md` is the canonical doctrine for
|
|
328
|
+
- `agora-marketing.md` is the canonical doctrine for user authority, argument, channels, optional claim review, GEO/AEO, AI-writing-tell controls, examples, research grades, and conflict handling.
|
|
332
329
|
- `agora-craft.md` adds headlines, heroes, awareness and sophistication, emotion, and prose rhythm.
|
|
333
|
-
- `agora-science.md` adds empirical and technical claim
|
|
334
|
-
- `agora-case-studies.md` adds case structure, results, attribution,
|
|
335
|
-
- `agora-invest.md` adds fundraising, diligence, and
|
|
336
|
-
- `agora-voice.md` adds measured
|
|
330
|
+
- `agora-science.md` adds empirical and technical explanation plus optional scientific claim review.
|
|
331
|
+
- `agora-case-studies.md` adds case structure, results, and optional attribution, permission, and confidentiality review.
|
|
332
|
+
- `agora-invest.md` adds fundraising, diligence, allocation, and optional claim-review procedures.
|
|
333
|
+
- `agora-voice.md` adds measured voice profiles and user-controlled profile use.
|
|
337
334
|
|
|
338
335
|
## Public-package hygiene
|
|
339
336
|
|
|
@@ -343,7 +340,7 @@ The public repository and npm package must not contain raw or corrected transcri
|
|
|
343
340
|
|
|
344
341
|
`npm run check` always runs a release-hygiene scan after validation, deterministic tests, and the exact package allowlist. `npm pack` and `npm publish` run the same complete release gate through `prepack` and `prepublishOnly`.
|
|
345
342
|
|
|
346
|
-
The blind corpus
|
|
343
|
+
The versioned `evals/blind/v1.5.0/` corpus is retained as a historical release artifact. Its 86 prompt and manifest pairs record the v1.5.0 contract and do not govern the current user-authority behavior. Current deterministic tests verify that claim, evidence, permission, disclosure, confidentiality, diligence, and compliance review remain opt-in.
|
|
347
344
|
|
|
348
345
|
## Verify
|
|
349
346
|
|
|
@@ -354,12 +351,13 @@ npm pack --dry-run --json
|
|
|
354
351
|
npx -y @maestroagora/agora --dry-run
|
|
355
352
|
```
|
|
356
353
|
|
|
357
|
-
The release gate checks skill structure, routing contracts,
|
|
354
|
+
The release gate checks skill structure, routing contracts, user-authority boundaries, modifiers, typography, metadata, reference links, full-tree installer parity, exact npm contents, blind-corpus integrity, and public-tree hygiene.
|
|
358
355
|
|
|
359
356
|
## Change record
|
|
360
357
|
|
|
361
358
|
| Version | What changed |
|
|
362
359
|
|---|---|
|
|
360
|
+
| 1.6.0 | Expands user control across every writing mode. User-selected claims, fiction, urgency, attribution, profile use, and publication choices now control the draft. Claim, evidence, permission, disclosure, confidentiality, diligence, and compliance review are opt-in. Adds a user-responsibility disclaimer and an accurate privacy notice. |
|
|
363
361
|
| 1.5.0 | Hardens `INVEST` across fundraising, diligence, and capital allocation. Adds an investment claim ledger, metric separations, asset-specific procedures, decision-led questions, objection handling, defensibility analysis, truthful urgency and commitment language, modifier composition, and current-verification boundaries. Separates real projects from fictional mock and concept-portfolio routes, and permits clearly disclosed invention for mock and hypothetical articles. Adds a customer-language boundary that keeps internal checking terms out of ordinary public copy while preserving them where scientific, methodological, audit, legal, compliance, diligence, or technical work needs them. Expands the blind corpus from 60 to 86 cases. Adds a mandatory public-tree and package hygiene gate that blocks research, transcripts, supplied private documents, raw model outputs, local paths, secrets, unexpected binaries, and private source identities. |
|
|
364
362
|
| 1.4.0 | Adds stronger hero and short-form sales composition plus the composable `SCIENCE` and `CASE_STUDY` capabilities. Heroes now separate truth gates from persuasive optimization and treat the complete first-screen composition as one argument. Scientific and technical work preserves claim class, causality, statistics, uncertainty, analogy limits, and source limits. Case studies add result classes, causality, permissions, confidentiality, role attribution, quote, typicality, and visual-support gates. The blind corpus contains 60 cases. |
|
|
365
363
|
| 1.3.0 | Adds executable `VOICE` profiles, a deterministic measurement engine, admission gates, local profile storage, register-aware checking, and the craft reference. The archived incumbent corpus contains 28 cases. |
|
|
@@ -372,9 +370,9 @@ Every research-derived rule records its source grade and boundary or failure con
|
|
|
372
370
|
## Maestro suite
|
|
373
371
|
|
|
374
372
|
- **[Maestro Frontier](https://github.com/mbanderas/maestro):** Fuses the model CLIs you already run into one judged, grounded answer.
|
|
375
|
-
- **[Maestro Agora](https://github.com/mbanderas/maestro-agora):** Writes persuasive copy, technical explanations, compelling case studies, and investment communication
|
|
373
|
+
- **[Maestro Agora](https://github.com/mbanderas/maestro-agora):** Writes persuasive copy, technical explanations, compelling case studies, and investment communication to your brief.
|
|
376
374
|
- **[Maestro CostGuard](https://github.com/mbanderas/costguard):** Audits CI and cloud infrastructure for cost leaks and shows what to fix.
|
|
377
375
|
|
|
378
376
|
## License
|
|
379
377
|
|
|
380
|
-
[MIT](LICENSE)
|
|
378
|
+
[MIT](LICENSE). See [User Responsibility and Disclaimer](DISCLAIMER.md) and [Privacy Notice](PRIVACY.md).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@maestroagora/agora",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.6.0",
|
|
4
4
|
"description": "Install Maestro: Agora for persuasive writing, scientific and technical explanation, case studies, fundraising, and investment analysis.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -12,7 +12,9 @@
|
|
|
12
12
|
".claude-plugin/marketplace.json",
|
|
13
13
|
".claude-plugin/plugin.json",
|
|
14
14
|
".codex-plugin/plugin.json",
|
|
15
|
+
"DISCLAIMER.md",
|
|
15
16
|
"LICENSE",
|
|
17
|
+
"PRIVACY.md",
|
|
16
18
|
"README.md",
|
|
17
19
|
"assets/agora-orbit.svg",
|
|
18
20
|
"assets/icon.png",
|
|
@@ -444,7 +444,7 @@ export function renderProfile({ name, measured, gates, corpus, pipeline, now })
|
|
|
444
444
|
const excerpts = selectExcerpts(corpus.documents, measured);
|
|
445
445
|
|
|
446
446
|
const vocabulary = [
|
|
447
|
-
"**Owned.** Words measured as recurring across independent documents in this corpus. The list is an allowlist against the generic AI-vocabulary ban and reaches those words 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
|
|
447
|
+
"**Owned.** Words measured as recurring across independent documents in this corpus. The list is an allowlist against the generic AI-vocabulary ban and reaches those words 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.",
|
|
448
448
|
"",
|
|
449
449
|
];
|
|
450
450
|
if (owned.withheld) {
|
|
@@ -494,7 +494,7 @@ export function renderProfile({ name, measured, gates, corpus, pipeline, now })
|
|
|
494
494
|
"",
|
|
495
495
|
`# Voice profile: ${name}`,
|
|
496
496
|
"",
|
|
497
|
-
"A profile
|
|
497
|
+
"A profile controls how a proposition is expressed. Claims, numbers, quotations, positions, preferences, endorsements, attribution, and publication decisions come from the user's current brief, not from this file.",
|
|
498
498
|
"",
|
|
499
499
|
"Voice enters at level 6 of the conflict hierarchy and never rises above it.",
|
|
500
500
|
"",
|