Editorial prompt strategy

# Editorial Prompts Strategy

## Overview

Editorial prompting involves crafting prompts that help AI assistants produce high-quality written content—from blog posts and documentation to marketing copy and technical writing. This strategy covers best practices for content creation, editing, tone adaptation, and maintaining consistent voice across projects.

## Core Principles

### 1. Define Voice and Tone

- **Specify Brand Voice**: Formal, conversational, authoritative, friendly, technical
- **Target Audience**: Who will read this content and what do they need
- **Emotional Register**: Informative, persuasive, empathetic, urgent, celebratory
- **Reading Level**: Technical expert, general audience, beginner-friendly

### 2. Structure Before Style

- **Outline First**: Request structure before full content
- **Format Specification**: Headers, lists, paragraphs, callouts
- **Length Constraints**: Word count, section limits, summary requirements
- **Visual Hierarchy**: How content should flow and be scanned

### 3. Context Shapes Content

- **Publication Channel**: Blog, documentation, email, social media, whitepaper
- **Content Goals**: Educate, convert, inform, entertain, persuade
- **SEO Requirements**: Keywords, meta descriptions, title optimization
- **Related Content**: How this piece fits with existing materials

## Scenario-Specific Guidelines

### 1. Content Creation

#### Best Practices

- **Start with Purpose**: Define why this content exists before how it reads
- **Provide Examples**: Share similar content that matches desired style
- **Specify Constraints**: Word count, required sections, call-to-action
- **Request Drafts**: Ask for outlines before full content

#### Structure for Content Creation Prompts

```text
Content Type: [Blog post, documentation, email, whitepaper]
Topic: [Primary subject matter]
Audience: [Who will read this and their knowledge level]
Goals:
  - Primary: [Main objective]
  - Secondary: [Supporting objectives]
Voice/Tone: [Brand voice guidelines]
Format Requirements:
  - Length: [Word count or section requirements]
  - Structure: [Headers, lists, images placeholders]
  - Sections: [Required components]
SEO/Keywords: [Target terms if applicable]
Call to Action: [Desired reader action]
```

### 2. Editing and Revision

#### Best Practices

- **Specify Edit Type**: Line edit, developmental edit, copyedit, proofread
- **Define Priorities**: Clarity, concision, engagement, accuracy
- **Preserve Intent**: Clarify what must remain unchanged
- **Request Explanations**: Ask for rationale behind suggested changes

#### Structure for Editing Prompts

```text
Edit Type: [Line edit, copyedit, developmental, proofread]
Content: [Text to be edited]
Priorities:
  - Must Fix: [Critical issues to address]
  - Should Improve: [Secondary concerns]
  - Preserve: [Elements that should not change]
Style Guide: [Reference standards—AP, Chicago, house style]
Tone Adjustment: [Any voice/tone changes needed]
Output Format: [Track changes, clean copy, annotations]
```

### 3. Tone and Voice Adaptation

#### Best Practices

- **Provide Contrast**: Show original vs. desired voice
- **Use Exemplars**: Reference writers or brands with similar voice
- **Define Boundaries**: What's too casual, too formal, too promotional
- **Test Consistency**: Request multiple samples to verify voice match

#### Structure for Tone Adaptation Prompts

```text
Source Content: [Original text]
Current Tone: [How it reads now]
Target Tone: [Desired voice characteristics]
Reference Examples: [Content that exemplifies target tone]
Audience Context: [Who will read and their expectations]
Constraints:
  - Must Maintain: [Key messages, facts, structure]
  - Can Change: [Word choice, sentence structure, examples]
  - Avoid: [Specific phrases, approaches, or styles]
```

### 4. Content Transformation

#### Best Practices

- **Clarify Purpose Change**: Different formats serve different needs
- **Specify New Constraints**: Length, format, audience differences
- **Maintain Core Message**: What must be preserved across formats
- **Request Multiple Versions**: Compare approaches for best fit

#### Structure for Transformation Prompts

```text
Source Material: [Original content type and text]
Target Format: [New content type]
Audience Shift: [Changes in reader expectations]
Core Message: [What must be preserved]
New Requirements:
  - Length: [New word count]
  - Structure: [New format requirements]
  - Tone: [Any voice adjustments]
Platform Constraints: [Character limits, formatting rules]
```

## Editorial Metaprompt Patterns

### 1. The Voice Emulation Pattern

```text
Write in the style of [reference voice/brand]
For [specific audience]
About [topic]
Maintaining [key characteristics]
While avoiding [anti-patterns]
```

### 2. The Progressive Refinement Pattern

```text
Start with [rough draft/outline]
Improve [specific aspect]
Then enhance [another aspect]
Ensure [quality standards]
Preserve [original intent]
```

### 3. The Audience Adaptation Pattern

```text
Given content for [original audience]
Adapt for [new audience]
Adjusting [language, complexity, examples]
While maintaining [core message]
Adding [audience-specific elements]
```

### 4. The Multi-Format Pattern

```text
From [source content]
Create [format 1: short summary]
And [format 2: detailed version]
And [format 3: social snippet]
Ensuring [consistent messaging]
```

## Quality Attributes to Specify

### Clarity

- Sentence complexity limits
- Jargon tolerance level
- Definition requirements
- Example density

### Engagement

- Hook requirements
- Storytelling elements
- Interactive components
- Call-to-action strength

### Accuracy

- Fact-checking requirements
- Citation needs
- Source attribution
- Technical precision

### Consistency

- Voice adherence
- Terminology standards
- Formatting uniformity
- Brand alignment

## Common Anti-Patterns to Avoid

### 1. Vague Voice Direction

- "Make it engaging"
- "Write in a professional tone"
- "Sound like our brand"

### 2. Missing Audience Context

- "Write a blog post about AI"
- "Create documentation for this feature"

### 3. Unclear Scope

- "Edit this to make it better"
- "Improve the flow"

### 4. Format Amnesia

- "Write something about our product"
- "Create content for marketing"

## Anti-Pattern Corrections

### 1. Vague Voice Direction

❌ "Make it engaging"
✅ "Write with short paragraphs, active voice, direct reader address, and include a surprising statistic in the opening to hook readers"

### 2. Missing Audience Context

❌ "Write a blog post about AI"
✅ "Write a 1200-word blog post about AI code assistants for senior developers skeptical of AI tools, addressing their concerns about accuracy and control"

### 3. Unclear Scope

❌ "Edit this to make it better"
✅ "Copyedit for clarity: reduce average sentence length to under 20 words, eliminate passive voice, and ensure each paragraph has a clear topic sentence"

### 4. Format Amnesia

❌ "Write something about our product"
✅ "Write a 300-word email announcement for existing customers about our new feature, emphasizing time savings and including three bullet points of key benefits"

## Tips for Effective Editorial Prompting

### 1. Layer Your Requirements

- Start with content purpose
- Add audience context
- Specify voice and tone
- Define structural requirements
- Include quality criteria last

### 2. Use Reference Materials

- Provide style guide excerpts
- Share successful examples
- Include brand voice documents
- Reference competitor approaches

### 3. Be Explicit About Trade-offs

- Completeness vs. brevity
- Precision vs. accessibility
- Personality vs. professionalism
- SEO vs. natural reading

### 4. Request Reasoning

- Ask why specific word choices were made
- Seek alternative approaches
- Request explanation of structure decisions
- Ask for readability considerations

### 5. Specify Output Format

- Document structure
- Heading hierarchy
- List formatting
- Metadata requirements

## Content Type Templates

### Blog Post Template

```text
Write a [word count] blog post about [topic]

Audience: [Reader profile]
Goal: [What reader should do/know after reading]
Tone: [Voice characteristics]

Structure:
- Hook: [Opening approach]
- Sections: [Required topics to cover]
- CTA: [Desired action]

Keywords: [SEO terms to include naturally]
Internal Links: [Related content to reference]
```

### Documentation Template

```text
Create documentation for [feature/product]

User Type: [Technical level and role]
Documentation Type: [Tutorial, reference, concept, how-to]
Prerequisites: [What user should know already]

Include:
- Overview: [Purpose and capabilities]
- Steps: [Numbered procedures]
- Examples: [Code samples, screenshots]
- Troubleshooting: [Common issues]

Style: [Documentation standards]
```

### Email Campaign Template

```text
Write a [type] email for [campaign]

Recipient: [Audience segment]
Relationship: [New lead, customer, churned user]
Goal: [Open, click, convert, inform]

Subject Line: [Requirements or suggestions]
Preview Text: [First line visible in inbox]
Body:
  - Opening: [Hook approach]
  - Value: [Key message]
  - Proof: [Social proof, data, testimonials]
  - CTA: [Specific action with button text]

Constraints: [Word count, mobile optimization]
```

### Social Media Template

```text
Create [number] social posts for [platform]

Campaign: [Larger context]
Content Source: [Article, announcement, promotion]
Brand Voice: [Platform-specific tone]

Requirements:
- Character Limit: [Platform constraints]
- Hashtags: [Number and style]
- Emoji Usage: [Guidelines]
- Visual Reference: [What image will accompany]

Variations: [A/B testing elements]
```

## Checklist for Editorial Prompts

Before submitting a prompt, ensure you've included:

- [ ] Content type and format
- [ ] Target audience profile
- [ ] Purpose and goals
- [ ] Voice and tone direction
- [ ] Length and structure requirements
- [ ] Quality criteria
- [ ] Reference materials or examples
- [ ] Call-to-action or desired outcome
- [ ] Platform constraints (if applicable)
- [ ] SEO requirements (if applicable)

## Editorial Review Criteria

When evaluating AI-generated editorial content:

### Accuracy

- Facts are correct and verifiable
- Claims are appropriately hedged
- Sources are properly attributed

### Voice Consistency

- Tone matches brand guidelines
- Personality is maintained throughout
- Audience appropriateness is consistent

### Structure

- Logical flow and progression
- Clear hierarchy and formatting
- Appropriate length for purpose

### Engagement

- Strong opening hook
- Maintained reader interest
- Clear and compelling CTA

### Technical Quality

- Grammar and punctuation
- Spelling and word choice
- Style guide adherence