The Writer

The Writer turns a ContentForge topic into a full draft. It pulls relevant passages from your knowledge base, applies your brand voice, and produces an article along with SEO metadata.

You don't call the Writer directly. It runs when you click Generate on a topic in ContentForge.

What the Writer produces

For each topic, the Writer produces:

• The article body (no H1 — this is the topic title).
• An SEO title, meta description, and URL slug.
• A list of internal links inserted into the body.
• A word count and source-chunk list, visible on the topic detail page.

After generation, the topic moves into the Writing in Progress stage so you can review and edit before it advances toward publish.

Formats

The Writer supports four formats. You pick the format when the topic is created (manually or via the Strategist):

• Blog — long-form editorial.
• FAQ — question-and-answer structure.
• Case Study — customer-outcome narrative.
• How-To — step-by-step instructional.

Fresh vs refresh

The Writer generates content in one of two modes:

• Fresh — writes a new article from scratch using your knowledge base.
• Refresh — updates an existing published article, preserving what works and applying targeted improvements.

A topic enters refresh mode automatically when:

• It was created from a recommendation that targets an already-published topic, or
• You created it by submitting the URL of an existing article, or
• The duplicate-detection step linked it to an existing topic.

In refresh mode, the Writer fetches the live page (or falls back to the last stored draft), applies the refresh instructions, and produces a change summary listing what was updated.

Generate fresh override

If a topic is linked as a refresh but you want a standalone article instead, use the Generate fresh option in the split-button on the topic detail page. This clears the refresh link, treats the topic as new content, and re-runs duplicate detection against the resulting draft.

Internal linking

After the article is written, the Writer runs a second pass to insert internal links to other published articles. It only links when the connection is natural — irrelevant candidates are skipped.

Links are chosen by semantic similarity to the topic's title. URLs from a brand's previous staging domain are rewritten to the current production domain automatically.

The inserted links are listed on the topic detail page so you can audit them.

Duplicate detection

After the draft is produced, GEOforge compares it against your existing drafts and published content. If overlap above the threshold is found, the topic is flagged with a Review duplicate prompt linking to the matched article.

You then choose one of two actions:

• Link as refresh — make this topic a refresh of the matched article. Future generations will preserve the original URL slug and apply targeted updates.
• Keep as standalone — confirm the topics are distinct. The flag is cleared and won't be re-raised on regeneration.

Duplicate detection runs only on fresh generations. Topics already linked as refreshes skip this step.

Brand voice

The Writer reads brand voice guidelines from your brand settings and threads them into every generation. To customize voice for a brand, edit the Brand Voice Guidelines field in Settings → Brand Profile.

Tuning the Writer

For finer control beyond the Brand Voice Guidelines, an admin can override the Writer's prompts per brand under Settings → Agent Prompts → Writer. Two layers are exposed:

• Writer system prompt — the high-level instructions that apply to every article the Writer generates, regardless of format. This is the right place to enforce structural rules (e.g. always lead with a one-paragraph summary), banned constructions (em-dashes, marketing-speak phrases), or how the Writer should weigh knowledge-base evidence against general world knowledge.
• Format-specific prompts — one per format: Blog, FAQ, Case Study, and How-To. These layer on top of the system prompt and shape the structure of that format — heading patterns, length guidance, the rhythm of paragraphs vs. lists, how to handle citations, and so on. Edit these when one format consistently comes out wrong but the others are fine.

Each override applies to your brand only, takes effect on the next generation, and can be reset to the platform default at any time. Changes do not retroactively rewrite existing drafts — re-generate the topic to see the new prompt in action.

SEO metadata

The Writer emits an SEO title, meta description, and URL slug alongside the article body. These are extracted automatically and shown in the metadata card on the topic detail page. You can edit any of them before publishing.

On a refresh, the original URL slug is preserved so your CMS updates the existing post rather than creating a new one at a different URL.