manage-adrslisted

# Managing ADRs with adrplus `adrplus` is a cross-platform .NET CLI tool for managing Architecture Decision Records. This skill teaches you how to drive it directly, without ever going through its interactive `--wizard` mode. ## Critical rule: never use `--wizard`/`-w` `adrplus`'s wizard mode is an interactive terminal UI (arrow-key menus, live text prompts) built for a human sitting at a real terminal. You cannot drive it through the Bash tool — it will hang waiting for keystrokes it will never receive. **Always use the direct, non-interactive flags documented below instead.** If a user explicitly asks to run the wizard themselves, tell them to run the command in their own terminal — don't attempt it yourself. ## Prerequisite `adrplus` must already be installed as a .NET global tool: ```bash adrplus --version ``` If this fails, tell the user to run `dotnet tool install -g adrplus` (requires .NET 8+ runtime) before continuing. To upgrade an existing install to the latest release — including when the user asks directly how to update `adrplus`, or when the installed version is below one of the minimums in this section — the command is `dotnet tool update -g adrplus`, then re-check with `adrplus --version`. Don't wait for a crash to mention this. **Requires v1.0.0-beta3 or later (any 1.x release, including pre-releases).** Versions before beta1 drew a startup banner and could fall into an interactive first-run wizard on every command, unconditionally — both crashed or hung