marcusquinn · marcusquinn · Feb 8, 2026 · Feb 8, 2026
diff --git a/.agents/content.md b/.agents/content.md
@@ -3,13 +3,19 @@ name: content
 description: Content creation and management - copywriting, guidelines, editorial workflows
 mode: subagent
 subagents:
-  # Content
+  # Content creation
   - guidelines
   - humanise
   - summarize
+  - seo-writer
+  - meta-creator
+  - editor
+  - internal-linker
+  - context-templates
   # SEO integration
   - keyword-research
   - eeat-score
+  - content-analyzer
   # WordPress publishing
   - wp-admin
   - mainwp
@@ -31,20 +37,50 @@ subagents:
 - **Focus**: Quality, SEO-optimized content production
 
 **Subagents** (`content/`):
-- `guidelines.md` - Content standards and style guide
-- `humanise.md` - Remove AI writing patterns, make text sound human
+
+| Subagent | Purpose |
+|----------|---------|
+| `guidelines.md` | Content standards and style guide |
+| `humanise.md` | Remove AI writing patterns, make text sound human |
+| `seo-writer.md` | SEO-optimized content writing with keyword integration |
+| `meta-creator.md` | Generate meta titles and descriptions for SEO |
+| `editor.md` | Transform AI content into human-sounding articles |
+| `internal-linker.md` | Strategic internal linking recommendations |
+| `context-templates.md` | Per-project SEO context templates (brand voice, style, keywords) |
+
+**SEO Analysis** (via `seo/`):
+
+| Subagent | Purpose |
+|----------|---------|
+| `content-analyzer.md` | Full content audit (readability, keywords, SEO quality) |
+| `seo-optimizer.md` | On-page SEO recommendations |
+| `keyword-mapper.md` | Keyword placement and density analysis |
 
 **Integrations**:
-- `seo.md` - Keyword optimization
+- `seo.md` - Keyword research and optimization
 - `tools/wordpress/` - Publishing workflow
 - `tools/context/` - Research tools
 
+**Content Analysis Script**:
+
+```bash
+# Full content analysis with keyword
+python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py analyze article.md --keyword "target keyword"
+
+# Individual analyses
+python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py readability article.md
+python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py keywords article.md --keyword "keyword"
+python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py quality article.md
+python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py intent "search query"
+```
+
 **Workflow**:
 1. Research (keywords, competitors, audience)
-2. Outline (structure, key points)
-3. Draft (following guidelines)
-4. Optimize (SEO, readability)
-5. Publish (via WordPress or CMS)
+2. Write (`content/seo-writer.md` with keyword targets)
+3. Analyze (`seo-content-analyzer.py analyze`)
+4. Optimize (address issues from analysis)
+5. Edit (`content/editor.md` for human voice)
+6. Publish (via WordPress or CMS)
 
 <!-- AI-CONTEXT-END -->
 

diff --git a/.agents/content/context-templates.md b/.agents/content/context-templates.md
@@ -0,0 +1,195 @@
+---
+name: context-templates
+description: Context file templates for SEO content creation (brand voice, style guide, keywords, links)
+mode: subagent
+model: haiku
+---
+
+# Content Context Templates
+
+Templates for project-level context files that guide SEO content creation. Adapted from [TheCraigHewitt/seomachine](https://github.com/TheCraigHewitt/seomachine) (MIT License).
+
+## Setup
+
+Create a `context/` directory in your project root and populate these templates:
+
+```bash
+mkdir -p context
+```
+
+The content writing subagents (`content/seo-writer.md`, `content/editor.md`, `content/internal-linker.md`) automatically check for these files before writing.
+
+## Templates
+
+### context/brand-voice.md
+
+```markdown
+# Brand Voice Guide
+
+## Voice Pillars
+- **[Pillar 1]**: [Description of this voice quality]
+- **[Pillar 2]**: [Description]
+- **[Pillar 3]**: [Description]
+
+## Tone by Content Type
+| Content Type | Tone | Example |
+|-------------|------|---------|
+| Blog posts | [e.g., conversational, expert] | "Here's what we found..." |
+| Landing pages | [e.g., confident, direct] | "Get started in minutes" |
+| Documentation | [e.g., clear, helpful] | "Follow these steps..." |
+
+## Core Messages
+1. [Primary value proposition]
+2. [Secondary message]
+3. [Differentiator]
+
+## Writing Style
+- **Sentence length**: [e.g., Mix of short and medium]
+- **Vocabulary level**: [e.g., Professional but accessible]
+- **Contractions**: [e.g., Yes, use naturally]
+- **First person**: [e.g., "We" for company, avoid "I"]
+- **Reader address**: [e.g., "You" directly]
+
+## Words to Use
+[List preferred terminology]
+
+## Words to Avoid
+[List terms that don't fit the brand]
+```
+
+### context/style-guide.md
+
+```markdown
+# Style Guide
+
+## Grammar and Mechanics
+- **Oxford comma**: [Yes/No]
+- **Capitalization**: [Title case for headings / Sentence case]
+- **Numbers**: [Spell out under 10 / Always use digits]
+- **Dates**: [Format: January 15, 2026]
+
+## Formatting
+- **Headings**: [H2 for main sections, H3 for subsections]
+- **Lists**: [Bullet for unordered, numbered for steps]
+- **Bold**: [For key terms and emphasis]
+- **Code**: [Backticks for technical terms]
+
+## Terminology
+| Use | Don't Use |
+|-----|-----------|
+| [preferred term] | [avoided term] |
+
+## Content Structure
+- Introduction: [Hook + context + promise]
+- Body: [H2 sections every 300-400 words]
+- Conclusion: [Summary + CTA]
+```
+
+### context/target-keywords.md
+
+```markdown
+# Target Keywords
+
+## Pillar Topics
+
+### [Topic Cluster 1]
+- **Pillar keyword**: [main keyword] (volume: X, difficulty: Y)
+- **Cluster keywords**:
+  - [subtopic keyword 1] (volume: X)
+  - [subtopic keyword 2] (volume: X)
+  - [subtopic keyword 3] (volume: X)
+- **Long-tail variations**:
+  - [long-tail 1]
+  - [long-tail 2]
+- **Search intent**: [informational/commercial/transactional]
+
+### [Topic Cluster 2]
+...
+
+## Current Rankings
+| Keyword | Position | URL | Opportunity |
+|---------|----------|-----|-------------|
+| [keyword] | [pos] | [url] | [action needed] |
+```
+
+### context/internal-links-map.md
+
+```markdown
+# Internal Links Map
+
+## Product/Feature Pages
+- [/features](/features) - Main features overview (anchor: "our features")
+- [/pricing](/pricing) - Pricing plans (anchor: "pricing", "plans")
+- [/integrations](/integrations) - Integration directory
+
+## Pillar Content
+- [/blog/guide-to-X](/blog/guide-to-X) - Primary pillar (anchor: "complete guide to X")
+- [/blog/Y-explained](/blog/Y-explained) - Secondary pillar (anchor: "understanding Y")
+
+## Top Blog Posts
+- [/blog/how-to-Z](/blog/how-to-Z) - High traffic (anchor: "how to Z")
+- [/blog/best-tools](/blog/best-tools) - High conversion (anchor: "best tools for...")
+
+## Topic Clusters
+### Cluster: [Topic A]
+- Pillar: /blog/topic-a-guide
+- Cluster: /blog/topic-a-subtopic-1
+- Cluster: /blog/topic-a-subtopic-2
+```
+
+### context/competitor-analysis.md
+
+```markdown
+# Competitor Analysis
+
+## Primary Competitors
+| Competitor | Domain | Strengths | Weaknesses |
+|-----------|--------|-----------|------------|
+| [Name] | [domain.com] | [what they do well] | [gaps we can exploit] |
+
+## Content Strategy Comparison
+| Topic | Us | Competitor A | Competitor B | Gap |
+|-------|-----|-------------|-------------|-----|
+| [topic] | [our coverage] | [their coverage] | [their coverage] | [opportunity] |
+
+## Keyword Gaps
+Keywords competitors rank for that we don't:
+- [keyword] - [competitor] ranks #[X], we don't rank
+```
+
+### context/seo-guidelines.md
+
+```markdown
+# SEO Guidelines
+
+## Content Requirements
+- Minimum word count: 2,000 (optimal: 2,500-3,000)
+- Primary keyword density: 1-2%
+- Reading level: Grade 8-10
+
+## On-Page SEO
+- Meta title: 50-60 characters, keyword near front
+- Meta description: 150-160 characters, include keyword and CTA
+- H1: Single, includes primary keyword
+- H2: 4+ sections, 2-3 include keyword variations
+- Internal links: 3-5 per article
+- External links: 2-3 to authoritative sources
+
+## Technical
+- URL slug: lowercase, hyphens, include keyword
+- Image alt text: descriptive, include keyword variation
+- Schema markup: Article, FAQ, HowTo as appropriate
+```
+
+## Usage
+
+Content subagents check for these files automatically:
+
+```bash
+# Check what context is available
+ls context/ 2>/dev/null || ls .aidevops/context/ 2>/dev/null
+
+# Initialize context for a new project
+mkdir -p context
+# Then populate templates above with your project's information
+```
diff --git a/.agents/content/editor.md b/.agents/content/editor.md
@@ -0,0 +1,99 @@
+---
+name: editor
+description: Transform AI-generated content into human-sounding, engaging articles
+mode: subagent
+model: sonnet
+---
+
+# Content Editor
+
+Transform technically accurate content into human-sounding, engaging articles. Complements `content/humanise.md` with deeper editorial analysis.
+
+Adapted from [TheCraigHewitt/seomachine](https://github.com/TheCraigHewitt/seomachine) (MIT License).
+
+## Quick Reference
+
+- **Purpose**: Make content sound human, engaging, and authentic
+- **Input**: Draft article
+- **Output**: Editorial report with specific improvements and humanity score
+- **Related**: `content/humanise.md` (pattern removal), this agent (editorial voice)
+
+## Analysis Dimensions
+
+### 1. Voice and Personality (Score 0-100)
+
+- Consistent tone throughout
+- Author personality showing through
+- Conversational elements (questions, asides)
+- Unique perspective or angle
+- Avoidance of generic filler
+
+### 2. Specificity (Score 0-100)
+
+- Concrete examples vs vague claims
+- Real data and statistics (with sources)
+- Named tools, companies, or people
+- Specific numbers ("40% increase" not "significant improvement")
+- Case studies or scenarios
+
+### 3. Readability and Flow (Score 0-100)
+
+- Varied sentence length (mix of short and long)
+- Smooth transitions between sections
+- Logical progression of ideas
+- Active voice predominance
+- Paragraph rhythm (not all same length)
+
+### 4. Robotic vs Human Patterns
+
+Detect and flag:
+
+- **AI vocabulary**: delve, tapestry, landscape, leverage, utilize, facilitate
+- **Filler phrases**: "It's worth noting that", "In today's digital age"
+- **Rule of three**: Excessive use of three-item lists
+- **Em dash overuse**: More than 2-3 per article
+- **Hedging**: "might", "could potentially", "it's possible that"
+- **Promotional language**: "game-changer", "revolutionary", "cutting-edge"
+
+See `content/humanise.md` for the complete pattern list.
+
+### 5. Engagement and Storytelling
+
+- Hook in the introduction
+- Anecdotes or real-world examples
+- Questions that engage the reader
+- Surprising facts or counterintuitive points
+- Strong conclusion with clear takeaway
+
+## Output Format
+
+```markdown
+## Editorial Report
+
+### Humanity Score: XX/100
+
+### Critical Edits (Must Fix)
+1. **Before**: [original text]
+   **After**: [improved text]
+   **Why**: [explanation]
+
+### Pattern Analysis
+- AI vocabulary found: [list]
+- Filler phrases: [count]
+- Passive voice: [percentage]
+- Hedging instances: [count]
+
+### Section-by-Section Notes
+- Introduction: [feedback]
+- Section 2: [feedback]
+- ...
+
+### Specific Rewrites
+[3-5 before/after examples targeting the weakest sections]
+```
+
+## Related
+
+- `content/humanise.md` - Automated AI pattern detection and removal
+- `content/seo-writer.md` - Initial content creation
+- `content/guidelines.md` - Content standards