> ## 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.

# Signal Taxonomy Overview

> 8 signal families, 93+ signal types, 7-state lifecycle

# Signal Taxonomy

PILLAR generates signals when scoring outputs cross configurable thresholds or when external events (Starbridge webhooks) are detected. Signals are the primary action-driving mechanism in the platform.

<Note>
  Signal correctness is enforced by [The Guarantee](/the-guarantee) — specifically the Signals (S) and Rules (R) invariant categories. Every signal traces back to a triggered rule (no ghost signals), the rule catalog itself is append-only with stable IDs (`G-R-02`), and the signal-to-source consistency tests verify that scoring audit decomposition matches the underlying contact, renewal, and activity data.
</Note>

## 8 Signal Families

| Family     | Description                                                             |
| ---------- | ----------------------------------------------------------------------- |
| RENEWAL    | Churn risk indicators from engagement, stakeholders, support, contracts |
| PIPELINE   | Deal health, forecast issues, handoff compliance, onboarding risk       |
| EXPANSION  | Growth opportunities from whitespace, usage, grants, strategic fit      |
| ACCOUNT    | Account-level changes from contacts, competitors, meetings              |
| COVERAGE   | Multi-threading gaps, territory imbalance, single-threaded risk         |
| WORKFLOW   | SLA compliance, deal on/off track status                                |
| STARBRIDGE | District intelligence updates (conferences, procurement)                |
| ECONOMICS  | Financial health: budget, unit economics, S\&M efficiency               |

## 7-State Lifecycle

```
PENDING → ACTIVE → ACKNOWLEDGED → IN_PROGRESS → RESOLVED
                                                → EXPIRED
                → SUPPRESSED
```

Terminal states: RESOLVED, EXPIRED, SUPPRESSED

## Severity Levels

| Severity | Description                         | Routing                                             |
| -------- | ----------------------------------- | --------------------------------------------------- |
| CRITICAL | Immediate action required           | Slack notification, email alert, top of signal feed |
| WARNING  | Attention needed within 24-48 hours | Signal feed, weekly digest                          |
| INFO     | Informational, no immediate action  | Signal feed only                                    |

## Recomputation Schedule

| Schedule             | Interval       | Families                              |
| -------------------- | -------------- | ------------------------------------- |
| Scoring refresh      | Periodic       | RENEWAL, PIPELINE, EXPANSION          |
| Account health       | Daily          | ACCOUNT, COVERAGE                     |
| Economics refresh    | Daily          | ECONOMICS                             |
| Starbridge sync      | Periodic       | STARBRIDGE (account data)             |
| Starbridge real-time | Webhook-driven | STARBRIDGE (RFPs, grants, departures) |

## Signal Anatomy

Every generated signal includes:

| Component          | Description                                     |
| ------------------ | ----------------------------------------------- |
| Signal Type        | Machine-readable type identifier                |
| Title              | Human-readable title                            |
| Explanation        | Plain-language explanation of what was detected |
| Evidence           | Supporting metrics and data references          |
| Recommended Action | AI-generated recommended next action            |
| Severity           | CRITICAL, WARNING, or INFO                      |
| Confidence         | 0-100 confidence level                          |

All signal thresholds are configurable per organization.

> Detailed signal generation logic, default threshold values, and routing configurations are available in the PILLAR Implementation Guide provided to active customers.