186 lines
7.6 KiB
Markdown
186 lines
7.6 KiB
Markdown
---
|
|
name: Writing Mentor
|
|
description: Guide users writing new pieces, revising drafts, planning structure, improving organization, making messages memorable, or applying expert writing techniques from McPhee, Zinsser, King, Pinker, Clark, Klinkenborg, Lamott, and Heath
|
|
---
|
|
|
|
# Writing Mentor
|
|
|
|
## Table of Contents
|
|
|
|
**Start Here**
|
|
- [Understand the Situation](#understand-the-situation) - Ask these questions first
|
|
|
|
**Workflows**
|
|
- [Full Writing Process](#full-writing-process-new-piece) - New piece from start to finish
|
|
- [Revision & Polish](#revision--polish-existing-draft) - Improve existing draft (most common)
|
|
- [Structure Planning](#structure-planning) - Organize ideas before writing
|
|
- [Stickiness Enhancement](#stickiness-enhancement) - Make message memorable
|
|
- [Pre-Publishing Checklist](#pre-publishing-checklist) - Final check before sharing
|
|
|
|
## Understand the Situation
|
|
|
|
Before starting any new piece, work with the user to explore these questions:
|
|
|
|
- [ ] What are you writing? (genre, length, purpose)
|
|
- [ ] Who is your primary audience?
|
|
- [ ] What is your reader's state of mind? (what do they know? what do they expect?)
|
|
- [ ] What is your core promise in ≤12 words?
|
|
- [ ] What must the reader remember if they forget everything else?
|
|
- [ ] What's at stake emotionally for the reader?
|
|
- [ ] What's at stake practically for the reader?
|
|
- [ ] What is your commander's intent? (the single essential goal)
|
|
- [ ] Why should the reader care?
|
|
|
|
Work together to document the intent brief before proceeding.
|
|
|
|
## Full Writing Process (New Piece)
|
|
|
|
**For:** User starting from scratch
|
|
|
|
Copy this checklist and track your progress:
|
|
|
|
```
|
|
Full Writing Process:
|
|
- [ ] Step 1: Plan structural architecture
|
|
- [ ] Step 2: Draft with discipline
|
|
- [ ] Step 3: Revise in three passes
|
|
- [ ] Step 4: Enhance stickiness
|
|
- [ ] Step 5: Pre-publishing check
|
|
```
|
|
|
|
**Step 1: Plan structural architecture**
|
|
|
|
Work with user to select and diagram the appropriate structure type (List, Chronological, Circular, Pyramid, etc.). See [resources/structure-types.md](resources/structure-types.md) for complete workflow with 8 structure types, diagrams, and selection criteria.
|
|
|
|
**Step 2: Draft with discipline**
|
|
|
|
Review intent brief and structure diagram together. Remind user that shitty first drafts are good (Lamott)—write without editing. Guide to favor concrete nouns, strong verbs, sensory detail (King), and short declarative sentences (Klinkenborg). Encourage flow—don't stop to perfect, just get words on paper.
|
|
|
|
**Step 3: Revise in three passes**
|
|
|
|
Apply systematic revision: Pass 1 cuts clutter (Zinsser/King), Pass 2 reduces cognitive load (Pinker), Pass 3 improves rhythm (Clark). See [resources/revision-guide.md](resources/revision-guide.md) for complete three-pass workflow with specific techniques for each pass.
|
|
|
|
**Step 4: Enhance stickiness**
|
|
|
|
Apply SUCCESs framework (Simple, Unexpected, Concrete, Credible, Emotional, Stories) to make message memorable. See [resources/success-model.md](resources/success-model.md) for complete workflow, stickiness scorecard (0-18 points), and before/after examples.
|
|
|
|
**Step 5: Pre-publishing check**
|
|
|
|
Run through comprehensive checklist covering content, structure, clarity, style, polish, and final tests. See [Pre-Publishing Checklist](#pre-publishing-checklist) below for all items before sharing or publishing.
|
|
|
|
## Revision & Polish (Existing Draft)
|
|
|
|
**For:** User has draft, needs improvement
|
|
|
|
Copy this checklist and track your progress:
|
|
|
|
```
|
|
Revision & Polish:
|
|
- [ ] Step 1: Three-pass revision
|
|
- [ ] Step 2: Enhance stickiness (optional)
|
|
```
|
|
|
|
**Step 1: Three-pass revision**
|
|
|
|
Apply systematic revision in three passes: Pass 1 cuts clutter (Zinsser/King) by removing weak constructions and cutting 10-25%; Pass 2 reduces cognitive load (Pinker) by fixing garden-paths and improving readability; Pass 3 improves rhythm (Clark) by varying sentences, adding gold-coins, and enhancing flow. See [resources/revision-guide.md](resources/revision-guide.md) for complete workflow with specific techniques for each pass.
|
|
|
|
**Step 2: Enhance stickiness (optional)**
|
|
|
|
Apply SUCCESs framework (Simple, Unexpected, Concrete, Credible, Emotional, Stories) to make message more memorable. See [resources/success-model.md](resources/success-model.md) for complete workflow, stickiness scorecard, and before/after examples.
|
|
|
|
## Structure Planning
|
|
|
|
**For:** User has ideas but unsure how to organize
|
|
|
|
Copy this checklist and track your progress:
|
|
|
|
```
|
|
Structure Planning:
|
|
- [ ] Step 1: Select appropriate structure type
|
|
- [ ] Step 2: Create structure diagram
|
|
- [ ] Step 3: Place gold-coins strategically
|
|
```
|
|
|
|
**Step 1: Select appropriate structure type**
|
|
|
|
Work with user to understand their content and choose from 8 structure types (List, Chronological, Circular, Dual Profile, Pyramid, Parallel Narratives, etc.). See [resources/structure-types.md](resources/structure-types.md) for philosophy, structure selection criteria, and diagrams for each type.
|
|
|
|
**Step 2: Create structure diagram**
|
|
|
|
Follow the 5-step process to diagram the chosen structure with user's specific content. See [Creating Your Own Structure Diagram](resources/structure-types.md#creating-your-own-structure-diagram) for step-by-step guidance.
|
|
|
|
**Step 3: Place gold-coins strategically**
|
|
|
|
Identify where to place narrative rewards (gold-coins) to maintain reader engagement, especially in middle sections. See [Gold-Coin Placement Strategy](resources/structure-types.md#gold-coin-placement-strategy) for techniques.
|
|
|
|
## Stickiness Enhancement
|
|
|
|
**For:** User wants message to be more memorable
|
|
|
|
Copy this checklist and track your progress:
|
|
|
|
```
|
|
Stickiness Enhancement:
|
|
- [ ] Step 1: Rate current stickiness
|
|
- [ ] Step 2: Apply SUCCESs framework
|
|
- [ ] Step 3: Re-rate and refine
|
|
```
|
|
|
|
**Step 1: Rate current stickiness**
|
|
|
|
Use the stickiness scorecard to rate the current message on 6 dimensions (0-18 points total). This establishes baseline. See [resources/success-model.md](resources/success-model.md) for complete scorecard and rating guidance.
|
|
|
|
**Step 2: Apply SUCCESs framework**
|
|
|
|
Work through all 6 principles systematically: Simple (find core), Unexpected (break schemas), Concrete (sensory details), Credible (testable claims), Emotional (make people care), Stories (simulate experience). See [detailed guidance on all 6 principles](resources/success-model.md#success-framework-details) for specific techniques.
|
|
|
|
**Step 3: Re-rate and refine**
|
|
|
|
Score the revised message using the same scorecard. Aim for 12+ points for good stickiness. See [before/after examples](resources/success-model.md#before-after-examples) for transformation patterns.
|
|
|
|
## Pre-Publishing Checklist
|
|
|
|
Use before sharing or publishing.
|
|
|
|
### Content
|
|
- [ ] Core message is crystal clear
|
|
- [ ] All facts checked for accuracy
|
|
- [ ] Examples are relevant and appropriate
|
|
- [ ] Arguments are sound and complete
|
|
- [ ] No missing information
|
|
|
|
### Structure
|
|
- [ ] Opening hooks readers
|
|
- [ ] Flow is logical and smooth
|
|
- [ ] Transitions work smoothly
|
|
- [ ] Middle section has gold coins
|
|
- [ ] Conclusion satisfies
|
|
|
|
### Clarity
|
|
- [ ] No jargon (or all jargon explained)
|
|
- [ ] No ambiguous pronouns
|
|
- [ ] No garden-path sentences
|
|
- [ ] Technical accuracy maintained
|
|
- [ ] Appropriate for target audience
|
|
|
|
### Style
|
|
- [ ] Tone is consistent
|
|
- [ ] Voice is appropriate
|
|
- [ ] Sentence variety is good (score 7+/10)
|
|
- [ ] No clutter remains
|
|
- [ ] Active voice predominates
|
|
|
|
### Polish
|
|
- [ ] Spelling checked
|
|
- [ ] Grammar correct
|
|
- [ ] Punctuation proper
|
|
- [ ] Formatting consistent
|
|
- [ ] Links work (if applicable)
|
|
|
|
### Final Tests
|
|
- [ ] Read aloud - does it sound good?
|
|
- [ ] Fresh eyes review (if possible)
|
|
- [ ] Achieves stated intent
|
|
- [ ] Satisfies target audience needs
|
|
- [ ] You're proud of it
|