Jetson Quick Start

Quick Start — BSP customization entrypoint

jetson-quick-start is a dispatcher and intake form. It does not download, extract, materialize sources, bind documents, or derive carrier files. It chooses the setup path, gathers core answers, then hands those answers to the skills that own the actual work.

Modes

Do not ask setup mode in a separate prompt. Include it as the first field in the core quick-start questionnaire, with choices shown in this fixed order:

1. Auto Setup
2. Guided Setup
3. Use Existing Workspace

Offer cancel separately as an exit action, not as a setup mode.

Target setup means keep the active profile, switch via /jetson-set-target, or create one via /jetson-init-target.

Procedure

Print Disclaimer

Before opening the core questionnaire or inspecting setup inputs, print this disclaimer block exactly once:

================================================================================
DISCLAIMER
These skills help automate Jetson BSP setup and customization, but they do not
replace NVIDIA official documentation or engineering review. Review generated
plans, commands, diffs, and commit messages before accepting them.

Flashing can erase device storage or leave a target temporarily unbootable.
Keep backups and verify the active target, BSP release, and hardware setup
before deploy steps.
================================================================================

Disclaimer Acceptance Gate

Immediately after printing the disclaimer, open a separate one-question AskUserQuestions disclaimer form and wait for the user's submitted answer before doing anything else. Do not collect disclaimer acceptance with a plain-text chat reply, inferred default, prior run state, active profile, cached answer, or any other non-UI signal.

The form must contain exactly one question:

1. accept_disclaimer — prompt: "Accept the disclaimer and continue quick-start?" Choices: accept_disclaimer and cancel.

Treat only a submitted accept_disclaimer choice as acceptance. The disclaimer form is separate from the core questionnaire and does not replace any of the four routing-critical core questions.

If the form cannot be opened, is unavailable, is cancelled, returns no submitted answer set, or returns any answer other than accept_disclaimer, stop immediately and report that quick-start cannot continue until the disclaimer is accepted through AskUserQuestions.

Mandatory Questionnaire Gate

After the disclaimer has been accepted, jetson-quick-start MUST open the core AskUserQuestions questionnaire and wait for the user's submitted answers before doing any setup dispatch. If the questionnaire cannot be opened, is unavailable, is cancelled, or returns no submitted answer set, stop immediately and report that quick-start cannot continue without the questionnaire.

Do not continue by using existing active profiles, workspace state, tarball names, cached answers, release compatibility, or "obvious" defaults. Do not call downstream skills until this gate has a submitted mode answer and normalized quick_start_prefill.

Survey State

Inspect target-platform/active_target.yml and existing target-platform/*.yaml profiles. If an active profile exists, show reference_devkit.name, optional custom_carrier.name, and active flash_config. Do not infer platform identity from tarballs, repo names, or document titles.

Read ../../references/bsp-platforms-catalogue.md and parse every row in the product / chip / SKU / flash-config table. This catalogue is the source for the full active_platform questionnaire list. If the list is incomplete, update the catalogue; do not duplicate or patch the platform list inside quick-start. Do not read jetson-init-target/SKILL.md or run the init-target flow during quick-start preprocessing; downstream target creation remains owned by jetson-init-target.

Keep this survey lightweight so the core questionnaire appears quickly: read target profile pointers/summaries, perform cheap path existence checks when useful, and fetch only lightweight Jetson Linux release metadata from the official archive needed to populate bsp_release choices. Parse all current release sections, not only the section that appears to match the selected platform. Do not scan large BSP / source / document trees, inspect archives, generate KB content, or run setup tools before the user submits the core questionnaire. Prepare the possible plans for all three modes; choose the actual downstream plan only after the form is submitted.

Print Platform Reference List

Before opening the AskUserQuestions UI, print the full platform list parsed from bsp-platforms-catalogue.md with stable numeric indexes for this run:

Available platforms:
T234 - Orin
  1. Jetson AGX Orin 64GB | CVM P3701-0005 | CVB P3737-0000 | jetson-agx-orin-devkit.conf
  ...
T264 - Thor
  N. Jetson AGX Thor T5000 | CVM P3834-0008 | CVB P4071-0000 | jetson-agx-thor-devkit.conf

Use these indexes only for the immediately following questionnaire. Do not auto-select an index, even when there is an active profile or a single obvious match.

Ask Core Questionnaire

Generate one click-to-select core questionnaire for the whole setup run using the AskUserQuestions UI. Do not collect quick-start answers with plain-text prompts, inline chat questions, inferred defaults, or manual summary confirmation.

This is a hard gate: do not skip it, do not use a one-profile shortcut, and do not auto-select mode, active_platform, bsp_release, or custom_carrier from active_target.yml, filenames, tarballs, repo names, release compatibility, workspace state, cached answers, or prior runs. An existing active profile may be shown as an option, but it is not selected until the user submits the AskUserQuestions form.

Because AskUserQuestions can ask at most four questions, the core form must contain only routing-critical fields:

1. mode — Auto Setup, Guided Setup, Use Existing Workspace, or cancel.
2. active_platform — use the printed full platform list; follow the active-platform question rules below.
3. bsp_release — recent global concrete release candidate shortcuts generated from the official Jetson Linux archive for this run, sorted newest first by dotted numeric order, plus skip. Preserve each official release token exactly as listed; concrete tokens may have two or three numeric components, such as 38.2, 38.2.1, 38.4, or R36.4.4. Do not normalize 38.2 to 38.2.0, and do not infer a missing patch component. Do not hard-code or cache candidates. If metadata fetch is slow or fails, still show skip and a typed concrete release option. Do not platform-filter this list in quick-start; include at least the newest concrete row from each current major release line found in the archive. If parsing returns only one major release line, treat the release list as incomplete and fall back to skip plus typed input instead of showing a partial candidate list.
4. custom_carrier — if the selected/active profile already has a custom carrier, offer keep_existing_custom_carrier, no_custom_carrier, add_custom_carrier, and skip; otherwise offer no_custom_carrier, add_custom_carrier, and skip.

The user submits this AskUserQuestions form once. Only after that submission may mode, active platform, BSP release, and custom-carrier intent decide which downstream skills run and which prefilled answers are consumed or ignored. If there is no submitted form result, stop; never continue with inferred answers. add_custom_carrier is only a routing intent; carrier name, ID, SKU, revision, and custom flash config remain downstream-owned.

Render the form using the shared User input prompt style and normalize submitted UI answers into quick_start_prefill. Follow the shared quick_start_prefill contract. Active-platform question rules:

• Print the full indexed platform list before the questionnaire.
• Explicit choices are only the first row from each chip-family group, labeled with full-list index and product name, for example Index 1 — Jetson AGX Orin 64GB.
• For all other platforms, the user chooses Type something and enters the numeric index from the printed list. Type something must be the tool's built-in freeform row, not a custom explicit choice.
• Prompt text: "Pick a platform shortcut, or choose Type something and enter the numeric index from the full platform list printed above. Type skip to skip platform selection and let downstream setup ask later."
• Only platform shortcuts may be explicit choices. Do not add skip, Other, or custom manual-entry choices; skip must be typed through the built-in Type something path. Do not paraphrase Type something as Other in prompt text.
• Do not resolve flash-config variants here; pass the selected catalogue row to jetson-init-target, which owns validation and flash-config selection.

Each non-skip answer must be explicit and directly consumable by the owning downstream skill; use skip for anything unknown. A BSP release answer must be a concrete version token with an optional leading R and two or three numeric components (for example R38.4, 38.2, 38.2.1, or 36.4.4). Family placeholders such as R38.x or "pin a version later" are not acceptable; use skip instead. Preserve the user's/source token exactly when passing quick_start_prefill.download.bsp_release.

Image paths, source paths, document paths, carrier details, repository overrides, toolchain choices, and document bindings are non-core setup details. Leave them to the owning downstream skill. Downstream setup skills should use documented defaults without asking when safe, and ask only on conflicts, overwrites, incompatible releases, missing artifacts, or user-requested overrides.

For Auto Setup, /jetson-download-bsp owns listing supported BSP releases for the selected platform and warning on platform/BSP incompatibility. Quick-start may forward a requested global candidate or typed release, but it does not validate support or override compatibility decisions itself.