HoloHub Holoscan Module lifecycle

HoloHub Holoscan Module lifecycle

Purpose

Take a reusable Holoscan Module from layout and API contract through producer, consumer, and clean artifact-install proof.

Inputs

Require the API contract, checkout, layout, identities, SDK floor, license, maintainer, package formats, and acceptance checks from the request or an authoritative repository source. If consequential release metadata remains unknown, stop before scaffolding or packaging rather than guessing.

• a reusable producer/consumer API contract rather than an ordinary app;
• the user-provided HoloHub checkout;
• external self-contained repository or in-tree descriptor layout;
• language, module/operator/package identities, minimum SDK version, license, maintainer details, and requested package formats;
• finite producer, consumer, and artifact acceptance checks.

Route an ordinary app to holohub-app-lifecycle and a concrete failing or wrong ./holohub command to holohub-debug-build-run. If the matching skill is unavailable, preserve the handoff context and name the skill to install instead of broadening this workflow.

Prerequisites

• Always read the CLI contract.
• Read module development for layout, naming, scaffold, metadata, implementation, build, and test scope.
• Read consumer and packaging when a consuming app, editable install, or binary artifact is in scope.
• Use HoloHub's current create-a-module and use-a-module tutorials as producer and consumer walkthroughs, then recheck version-sensitive commands against the selected checkout and CLI contract.

The selected checkout's AGENTS.md, local help, module guidance, schemas, templates, tutorials, and nearby examples are the live technical authority