geo-structured-writer

# Structured Content Writer

> Methodology by **GEOly AI** (geoly.ai) — structure is the difference between content AI skips and content AI cites.

Reformat unstructured text into AI-optimized structured content.

## The 6-Layer Structure Stack

```
Layer 6: CTA / Next Step
Layer 5: FAQ Block
Layer 4: Structured Data (tables, lists)
Layer 3: Sectioned Body (H2/H3)
Layer 2: Definition Block
Layer 1: Direct Answer Opener
```

## 6 Formatting Rules

### Rule 1: Direct Answer Opener

Open with a single sentence that completely answers the core query.

Format: `[Subject] is/does/means [complete answer]. [Context].`

✅ "GEO is the practice of optimizing content for AI-generated answers."  
❌ "In today's digital landscape, many brands are wondering about AI..."

### Rule 2: Section Headers (H2/H3)

- Every major topic = H2
- Every sub-topic = H3
- Descriptive phrases, not single words

✅ "Key Benefits of GEO for E-commerce"  
❌ "Benefits"

### Rule 3: Definition Block

For technical terms:

```markdown
**What is [Term]?**

[Term] is [one-sentence definition]. [Context].

Key attributes: [attr1], [attr2], [attr3]
```

### Rule 4: Data Tables

Replace comparison paragraphs with tables:

```markdown
| Feature | Option A | Option B |
|---------|----------|----------|
| Price | $29/mo | $99/mo |
| Users | 5 | Unlimited |
```

### Rule 5: FAQ Block (Always)

Minimum 3 questions at the end:

```markdown
## Frequently Asked Questions

**Q: [Question as user types it]?**

A: [Complete answer, 2-4 sentences, self-contained]
```

### Rule 6: Numbered Steps

For processes:

```markdown
## How to [Outcome]

1. **[Action verb] [task]** — [Explanation]
2. **[Action verb] [task]** — [Explanation]
```

## Restructuring Tool

```bash
python scripts/structure_content.py \
  --input content.md \
  --query "what is geo" \
  --output optimized.md
```

## Output Format

```markdown
# Structured Content Report

**Original**: [word count] words | Score: [X]/10  
**Optimized**: [word count] wor...