Content Research & Writing Guide
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
Type Example
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?"