Collaborative writing partner for articles, blog posts, and documentation.
Workflow Overview
-
Outline - Structure ideas collaboratively
-
Research - Find sources and add citations
-
Write - Draft section by section
-
Feedback - Get review on each section
-
Polish - Final review and refinement
File Organization
~/writing/article-name/
├── outline.md # Structure
├── research.md # Sources and citations
├── draft-v1.md # First draft
├── draft-v2.md # Revised
├── final.md # Publication-ready
└── sources/ # Reference materials
Outline Template
# Article Outline: [Title]
## Hook
- Opening line/story/statistic
- Why reader should care
## Introduction
- Context and background
- Problem statement
- What this article covers
## Main Sections
### Section 1: [Title]
- Key point A
- Key point B
- [Research needed: topic]
### Section 2: [Title]
- Key point C
- Evidence/data needed
## Conclusion
- Summary
- Call to action
- Final thought
## Research To-Do
- [ ] Find data on [topic]
- [ ] Source for [claim]
Hook Improvement
When reviewing introductions, consider:
-
Does it create curiosity?
-
Does it promise value?
-
Is it specific enough?
-
Does it match the audience?
Hook Types
| Bold statement | "Product management will never be the same."
| Question | "What if you could talk to every customer before coffee?"
| Story | "Sarah spent two weeks building the wrong feature..."
| Data | "Last month, AI analyzed 500 interviews in 30 minutes."
Section Feedback Format
# Feedback: [Section Name]
## What Works Well ✓
- [Strength 1]
- [Strength 2]
## Suggestions
### Clarity
- [Issue] → [Fix]
### Flow
- [Transition issue] → [Better connection]
### Evidence
- [Claim needing support] → [Add citation]
## Specific Line Edits
Original:
> [Quote from draft]
Suggested:
> [Improved version]
Why: [Explanation]
Citation Formats
Inline:
Studies show 40% improvement (McKinsey, 2024).
Numbered:
Studies show 40% improvement [1].
[1] McKinsey Global Institute. (2024)...
Pre-Publish Checklist
All claims sourced Citations formatted Examples clear Transitions smooth Call to action present Proofread for typos
Voice Preservation
-
Learn writer's style from samples
-
Suggest, don't replace
-
Match tone (formal/casual/technical)
-
Ask: "Does this sound like you?"