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

# BUILDER overview

> What BUILDER is, how it fits with PILLAR and DRAFTER, and what it ships with on day one.

BUILDER is the third layer of PILLAR, the Revenue Architecture Operating System.

<CardGroup cols={3}>
  <Card title="PILLAR" icon="layer-group">
    The dashboard — your account 360, your scoring, your signals.
  </Card>

  <Card title="DRAFTER" icon="sparkles">
    The assistant — ask any question, get answers grounded in your data.
  </Card>

  <Card title="BUILDER" icon="bolt">
    The automation — when something happens in your data, the right thing happens automatically. Or, more often, the right thing gets proposed to a human and they click "approve" in one tap.
  </Card>
</CardGroup>

If PILLAR is the eyes and DRAFTER is the brain, BUILDER is the hands. With three safety nets so the hands don't move until the brain has watched them long enough to trust them.

## What BUILDER does

BUILDER takes a **rule** like:

> "When a customer with annual contract value over \$250,000 has their health score drop by 15+ points in 7 days, schedule an executive sponsor sync."

and turns it into a real thing that runs while you sleep — but only after watching it operate safely for at least 7 days first.

## Three trigger types

Most revenue automation is one of three shapes — something happened, the calendar says it's time, or a deadline elapsed. BUILDER unifies all three under one rule model.

<CardGroup cols={3}>
  <Card title="Event" icon="bell">
    Fires when something happens in your data: critical signal fires, deal stage changes, score crashes.
  </Card>

  <Card title="Schedule" icon="calendar">
    Fires when the calendar says it's time: daily 6am ET, every Monday, first of the month.
  </Card>

  <Card title="SLA timer" icon="hourglass">
    Fires when a deadline elapsed: save play has been open 48h with no activity.
  </Card>
</CardGroup>

## Three execution modes (with mandatory progression)

<CardGroup cols={3}>
  <Card title="Shadow" icon="eye">
    BUILDER watches every signal and writes down what it *would* have done. **No actions taken.** Read the log every few days; decide whether the rule is matching the right things.
  </Card>

  <Card title="Propose" icon="check-double">
    BUILDER does almost everything. When conditions match, it creates a **proposed action** in your approval queue. A human approves or rejects with one click.
  </Card>

  <Card title="Execute" icon="rocket">
    BUILDER does the action directly. Logs everything. Reversible via the global kill switch.
  </Card>
</CardGroup>

Every new rule **must** spend at least 7 days in shadow before promotion to propose. And at least 14 days in propose with an 80%+ approval rate before promotion to execute. The system enforces these gates — they're not suggestions.

## Ten action types

Every action is mode-aware (shadow / propose / execute), idempotent, and logged with provenance.

<CardGroup cols={2}>
  <Card title="notify_user" icon="bell">
    In-app, email, Slack, or Teams notification.
  </Card>

  <Card title="create_task" icon="list-check">
    Drops a task in someone's queue with a due date.
  </Card>

  <Card title="start_play" icon="play">
    Kicks off a play from your play templates.
  </Card>

  <Card title="escalate_play" icon="arrow-up-right-from-square">
    Reassigns to a manager + bumps severity + notifies.
  </Card>

  <Card title="update_signal_status" icon="circle-check">
    Acknowledge / resolve / suppress a signal.
  </Card>

  <Card title="rescore_account" icon="arrows-rotate">
    Forces an immediate scoring run.
  </Card>

  <Card title="fire_signal" icon="bullhorn">
    Creates a new signal — used to chain rules together.
  </Card>

  <Card title="update_field" icon="pen-to-square">
    Generic field update (with high-impact gate).
  </Card>

  <Card title="dispatch_webhook" icon="webhook">
    Calls an external webhook (Slack, Zapier, etc.).
  </Card>

  <Card title="invoke_mcp_tool" icon="puzzle-piece">
    Escape hatch — calls any tool in PILLAR's MCP catalog.
  </Card>
</CardGroup>

Plus `require_approval` which can be inserted as a "pause here for a human" step in the middle of any action chain.

## Three authoring paths

<CardGroup cols={3}>
  <Card title="The UI" icon="window-maximize" href="https://app.pillargtm.com">
    `/builder` route — form for the common case (90% of rules), JSON DSL textarea for conditions and actions.
  </Card>

  <Card title="YAML config-as-code" icon="file-code">
    Export any rule as YAML, edit in your code editor, version-control alongside scoring config, reapply with `pillar rules apply` from the CLI.
  </Card>

  <Card title="DRAFTER" icon="sparkles">
    Describe a rule in plain English. DRAFTER calls `propose_builder_rule`, returns a structured draft, you refine + save.
  </Card>
</CardGroup>

## Where to go next

<CardGroup cols={3}>
  <Card title="Configuration" icon="sliders" href="/builder/configuration">
    How BUILDER is shaped during implementation — the most important thing about BUILDER.
  </Card>

  <Card title="Preset libraries" icon="layer-group" href="/builder/preset-libraries">
    The four out-of-the-box rule sets, with the rules in each.
  </Card>

  <Card title="Safety rails" icon="shield-halved" href="/builder/safety-rails">
    Every guardrail BUILDER ships with: shadow mode, kill switch, Guarantee runtime, more.
  </Card>
</CardGroup>
