Wizard

A wizard is a bash script that walks a human through a manual procedure: it opens each URL, says what to click and copy, captures the values, writes them where they belong, confirms at every stage, and shows how many stages are left.

The UX lives in scripts/template.sh: stage progress, confirmation gates, cross-platform URL opening, hidden secret entry, idempotent .env upserts, gh secret / gh variable writes, and a closing summary. Scope the procedure and author its stages. The library above the STAGES marker is identical in every wizard.

Resolve every .agents/projects/ path from the repository root; never read or write project artifacts in a global agent-installation directory.

A wizard is ephemeral by default. Write it to .agents/projects/<project>/wizard-<slug>.sh. Commit it into the repository's scripts/ only when the user wants a repeatable setup path.