cdp-lite-adapter

Adapt the User Explorer (CDP-lite) prototype to new data sources by mapping input exports to the build pipeline, updating adapters/enrichments, and preserving output JSON schemas for the UI. Use when asked to connect real data, replace inputs, or modify the build outputs/UI contracts.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/cdp-lite-adapter

SKILL.md

CDP-lite Adapter

Overview

Map new data sources into the existing CDP-lite build pipeline while keeping output schemas stable for the UI.

Workflow

Identify input formats and field names for activity + profiles.
Update adapters to normalize into the expected fields.
Adjust enrichments (score/segments) only if business rules change.
Run make build and validate data/ outputs against the UI contract.

Adapter Targets

scripts/adapters/activity.js
- Normalize to: email, date, login, total_views, unique_views, dashboard_name (optional)
scripts/adapters/profiles.js
- Normalize to: email, name, department, geo, title, manager_email, skip_level_email

Output Contract

Preserve the output schemas in:

data/users/u_<sha1>.json
data/index.json
data/facets.json
data/dashboards.json

For field-level details, read references/data-contract.md.

Notes

Weekly activity must include every week from 2025-06-01 to today, Monday week start.
Email is the primary key; always normalize to lowercase + trim.
Keep activity_score_bucket in the index for filtering.