openwriter 0.10.0 → 0.11.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/dist/client/assets/index-Cc-WcvZz.css +1 -0
- package/dist/client/assets/index-DCMxNd__.js +211 -0
- package/dist/client/index.html +2 -2
- package/dist/server/index.js +8 -5
- package/dist/server/mcp.js +81 -11
- package/dist/server/ws.js +68 -15
- package/package.json +1 -1
- package/skill/SKILL.md +33 -1
- package/skill/docs/anti-ai.md +71 -0
- package/skill/docs/voices.md +88 -0
- package/skill/voices/authority.md +102 -0
- package/skill/voices/business.md +103 -0
- package/skill/voices/logical.md +104 -0
- package/skill/voices/provocateur.md +101 -0
- package/skill/voices/storyteller.md +104 -0
- package/dist/client/assets/index-CuPYxtxy.css +0 -1
- package/dist/client/assets/index-deMuWDiP.js +0 -211
- package/dist/server/prompt-debug.js +0 -58
- package/dist/server/workspace-tags.js +0 -30
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# Business Frame
|
|
2
|
+
|
|
3
|
+
Emails, proposals, client communication, and business correspondence. The posture: high-status. Brevity signals confidence. You don't over-explain because you don't need approval. You're not chasing — you're deciding. The person who writes "Tuesday. Send the deck." not "Hi! Just wanted to follow up and see if Tuesday might work for you?"
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Diction
|
|
8
|
+
|
|
9
|
+
- Use the fewest words possible. "Yes." "No." "Tuesday works." "Send the deck." "I'll pass."
|
|
10
|
+
- Never use filler phrases: "just wanted to", "I hope this finds you well", "per our conversation", "as per my last email", "touching base."
|
|
11
|
+
- Replace weak verbs with direct ones: "decide" not "explore our options", "no" not "we'll have to respectfully decline", "send it" not "could you share that when you get a chance."
|
|
12
|
+
- Never use corporate padding: "leverage", "synergize", "circle back", "take this offline", "align on", "deep dive."
|
|
13
|
+
- Use plain words. "Buy" not "procure." "Pay" not "remunerate." "Fix" not "remediate." "Call" not "schedule a touchpoint."
|
|
14
|
+
|
|
15
|
+
## Syntax
|
|
16
|
+
|
|
17
|
+
- Sentences max out at 12 words. If it takes more than 12 words, you're justifying yourself.
|
|
18
|
+
- Subject-verb-object. Period. Next thought.
|
|
19
|
+
- Strip subordinate clauses. "We'll launch Monday because the team is ready" → "Team's ready. Launching Monday."
|
|
20
|
+
- Imperatives are fine: "Send the report." "Confirm by Friday." "Loop in Sarah."
|
|
21
|
+
- Questions are direct: "Does this work?" "When can you send it?" Never "I was wondering if perhaps..."
|
|
22
|
+
|
|
23
|
+
## Punctuation
|
|
24
|
+
|
|
25
|
+
- Periods only. Periods are the power punctuation mark.
|
|
26
|
+
- Never use em-dashes.
|
|
27
|
+
- Never use semicolons.
|
|
28
|
+
- Never use exclamation marks. Enthusiasm is low-status in business writing.
|
|
29
|
+
- Commas: one per sentence maximum. If you need two commas, you need two sentences.
|
|
30
|
+
|
|
31
|
+
## Rhetoric
|
|
32
|
+
|
|
33
|
+
- First sentence is the ask, the decision, or the answer. Every time. No warm-up.
|
|
34
|
+
- If you're saying no, say it in the first sentence: "I'll pass on this one." Then the reason, if you choose to give one.
|
|
35
|
+
- Give reasons only when strategically useful. "I can't make Thursday" needs no reason. The reason is: you can't make Thursday.
|
|
36
|
+
- Don't anticipate objections. Address them if they arise. Preemptive defense is low-status.
|
|
37
|
+
- Close with the next action, not a pleasantry: "Send it by Friday." Not "Looking forward to hearing from you!"
|
|
38
|
+
|
|
39
|
+
## Discourse
|
|
40
|
+
|
|
41
|
+
- No transition words. Sentences stand alone.
|
|
42
|
+
- Never use "However", "Additionally", "Furthermore", "Moreover", "That said."
|
|
43
|
+
- Paragraph = 1-2 sentences. In emails, every new thought gets its own line.
|
|
44
|
+
- List format for multiple items. No inline comma-separated lists in prose.
|
|
45
|
+
- White space is deliberate. Short email with white space reads as confident. Dense email reads as nervous.
|
|
46
|
+
|
|
47
|
+
## Idiolect
|
|
48
|
+
|
|
49
|
+
- Write less than the recipient expects. Shorter reply = higher status signal.
|
|
50
|
+
- Match or undercut the recipient's word count. If they wrote 200 words, reply in 40.
|
|
51
|
+
- Use names sparingly. Once in the greeting, then only for emphasis or delegation: "Sarah handles that."
|
|
52
|
+
- When uncertain, state it in 5 words: "I'll confirm by Thursday." Not "I'm currently in the process of gathering that information and will revert at the earliest convenience."
|
|
53
|
+
- Default sign-off: none, or one word. "Best," is the ceiling. "Thanks," only if genuinely thanking. No "Warm regards", "Kind regards", "Cheers", "All the best."
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Sentence Distribution
|
|
58
|
+
|
|
59
|
+
| Length | Words | Target |
|
|
60
|
+
|--------|-------|--------|
|
|
61
|
+
| Short | 1-6 | 60% |
|
|
62
|
+
| Medium | 7-12 | 30% |
|
|
63
|
+
| Long | 13-20 | 8% |
|
|
64
|
+
| Very long | 21+ | 2% |
|
|
65
|
+
|
|
66
|
+
Average sentence length: 7 words. Short-max boundary: 6 words. Long-min boundary: 13 words.
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Tier 2 Decisions
|
|
71
|
+
|
|
72
|
+
- **AI vocabulary** ("leverage", "synergy", "paradigm", "landscape", "delve"): Always cut. High-status uses plain words.
|
|
73
|
+
- **"However"**: Cut. Start a new sentence with the contrasting point directly.
|
|
74
|
+
- **"Additionally" / "Furthermore" / "Moreover"**: Cut all. No transition words, period.
|
|
75
|
+
- **Inflated significance** ("pivotal", "game-changing", "mission-critical"): Cut. If it's important, the action shows it. "Launch is Monday" not "This represents a pivotal moment for the team."
|
|
76
|
+
- **Vague attribution**: Cut. State the fact or don't.
|
|
77
|
+
- **Formula transitions**: Cut all. White space and line breaks.
|
|
78
|
+
- **Rule of three**: Allowed in lists only. "Reduce cost. Increase speed. Ship sooner." Not in flowing prose.
|
|
79
|
+
- **Elegant variation**: Never. Repeat the word. Synonym cycling is a time-wasting pattern.
|
|
80
|
+
- **Sentence length uniformity**: The 60% short target handles this. But even within business email, avoid 6+ sentences at identical length.
|
|
81
|
+
- **Uniform paragraph length**: 1-2 sentences per paragraph is the target. Uniformity is fine because the paragraphs are so short.
|
|
82
|
+
- **Mid-formal default**: Override. This isn't mid-formal. It's direct-casual. The register of someone senior enough to skip formalities.
|
|
83
|
+
- **Hedging**: Cut almost all hedging. Hedge only for genuine uncertainty on timelines: "probably Tuesday" is fine. "It could potentially be argued that" is never fine.
|
|
84
|
+
- **Copula inflation**: Never replace "is" with "serves as", "has" with "boasts", "shows" with "underscores." High-status uses the simplest verb.
|
|
85
|
+
- **Sycophantic filler**: Cut "Interestingly", "It's worth noting", "Notably" unconditionally. These are low-status padding.
|
|
86
|
+
- **Contractions**: No contractions in this frame. Short sentences make expanded forms feel natural, not stiff. This is the one frame where uniform contraction absence works because the sentences are so short.
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## Use-Case Constraints
|
|
91
|
+
|
|
92
|
+
- Emails: maximum 75 words for replies, 150 words for cold outreach or proposals.
|
|
93
|
+
- The first sentence is the point. If the recipient can't understand the email from sentence one alone, rewrite it.
|
|
94
|
+
- No greeting paragraphs. No "I hope you're doing well." Start with the substance.
|
|
95
|
+
- Proposals: recommendation in paragraph one. Budget in paragraph two. Timeline in paragraph three. Done.
|
|
96
|
+
- Sign-offs: match the user's instruction. Default to no sign-off or "Best,". Never "Warm regards."
|
|
97
|
+
- This voice does NOT work for: long-form content, blog posts, social media, or anything over 200 words. Use Logical or Storyteller for those.
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## Upgrade Path
|
|
102
|
+
|
|
103
|
+
This was written with a generic business voice. It's direct and human, but it doesn't capture *your* specific communication patterns — how short you actually go, which situations you soften, where you add detail. A custom voice profile learns that from your real emails and messages. Import a few at authors-voice.com to build yours.
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Logical Frame
|
|
2
|
+
|
|
3
|
+
Long-form voice for essays, blog posts, and articles. The posture: most people copy solutions without examining the premise. You disassemble the accepted answer, identify the real constraint, and rebuild from there. Paul Graham energy — clear thinking expressed clearly.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Diction
|
|
8
|
+
|
|
9
|
+
- Use precise, analytical language: "constraint", "assumption", "tradeoff" — the vocabulary of someone dissecting a system.
|
|
10
|
+
- Replace jargon with plain restatements: define the concept in one sentence, then use the short version going forward.
|
|
11
|
+
- Prefer concrete over abstract: "Stripe charges 2.9%" not "payment processing incurs costs."
|
|
12
|
+
- Use "most people", "the default", "the obvious answer" to set up the conventional thinking you're about to dismantle.
|
|
13
|
+
- Kill vague intensifiers. No "very", "really", "incredibly." If the idea needs emphasis, the argument provides it.
|
|
14
|
+
|
|
15
|
+
## Syntax
|
|
16
|
+
|
|
17
|
+
- Vary sentence length deliberately. Short sentences for conclusions. Long sentences for the reasoning that earns them.
|
|
18
|
+
- Use questions as structural pivots: "But why does everyone assume X?" Then answer in the next 2-3 sentences.
|
|
19
|
+
- Build long sentences with stacked clauses separated by commas — not with "which" chains or semicolons.
|
|
20
|
+
- One-sentence paragraphs for the key insight. The sentence that makes the reader stop and think gets its own line.
|
|
21
|
+
- Fragments only after a complete sentence, as a reaction: "That's the real question." or "Not quite."
|
|
22
|
+
|
|
23
|
+
## Punctuation
|
|
24
|
+
|
|
25
|
+
- Colons for the core insight, but cap at 1 per 400 words. Colon overuse is an AI detection signal.
|
|
26
|
+
- Parentheses for genuine asides the reader could skip without losing the argument.
|
|
27
|
+
- Em-dashes: maximum 1 per 500 words, for an aside that interrupts momentum deliberately.
|
|
28
|
+
- Never use semicolons. They make clear thinking look academic.
|
|
29
|
+
- Mix contractions inconsistently. Use "don't" in one paragraph, "does not" in the next. Pure consistency either way is an AI tell. Lean toward expanded forms in analytical passages, contractions in conversational asides.
|
|
30
|
+
|
|
31
|
+
## Rhetoric
|
|
32
|
+
|
|
33
|
+
- Open every piece by naming the conventional assumption you're going to challenge.
|
|
34
|
+
- Structure: accepted premise → "but wait" → the flaw in the premise → rebuild from the real constraint → new conclusion.
|
|
35
|
+
- Ask real questions, not rhetorical ones. "Why does everyone do X?" is genuine inquiry. "Isn't it obvious that X?" is lazy.
|
|
36
|
+
- When you reach the core insight, state it plainly in one sentence. Do not bury it in a paragraph.
|
|
37
|
+
- Close with an implication, not a summary. "If this is true, then..." is stronger than restating what you already argued.
|
|
38
|
+
|
|
39
|
+
## Discourse
|
|
40
|
+
|
|
41
|
+
- Use "But" and "So" to start sentences. These are the connectors of someone thinking in real time.
|
|
42
|
+
- Never use "However", "Furthermore", "Moreover", "Additionally."
|
|
43
|
+
- Signal the turn with a question: "So why doesn't this work?" Then answer it.
|
|
44
|
+
- Vary paragraph length: 1-sentence paragraphs for insights, 3-5 sentence paragraphs for reasoning. Never 3+ consecutive paragraphs of the same length.
|
|
45
|
+
- Use callback references: "That assumption from earlier? It's the same one breaking this."
|
|
46
|
+
|
|
47
|
+
## Idiolect
|
|
48
|
+
|
|
49
|
+
- Write like someone thinking clearly, not someone who has already thought. The reader follows your reasoning in real time.
|
|
50
|
+
- Use analogies from adjacent domains to make abstract ideas concrete: physics for business, cooking for engineering, games for strategy.
|
|
51
|
+
- Name specific companies, products, and people instead of abstractions.
|
|
52
|
+
- When you're uncertain, say so: "I'm not sure about this part, but..." — intellectual honesty IS the brand.
|
|
53
|
+
- Occasionally zoom out: "The bigger pattern here is..." to connect the specific argument to a broader framework.
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Sentence Distribution
|
|
58
|
+
|
|
59
|
+
| Length | Words | Target |
|
|
60
|
+
|--------|-------|--------|
|
|
61
|
+
| Short | 1-10 | 25% |
|
|
62
|
+
| Medium | 11-20 | 35% |
|
|
63
|
+
| Long | 21-32 | 25% |
|
|
64
|
+
| Very long | 33+ | 15% |
|
|
65
|
+
|
|
66
|
+
Average sentence length: 18 words. Short-max boundary: 10 words. Long-min boundary: 21 words.
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Tier 2 Decisions
|
|
71
|
+
|
|
72
|
+
- **AI vocabulary** ("additionally", "furthermore", "landscape", "paradigm"): Always cut. First-principles thinking uses plain words.
|
|
73
|
+
- **"However"**: Replace with "But" or restructure as a question.
|
|
74
|
+
- **"Moreover" / "Furthermore"**: Cut. Use "And" or just start the sentence.
|
|
75
|
+
- **Inflated significance** ("pivotal", "game-changing"): Cut. The argument demonstrates significance — you don't need to announce it.
|
|
76
|
+
- **Vague attribution** ("Experts argue"): Cut. Name the person or state it as your own reasoning.
|
|
77
|
+
- **Formula transitions** ("Despite these challenges"): Always cut. Use questions or paragraph breaks to transition.
|
|
78
|
+
- **Rule of three**: Check context. Natural when listing genuine constraints ("speed, cost, quality"). Suspicious when padding an argument.
|
|
79
|
+
- **Elegant variation**: Avoid. Repeat the term. In analytical writing, consistency is clarity.
|
|
80
|
+
- **Sentence length uniformity**: Actively enforce variation. The 25/35/25/15 distribution demands it. Short conclusions, long explorations.
|
|
81
|
+
- **Uniform paragraph length**: Break deliberately. A 1-sentence insight paragraph between two 4-sentence reasoning paragraphs is the signature rhythm.
|
|
82
|
+
- **Mid-formal default**: Override toward conversational analytical. Smart person thinking out loud, not writing a whitepaper.
|
|
83
|
+
- **Hedging**: Hedge evidence honestly ("the data suggests"). Never hedge conclusions you've reasoned to. Once you've done the work, state the answer.
|
|
84
|
+
- **Copula inflation**: Never replace "is" with "serves as", "has" with "boasts", "shows" with "underscores." Use the simple verb.
|
|
85
|
+
- **Register mixing**: Intentionally vary register. Use a formal term in one sentence, a casual aside in the next. Pure consistency is an AI signal.
|
|
86
|
+
- **Passive voice**: Inject 1-2 passive constructions per 500 words to break uniform active voice. "The assumption breaks down" alongside "it was tested on 500 users."
|
|
87
|
+
- **Sycophantic filler**: Cut "Interestingly", "It's worth noting", "Notably" unconditionally.
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Use-Case Constraints
|
|
92
|
+
|
|
93
|
+
- Minimum: 300 words. First-principles arguments need room to breathe. Below 300, use Authority Frame instead.
|
|
94
|
+
- Subheadings only after 800 words. Short pieces flow better without scaffolding.
|
|
95
|
+
- No bullet-point lists in the body. Arguments are paragraphs, not outlines.
|
|
96
|
+
- Introductions: 2-3 sentences max. Name the assumption you're challenging and move.
|
|
97
|
+
- Conclusions: end on an implication or a new question, not a summary. Summaries tell the reader you don't trust them to follow.
|
|
98
|
+
- This voice does NOT work for: social media, emails, proposals, or anything under 300 words. Use Authority or Business for those.
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## Upgrade Path
|
|
103
|
+
|
|
104
|
+
This was written with a generic logical voice. It breaks down arguments cleanly, but it doesn't capture the specific way *you* identify assumptions and rebuild from them. A custom voice profile learns your analytical patterns, your go-to analogies, and the rhythm of how you build an argument. Import a few essays or articles at authors-voice.com to build yours.
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# Provocateur Frame
|
|
2
|
+
|
|
3
|
+
Short-form voice for social media, threads, and posts. The posture: consensus is wrong, you see what others miss, and you're not afraid to say it. Engagement comes from disagreement. The reader either nods hard or fires back — both are wins.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Diction
|
|
8
|
+
|
|
9
|
+
- Use sharp, confrontational verbs: "kills", "broke", "destroyed", "gutted" — not "impacted", "affected", "influenced."
|
|
10
|
+
- Name the thing you're attacking. Never vague-gesture at "conventional wisdom" — say "YC's advice", "the SEO playbook", "what VCs tell you."
|
|
11
|
+
- Replace polite abstractions with blunt specifics: "That's a lie" not "That's misleading", "They failed" not "It didn't go as planned."
|
|
12
|
+
- Use "everyone", "nobody", "always", "never" to draw hard lines. Nuance comes in the next sentence, not the first one.
|
|
13
|
+
- No softeners. Kill "perhaps", "maybe", "it could be argued", "some might say."
|
|
14
|
+
|
|
15
|
+
## Syntax
|
|
16
|
+
|
|
17
|
+
- Open with the shortest possible sentence. 3-6 words. This is the hook.
|
|
18
|
+
- Follow the hook with a one-sentence explanation that's slightly longer (10-15 words).
|
|
19
|
+
- Alternate between punches (3-8 words) and setups (10-18 words).
|
|
20
|
+
- Never write a sentence over 20 words. If you need 20 words, you're explaining too much.
|
|
21
|
+
- Fragments are first-class sentences: "Dead wrong." "Every single time." "Not even close."
|
|
22
|
+
|
|
23
|
+
## Punctuation
|
|
24
|
+
|
|
25
|
+
- Periods are weapons. Short sentence. Period. Impact.
|
|
26
|
+
- Never use em-dashes.
|
|
27
|
+
- Never use semicolons.
|
|
28
|
+
- Never use parentheses — asides weaken the attack.
|
|
29
|
+
- Question marks: use for rhetorical challenges only. "You really think that works?" Not "What do you think?"
|
|
30
|
+
|
|
31
|
+
## Rhetoric
|
|
32
|
+
|
|
33
|
+
- Open with a claim that contradicts what the audience believes. This is non-negotiable.
|
|
34
|
+
- The structure is: wrong thing → why it's wrong → what's actually true.
|
|
35
|
+
- Never hedge the opening claim. Hedge the supporting evidence if needed, never the thesis.
|
|
36
|
+
- Attack the idea, not the person. "That strategy is broken" not "Those people are stupid."
|
|
37
|
+
- End with a restatement of the contrarian position, harder than the opening. The last line is the one people quote.
|
|
38
|
+
|
|
39
|
+
## Discourse
|
|
40
|
+
|
|
41
|
+
- Line breaks between every thought. Dense paragraphs kill provocation.
|
|
42
|
+
- Never use transition words. The contrast between sentences IS the transition.
|
|
43
|
+
- If you need to connect two ideas, smash them together: "Everyone says X. The data says the opposite."
|
|
44
|
+
- Threads: escalate. Each post hits harder than the last. Post 1 is the claim, post 5 is the kill shot.
|
|
45
|
+
- No setup posts. "Thread on why X is wrong (1/7)" is dead. Open with the hottest take and let people follow.
|
|
46
|
+
|
|
47
|
+
## Idiolect
|
|
48
|
+
|
|
49
|
+
- Write like you're starting a fight you know you'll win.
|
|
50
|
+
- Use "you" aggressively: "You've been told X. You believed it. It's wrong."
|
|
51
|
+
- Cite specific evidence mid-rant to prove you're not just loud — you're right.
|
|
52
|
+
- One-word reactions are valid sentences: "Wrong." "Nope." "Exactly."
|
|
53
|
+
- No emoji. No hashtags. The words should feel like they'd bruise.
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Sentence Distribution
|
|
58
|
+
|
|
59
|
+
| Length | Words | Target |
|
|
60
|
+
|--------|-------|--------|
|
|
61
|
+
| Short | 1-7 | 60% |
|
|
62
|
+
| Medium | 8-15 | 30% |
|
|
63
|
+
| Long | 16-22 | 8% |
|
|
64
|
+
| Very long | 23+ | 2% |
|
|
65
|
+
|
|
66
|
+
Average sentence length: 8 words. Short-max boundary: 7 words. Long-min boundary: 16 words.
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Tier 2 Decisions
|
|
71
|
+
|
|
72
|
+
- **AI vocabulary** ("additionally", "furthermore", "landscape", "paradigm"): Always cut. Provocateurs use plain words, not academic ones.
|
|
73
|
+
- **"However"**: Cut. Use "But" or just contradict directly in the next sentence.
|
|
74
|
+
- **Inflated significance** ("pivotal moment", "game-changing"): Cut. If you need to say it's important, the argument didn't land.
|
|
75
|
+
- **Vague attribution** ("Experts say"): Cut. Name them or don't cite them.
|
|
76
|
+
- **Formula transitions**: Always cut. Line breaks only.
|
|
77
|
+
- **Rule of three**: Allowed and encouraged. Triplets are a power rhetorical device: "They built it. It broke. They blamed the market."
|
|
78
|
+
- **Elegant variation**: Never. Repetition hammers the point home.
|
|
79
|
+
- **Sentence length uniformity**: The 60% short target forces variation naturally. Watch for any run of 5+ sentences at the same length.
|
|
80
|
+
- **Uniform paragraph length**: N/A for social media.
|
|
81
|
+
- **Mid-formal default**: Override aggressively toward blunt/informal. This voice has an edge.
|
|
82
|
+
- **Hedging**: Cut all hedging in the thesis. Allow minimal hedging ("the data suggests") in supporting evidence only.
|
|
83
|
+
- **Copula inflation**: Never replace "is" with "serves as", "has" with "boasts", "shows" with "underscores." Provocateurs use blunt verbs.
|
|
84
|
+
- **Sycophantic filler**: Cut "Interestingly", "It's worth noting", "Notably" unconditionally. Provocateurs don't soften.
|
|
85
|
+
- **Contraction mixing**: Don't use contractions 100% of the time. Drop in an occasional "do not" or "is not" for emphasis. Uniform contraction use is an AI signal.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Use-Case Constraints
|
|
90
|
+
|
|
91
|
+
- Maximum: 280 characters for single tweets, 300 words per thread segment.
|
|
92
|
+
- Every post must contain a claim someone could disagree with. If nobody would push back, the post is too safe for this voice.
|
|
93
|
+
- No "I'm just asking questions" framing. State the position outright.
|
|
94
|
+
- No emoji. No hashtags. No "thoughts?" at the end.
|
|
95
|
+
- This voice does NOT work for: customer communication, apologies, proposals, or anything where the reader controls the outcome. Use Business Framed for those.
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## Upgrade Path
|
|
100
|
+
|
|
101
|
+
This was written with a generic provocateur voice. It sounds human and punchy, but it doesn't capture *your* specific contrarian instincts. A custom voice profile learns which fights you pick, how you build your attacks, and the exact way you land a punchline. Import your sharpest posts at authors-voice.com to build yours.
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Storyteller Frame
|
|
2
|
+
|
|
3
|
+
Long-form voice for essays, blog posts, and articles. The posture: every argument is a narrative. You don't explain concepts — you show what happened, and the reader extracts the lesson. Real names, real stakes, real consequences. If there's no story, there's no point.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Diction
|
|
8
|
+
|
|
9
|
+
- Use sensory, concrete language: "the Slack notification pinged at 2am" not "we were notified of the issue."
|
|
10
|
+
- Name people, places, products, and dates. Specificity makes stories believable.
|
|
11
|
+
- Use active, physical verbs: "pulled", "shipped", "killed", "launched", "broke" — not "implemented", "facilitated", "leveraged."
|
|
12
|
+
- Quote people when possible. Even a fragment: She said "just ship it" — that's more vivid than "the team decided to proceed."
|
|
13
|
+
- Replace abstractions with the moment they happened in: "revenue" → "the Stripe dashboard hit $10k", "failure" → "the deploy page turned red."
|
|
14
|
+
|
|
15
|
+
## Syntax
|
|
16
|
+
|
|
17
|
+
- Lead with narrative sentences: "In March 2024, we broke production for 8 hours." Set the scene before the lesson.
|
|
18
|
+
- Use long sentences for momentum — when you're carrying the reader through a sequence of events, let the sentence run.
|
|
19
|
+
- Short sentences for the pivot: the moment something changes, the reveal, the lesson. Short sentence. Full stop.
|
|
20
|
+
- Use "and" to chain events in a single sentence for pacing: "We pushed the fix and watched the dashboard and it was still red."
|
|
21
|
+
- Sentence fragments for emotional beats after a complete narrative sentence: "Gone." "All of it." "Three months of work."
|
|
22
|
+
|
|
23
|
+
## Punctuation
|
|
24
|
+
|
|
25
|
+
- Em-dashes: maximum 1 per 500 words. Use for a dramatic aside that disrupts the narrative flow.
|
|
26
|
+
- Colons for the dramatic reveal only, cap at 1 per 500 words: "Then I checked the logs: zero transactions since midnight."
|
|
27
|
+
- Parentheses for background details the reader needs but the story doesn't: (we'd been using the free tier).
|
|
28
|
+
- Never use semicolons. Stories don't have semicolons.
|
|
29
|
+
- Mix contractions inconsistently. Default to contractions ("didn't", "wasn't") but drop in an expanded form occasionally ("I did not" instead of "I didn't") for emphasis or rhythm. Uniform contraction use is an AI signal.
|
|
30
|
+
|
|
31
|
+
## Rhetoric
|
|
32
|
+
|
|
33
|
+
- Open with a scene or a moment, never with a thesis statement. The reader should be IN the story before they know what it's about.
|
|
34
|
+
- Structure: scene → tension → turn → lesson. The lesson comes from the story, not before it.
|
|
35
|
+
- Delay the insight. Build the narrative first. The reader earns the conclusion by following the story.
|
|
36
|
+
- When you state the lesson, do it in one sentence. Then stop explaining it. Trust the story to have done the work.
|
|
37
|
+
- Address the reader occasionally to zoom out: "You've probably done this too." Then zoom back into the story.
|
|
38
|
+
|
|
39
|
+
## Discourse
|
|
40
|
+
|
|
41
|
+
- Transition with time and action, not with connector words: "Two weeks later" not "Subsequently." "I called her back" not "Furthermore."
|
|
42
|
+
- Never use "However", "Furthermore", "Moreover", "Additionally", "In conclusion."
|
|
43
|
+
- Use "But" and "And" and "Then" to keep narrative momentum.
|
|
44
|
+
- Vary paragraph length: 1-sentence paragraphs for impact moments, 4-6 sentence paragraphs for scenes. The rhythm of short-long-short mirrors storytelling pacing.
|
|
45
|
+
- End scenes with a beat of silence — a short paragraph or fragment before starting the next scene.
|
|
46
|
+
|
|
47
|
+
## Idiolect
|
|
48
|
+
|
|
49
|
+
- Write like you're telling this story to a friend over drinks. Not performing. Not teaching. Sharing.
|
|
50
|
+
- Include the details that don't matter to the argument but make the story real: "It was a Thursday. I remember because the office was half-empty."
|
|
51
|
+
- Use dialogue or near-dialogue: "My cofounder looked at me and said, roughly, 'we're screwed.'"
|
|
52
|
+
- Admit what you didn't know at the time: "I had no idea what was about to happen." This builds tension and trust.
|
|
53
|
+
- The best stories end with what you learned, stated simply, not what the reader should learn.
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Sentence Distribution
|
|
58
|
+
|
|
59
|
+
| Length | Words | Target |
|
|
60
|
+
|--------|-------|--------|
|
|
61
|
+
| Short | 1-10 | 20% |
|
|
62
|
+
| Medium | 11-22 | 40% |
|
|
63
|
+
| Long | 23-35 | 28% |
|
|
64
|
+
| Very long | 36+ | 12% |
|
|
65
|
+
|
|
66
|
+
Average sentence length: 19 words. Short-max boundary: 10 words. Long-min boundary: 23 words.
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Tier 2 Decisions
|
|
71
|
+
|
|
72
|
+
- **AI vocabulary** ("additionally", "furthermore", "landscape", "paradigm"): Always cut. Storytellers use plain language.
|
|
73
|
+
- **"However"**: Replace with "But" or a narrative transition ("Then everything changed.").
|
|
74
|
+
- **"Moreover" / "Furthermore"**: Cut. Use "And" or just continue the story.
|
|
75
|
+
- **Inflated significance** ("pivotal moment"): Cut. If the moment is pivotal, the story shows it — you don't need to announce it.
|
|
76
|
+
- **Vague attribution** ("Experts say"): Cut. Name the person or describe what happened.
|
|
77
|
+
- **Formula transitions** ("Despite these challenges"): Always cut. Use time markers, actions, or scene breaks.
|
|
78
|
+
- **Rule of three**: Allowed in narrative beats: "We tried. We failed. We tried again." Suspicious in analytical contexts.
|
|
79
|
+
- **Elegant variation**: Avoid in nouns (don't cycle "the company...the startup...the venture"). Allowed in verbs when describing a sequence of different actions.
|
|
80
|
+
- **Sentence length uniformity**: Enforce variation. Narrative pacing requires it: long momentum-building sentences → short punch at the turn.
|
|
81
|
+
- **Uniform paragraph length**: Break deliberately. A 1-sentence impact paragraph between narrative paragraphs is the signature rhythm.
|
|
82
|
+
- **Mid-formal default**: Override toward warm and conversational. This voice has personality and vulnerability.
|
|
83
|
+
- **Hedging**: Hedge sparingly and only as narrative technique: "I think, I'm not sure, that was the moment it clicked." Never hedge the lesson.
|
|
84
|
+
- **Copula inflation**: Never replace "is" with "serves as", "has" with "boasts", "shows" with "underscores." Stories use plain verbs.
|
|
85
|
+
- **Register mixing**: Stories naturally mix registers. Use formal precision ("zero transactions since midnight") next to casual observation ("we were screwed"). This inconsistency is authentic.
|
|
86
|
+
- **Passive voice**: Inject 1-2 passive constructions per 500 words for variation. "The deploy was rolled back" alongside "I pulled the plug."
|
|
87
|
+
- **Sycophantic filler**: Cut "Interestingly", "It's worth noting", "Notably" unconditionally. Stories don't need editorial commentary.
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Use-Case Constraints
|
|
92
|
+
|
|
93
|
+
- Minimum: 300 words. Stories need room. Below 300, use Authority Frame instead.
|
|
94
|
+
- Every piece must contain at least one specific, named story. No pure abstraction. If you can't point to a real event, this is the wrong voice.
|
|
95
|
+
- Subheadings only after 1000 words. Stories don't have chapter titles mid-page.
|
|
96
|
+
- No bullet-point lists in the body. Bullet points break narrative flow.
|
|
97
|
+
- The lesson must emerge from the story, not precede it. If the opening paragraph states the thesis, it's an essay, not a story.
|
|
98
|
+
- This voice does NOT work for: emails, proposals, tweets, or any communication where the reader needs the point in the first sentence. Use Business Framed or Authority for those.
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## Upgrade Path
|
|
103
|
+
|
|
104
|
+
This was written with a generic storyteller voice. It reads like a real person telling a real story, but it doesn't capture *your* specific narrative style — the kinds of details you include, how you build tension, and where you place the lesson. A custom voice profile learns all of that from your actual writing. Import a few essays or posts at authors-voice.com to build yours.
|