# Structure

The post has exactly 5 parts. Write them in order. Do not add section labels like "Part 1" or "Section" in the final output.

---

## Part 1: The Setup (200-300 words)

Start with a specific, concrete moment backed by something real from research.
A documented complaint, a known failure, a real user reaction, a named event.

What works:
- "Spent sunday watching my search app return cat photos for dog queries. My embeddings were wrong."
- A stat or outcome that happened to a real person or product

Include:
- Where you were or what you were doing
- What went wrong or what was surprising
- Why the reader should care

Do not write:
- "Many people face this problem."

Do write:
- "You've probably done this. i know i have."

CRITICAL NON-NEGOTIABLE: never open with a day/time phrase like "last Sunday," "this morning," "today I." Open with the real-world fact or documented reaction directly.

---

## Part 2: The Deep Dive (600-800 words)

Break this into 3-5 chunks. Each chunk is 150-200 words.

Start each chunk differently. Use one of these openers:
- "i used to think..."
- "here's a question people always ask..."
- "the first time i tried this..."
- "most tutorials tell you..."
- "what actually happens is..."
- "my coworker tried to..."
- "the problem isn't what you think..."

Within each chunk:
- Explain the idea across 2-3 short paragraphs. Each paragraph is 2-3 sentences maximum.
- Tell a mini-story about it failing or confusing you
- Address one question people have
- Show one surprising detail you wish you had known

Paragraph rhythm inside chunks:
- Hard limit: 3 sentences per paragraph. Break and start a new paragraph.
- Add a 1-sentence paragraph for emphasis
- Talk directly to the reader every few paragraphs

Use rich markdown elements throughout. See writing-style.md for the full list: bold punch lines, short lists, blockquotes, numbered steps, inline code, comparison tables, small headings, and horizontal rules. Aim for at least one element every 200 words.

---

## Part 3: The Random Break (150-200 words)

CRITICAL NON-NEGOTIABLE: this section is not optional. It must exist.

Go off-topic. Talk about something related but not direct to the main subject.

Examples:
- In a post about databases, talk about naming projects after animals
- In a post about redirects, talk about that coworker who self-hosts everything
- In a post about APIs, talk about the time you read docs for 2 hours and missed a comment in the example

Purpose: gives the reader a mental pause. Reminds them they are reading a human, not a generator.

---

## Part 4: The Real Talk (150-200 words)

Get honest. Be blunt.

If teaching: admit where this is not useful. Name who should not bother.
If comparing: acknowledge the winner is not for everyone.
If sharing new info: name the biggest misconception about it.

Examples:
- "Most people don't need this."
- "This is overkill for small sites."
- "If you're running under 10k requests a day, just use the simple thing."

Do not soften it. Direct honesty is the point of this section.

---

## Part 5: The Ending (100-150 words)

Do not summarize. Do not list what you covered.

Give one final thought. A small story. A question. End like you are finishing a conversation.

Bad: "In conclusion, vector databases are a powerful tool for..."
Good: "i still think about that sunday. Should have walked my dog. But at least my app works now."

---

## Length management

- Target: 1200-1500 words
- If short: add another mini-story inside Part 2 or extend Part 3
- If long: cut any paragraph that functions as a hidden list