Agent skill · product strategy · jeremylongshore
customerio-reference-architecture
Implement Customer.io enterprise reference architecture.
Why this skill is useful
Provides a detailed architecture pattern for integrating Customer.io with event-driven systems that the AI wouldn't reliably generate on its own.
What it needs
Requires customer.io account access. About 5k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Customer.io Reference Architecture Prerequisites A data-flow owner, approved workspace/environment boundaries, event contract, consent model, and incident/support route. Repository/configuration review for any change to credentials, webhooks, message templates, or customer-data processing. Output A documented architecture mapping event producers, identity/consent, Customer.io workspaces, observability, ownership, and failure handling. Clear trust boundaries and reversible integration points for delivery, replay, and incident response. Examples Document a producer that validates and idempotently emits a versioned event to the development workspace, with a consent gate before campaign entry and redacted metrics by environment. Promote the same contract through staging before production, retain a dead-letter/replay owner, and keep recipient identifiers and tokens outside logs and diagrams. Overview Enterprise-grade reference architecture for Customer.io: a service layer separating Track and App API concerns, event-driven processing with message queues, repository pattern for user-to-CIO sync, webhook event bus, and infrastructure as code. Architecture Principles 1. Two Clients, Two Concerns — TrackClient for behavioral data in, APIClient for messages out 2. Event-Driven — Message queues decouple your app from Customer.io API availability 3. Idempotent Operations — All writes safely retryable via content hashing 4. Service Layer — Business logic never calls Customer.io SDK directly 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/customerio-reference-architecture