Skip to main content

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

​
Signal Engine

  • Version: 3.0.0
  • Evaluation Frequency: Every 5-6 hours (scoring-based), real-time (webhook-based)
  • Output: GeneratedSignal objects written to the signals table

​
8 Signal Families

FamilySignal CountDescription
RENEWAL7 typesChurn risk indicators from engagement, stakeholders, support, contracts
PIPELINE7+ typesDeal health, forecast issues, handoff compliance, onboarding risk
EXPANSION5 typesGrowth opportunities from whitespace, usage, grants, strategic fit
ACCOUNT4+ typesAccount-level changes from contacts, competitors, meetings
COVERAGE3 typesMulti-threading gaps, territory imbalance, single-threaded risk
WORKFLOW3 typesSLA compliance, deal on/off track status
STARBRIDGE2+ typesDistrict intelligence updates (conferences, procurement)
ECONOMICS6 typesFinancial 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

SeverityDescriptionRouting
CRITICALImmediate action requiredSlack notification, email alert, top of signal feed
WARNINGAttention needed within 24-48 hoursSignal feed, weekly digest
INFOInformational, no immediate actionSignal feed only

​
Recomputation Schedule

ScheduleIntervalFamilies
Scoring refreshEvery 6 hoursRENEWAL, PIPELINE, EXPANSION
Account healthEvery 24 hoursACCOUNT, COVERAGE
Economics refreshEvery 24 hoursECONOMICS
Starbridge syncEvery 6 hoursSTARBRIDGE (account data)
Starbridge real-timeWebhook-drivenSTARBRIDGE (RFPs, grants, departures)

​
Signal Anatomy

Every generated signal includes:
ComponentDescription
signal_typeMachine-readable type identifier
titleHuman-readable title
explanation_textPlain-language explanation of what was detected
evidence_refsJSON object with supporting metrics
recommended_actionAI-generated recommended next action
score_valueNumeric score that triggered the signal
severityCRITICAL, WARNING, or INFO
confidence0-100 confidence in the signal
model_versionEngine version that generated it

​
Default Thresholds

Key configurable thresholds:
ParameterDefaultDescription
renewal_critical_score85Score for CRITICAL renewal signals
renewal_warning_score50Score for WARNING renewal signals
pipeline_critical_score70Hygiene score for CRITICAL pipeline signals
pipeline_warning_score50Hygiene score for WARNING pipeline signals
expansion_ready_score70Propensity for expansion signals
min_contacts_per_opp3Minimum contacts for coverage
meeting_gap_days30Days before meeting gap signal
push_count_warning2Close date pushes for WARNING
push_count_critical3Close date pushes for CRITICAL
stage_stagnation_days30Days in stage before stagnation signal
competitor_contract_expiry_days120Days before competitor contract expires