> ## Documentation Index
> Fetch the complete documentation index at: https://docs.writerzroom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Model Routing

> WriterzRoom routes generation work by tier and agent role to balance speed, quality, cost control, and output depth.

WriterzRoom uses model routing to match each generation task with the right level of processing.

Instead of exposing raw model selection to users, WriterzRoom routes work based on the selected generation tier, agent role, template requirements, and platform safeguards.

<div style={{ display: 'grid', gridTemplateColumns: 'repeat(4, 1fr)', gap: '10px', margin: '1.5rem 0' }}>
  <div style={{ border: '1px solid rgba(128,128,128,0.20)', borderRadius: '12px', padding: '14px', background: 'rgba(255,255,255,0.04)' }}>
    <div style={{ fontWeight: 800, marginBottom: '5px' }}>Tier</div>
    <div style={{ fontSize: '12px', color: 'var(--colors-content-secondary)', lineHeight: 1.5 }}>Quick, Standard, or Premium generation depth.</div>
  </div>

  <div style={{ border: '1px solid rgba(128,128,128,0.20)', borderRadius: '12px', padding: '14px', background: 'rgba(255,255,255,0.04)' }}>
    <div style={{ fontWeight: 800, marginBottom: '5px' }}>Agent Role</div>
    <div style={{ fontSize: '12px', color: 'var(--colors-content-secondary)', lineHeight: 1.5 }}>Planning, writing, editing, formatting, SEO, or publishing.</div>
  </div>

  <div style={{ border: '1px solid rgba(128,128,128,0.20)', borderRadius: '12px', padding: '14px', background: 'rgba(255,255,255,0.04)' }}>
    <div style={{ fontWeight: 800, marginBottom: '5px' }}>Template</div>
    <div style={{ fontSize: '12px', color: 'var(--colors-content-secondary)', lineHeight: 1.5 }}>Content type, length, structure, and required behavior.</div>
  </div>

  <div style={{ border: '1px solid rgba(128,128,128,0.20)', borderRadius: '12px', padding: '14px', background: 'rgba(255,255,255,0.04)' }}>
    <div style={{ fontWeight: 800, marginBottom: '5px' }}>Safeguards</div>
    <div style={{ fontSize: '12px', color: 'var(--colors-content-secondary)', lineHeight: 1.5 }}>Reliability, limits, validation, and failure behavior.</div>
  </div>
</div>

## Why Routing Matters

Different parts of content generation require different capabilities.

Planning, formatting, metadata, and publishing tasks often benefit from speed and consistency. Long-form drafting and editing require stronger reasoning, longer context handling, and tighter language control.

Model routing helps WriterzRoom balance:

* Output quality
* Generation speed
* Cost control
* Tier consistency
* Workflow reliability

## Routing by Tier

| Tier     | Routing goal                                        |
| -------- | --------------------------------------------------- |
| Quick    | Favor speed and lightweight generation              |
| Standard | Balance quality, depth, and turnaround time         |
| Premium  | Prioritize deeper generation and longer-form output |

## Routing by Agent Role

| Agent       | Routing priority                             |
| ----------- | -------------------------------------------- |
| Planner     | Fast strategy and structure                  |
| Researcher  | Source-aware retrieval and evidence handling |
| Call Writer | Lightweight coordination                     |
| Writer      | Strong drafting capability                   |
| Editor      | Quality enforcement and refinement           |
| Formatter   | Reliable output formatting                   |
| SEO         | Metadata and discoverability support         |
| Publisher   | Final preparation and delivery workflow      |

## User-Controlled vs System-Controlled

Users control the generation tier.

WriterzRoom controls the underlying model routing. This protects platform reliability, keeps results aligned with the selected plan, and avoids forcing users to manage model names or provider-specific settings.

<Info>
  API users may submit generation settings, but WriterzRoom determines final routing based on plan, tier, template requirements, and platform safeguards.
</Info>

## Routing Flow

<Steps>
  <Step title="User selects a generation tier">
    The selected tier establishes the expected balance of speed, quality, and processing depth.
  </Step>

  <Step title="WriterzRoom reads the template and style profile">
    The system evaluates the content type, structure, output expectations, and style behavior.
  </Step>

  <Step title="Each agent receives an assigned routing path">
    The Planner, Writer, Editor, Formatter, SEO, and Publisher can each receive task-appropriate processing.
  </Step>

  <Step title="The workflow fails clearly if required systems are unavailable">
    WriterzRoom avoids presenting incomplete work as if it passed the full generation path.
  </Step>
</Steps>

## Fail-Fast Behavior

WriterzRoom is designed to fail clearly when required generation systems are unavailable.

This is preferable to silently falling back to a lower-quality path or returning incomplete content as if it passed the intended workflow.

<Warning>
  Fail-fast behavior may produce a visible error instead of a degraded draft. This is intentional. It helps protect output quality and makes generation issues easier to diagnose.
</Warning>

## What This Means for Users

You do not need to select individual models.

Choose the tier that matches the importance and complexity of the task:

| Need                          | Best fit |
| ----------------------------- | -------- |
| Speed                         | Quick    |
| Balanced production           | Standard |
| Depth and stronger processing | Premium  |

<CardGroup cols={2}>
  <Card title="Generation Tiers" icon="layers" href="/getting-started/generation-tiers">
    Compare Quick, Standard, and Premium generation behavior.
  </Card>

  <Card title="Multi-Agent Pipeline" icon="network" href="/architecture/multi-agent-pipeline">
    See how routed models support each pipeline stage.
  </Card>
</CardGroup>
