voyager-launch

Launch - Complete Pipeline Builder

Build a complete runnable Voyager SDK solution from the user prompt. Optimize for speed, but never trade away validation integrity.

Use This Skill When / Not When

• Use when: the user wants a complete runnable pipeline or demo from natural language, with validation artifacts and a browser viewer.
• Not when: the model/pipeline already exists and they only want to execute it -- route to voyager-run.
• Not when: they explicitly want YAML-only design -- route to voyager-new-pipeline.
• Not when: they bring an existing error or log to fix in existing code -- route to voyager-debug.

{{INCLUDE workflows/pre-flight.md}}

Launch Contract

A launch is complete only when it creates a runnable package and one of these outcomes is true:

• On a Metis machine: RUN_HERE.sh ran successfully on Metis, not CPU, and produced VALIDATED.txt, results/EVALUATION.json, results/METIS_PROOF.json, results/RUN_SUMMARY.json, results/VIEWER_CHECKS.json, a log, an output image/video, and an Open Design-style Axelera dark/gold browser viewer at viewer/index.html that is auto-opened by default. results/METIS_PROOF.json must have status=passed, metis_detected=true, accelerator_operator_seen=true, cpu_only_rejected=true, and metrics schema voyager.metrics.v1 with measured end-to-end FPS, measured Metis device FPS from the SDK tracer, measured SDK latency, stage metrics, slowest SDK stage evidence, metric_truth_gates, metric_bounds_gate, and metric_provenance. For video, the viewer must use extracted JPEG result frames by default so it does not depend on browser MP4 codec support.
• Off-device, MacBook, web, or missing SDK/hardware: a Linux package was created with RUN_ON_METIS_LINUX.md and results/PACKAGE_CHECKS.json; the final response clearly says generation was package-only and not hardware validated.
• Local Linux with a detected Metis card but unusable axdevice: stop before creating package/viewer artifacts and report the local runtime repair diagnostics. Do not hide this by generating a Linux package.