# Waterfall Blueprint

> Use to design provider sequences, throttling logic, and credit policies for enrichment waterfalls.

- Skill: `majiayu000/waterfall-blueprint` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/waterfall-blueprint`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/waterfall-blueprint/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/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.

---