vda5050_integration

Bridge VDA 5050 fleet-control protocol onto Nav 2 using Clean Architecture layers.

Updated Aug 16, 2026
One-click install
npx skills add https://github.com/three1324/yeonjinautomotive --skill vda5050-integration-three1324
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vda5050_integration
Source: https://github.com/three1324/yeonjinautomotive/tree/main/.claude/skills/vda5050_integration
Command: npx skills add https://github.com/three1324/yeonjinautomotive --skill vda5050-integration-three1324

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Connecting an AGV or mobile robot running ROS 2 / Nav 2 to a VDA 5050 fleet-control master requires translating MQTT/JSON order messages into navigation goals while keeping protocol concerns out of the domain model. This Skill provides the architecture, mapping rules, and checklist to build that connector without coupling domain logic to MQTT or ROS. ## Core Features & Use Cases - Clean Architecture blueprint: Domain entities (Order, Node, Edge, Action, State) with abstract ports for MQTT and navigation, plus application services for order handling, state assembly, and instant actions. - VDA 5050 to Nav 2 mapping cheat-sheet: Maps order nodes to NavigateToPose goals, edge speed limits to controller caps, telemetry topics to state fields, and instant actions like cancelOrder and initializePosition to Nav 2 equivalents. - QoS and protocol compliance guidance: Aligns MQTT QoS levels with ROS 2 QoS profiles, covers last-will connection handling, headerId increments, and JSON schema validation against the official v3.0.0 schemas. - Use Case: A robotics engineer needs their warehouse AGV to accept orders from a VDA 5050 master control system. Use this Skill to structure the connector so order stitching, action status state machines, and state publishing all live in testable application services. ## Quick Start Ask the AI to scaffold a VDA 5050 connector package with domain entities, MQTT and Nav 2 adapters behind ports, and an order handler that maps released nodes to NavigateToPose goals.

Frequently Asked Questions about vda5050_integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect a VDA 5050 fleet controller to ROS 2 Nav 2?

Build a connector that translates VDA 5050 order messages received over MQTT into NavigateToPose or NavigateThroughPoses action goals. Keep domain entities free of MQTT and ROS imports, and implement MQTT and Nav 2 adapters behind abstract port interfaces.

How do I map VDA 5050 order nodes to Nav 2 navigation goals?

Each released order node with a nodePosition maps to a NavigateToPose goal using geometry_msgs/PoseStamped in the map frame. A whole released base can be sent as a single NavigateThroughPoses goal, and edge maximumSpeed maps to controller speed limits.

What MQTT QoS levels does VDA 5050 require?

VDA 5050 uses QoS 0 for order, instantActions, state, and visualization topics, and QoS 1 for the connection topic. The connection topic also requires a last will set to CONNECTION_BROKEN so the master detects unexpected disconnects.

Why should domain entities not import json or paho in a VDA 5050 connector?

VDA 5050 is an outer-world protocol, so serialization belongs in infrastructure adapters, not the domain. Keeping entities as plain dataclasses makes order handling, graph traversal, and action state machines unit-testable without ROS or an MQTT broker.

How do I handle VDA 5050 order updates and stitching?

An order update must share the same orderId, increment orderUpdateId, and have its first node equal to the previous order's lastNodeId. Reject invalid updates with an error message carrying the orderId and orderUpdateId, and never mutate already released base nodes.