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

Voice Preservation

Learn writer's style from samples
Suggest, don't replace
Match tone (formal/casual/technical)
Ask: "Does this sound like you?"

content-writing