Skip to content
Back to skills

Logistics Reference

ASecurity

Use when checking what is live (the solver landscape, and quantum and AI optimization claims, verified August 2026), checking an optimization anti-pattern, correcting a misconception, looking up a problem size or runtime expectation, finding the canon, or needing a picker. Companion to the other logistics-software-optimization skills.

  • 2 stars
  • 0 votes
  • 0 copies
  • 2 views
  • Added September 19, 2026
ai-agentsrustgonodetestingperformancedocumentation

Security analysis

A100/100

Scanned September 19, 2026

npx -y skills add the-vibey-project/vibey --skill logistics-reference --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Logistics Reference?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Logistics Reference
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/the-vibey-project-logistics-reference/badge)](https://www.skillsdirectory.com/skills/the-vibey-project-logistics-reference)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: logistics-reference
description: "Use when checking what is live (the solver landscape, and quantum and AI optimization claims, verified August 2026), checking an optimization anti-pattern, correcting a misconception, looking up a problem size or runtime expectation, finding the canon, or needing a picker. Companion to the other logistics-software-optimization skills."
---

# Logistics and Optimization Software: What's Live, Anti-Patterns, Misconceptions, and Canon

> **Part 5 of 5** of the *Logistics and Optimization Software* reference (plugin `logistics-software-optimization`), covering §25–§31. Sibling skills: `logistics-why-projects-fail-complexity-and-modeling` (§0–§5), `logistics-constraint-programming-metaheuristics-and-bounds` (§6–§9), `logistics-routing-packing-scheduling-and-network-design` (§10–§16), `logistics-inventory-forecasting-operations-and-solvers` (§17–§24). Section numbers are shared across the set; a reference written as §N → `skill` points into that sibling skill.
>
> **Currency:** The algorithms and complexity results are permanent. Two areas are live. See §25 below for the solver landscape and the quantum and AI optimization claims.

> **⚠️ Scope.** For engineers building or integrating logistics systems. Complements a
> data-engineering reference (pipelines), an operations reference (process), and a
> business reference (unit economics).
>
> **⚠️ GOTCHA** boxes mark things that sink projects or silently produce wrong answers.
>
> **The three ideas that organize this document:**
> 1. **⚠️ Optimization projects almost never fail on the algorithm.** **They fail on data
>    quality, on constraints nobody told you about, and on solutions the drivers refuse to
>    run** (§1 → `logistics-why-projects-fail-complexity-and-modeling`). **The maths is the easy part and it is not where your time goes.**
> 2. **⚠️ NP-hard does not mean unsolvable — it means no guaranteed-fast exact method.**
>    **Real instances with tens of thousands of stops are solved to within a few percent
>    of optimal every night by well-engineered heuristics** (§2 → `logistics-why-projects-fail-complexity-and-modeling`, §8 → `logistics-constraint-programming-metaheuristics-and-bounds`).
> 3. **⚠️ A 2% better solution that operations won't execute is worth 0%.** **Stability,
>    explainability and consistency with yesterday's plan routinely matter more than the
>    objective value** (§1 → `logistics-why-projects-fail-complexity-and-modeling`, §26).

---

## §25. What's Live — verified August 2026

### 25.1 ⚠️ The solver landscape
**⚠️ The commercial/open-source gap narrowed, the benchmark situation got murkier, and
GPUs entered LP.**

- **⚠️ The gap is roughly one order of magnitude, not two.** **Analysis in 2025–26 puts
  HiGHS at about 20× slower than the top commercial solvers on Mittelmann benchmarks** —
  ⚠️ **and explicitly notes this is "not the 'two orders of magnitude' that sales
  engineers love to claim."** **The framing worth carrying: ⚠️ "20× slower than
  instantaneous" is still instantaneous for many real applications.**
- **⚠️ HiGHS has become the default open-source choice** — **commercial-grade enough for
  many workloads without licensing complexity** — **and SCIP remains strong (check its
  licence terms for your use case).**
- **⚠️ COPT (Cardinal Optimizer) is a genuine competitor to Gurobi and CPLEX**, **and
  benchmark reports have it leading on several problem categories.** **The commercial
  field is no longer a two-horse race.**

> **⚠️ GOTCHA — the benchmark landscape itself became less trustworthy, and you should
> know this before quoting anyone's numbers.** ⚠️ **Gurobi withdrew from Hans Mittelmann's
> widely-cited benchmarks in August 2024, followed by MindOpt in December.** **One
> commentator's read: when solvers start avoiding public benchmarks it usually means
> either the results aren't flattering or the methodology has been gamed.**
> ⚠️ **Note also that commercial solver licences frequently restrict published
> benchmarking** — **the GAMS MIPfeas benchmark works around this by grouping COPT, CPLEX
> and Xpress into synthetic "Virtual Best/Mean/Worst Commercial Solver" baselines rather
> than naming per-solver results.** **⚠️ Benchmark your OWN models on YOUR instances.
> Published rankings are weakly predictive of your workload.**

- **⚠️ GPU-based first-order LP methods are real and maturing.** **PDLP/cuPDLP variants
  have been incorporated into solvers from Gurobi, COPT, FICO Xpress, HiGHS, Google and
  NVIDIA.** ⚠️ **The honest positioning: on Mittelmann's LP set, commercial simplex and
  barrier methods remain fastest overall and most reliable — one 2026 comparison has COPT
  solving 50 instances against 46 for GPU methods, and roughly 1.8× faster in shifted
  geometric mean.** **But on specific very large structured instances the advantage
  inverts dramatically** — ⚠️ **COPT reported a classic instance solved in under 15
  minutes by cuPDLP-C versus 16 hours by CPU interior point.**
  **⚠️ The read: GPU LP is not a general replacement, and it is a genuine unlock for
  certain large problems including supply chain ones. Test, don't assume.**

### 25.2 ⚠️ Quantum and AI optimization claims
**⚠️ Two hype axes where practitioners need calibration, and they need it in opposite
directions.**

> **⚠️ GOTCHA — quantum optimization for logistics is not commercially real in 2026, and
> the literature saying otherwise has documented methodological problems.**
> ⚠️ **A 2025 systematic review of peer-reviewed quantum-and-quantum-inspired transport
> optimization studies found that although several demonstrate gains over classical
> heuristics, "most rely on synthetic datasets, lack statistical robustness, and omit
> critical operational metrics."** **That is the sentence to remember.**

**⚠️ What the honest technical work actually says:**
- **⚠️ Hardware can't hold real problems.** **NISQ hardware is described as "almost
  universally incompatible with full-scale optimization problems of practical
  importance."** **Circuit-model quantum algorithms can't be tested much beyond ~30 binary
  variables even on simulators; ⚠️ quantum annealers become cumbersome around a few
  hundred variables due to embedding challenges.** **A realistic VRP has orders of
  magnitude more.**
- **⚠️ Everything credible is HYBRID and decomposed.** **The most-cited serious study
  (QC Ware with Aisin, in *Scientific Reports*) handled a real-scale multi-truck routing
  problem only by iteratively generating one truck's subproblem at a time, each around
  2,500 binary variables** — **explicitly to avoid a full embedding that isn't possible.**
- **⚠️ The comparisons are frequently against weak baselines.** **A result like "85% of
  optimal at 95% faster runtime than a genetic algorithm" is measured against a GA** —
  ⚠️ **and a well-tuned classical LNS (§8 → `logistics-constraint-programming-metaheuristics-and-bounds`) is a much stronger baseline that these papers
  typically don't run.**
- **⚠️ Treat the big vendor and analyst numbers with real scepticism.** **Claims of
  "40–60% logistics cost reductions" circulate in industry-analyst material.** ⚠️ **They
  do not come from operational deployments, and the same sources acknowledge persistent
  bottlenecks in data loading, algorithm tuning and hybrid integration with existing ERP
  and WMS.**

**⚠️ On LLMs and optimization — a more nuanced picture, and the useful direction is not
the obvious one:**
⚠️ **LLMs do not solve combinatorial problems; solvers do.** **Where the research is
genuinely promising is LLMs as an INTERFACE to optimization** — **the OptiGuide-style
pattern, where natural-language what-if questions are translated into model
modifications, the solver is re-run, and results are explained back.**
⚠️ **That targets §1 → `logistics-why-projects-fail-complexity-and-modeling`'s real failure modes — constraint elicitation, explainability and
trust — rather than the solve time, which was rarely the bottleneck.** **There is also
active work on ML-guided branching and solution prediction to accelerate MIP within
solvers, with reported primal-gap improvements over solver defaults on specific
benchmarks.** ⚠️ **Both are worth watching; neither replaces knowing §5 → `logistics-why-projects-fail-complexity-and-modeling`.**

---

## §26. ⚠️ Anti-Patterns

```
⚠️ Building the optimizer before profiling the data (§1)
⚠️ No independent feasibility checker — the optimizer exploits every
   modeling gap and it looks fine until a driver tries it (§12)
⚠️ All-hard constraints, so the answer at 4am is "infeasible" (§5)
⚠️ No bound — you cannot say whether you're 2% or 40% off (§9)
⚠️ Re-optimizing from scratch nightly and destroying route stability (§1)
⚠️ Optimizing the objective operations doesn't actually care about (§1)
⚠️ Big-M set to 1e9 "to be safe" — weak relaxation, numerical garbage (§5)
⚠️ Straight-line distance in the production plan (§22)
⚠️ Flat service time for every stop (§21)
⚠️ Naive full n² distance matrix rebuild every night (§22)
⚠️ Bolting driver hours-of-service on after routing (§12)
⚠️ Routing and load planning solved independently with no iteration (§13)
⚠️ Building a MIP for something that was min-cost flow (§10)
⚠️ Reaching for a genetic algorithm because it's familiar, not because
   it's better — try LNS first (§7, §8)
⚠️ No degraded fallback mode when the optimizer fails (§1)
⚠️ Buying a commercial solver licence before proving solve time is the
   binding constraint (§24)
⚠️ Believing published solver benchmarks apply to your models (§25.1)
⚠️ Piloting quantum optimization instead of tuning your LNS (§25.2)
⚠️ Chasing forecast accuracy while ignoring forecast BIAS (§18)
⚠️ Treating the bullwhip effect as a forecasting problem (§17)
```

---

## §27. Misconceptions

| Misconception | Correction |
|---|---|
| NP-hard means practically unsolvable | ⚠️ **Real instances solve to within a few % routinely** (§2 → `logistics-why-projects-fail-complexity-and-modeling`) |
| The algorithm is the hard part | ⚠️ **Data, hidden constraints and trust are** (§1 → `logistics-why-projects-fail-complexity-and-modeling`) |
| A better objective value is a better plan | ⚠️ **Not if operations won't run it** (§1 → `logistics-why-projects-fail-complexity-and-modeling`) |
| Stop count drives difficulty | ⚠️ **Interacting constraints and tight windows do** (§2 → `logistics-why-projects-fail-complexity-and-modeling`) |
| The solver choice matters most | ⚠️ **The formulation matters more** (§5 → `logistics-why-projects-fail-complexity-and-modeling`) |
| Make constraints hard so they're respected | ⚠️ **Soft + penalties; "infeasible" helps nobody** (§5 → `logistics-why-projects-fail-complexity-and-modeling`) |
| Genetic algorithms are state of the art for routing | ⚠️ **LNS/ALNS generally beats them** (§7 → `logistics-constraint-programming-metaheuristics-and-bounds`, §8 → `logistics-constraint-programming-metaheuristics-and-bounds`) |
| A heuristic that returns a solution is working | ⚠️ **Without a bound you know nothing** (§9 → `logistics-constraint-programming-metaheuristics-and-bounds`) |
| TSP is the hard part of routing | ⚠️ **Assignment to vehicles is** (§11 → `logistics-routing-packing-scheduling-and-network-design`, §12 → `logistics-routing-packing-scheduling-and-network-design`) |
| Straight-line distance is close enough | ⚠️ **Error is worst exactly where geography binds** (§22 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Geocoding gives you a location | ⚠️ **It gives a point and a quality flag; the flag matters** (§22 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Service time is roughly constant | ⚠️ **It varies hugely by stop type and destroys plans** (§21 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Re-optimize continuously for best results | ⚠️ **It destabilizes the plan; freeze a near horizon** (§23 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Safety stock should target a service level | ⚠️ **Newsvendor: derive it from cost asymmetry** (§17 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Reduce average lead time | ⚠️ **Reducing lead time VARIABILITY usually matters more** (§17 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Bullwhip is a forecasting failure | ⚠️ **It's structural** (§17 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Fancy ML beats simple forecasting | ⚠️ **Often not, especially on intermittent demand** (§18 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Open-source solvers are 100× slower | ⚠️ **Roughly 20×, and often fast enough** (§25.1) |
| Published solver benchmarks predict my performance | ⚠️ **Weakly. Benchmark your own models** (§25.1) |
| Quantum will solve routing soon | ⚠️ **Annealers cumbersome at a few hundred variables** (§25.2) |
| LLMs can solve optimization problems | ⚠️ **They're an interface to solvers, not a solver** (§25.2) |

---

## §28. Numbers

```
⚠️ MIP gap to aim for in production      1–3% is usually plenty
⚠️ Nearest-neighbour TSP quality         ~25% above optimal — starting point only
⚠️ Christofides guarantee                1.5× optimal (metric TSP)
⚠️ First-Fit Decreasing (bin packing)    within 11/9 of optimal
Held-Karp exact TSP                      O(n²2ⁿ) — practical to ~20 nodes
⚠️ Distance matrix size                  n². 1,000 stops → 10⁶ entries
⚠️ Safety stock                          ≈ z · σ over lead time (scales √t)
⚠️ Risk pooling benefit                  safety stock scales ~√n
⚠️ Newsvendor optimal service level      Cu / (Cu + Co)
⚠️ Travel share of manual picking        commonly ~50% of picker time
⚠️ HiGHS vs top commercial (Mittelmann)  ~20× slower (§25.1)
⚠️ Quantum annealer practical limit      a few hundred variables (§25.2)
⚠️ Circuit-model QC testable limit       ~30 binary variables (§25.2)
⚠️ ALOHA-style channel efficiency         (see a radio reference §13 — the same
   "simple protocol collapses under load" lesson applies to dispatch systems)
```

---

## §29. Books

| Author | Work | Why |
|---|---|---|
| **Williams** | ***Model Building in Mathematical Programming*** | ⚠️ **THE book on §5 → `logistics-why-projects-fail-complexity-and-modeling`. Read it before any solver documentation** |
| **Wolsey** | *Integer Programming* | The rigorous §4 → `logistics-why-projects-fail-complexity-and-modeling` reference |
| **Toth & Vigo** | ***Vehicle Routing: Problems, Methods, Applications*** | ⚠️ **The VRP bible (§12 → `logistics-routing-packing-scheduling-and-network-design`)** |
| **Applegate et al.** | *The Traveling Salesman Problem* | §11 → `logistics-routing-packing-scheduling-and-network-design`, exhaustive |
| **Pisinger & Ropke** | *"Large Neighborhood Search"* (chapter) | ⚠️ **§8 → `logistics-constraint-programming-metaheuristics-and-bounds`. The technique that actually wins** |
| **Ahuja, Magnanti & Orlin** | *Network Flows* | ⚠️ **§10 → `logistics-routing-packing-scheduling-and-network-design`. Recognize flow problems and save yourself** |
| **Silver, Pyke & Thomas** | *Inventory and Production Management* | §17 → `logistics-inventory-forecasting-operations-and-solvers` |
| **Hyndman & Athanasopoulos** | ***Forecasting: Principles and Practice*** | ⚠️ **§18 → `logistics-inventory-forecasting-operations-and-solvers`. Free online, excellent** |
| **Bartholdi & Hackman** | ***Warehouse & Distribution Science*** | ⚠️ **§20 → `logistics-inventory-forecasting-operations-and-solvers`. Free PDF, genuinely good** |
| **Chopra & Meindl** | *Supply Chain Management* | The business-level frame |

**⚠️ Also**: **the OR-Tools documentation and examples are unusually good and are the
fastest practical on-ramp**; **CVRPLIB and Solomon instances for benchmarking (§9 → `logistics-constraint-programming-metaheuristics-and-bounds`)**;
**and ⚠️ the *Operations Research* / *Transportation Science* / *EJOR* literature, where
the honest comparative studies live — as distinct from the vendor material.**

---

## §30. Quick Reference

### 30.1 Picker
| Question | Answer |
|---|---|
| Where do I start on a new project? | ⚠️ **Profile the data. Not the model** (§1 → `logistics-why-projects-fail-complexity-and-modeling`) |
| Is my heuristic any good? | ⚠️ **Get a bound. Any bound** (§9 → `logistics-constraint-programming-metaheuristics-and-bounds`) |
| Solver says infeasible at 4am | ⚠️ **Soften constraints with penalties** (§5 → `logistics-why-projects-fail-complexity-and-modeling`) |
| Routing engine architecture? | ⚠️ **Cluster → construct → ALNS → post-process → validate** (§12 → `logistics-routing-packing-scheduling-and-network-design`) |
| Which metaheuristic? | ⚠️ **LNS/ALNS first** (§8 → `logistics-constraint-programming-metaheuristics-and-bounds`) |
| Is this actually a hard problem? | ⚠️ **Check whether it's min-cost flow** (§10 → `logistics-routing-packing-scheduling-and-network-design`) |
| Scheduling with resources and precedence? | ⚠️ **CP-SAT** (§6 → `logistics-constraint-programming-metaheuristics-and-bounds`, §15 → `logistics-routing-packing-scheduling-and-network-design`) |
| Distance matrix too slow/expensive? | ⚠️ **Self-host OSRM; k-nearest only** (§22 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Plans keep running late | ⚠️ **Measure real service times; add buffer** (§21 → `logistics-inventory-forecasting-operations-and-solvers`, §23 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Drivers reject the plan | ⚠️ **Stability penalty + an explainer** (§1 → `logistics-why-projects-fail-complexity-and-modeling`) |
| How much safety stock? | ⚠️ **Newsvendor on cost asymmetry, not a target SL** (§17 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Which solver? | ⚠️ **OR-Tools + HiGHS until proven otherwise** (§24 → `logistics-inventory-forecasting-operations-and-solvers`) |
| Should we try quantum? | ⚠️ **No. Tune your LNS** (§25.2) |
| Can an LLM do this? | ⚠️ **As an interface and explainer, yes. As a solver, no** (§25.2) |

### 30.2 Before going live
- [ ] ⚠️ **Data profiled: address quality, service times, capacities, skills** (§22 → `logistics-inventory-forecasting-operations-and-solvers`)
- [ ] ⚠️ **Independent feasibility checker, separate from the optimizer** (§12 → `logistics-routing-packing-scheduling-and-network-design`)
- [ ] ⚠️ **A bound, so you can state solution quality** (§9 → `logistics-constraint-programming-metaheuristics-and-bounds`)
- [ ] Hard constraints limited to genuine impossibilities (§5 → `logistics-why-projects-fail-complexity-and-modeling`)
- [ ] ⚠️ **Stability penalty against the incumbent plan** (§1 → `logistics-why-projects-fail-complexity-and-modeling`)
- [ ] ⚠️ **Degraded fallback that always returns something** (§1 → `logistics-why-projects-fail-complexity-and-modeling`)
- [ ] Plan explainer: "why is this stop on this route?" (§1 → `logistics-why-projects-fail-complexity-and-modeling`)
- [ ] ⚠️ **Driver hours / breaks modeled, not bolted on** (§12 → `logistics-routing-packing-scheduling-and-network-design`)
- [ ] Runtime fits the operational window with margin (§1 → `logistics-why-projects-fail-complexity-and-modeling`)
- [ ] ⚠️ **Shadow-mode comparison against current human plans** (§1 → `logistics-why-projects-fail-complexity-and-modeling`)
- [ ] Penalty weights exposed as a business-facing interface (§5 → `logistics-why-projects-fail-complexity-and-modeling`)
- [ ] ⚠️ **Benchmarked on YOUR instances, not published rankings** (§25.1)

---

## §31. Method

**§1–§24 → `logistics-why-projects-fail-complexity-and-modeling`, `logistics-constraint-programming-metaheuristics-and-bounds`, `logistics-routing-packing-scheduling-and-network-design`, `logistics-inventory-forecasting-operations-and-solvers` and §26–§30 rest on stable material** — **complexity theory, LP/MIP/CP,
metaheuristics, the classical OR problem family, inventory theory and warehouse
science** — sourced from §29. ⚠️ **None of it needed verification; Dijkstra, Held-Karp,
the newsvendor result and branch-and-bound are not going to change.**

**Two searches were run in August 2026**, on **the solver landscape** and **quantum/AI
optimization claims** — ⚠️ **one because the buy-vs-open-source decision genuinely
shifted, and one because it's where practitioners are currently being mis-sold.**

**Confidence.** **High** in §1 → `logistics-why-projects-fail-complexity-and-modeling`, which is the section I'd most want read and the one that
is least present in textbooks. ⚠️ **The claim that these projects fail on data, hidden
constraints and trust rather than on algorithms is a position, and I've presented it as
an ordered judgement rather than a measured finding** — **but the stability requirement,
the need for a feasibility checker independent of the optimizer, and the soft-constraints
recommendation in §5 → `logistics-why-projects-fail-complexity-and-modeling` are the three things I'd defend hardest.**

**High** in §2 → `logistics-why-projects-fail-complexity-and-modeling`'s framing. ⚠️ **"NP-hard ≠ unsolvable" is the correction that most changes
how a software engineer approaches this domain**, **and the practical difficulty drivers
(interacting constraints, tight time windows) matter far more than instance size.**

**Moderate-to-high** in §25.1's specifics. ⚠️ **The ~20× HiGHS-vs-commercial figure and
the "one order of magnitude, not two" framing come from 2025–26 analysis referencing
Mittelmann benchmarks, and I've attributed rather than asserted them.** **The Gurobi
(August 2024) and MindOpt (December 2024) benchmark withdrawals are reported, and the
interpretation offered — that withdrawal signals unflattering results or gamed methodology
— is one commentator's read, which I've labelled as such.** ⚠️ **The structural point is
more reliable than any number: commercial licences often restrict published benchmarking,
which is why GAMS uses anonymized "virtual commercial solver" baselines — so treat all
public rankings as weakly predictive and benchmark your own models.**

**High** in §25.2's sceptical read, and this is the section I'd stand behind most firmly
against the surrounding marketing. ⚠️ **The decisive evidence is a peer-reviewed
systematic review finding that most quantum transport-optimization studies "rely on
synthetic datasets, lack statistical robustness, and omit critical operational
metrics."** **The hardware limits — ~30 binary variables for circuit-model testing, a few
hundred for annealer embedding — come from the technical literature including the QC Ware
paper, which is notably candid about them.** ⚠️ **I've deliberately contrasted that honest
work against the analyst claims of 40–60% cost reductions, and flagged that the latter
don't come from operational deployments.**

⚠️ **Sourcing caution**: **solver vendors publish benchmarks showing they win; quantum
vendors and analysts publish projections showing transformation.** **Where I could anchor
on peer-reviewed work, a systematic review, or a neutral party (the GAMS benchmark
methodology, arXiv comparisons), I did.** ⚠️ **The LLM-as-interface point in §25.2 is my
own synthesis — that the promising direction targets §1 → `logistics-why-projects-fail-complexity-and-modeling`'s failure modes rather than solve
time — and I'd flag it as an argument rather than a finding.**

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…