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 materialsOutline 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?"