/signal-taxonomy

name: signal-taxonomy
description: Use to define schemas, topic tags, and lineage metadata for enriched
  signals.

Signal Taxonomy Skill

When to Use

• Normalizing multiple provider outputs into a unified schema.
• Rolling out new intent topics, enrichment attributes, or scoring dimensions.
• Auditing lineage + compliance requirements.

Framework

1. **Schema Definition** – fields, datatypes, required/optional flags. 2. **Topic & Attribute Mapping** – align provider-specific attributes to canonical names. 3. **Versioning** – maintain change logs, effective dates, and migration steps. 4. **Validation Rules** – min/max values, allowed lists, dependency rules. 5. **Documentation** – publish data dictionary + lineage diagrams.

Templates

• Data dictionary sheet (field, description, source, owner).
• Topic mapping table by provider.
• Migration checklist for schema changes.

Tips

• Keep names human-readable for GTM teams but consistent with data warehouse standards.
• Tag every field with owner + refresh cadence.
• Pair with `identity-resolution` to ensure IDs and linkages stay consistent.

---