# Waterfall Blueprint > Use to design provider sequences, throttling logic, and credit policies Use when this capability is needed. - Skill: `tomevault-io/waterfall-blueprint` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/waterfall-blueprint` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/waterfall-blueprint/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Marketing & Growth - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/waterfall-blueprint --- # Waterfall Blueprint Skill ## When to Use - Building contact/company enrichment workflows across multiple providers. - Updating fallback rules after provider outages or cost shifts. - Documenting waterfall logic for RevOps + engineering handoffs. ## Framework 1. **Goal & Constraints** – define enrichment type, data requirements, credit ceiling, SLA. 2. **Provider Catalog** – list eligible providers with success %, latency, compliance notes. 3. **Routing Logic** – determine sequence, branching, and retry intervals. 4. **Safeguards** – set throttles, dedupe checks, and exception triggers. 5. **Versioning** – log changes, approvals, and effective dates. ## Templates - Waterfall diagram (sequence, inputs, outputs, fallback paths). - Routing table (provider, criteria, cost, notes). - Change log with owners + rationale. ## Tips - Keep sequences short for real-time use cases; reserve long chains for batch mode. - Use A/B tests to validate new providers before full rollout. - Pair with `provider-scorecard` to continuously optimize routing. --- --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/gtmagents) — claim your Tome and manage your conversions.