# Supply Chain Disruption Monitor

> A supply-chain monitor that detects disruptions from real sourced signals, rates severity and confidence, and recommends actions for approval without acting on its own.

- **Category:** Supply Chain & Logistics
- **Difficulty:** Advanced
- **Setup time:** 45 min
- **Stacks:** Claude, LangGraph, OpenAI
- **Version:** 2.0.0 (updated 2026-06-21)
- **Source:** https://agent-kits.com/kit/disruption-monitor

## Overview

Monitors supplier, logistics, weather, and news signals for supply-chain disruptions.

Surfaces real disruptions with the source, impact, and a severity + confidence rating.

Distinguishes confirmed disruptions from unverified chatter to avoid false alarms.

Defensive: grounds every alert in a cited signal and recommends actions without acting on its own.

## When to use it

- You want early warning of disruptions affecting your suppliers or routes.
- You have signal sources the agent can monitor and cite.
- You want severity- and confidence-rated alerts, not noise.
- You want recommended actions a human approves, not autonomous changes.

## When not to use it

- You want it to reroute, cancel, or place orders automatically — it recommends only.
- You have no signal sources for it to ground alerts in.
- You want predictions stated as certainties (it rates confidence).
- You can't action or approve its recommendations.

## Architecture

- **Signal intake** — Ingests supplier, logistics, weather, and news signals from configured sources.
- **Disruption classifier** — Identifies candidate disruptions and the type of event from the signals.
- **Source verification** — Confirms each candidate traces to a real source and date, blocking fabricated alerts.
- **Impact assessor** — Maps the event to affected suppliers, SKUs, and routes to assess real impact.
- **Severity & confidence rating** — Rates severity and confidence, separating confirmed disruptions from unverified chatter.
- **Recommend-only gate** — Produces recommended actions for human approval and prevents any autonomous supply-chain action.
- **Prioritized digest** — Aggregates into a severity-ranked digest with watch items, avoiding alert fatigue.

## Files in this bundle

- `system-prompt.md` — the agent's system prompt
- `tools.json` — tool/function definitions the agent expects
- `workflow.md` — step-by-step run loop
- `.env.example` — environment variables to fill in
- `kit.json` — full structured metadata
- `starters/` — minimal starter snippets
- `LICENSE` — Apache-2.0 (code, configuration, and schema)
- `LICENSE-CONTENT` — CC BY 4.0 (specification text and documentation)
- `NOTICE` — attribution and trademark notice
- `run.py` — **runnable demo**: real agent loop with mock tools (`pip install anthropic`, set `ANTHROPIC_API_KEY`, `python run.py`)
- `agentaz.json` / `agentaz.schema.json` — AgentAz™ governance spec + schema

## Implementation notes

- Require a real, cited source for every alert; a fabricated disruption or impact figure erodes trust and can trigger costly overreactions.
- Separate confirmed disruptions from unverified chatter with explicit confidence, and keep rumors as watch items rather than red alerts.
- Keep the agent recommend-only; never let it reroute, cancel, expedite, or place orders, since an autonomous supply-chain action off a misread signal is expensive and hard to reverse.
- Rate severity by real impact on your suppliers, SKUs, and routes so attention goes to what matters.
- Avoid alert fatigue by aggregating and prioritizing; a monitor that cries wolf gets ignored when it counts.
- State uncertainty and what would confirm a signal, so humans can decide how much to react.
- Spend the strong model on impact and confidence assessment — a cheaper model can filter and classify routine signals.

## Variations

- **Basic — Signal monitor:** Surfaces sourced disruption signals affecting your suppliers and routes. Read-only, on demand.
- **Advanced — Rated, recommend-only alerts:** Adds source verification, severity/confidence rating, impact mapping, watch-item labeling, and recommended actions for approval.
- **Enterprise — Supply risk operations:** Adds ERP/signal integration, supplier/route mapping, scheduled monitoring, prioritized digests, and approval workflows for mitigation — never autonomous.

## FAQ

**Will it reroute or cancel orders on its own?**

No. It's recommend-only. It surfaces disruptions and proposes actions for a human to approve and execute. It never reroutes, cancels, expedites, or places orders itself, because an autonomous action off a misread signal is costly and hard to undo.

**Does it raise false alarms?**

It's designed not to. Every alert must cite a real source, and unverified chatter is labeled as a watch item rather than a confirmed disruption — so you get early warning without crying wolf on noise.

**Will it invent an impact figure?**

No. It won't fabricate a cost or impact number. It describes the qualitative impact on affected suppliers, SKUs, and routes, and flags that a costed estimate needs your finance and operations data.

**How does it tell confirmed from rumor?**

It rates each item's confidence and status — confirmed, likely, or unverified — based on the source. A sourced, verified event is an alert; unconfirmed chatter is a watch item, clearly labeled.

**Will I get flooded with alerts?**

No. It aggregates signals into a prioritized digest ranked by severity and keeps low-confidence items as watch rather than alarms, so the alerts you get are the ones worth acting on.

**What sources does it use?**

Whatever you connect — supplier/ERP status, logistics, weather, and news feeds. Every alert cites the specific signal and date it came from, so you can verify it.


---

© 2026 AgentKits · www.agent-kits.com

**Open source.** Code, configuration, and the AgentAz™ schema are licensed under
**Apache-2.0**; specification text and documentation under **CC BY 4.0** (with
attribution to AgentKits, link to https://www.agent-kits.com). See LICENSE, LICENSE-CONTENT,
and NOTICE in this bundle. "AgentAz" and "AgentKits" are trademarks of AgentKits.

**Flagship reference blueprint.** View the source, AgentAz™ spec, and frozen v1.0 schema
in the public registry: https://github.com/agent-kits/agentaz
Original: https://agent-kits.com/kit/disruption-monitor
