validate-journey

Validates CDP journey YAML configurations against tdx schema requirements. Use when reviewing journey structure, checking step types and parameters, verifying segment references, or troubleshooting journey configuration errors before pushing to Treasure Data.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/devops/journey

SKILL.md

Journey YAML Validation

bash

tdx journey validate                      # Validate all journey YAML files locally
tdx journey validate path/to/journey.yml  # Validate specific file
tdx journey push --dry-run                # Preview changes before push

Required Structure

yaml

type: journey              # Required
name: Journey Name

reentry: no_reentry        # no_reentry | reentry_unless_goal_achieved | reentry_always

journeys:
  - state: draft           # draft | launched
    latest: true           # Exactly one must be true
    stages:
      - name: Stage Name
        steps: [...]

Limits: Max 8 stages, 120 events/journey, 70 events/stage, 30 versions

Step Types Quick Reference

Type	Required `with`	Notes
`wait`	`duration` + `unit` OR `condition`	condition has `segment`, optional `next`, `timeout`
`activation`	`activation`	key from activations section
`decision_point`	`branches[]`	each needs segment, next
`ab_test`	`variants[]`	percentages must sum to 100
`merge`	(none)
`jump`	`target` with `journey`, `stage`	target is an object
`end`	(none)	no `next` or `with`

Important: next: is a direct field on step, not inside with:

Wait Condition Format