quadrantChart
    title Retail Agent Maturity — May 2026
    x-axis "Narrow Use Case" --> "Full Platform Strategy"
    y-axis "Pilot / Internal" --> "Verified Production Outcomes"
    quadrant-1 "Production Platform"
    quadrant-2 "Production Point-Solution"
    quadrant-3 "Pilot Point-Solution"
    quadrant-4 "Pilot Platform"
    Amazon Rufus: [0.85, 0.95]
    Walmart Sparky+Element: [0.92, 0.88]
    Shopify Sidekick/Magic: [0.88, 0.82]
    Mercado Libre Pago: [0.45, 0.90]
    Klarna OpenAI: [0.30, 0.55]
    Lowe's Mylow: [0.40, 0.78]
    Home Depot Magic Apron: [0.35, 0.65]
    Target Store Companion: [0.25, 0.55]
    Sephora Virtual Artist: [0.30, 0.60]
    Best Buy Agentic: [0.25, 0.45]
    Costco ML Forecast: [0.30, 0.85]
    IKEA Billie: [0.20, 0.35]

flowchart LR
    A[Klarna 2025 Walk-Back] --> L1[Lesson 1<br/>Deflection without CSAT is a trap]
    B[Walmart Checkout 3× Drop] --> L2[Lesson 2<br/>Never surrender the funnel to a 3rd-party agent runtime]
    C[Walmart Element Consolidation] --> L3[Lesson 3<br/>Orchestrate from day one — point-bots do not scale]
    L1 --> R[QuanData Doctrine]
    L2 --> R
    L3 --> R
    R -->|enforces| D1[Every metric pairs with CSAT/quality]
    R -->|enforces| D2[QuanData owns the MCP layer]
    R -->|enforces| D3[Orchestrator + Specialist topology]
    style R fill:#0b3d91,stroke:#fff,color:#fff
    style D1 fill:#1f6feb,stroke:#fff,color:#fff
    style D2 fill:#1f6feb,stroke:#fff,color:#fff
    style D3 fill:#1f6feb,stroke:#fff,color:#fff

flowchart LR
    U[User / Trigger] --> A1[Agent 1<br/>Research]
    A1 -->|structured output| A2[Agent 2<br/>Analysis]
    A2 -->|structured output| A3[Agent 3<br/>Writing]
    A3 -->|structured output| A4[Agent 4<br/>Review]
    A4 --> O[Final Output]
    style A1 fill:#0b3d91,stroke:#fff,color:#fff
    style A2 fill:#0b3d91,stroke:#fff,color:#fff
    style A3 fill:#0b3d91,stroke:#fff,color:#fff
    style A4 fill:#0b3d91,stroke:#fff,color:#fff

flowchart TB
    C[Commander Agent<br/>decomposes + synthesizes] --> W1[Worker 1<br/>document A]
    C --> W2[Worker 2<br/>document B]
    C --> W3[Worker 3<br/>document C]
    C --> W4[Worker 4<br/>document D]
    C --> W5[Worker 5<br/>document E]
    W1 --> S[Synthesis Layer]
    W2 --> S
    W3 --> S
    W4 --> S
    W5 --> S
    S --> O[Aggregated Output]
    style C fill:#0b3d91,stroke:#fff,color:#fff
    style S fill:#7c3aed,stroke:#fff,color:#fff

flowchart TB
    O[Orchestrator] --> CS[Customer Service Agent]
    O --> PS[Personal Shopper Agent]
    O --> IR[Inventory Agent]
    O --> PP[Pricing Agent]
    O --> MC[Marketing Content Agent]
    O --> SC[Supply Chain Agent]
    O --> AI[Analytics Agent]
    O --> SA[Store Associate Copilot]
    O --> FR[Fraud + Risk Agent]
    CS -.shared state.-> M[(Conversation /<br/>Memory Layer)]
    PS -.shared state.-> M
    IR -.shared state.-> M
    PP -.shared state.-> M
    MC -.shared state.-> M
    SC -.shared state.-> M
    AI -.shared state.-> M
    SA -.shared state.-> M
    FR -.shared state.-> M
    style O fill:#7c3aed,stroke:#fff,color:#fff
    style M fill:#0b3d91,stroke:#fff,color:#fff

flowchart TD
    Q1{Does the task have<br/>strict step ordering?}
    Q1 -- Yes --> Q2{Is it a single domain?}
    Q1 -- No --> Q3{Same operation on<br/>many items?}
    Q2 -- Yes --> P_Pipe[Pipeline<br/>e.g. order-status → policy → reply]
    Q2 -- No --> P_Spec1[Specialist Team<br/>w/ ordered handoffs]
    Q3 -- Yes --> P_Fan[Fan-Out<br/>e.g. SKU-level forecasts]
    Q3 -- No --> Q4{Multiple distinct<br/>domains needed?}
    Q4 -- Yes --> P_Spec2[Specialist Team]
    Q4 -- No --> P_Single[Single Agent<br/>or function call]
    style P_Pipe fill:#0b3d91,stroke:#fff,color:#fff
    style P_Fan fill:#7c3aed,stroke:#fff,color:#fff
    style P_Spec1 fill:#16a34a,stroke:#fff,color:#fff
    style P_Spec2 fill:#16a34a,stroke:#fff,color:#fff
    style P_Single fill:#6b7280,stroke:#fff,color:#fff

flowchart TB
    subgraph CH[Channel Layer]
        WEB[Web / Storefront]
        APP[Mobile App]
        POS[POS / In-Store]
        SLK[Slack / Internal]
        EML[Email / SMS]
    end

    subgraph OL[Orchestration Layer]
        GW[API Gateway<br/>auth + rate-limit + redaction]
        OR[Orchestrator Agent<br/>intent · routing · audit · approval]
    end

    subgraph SL[Specialist Layer]
        CSA[Customer Service Agent]
        PSA[Personal Shopper Agent]
        IRA[Inventory + Replenishment Agent]
        PPA[Pricing + Promotions Agent]
        MCA[Marketing Content Agent]
        SCLA[Supply Chain + Logistics Agent]
        AIA[Analytics + Insights Agent]
        SAC[Store Associate Copilot]
        FRA[Fraud + Risk Agent]
    end

    subgraph TL[Tool Layer — MCP]
        T_SHOP[Shopify MCP]
        T_STRIPE[Stripe MCP]
        T_KLAV[Klaviyo MCP]
        T_ALG[Algolia MCP]
        T_INT[Internal MCP<br/>ERP · WMS · CDP · POS]
    end

    subgraph DL[Data Layer]
        OMS[(OMS / Commerce<br/>Shopify · SAP CC)]
        ERP[(ERP / WMS<br/>SAP · NetSuite)]
        CDP[(CDP<br/>RudderStack · Segment)]
        VEC[(Vector Store<br/>pgvector · Turbopuffer)]
        WH[(Warehouse<br/>Snowflake · BigQuery)]
        AUD[(Audit Log<br/>append-only)]
        DRM[(Dreaming Store<br/>distilled memory)]
    end

    CH --> GW
    GW --> OR
    OR --> CSA
    OR --> PSA
    OR --> IRA
    OR --> PPA
    OR --> MCA
    OR --> SCLA
    OR --> AIA
    OR --> SAC
    OR --> FRA

    CSA & PSA & IRA & PPA & MCA & SCLA & AIA & SAC & FRA --> T_SHOP
    CSA & PSA & IRA & PPA & MCA & SCLA & AIA & SAC & FRA --> T_STRIPE
    MCA & PSA --> T_KLAV
    PSA & SAC --> T_ALG
    CSA & IRA & PPA & MCA & SCLA & SAC & FRA --> T_INT

    T_SHOP --> OMS
    T_STRIPE --> OMS
    T_KLAV --> CDP
    T_ALG --> VEC
    T_INT --> ERP
    T_INT --> CDP
    T_INT --> WH

    OR -.audit.-> AUD
    OR -.nightly distill.-> DRM
    DRM -.context inject.-> OR

    style OR fill:#7c3aed,stroke:#fff,color:#fff
    style GW fill:#0b3d91,stroke:#fff,color:#fff
    style DRM fill:#dc2626,stroke:#fff,color:#fff
    style AUD fill:#0b3d91,stroke:#fff,color:#fff

flowchart LR
    subgraph OR_BOX[Top-Level]
        ORCH[Orchestrator / Router]
    end
    subgraph CF[Customer-Facing]
        CSA[Customer Service]
        PSA[Personal Shopper]
        SAC[Store Associate Copilot]
    end
    subgraph MF[Merchant / Operator-Facing]
        IRA[Inventory + Replenishment]
        PPA[Pricing + Promotions]
        MCA[Marketing Content]
        SCLA[Supply Chain + Logistics]
        AIA[Analytics + Insights]
    end
    subgraph GR[Governance]
        FRA[Fraud + Risk]
    end
    ORCH --> CF
    ORCH --> MF
    ORCH --> GR
    style ORCH fill:#7c3aed,stroke:#fff,color:#fff
    style CF fill:#1f6feb,stroke:#fff,color:#fff
    style MF fill:#16a34a,stroke:#fff,color:#fff
    style GR fill:#dc2626,stroke:#fff,color:#fff

sequenceDiagram
    autonumber
    participant U as Customer
    participant O as Orchestrator
    participant CSA as Customer Service Agent
    participant OMS as OMS / Carrier
    participant POL as Policy KB
    participant AUD as Audit Log

    U->>O: "Where's my order, and can I return one item?"
    O->>O: classify_intent → {order_status, return}
    par Status lookup
        O->>CSA: order_status sub-task
        CSA->>OMS: get_order(order_id)
        CSA->>OMS: get_shipment_tracking(shipment_id)
        OMS-->>CSA: "Out for delivery, ETA 4pm"
    and Return setup
        O->>CSA: return sub-task
        CSA->>POL: lookup_policy("return_window")
        CSA->>OMS: create_return(order_id, line_2, "size_too_small")
        OMS-->>CSA: RMA-9981, refund $79
    end
    Note over CSA: Guardrail: $79 < $250 auto-threshold
    CSA-->>O: Combined result
    O->>AUD: log_audit_event(...)
    O-->>U: Tracking + RMA + QR label link

sequenceDiagram
    autonumber
    participant AIA as Analytics Agent
    participant O as Orchestrator
    participant IRA as Inventory Agent
    participant ERP as ERP / WMS
    participant BUY as Buyer (Slack)
    participant SCLA as Supply Chain Agent

    Note over AIA: 06:00 scheduled anomaly scan
    AIA->>AIA: get_anomaly_alerts({type:"stockout_risk"})
    AIA-->>O: SKU-4421, days-of-cover=4, lead=14
    O->>IRA: replenish(SKU-4421)
    par Forecast & reorder math
        IRA->>IRA: forecast_demand(SKU-4421, 30)
        IRA->>IRA: compute_reorder_point(SKU-4421, 0.95)
    end
    IRA->>ERP: draft_purchase_order(SUP-12, [{SKU-4421, qty:1200}])
    Note over IRA: Guardrail: PO $48k > $25k → human
    IRA->>BUY: submit_po_for_approval (Slack card)
    BUY-->>IRA: ✅ Approve
    IRA->>ERP: submit PO
    IRA->>SCLA: register ASN callback for ETA visibility

sequenceDiagram
    autonumber
    participant M as Merchant
    participant O as Orchestrator
    participant AIA as Analytics
    participant PPA as Pricing Agent
    participant MCA as Marketing Content
    participant REV as Brand Lead

    M->>O: "We're long on summer outerwear. Move it."
    O->>AIA: identify overstock
    AIA->>AIA: run_query(category='outerwear-summer', WoS>20)
    AIA-->>O: 47 SKUs
    O->>PPA: design_promo(skus, target=60%_in_14d)
    loop top-10 SKUs
        PPA->>PPA: simulate_price_change @ {15%, 25%, 35%}
    end
    PPA->>PPA: propose_promotion → "SUMMER25", 14d
    Note over PPA: Guardrail: 3 SKUs margin<10% — flagged
    PPA-->>M: Proposal (3 flagged)
    M-->>PPA: ✅ Approve with exclusions
    PPA->>PPA: create_promo_code + schedule_promo
    O->>MCA: generate_campaign(promo, [email, meta, web])
    par Variant generation
        MCA->>MCA: get_product_attributes (batch)
        MCA->>MCA: get_brand_voice
        MCA->>MCA: generate_copy (5 variants/channel)
    end
    MCA->>MCA: check_compliance ✓
    MCA->>REV: submit_for_review (4h SLA)
    REV-->>MCA: ✅
    MCA->>MCA: push_to_klaviyo + push_to_meta_ads
    O->>AIA: register sell-through monitor

sequenceDiagram
    autonumber
    participant CRON as Calendar
    participant O as Orchestrator
    participant MCA as Marketing Content
    participant AIA as Analytics
    participant PSA as Personal Shopper
    participant REV as Marketing Lead
    participant KLAV as Klaviyo

    CRON->>O: weekly_lapsed_campaign
    O->>MCA: kick off
    MCA->>AIA: query_segment(last_purchase 90-180d, ltv≥6)
    AIA-->>MCA: 38,400 customers, by affinity
    par Segment picks (Fan-Out)
        MCA->>PSA: per_segment_picks(seg=A, k=6)
        MCA->>PSA: per_segment_picks(seg=B, k=6)
        MCA->>PSA: per_segment_picks(seg=C, k=6)
    end
    MCA->>MCA: generate_copy (3 subjects × 3 segments)
    MCA->>MCA: check_compliance (CAN-SPAM, GDPR)
    Note over MCA: brand_score=0.91, compliance=pass
    MCA->>REV: auto-approval candidate
    REV-->>MCA: ✅
    MCA->>KLAV: push_to_klaviyo (A/B/C, 10% holdout)
    O->>AIA: schedule 7d post-send eval

sequenceDiagram
    autonumber
    participant A as Associate
    participant SAC as Store Associate Copilot
    participant WMS as Inventory
    participant CDP as Customer Profile
    participant OMS as OMS
    participant SCLA as Supply Chain
    participant O as Orchestrator (async audit)

    A->>SAC: scan barcode (sub-2s required)
    SAC->>WMS: check_stock(sku, this_store)
    WMS-->>SAC: 0
    SAC->>WMS: check_stock_nearby(sku, store, 25km)
    WMS-->>SAC: 3 stores (1, 2, 4 units)
    SAC->>CDP: lookup_customer(phone)
    CDP-->>SAC: customer + prefs
    SAC-->>A: options: reserve / SFS / STH
    A->>SAC: ship-from-store
    par
        SAC->>OMS: create_save_the_sale_order
    and
        SAC->>WMS: reserve_item (auto-release 4h)
    end
    SCLA-->>SCLA: async: carrier + label + customer notify
    SAC-->>O: post-hoc audit + clienteling note

flowchart TB
    subgraph EPH[Ephemeral Layer]
        CS[Conversation State<br/>Redis · 24h sliding]
        ST[Short-term Episodic<br/>last 20 turns]
    end
    subgraph WARM[Warm Layer]
        CP[Customer Profile<br/>Postgres + CDP]
        CAT[Catalog Embeddings<br/>pgvector / Turbopuffer]
        POL[Policy / KB Embeddings<br/>pgvector namespaced]
    end
    subgraph COLD[Cold / System-of-Record]
        OMS[(OMS · Orders · Returns)]
        WH[(Warehouse · Snowflake / BigQuery)]
        AUD[(Audit Log · 7yr retention)]
    end
    subgraph DREAM[Dreaming Layer]
        AM[Agent Memory<br/>Postgres + embeddings<br/>summaries · preferences · incidents]
        DSC[Dream Scheduler<br/>nightly background process]
    end

    CS --> ST
    ST --> CP
    CP --> CAT
    CAT --> POL
    POL --> OMS
    OMS --> WH
    WH --> AUD
    AUD -.feed.-> DSC
    DSC -->|distill| AM
    AM -->|inject context| CS

    style DREAM fill:#dc2626,stroke:#fff,color:#fff
    style EPH fill:#0b3d91,stroke:#fff,color:#fff
    style WARM fill:#1f6feb,stroke:#fff,color:#fff
    style COLD fill:#374151,stroke:#fff,color:#fff

stateDiagram-v2
    [*] --> Idle
    Idle --> Invoked: user message / trigger
    Invoked --> ToolCalling: classify + plan
    ToolCalling --> Reflecting: tool returns
    Reflecting --> ToolCalling: needs more
    Reflecting --> Outcome_Grading: draft ready
    Outcome_Grading --> ToolCalling: rubric fail
    Outcome_Grading --> Responding: rubric pass
    Responding --> [*]
    [*] --> Dreaming: nightly cron
    Dreaming --> Distilling: read audit + traces
    Distilling --> Updating_Memory: extract summaries / preferences / incidents
    Updating_Memory --> [*]

flowchart LR
    A[Agent generates output] --> B{Rubric grader<br/>self-evaluation}
    B -- pass --> C[Release to customer]
    B -- fail · iter < N --> A
    B -- fail · iter ≥ N --> H[Escalate to human]
    style B fill:#7c3aed,stroke:#fff,color:#fff
    style H fill:#dc2626,stroke:#fff,color:#fff

flowchart TB
    subgraph OFF[Offline Track]
        GD[Golden Datasets<br/>per agent]
        REG[Nightly Regression]
        ALERT[2σ Drop → page]
    end
    subgraph ON[Online Track]
        AB[5% No-Agent Holdout]
        VAR[Variant A/B/C between agent versions]
        JUD[LLM-as-judge + 50/wk human spot-check]
    end
    subgraph RED[Red Team]
        INJ[Prompt-injection probes]
        EXF[PII exfiltration]
        JBR[Jailbreak — refund / price tools]
    end
    GD --> REG --> ALERT
    AB --> VAR --> JUD
    INJ --> ALERT
    EXF --> ALERT
    JBR --> ALERT

flowchart TB
    L1[Layer 1 — Input Sanitization<br/>PII tokenization · prompt-injection classifier · channel auth]
    L2[Layer 2 — Intent Classification + Routing<br/>only registered intents reach specialists]
    L3[Layer 3 — Tool Allow-Lists<br/>each agent restricted to its tool set]
    L4[Layer 4 — Tool-Side Guardrails<br/>refund cap · MAP enforce · margin floor · MAP write block]
    L5[Layer 5 — Human-In-Loop Approvals<br/>refunds >$250 · POs >$25k · promos >30% · price Δ ±10%]
    L6[Layer 6 — Outcome Rubric Grader<br/>self-evaluation before release]
    L7[Layer 7 — Audit + Reversibility<br/>every mutation has audit_id + compensation path]
    L8[Layer 8 — Kill Switches<br/>per-agent flag + global pause]

    L1 --> L2 --> L3 --> L4 --> L5 --> L6 --> L7 --> L8

    style L1 fill:#0b3d91,stroke:#fff,color:#fff
    style L2 fill:#1f6feb,stroke:#fff,color:#fff
    style L3 fill:#1f6feb,stroke:#fff,color:#fff
    style L4 fill:#16a34a,stroke:#fff,color:#fff
    style L5 fill:#16a34a,stroke:#fff,color:#fff
    style L6 fill:#7c3aed,stroke:#fff,color:#fff
    style L7 fill:#7c3aed,stroke:#fff,color:#fff
    style L8 fill:#dc2626,stroke:#fff,color:#fff

flowchart LR
    IN[Untrusted Input<br/>customer msg · review · scraped page · return reason] --> PG[PromptGuard 2<br/>~50ms classifier]
    PG -- benign --> LG[LlamaGuard 3 — 8B<br/>hazard classification]
    PG -- suspected --> Q[Quarantine + Manual Review]
    LG -- safe --> NEM[NeMo Guardrails<br/>orchestration]
    LG -- hazard --> Q
    NEM --> A[Trusted Agent Loop]
    style Q fill:#dc2626,stroke:#fff,color:#fff
    style PG fill:#7c3aed,stroke:#fff,color:#fff
    style LG fill:#7c3aed,stroke:#fff,color:#fff

flowchart TB
    subgraph FE[Front End]
        NX[Next.js · Vercel]
        EXP[Mobile · Expo]
    end
    subgraph AR[Agent Runtime]
        MAS[Mastra TS<br/>chat-heavy]
        LG[LangGraph Python<br/>stateful + durable]
        TEMP[Temporal<br/>durable writes]
        SDK[Anthropic Agent SDK<br/>Claude-first builds]
    end
    subgraph MO[Models]
        HK[Claude Haiku 4.5<br/>routing]
        SO[Claude Sonnet 4.6<br/>main loop]
        OP[Claude Opus 4.7<br/>escalation]
        FB[GPT-5.5 / Gemini 2.x<br/>diversity / fallback]
    end
    subgraph TL_MCP[Tool Layer — MCP-Native]
        SH[Shopify MCP — official]
        ST[Stripe MCP — official]
        KL[Klaviyo MCP — official]
        AL[Algolia MCP — official]
        AD[Adobe Commerce MCP — official]
        SF[Salesforce B2C Commerce MCP]
    end
    subgraph TL_WRAP[Tool Layer — Wrapped]
        SAP[SAP S/4HANA via OData wrapper]
        NS[NetSuite via SuiteTalk wrapper]
        POS[Square · Lightspeed via REST wrapper]
    end
    subgraph DATA[Data]
        PG[(Postgres + pgvector)]
        TP[(Turbopuffer<br/>large catalogs)]
        SN[(Snowflake / BigQuery)]
        RU[RudderStack CDP]
        HT[Hightouch Reverse-ETL]
    end
    subgraph OBS[Observability]
        LF[Langfuse self-hosted]
        BT[Braintrust evals]
        PF[Promptfoo CI]
    end
    subgraph SEC[Security]
        PA[PromptArmor + PromptGuard 2]
        TR[Transcend Agentic Assist]
        SI[Signifyd / Riskified]
    end

    FE --> AR
    AR --> MO
    AR --> TL_MCP
    AR --> TL_WRAP
    TL_MCP --> DATA
    TL_WRAP --> DATA
    AR --> OBS
    FE --> SEC
    AR --> SEC

    style AR fill:#7c3aed,stroke:#fff,color:#fff
    style MO fill:#0b3d91,stroke:#fff,color:#fff
    style SEC fill:#dc2626,stroke:#fff,color:#fff

pie title Annual Cost Allocation — 1,000 conv/day with caching
    "LLM tokens (Sonnet + Haiku + 5% Opus)" : 30000
    "Vector DB (Turbopuffer 1M SKU)" : 1200
    "Observability (Langfuse self-host infra)" : 2400
    "Audit log infra (Postgres + S3)" : 1800
    "Eval & red-team compute" : 3600
    "Embedding refresh (catalog deltas)" : 600

gantt
    title QuanData Retail Orchestration — 12-Month Build
    dateFormat YYYY-MM-DD
    axisFormat %b %y
    section Foundation (Days 0-90)
    Data plumbing audit            :a1, 2026-06-01, 14d
    Orchestrator + audit + approval scaffold :a2, after a1, 21d
    Tool registry + envelope contract :a3, after a1, 21d
    Guardrail middleware           :a4, after a2, 14d
    CSA (returns + order status only) :a5, after a4, 28d
    PSA (chat + on-site reco)      :a6, after a5, 28d
    Eval harness v1                :a7, after a4, 60d
    section Merchant + Internal (Mo. 4-6)
    AIA — conversational BI         :b1, 2026-09-01, 45d
    IRA — recommend-only            :b2, after b1, 30d
    MCA — descriptions + subjects   :b3, 2026-09-15, 60d
    SAC pilot — 5-10 stores         :b4, 2026-10-01, 60d
    Red-team v1 + audit dashboards  :b5, 2026-09-01, 90d
    section Automation + Hard Problems (Mo. 7-12)
    PPA — live markdowns w/ approval :c1, 2026-12-01, 60d
    SCLA — ETA + carrier opt        :c2, 2026-12-01, 60d
    MCA — full campaign mode        :c3, 2027-01-01, 60d
    FRA — fraud + abuse             :c4, 2027-01-15, 75d
    SAC — full rollout              :c5, 2027-02-01, 90d
    IRA — auto-PO under threshold   :c6, 2027-03-01, 60d
    Dreaming layer — production     :c7, 2027-01-01, 90d

flowchart LR
    P1[Phase 1<br/>Foundation] -->|Lowest blast radius<br/>+ Fastest ROI| P2[Phase 2<br/>Merchant + Internal]
    P2 -->|Trust earned<br/>+ Audit muscle built| P3[Phase 3<br/>Automation + Hard]
    P1 -->|CSA: ticket-cost reduction<br/>PSA: proven LLM win| ROI1[Customer-Visible ROI<br/>by Day 90]
    P2 -->|AIA: merchants love it<br/>IRA: recommend-only<br/>MCA: low-stakes content| ROI2[Operator Trust<br/>by Month 6]
    P3 -->|PPA · SCLA · MCA full · FRA<br/>only after audit + eval mature| ROI3[Full Autonomy w/ Gates<br/>by Month 12]
    style P1 fill:#0b3d91,stroke:#fff,color:#fff
    style P2 fill:#1f6feb,stroke:#fff,color:#fff
    style P3 fill:#7c3aed,stroke:#fff,color:#fff

pie title Production Multi-Agent Failure Modes
    "Context Blindness (truncated/missing info)" : 31.6
    "Rogue Actions (wrong tool/arg)" : 30.3
    "Silent Degradation (looks right, isn't)" : 24.9
    "Memory Corruption" : 8.1
    "Runaway Execution (loops, cost blowouts)" : 5.1

flowchart TD
    Start([New task to orchestrate])
    Q1{Mutates inventory /<br/>payment / fulfillment?}
    Q2{Strict step ordering?}
    Q3{Same op on many items?}
    Q4{Multiple distinct domains?}
    Out_Single[Single Threaded<br/>+ Temporal]
    Out_Pipe[Pipeline]
    Out_Fan[Fan-Out]
    Out_Spec[Specialist Team]
    Out_Fn[Function call<br/>— not an agent]

    Start --> Q1
    Q1 -- Yes --> Out_Single
    Q1 -- No --> Q2
    Q2 -- Yes · 1 domain --> Out_Pipe
    Q2 -- Yes · N domains --> Out_Spec
    Q2 -- No --> Q3
    Q3 -- Yes --> Out_Fan
    Q3 -- No --> Q4
    Q4 -- Yes --> Out_Spec
    Q4 -- No --> Out_Fn

    style Out_Single fill:#dc2626,stroke:#fff,color:#fff
    style Out_Pipe fill:#0b3d91,stroke:#fff,color:#fff
    style Out_Fan fill:#7c3aed,stroke:#fff,color:#fff
    style Out_Spec fill:#16a34a,stroke:#fff,color:#fff
    style Out_Fn fill:#6b7280,stroke:#fff,color:#fff