Real-Time Lead Enrichment and Intent Router Specification
Design an event-driven architecture specification to ingest, score, enrich, and route sales leads in real time.
Use this specification template when engineering a high-throughput martech pipeline connecting incoming demand signals to downstream sales workflows. It establishes latency budgets, failure boundaries, enrichment fallbacks, and CRM integration contracts.
Role: Principal MarTech Systems Architect with 15+ years of experience designing event-driven revenue operations platforms.
Context
- Target CRM and core system of record: {{crm_platform}}
- Third-party data enrichment vendors: {{enrichment_vendors}}
- Backbone message bus and streaming infrastructure: {{event_streaming_engine}}
- Ingestion scale and peak load expectations: {{lead_volume_thresholds}}
- Sales routing and SDR dispatch channels: {{sales_alert_channels}}
- Data privacy and compliance mandate: {{security_compliance_standard}}
Task
Produce a production-ready technical architecture specification for an event-driven lead routing and real-time enrichment engine that processes incoming intent signals, applies data hygiene, and dispatches actionable records to sales teams.
Method
- Map out the high-level ingestion topography from web hooks, ad pixels, and form endpoints into {{event_streaming_engine}}.
- Define the schema contract for inbound raw lead payloads, standardizing identity keys across company domains, personal emails, and device fingerprints.
- Architect the asynchronous enrichment pipeline across {{enrichment_vendors}}, defining cascade ordering, timeout thresholds, and caching strategies.
- Formalize the intent scoring algorithm execution runtime, separating deterministic rule evaluation from statistical propensity scoring.
- Specify the deduplication and reconciliation mechanism to update {{crm_platform}} without triggering record locking or race conditions.
- Detail the notification dispatch mechanism delivering contextual leads to {{sales_alert_channels}} within target SLAs.
- Design the dead-letter queue (DLQ) topology, audit logging, and automated retry policies under {{security_compliance_standard}} compliance.
Constraints
- MUST define explicit latency SLAs for each stage: ingestion, enrichment, scoring, and CRM writeback.
- MUST NOT allow third-party enrichment timeouts to block lead ingestion or record creation.
- All personally identifiable information (PII) handling MUST comply strictly with {{security_compliance_standard}}.
- Vendor credentials and secret management must adhere to zero-trust architecture principles.
Output format
1. Architectural Overview
- Component topology and end-to-end data flow diagram in structured text/ASCII format.
2. Ingestion & Event Schema Spec
- JSON Schema definitions for raw inbound events, normalized identity envelopes, and scored lead payloads.
3. Enrichment & Scoring Pipeline Design
- Sequential execution flow, vendor fallback matrix, Redis/caching layer TTLs, and compute runtime specifications.
4. Integration & Routing Contracts
- Write patterns for {{crm_platform}}, dispatch payloads for {{sales_alert_channels}}, and idempotency keying.
5. Resiliency, Security & Compliance
- Error handling matrices, DLQ replay procedures, and {{security_compliance_standard}} privacy masking rules.
Self-review
- Do latency budgets account for worst-case degradation across all {{enrichment_vendors}}?
- Are race conditions between webhooks and CRM writes fully resolved by idempotency keys?
- Does the design guarantee zero data loss during traffic spikes defined in {{lead_volume_thresholds}}?
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.