Pilot Supply Chain Orchestrator Setup

Deploy a supply chain orchestration pipeline with 4 agents. Use this skill when: 1. User wants to set up coordinated inventory, logistics, procurement, and compliance agents 2. User is configuring warehouse management with automated reorder workflows 3. User asks about supply chain automation, procurement pipelines, or shipping compliance Do NOT use this skill when: - User wants a single inventory dashboard (use pilot-metrics instead) - User wants to send a one-off alert for low stock (use pilot-alert instead) - User only needs webhook integration with a supplier API (use pilot-webhook-bridge instead)

Supply Chain Orchestrator Setup

Deploy 4 agents: inventory, routing, procurement, and compliance.

Roles

Role	Hostname	Skills	Purpose
inventory	<prefix>-inventory	pilot-metrics, pilot-cron, pilot-alert, pilot-stream-data	Monitors stock levels, predicts demand, triggers reorders
routing	<prefix>-routing	pilot-task-router, pilot-stream-data, pilot-receipt	Optimizes delivery routes, manages fleet assignments
procurement	<prefix>-procurement	pilot-webhook-bridge, pilot-audit-log, pilot-escrow	Manages suppliers, places purchase orders
compliance	<prefix>-compliance	pilot-audit-log, pilot-event-filter, pilot-alert	Validates regulatory compliance, maintains audit trails

Setup Procedure

Step 1: Ask the user which role this agent should play and what prefix to use.

Step 2: Install the skills for the chosen role:

bash

# For inventory:
clawhub install pilot-metrics pilot-cron pilot-alert pilot-stream-data
# For routing:
clawhub install pilot-task-router pilot-stream-data pilot-receipt
# For procurement:
clawhub install pilot-webhook-bridge pilot-audit-log pilot-escrow
# For compliance:
clawhub install pilot-audit-log pilot-event-filter pilot-alert

Step 3: Set the hostname and write the manifest to ~/.pilot/setups/supply-chain-orchestrator.json.

Step 4: Tell the user to initiate handshakes with the peers for their role.

Manifest Templates Per Role

inventory

json

{
  "setup": "supply-chain-orchestrator", "role": "inventory", "role_name": "Inventory Manager",
  "hostname": "<prefix>-inventory",
  "skills": {
    "pilot-metrics": "Track stock levels, turnover rates, and demand forecasts.",
    "pilot-cron": "Run scheduled inventory audits and demand recalculations.",
    "pilot-alert": "Emit reorder alerts when stock falls below safety thresholds.",
    "pilot-stream-data": "Stream real-time warehouse activity to downstream agents."
  },
  "data_flows": [
    { "direction": "send", "peer": "<prefix>-procurement", "port": 1002, "topic": "reorder-request", "description": "Reorder requests when stock is low" },
    { "direction": "send", "peer": "<prefix>-routing", "port": 1002, "topic": "fulfillment-order", "description": "Fulfillment orders for customer deliveries" },
    { "direction": "receive", "peer": "<prefix>-compliance", "port": 1002, "topic": "compliance-clearance", "description": "Clearance to release held stock" }
  ],
  "handshakes_needed": ["<prefix>-procurement", "<prefix>-routing", "<prefix>-compliance"]
}

routing

json

{
  "setup": "supply-chain-orchestrator", "role": "routing", "role_name": "Logistics Router",
  "hostname": "<prefix>-routing",
  "skills": {
    "pilot-task-router": "Assign shipments to carriers based on cost, speed, and capacity.",
    "pilot-stream-data": "Stream shipment tracking updates in real time.",
    "pilot-receipt": "Generate delivery confirmations and proof-of-delivery receipts."
  },
  "data_flows": [
    { "direction": "receive", "peer": "<prefix>-inventory", "port": 1002, "topic": "fulfillment-order", "description": "Fulfillment orders to route" },
    { "direction": "send", "peer": "<prefix>-compliance", "port": 1002, "topic": "shipping-manifest", "description": "Shipping manifests for regulatory review" }
  ],
  "handshakes_needed": ["<prefix>-inventory", "<prefix>-compliance"]
}

procurement

json

{
  "setup": "supply-chain-orchestrator", "role": "procurement", "role_name": "Procurement Agent",
  "hostname": "<prefix>-procurement",
  "skills": {
    "pilot-webhook-bridge": "Interface with supplier APIs for quotes and order placement.",
    "pilot-audit-log": "Log all procurement decisions, bids, and purchase orders.",
    "pilot-escrow": "Hold funds in escrow until delivery confirmation."
  },
  "data_flows": [
    { "direction": "receive", "peer": "<prefix>-inventory", "port": 1002, "topic": "reorder-request", "description": "Reorder requests from inventory" },
    { "direction": "send", "peer": "<prefix>-compliance", "port": 1002, "topic": "purchase-order", "description": "Purchase orders for compliance validation" }
  ],
  "handshakes_needed": ["<prefix>-inventory", "<prefix>-compliance"]
}

compliance

json

{
  "setup": "supply-chain-orchestrator", "role": "compliance", "role_name": "Compliance Checker",
  "hostname": "<prefix>-compliance",
  "skills": {
    "pilot-audit-log": "Maintain immutable audit trail of all compliance decisions.",
    "pilot-event-filter": "Filter and classify events by regulatory category.",
    "pilot-alert": "Flag compliance violations and emit escalation alerts."
  },
  "data_flows": [
    { "direction": "receive", "peer": "<prefix>-procurement", "port": 1002, "topic": "purchase-order", "description": "Purchase orders to validate" },
    { "direction": "receive", "peer": "<prefix>-routing", "port": 1002, "topic": "shipping-manifest", "description": "Shipping manifests to check" },
    { "direction": "send", "peer": "<prefix>-inventory", "port": 1002, "topic": "compliance-clearance", "description": "Clearance to release goods" }
  ],
  "handshakes_needed": ["<prefix>-procurement", "<prefix>-routing", "<prefix>-inventory"]
}

Data Flows

• inventory -> procurement : reorder requests when stock drops below threshold (port 1002)
• inventory -> routing : fulfillment orders for customer deliveries (port 1002)
• procurement -> compliance : purchase orders requiring regulatory validation (port 1002)
• routing -> compliance : shipping manifests for export/import checks (port 1002)
• compliance -> inventory : compliance clearance to release held stock (port 1002)

Workflow Example

bash

# On inventory -- low stock triggers reorder:
pilotctl --json publish <prefix>-procurement reorder-request '{"sku":"WH-4821","warehouse":"us-east-1","current_qty":12,"reorder_point":50,"suggested_qty":200}'
# On procurement -- place PO after supplier selection:
pilotctl --json publish <prefix>-compliance purchase-order '{"po_id":"PO-9934","supplier":"GlobalParts Inc","sku":"WH-4821","qty":200,"unit_price":14.50}'
# On inventory -- ship customer order:
pilotctl --json publish <prefix>-routing fulfillment-order '{"order_id":"ORD-77201","sku":"WH-4821","qty":5,"dest_zip":"94105"}'
# On routing -- submit manifest:
pilotctl --json publish <prefix>-compliance shipping-manifest '{"manifest_id":"SHP-3301","carrier":"FedEx","items":[{"sku":"WH-4821","qty":5}]}'
# On compliance -- approve:
pilotctl --json publish <prefix>-inventory compliance-clearance '{"ref_id":"PO-9934","status":"approved"}'

Dependencies

Requires pilot-protocol skill, pilotctl binary, clawhub binary, and a running daemon.