AI content writing system

Let's write an article together, section by section. We're going to work in 3 steps.

Step 1: Gathering Information
When starting an article, request the following information from me:

1. Expertise Area: In which area are you an EXPERT?
2. Subject: The SUBJECT of the article.
3. Audience: Who is the ideal audience for this article, and what do they want to know?
4. Expert Interview Transcript: A transcript (or audio) of an interview with a subject matter expert on this topic. This is the primary source. Read it in full and extract the concrete claims, process steps, examples, numbers, and opinions in it. Summarize back the 5–10 most valuable insights you found and ask me to confirm which to build the article around. Treat these as ground truth over general knowledge; do not generalize or soften them.
5. Top-Ranking Articles: The URLs of top-ranking articles on the topic.
6. Outline: An outline of the article with section headlines.
7. Content Offer / Conversion: What is the content offer or conversion action for this article? For example: a downloadable checklist, a free consultation booking, a tool signup, or a product demo. This will be woven into the article as contextual CTAs.

Wait until I have given you this response, and then move to the next step.

Step 2: Outline Review
Once you have received this information:
1. Assess the Outline: Review the user's outline for completeness, conciseness, and logical flow, checking it against both the expert transcript (is every strong insight from the expert given a home?) and the top-ranking articles (what do they cover that we're missing, and what do we have that they don't?). Suggest improvements and provide context for each suggestion.
2. Feedback: Allow the user to provide feedback on the suggested improvements. Confirm how to proceed based on their feedback.

Do not start writing. Wait for the user feedback first before moving any further, to confirm how to proceed. Once the final outline is confirmed, move on to the next step.

Step 3: Writing the First Draft
Introduction: Based on the article topic and the approved outline, write a placeholder introduction using the AIDA formula. Keep it under 150 words.

Section Writing: Write each section based on the approved outline, one at a time. Include detailed explanations, examples, and context to ensure the reader fully understands the content. Use flowing paragraphs rather than bullet points. Draw examples, opinions, and specifics from the expert transcript wherever possible, and quote the expert directly where a quote is stronger than a paraphrase.

Ensure each section:
- Addresses the reader directly using personal pronouns.
- Maintains a conversational tone with simple language, contractions, and rhetorical questions.
- Includes comprehensive detail and context, simplifying complex ideas while keeping a level of detail.
- Contains step-by-step instructions and examples to allow readers to follow along easily.
- Is anchored in the expert's actual experience, not generic best practices.
- Opens with a direct, self-contained answer to the question the section heading implies (1–2 sentences) before expanding.

Visual Suggestions: After each section, add a short block titled "Suggested visuals" with 1–3 ideas for images, diagrams, charts, screenshots, tables, or illustrations that would help the reader understand this section. For each, give: the type (e.g. flowchart, before/after comparison, annotated screenshot, bar chart, simple illustration), what it should show, and a one-line caption. Only suggest visuals that carry real information — no decorative stock imagery.

User Feedback: After completing each section, stop and ask the user for feedback. Refine the section based on their input before moving on to the next.

Content Offer / CTA Placement: Using the content offer or conversion action provided in Step 1, place contextual CTAs at natural points throughout the article — at minimum after the first major section, once mid-article, and in or near the conclusion. Each CTA should bridge from the topic just discussed to the offer, using bold text for the action. If a specific offer was provided, write a contextual sentence like: "Need help with [topic]? **Download our free [Resource Name]** or **get in touch with [Company]** to talk about [relevant engagement]." If no specific offer was provided, insert a placeholder: [Add a HubSpot CTA here].

Further Notes on Writing:
- Remove any preamble and use a conversational tone, as if speaking to a friend.
- Simplify complex ideas, while still keeping a level of detail. Always provide context and examples.
- If citing information, give links to current, live sources that are up-to-date for the current year.
- Ensure each section is presented in detailed, flowing paragraphs rather than bullet points.
- Include step-by-step instructions and examples that allow readers to follow along easily.

I want to copy and paste the finished article so far, with all the approved final sections. Please rewrite it now for me as one response. Keep the "Suggested visuals" blocks in place under each section, marked clearly so they're easy to find and remove later.

Read the full article below. Propose a visual plan for it: a numbered list of every image, diagram, chart, table, screenshot, or illustration that would genuinely help the reader. Cap it at one visual per major section plus a hero image. For each, give:

1. Placement: which section, and after which paragraph
2. Type: e.g. flowchart, process diagram, comparison table, bar/line chart, annotated screenshot, before/after, simple line illustration, hero image
3. What it shows: a precise description a designer could work from — the elements, labels, data points, or steps to include
4. Caption and alt text
5. Source of the data or content (from the article, the expert interview, or something I need to supply)

Then, for any chart or table, draft the actual data table in markdown. For any diagram, write a Mermaid definition I can render. For the hero image and any illustration, write an image-generation prompt in a clean, flat, editorial style with no text baked into the image.

Skip anything decorative. Every visual must carry information the text alone conveys less well.

Article:
[PASTE FULL ARTICLE HERE]

Help me edit my article with the following changes. Please respond with the edited version of each section one at a time:

Personal Address: Write as if you are addressing one person. Use personal pronouns and incorporate words like 'you' and 'your' to make the writing feel direct and personal. Avoid using generic terms like 'people' or 'users.'

Conversational Tone: Write as if having a friendly chat with the reader. Use simple language, contractions, and rhetorical questions to make the writing more engaging.

Logical Flow: Create a logical flow with headlines that lead naturally to the next section, creating a cohesive narrative that guides the reader through the content.

Engaging Headlines: Ensure each headline captures the essence of the section it introduces and sparks curiosity about what the reader will learn or gain.

Comprehensive Detail: Include detailed explanations and context for each concept or example. Avoid overusing bullet points, and explain ideas in sentences and paragraphs to ensure a tutorial-like flow.

Step-by-Step Instructions: Include step-by-step instructions and examples in each section, explaining their significance and how they benefit the reader.

Transition Sentences: Create transition sentences between each major section to ensure smooth flow and provide context between ideas.

Preserve Expert Voice: Keep direct quotes, specific examples, numbers, and opinions from the subject matter expert intact. Do not generalize them.

Introduction and Conclusion:
- Write a new introduction using the AIDA formula (Attention, Interest, Desire, Action) based on the current version of the article. Keep it under 200 words.
- Write a conclusion in 150 words, recapping the article, covering major issues, key points, and the goal the audience wants to achieve. Add a call-to-action.

Process:
1. Identify the Ideal Audience: Before making any changes, ask me who the ideal audience is for this article. Wait for my response, then proceed with the next steps in the process.
2. Section-by-Section Editing: Edit each section individually and present it for review one at a time.
3. Show examples for each edit: Once all edits have been completed on a section, show examples of how each edit has been applied in that section for review and possible refinement.
4. Show the original text and the edited text side-by-side for easy comparison.
5. Section Finalization: Proceed to the next section only after the current one is finalized.
6. Final Rewrite: Once all sections have been edited and reviewed, rewrite the entire article with the new edits in place for final review. In the final rewrite, do not include the examples of how edits were applied. Only incorporate the final edited content.

Current Article:
[PASTE FULL ARTICLE HERE]

Help me edit my article for on-page SEO with the focus keyword "[FOCUS KEYWORD]". Please edit the entire article at once with the following changes:

1. Add the focus keyword into the title of the article.
2. Add the focus keyword once within the first 100 words.
3. Add the focus keyword in one H2 subheading.
4. Add the focus keyword three times within the body of the article, spread across different sections naturally.
5. Add the focus keyword in the last 150 words of the article.

Guidelines:
- Ensure the addition of the focus keyword is natural and maintains the flow and context of the article.
- Skip any instances where the keyword cannot be integrated naturally.
- Do not exceed the specified keyword frequency in each section (i.e., only once in the intro, once in an H2, three times in the body, and once in the conclusion).
- However, ensure that the focus keyword is integrated naturally without reducing the content length.

Now optimize this article for AI answer engines (ChatGPT, Perplexity, Claude, Google AI Overviews) without changing its voice or reducing its depth. Apply these changes and show me each one:

1. Direct answer up front: Right after the introduction, add a 40–60 word "short answer" paragraph (or a "Key takeaways" box of 3–5 one-sentence points) that answers the core question of the article in a way that could be quoted on its own.

2. Question-style headings: Where a section answers a question readers actually ask, rewrite its H2/H3 as that question (e.g. "How long does a HubSpot migration take?"). Keep the rest as statements. Don't force it.

3. Answer-first sections: Make sure the first 1–2 sentences under each heading give a complete, self-contained answer before the explanation. Each of those opening sentences should make sense if quoted alone, with no "this" or "it" referring back to earlier text.

4. Quotable specifics: Turn vague claims into specific ones with a number, a range, a timeframe, or a named condition, using the expert's statements and cited sources. Flag any specifics you can't support so I can verify or cut them.

5. Definitions: For each key term or concept the article relies on, make sure there's a one-sentence definition in the form "[Term] is ..." the first time it appears.

6. Entity clarity: Use full names for tools, companies, methods, and people on first mention (not "the platform", "the tool"). Mention the author/expert by name and role once so the expertise is attributable.

7. FAQ section: Add an FAQ near the end with 4–6 questions people genuinely ask about this topic (from People Also Ask, forums, and how AI assistants phrase it), each answered in 2–4 sentences. Don't repeat the exact questions already used as headings.

8. Schema: Output JSON-LD for Article (headline, author, datePublished, dateModified) and FAQPage (from the FAQ section) that I can paste into the page's head. If the article is a how-to, also output HowTo schema for the steps.

Show the edited article first, then the schema blocks separately. Do not change the focus keyword placements from the SEO pass.

I need to write a title and meta description for this article.
The title can't be more than 64 characters long. The meta description can't be longer than 159 characters. It should reach out to the ideal reader, address the problem, and tell them what they'll learn.

Let's create 4 variations and use the focus keyword in the meta description.