| name | back-order-resolution |
| description | Triaged a back-order / out-of-stock condition on an inbound order line and ranks resolution options — alternate DC, substitute SKU, split shipment, or reschedule. Triggered on BACK_ORDER_OOS events. |
| metadata | {"version":"1.0.0","author":"CPG Expert-Systems-Architect","required_tools":["mcp-oms-connector","mcp-inventory-service"],"recipes":["BackOrderResolutionRecipe.py"],"constrained_generation":["Guidance","Outlines"]} |
Skill: Back-Order (OOS) Resolution
1. Overview
This skill is triggered when a line on an inbound order cannot be fully
fulfilled from the primary distribution centre's on-hand inventory. It
classifies the gap severity and ranks resolution options without
inventing business policy — thresholds and option scoring live in
BackOrderResolutionRecipe.py.
2. Reasoning Loop
- Confirm event_type is
BACK_ORDER_OOS.
- Read
metadata.ordered_qty and metadata.available_qty. Never
guess — if either is missing, classification fails to human.
- Classify intent as
BACK_ORDER.
- Select
BackOrderResolutionRecipe.py — the only allowed recipe.
- Compliance Shadow must return a verdict before the recipe runs.
3. Constrained Generation Policy
- intent label must be
BACK_ORDER
- recipe name must be
BackOrderResolutionRecipe.py
- shadow verdict must be
GREEN | YELLOW | RED
- resolution option
type field emitted verbatim from the recipe —
not branched on by orchestration.
4. Recipe-to-Intent Mapping
- BACK_ORDER →
BackOrderResolutionRecipe.py
- All other intents on this event type →
FAIL_TO_HUMAN
5. Execution Protocol
Compliance Shadow runs first. Verdicts:
- GREEN → variance within auto-handle band; recipe proposal presented.
- YELLOW → MINOR_GAP; review the ranked options and approve.
- RED → SEVERE_GAP (gap ≥
BACK_ORDER_SEVERE_GAP_PCT); escalate to
buyer decision. Hard-block applies until escalation completes.
6. Output Requirements
Recipe Execution Log must capture:
gap_qty and gap_pctclassification (NO_GAP | MINOR_GAP | SEVERE_GAP)primary_option (top-ranked) + full resolution_options listrecommended_action (SPLIT_SHIPMENT | ALT_DC | SUBSTITUTE | RESCHEDULE)at_risk (gap × unit_price)
