Skip to content

Better in cli explanation#12

Merged
mrsimpson merged 3 commits into
mainfrom
better-in-cli-explanation
Mar 19, 2026
Merged

Better in cli explanation#12
mrsimpson merged 3 commits into
mainfrom
better-in-cli-explanation

Conversation

@mrsimpson
Copy link
Copy Markdown
Contributor

No description provided.

Users running `ade setup` had no context for what the tool does or what
each facet means. The wizard felt like a blind questionnaire. This commit
adds orientation at every step so that first-time users understand the
purpose of each choice.

- ASCII art logo (ANSI Shadow, "ADE Setup") displayed at the start of
  `ade setup`, before the clack intro
- Opening note rewritten to explain the team-oriented purpose: pick facets,
  ADE translates them into a shared information hierarchy in the repo
- Facet descriptions are now part of the prompt message itself
  (`label — description`) instead of a disconnected `log.info` line before it
- Harness prompt description folded into the multiselect message — eliminates
  the duplicate header that appeared as a separate log entry
- Skills confirm prompt now lists the individual skill names instead of
  showing a generic explanation followed by a bare count
- Catalog facet descriptions improved for clarity: process, practices,
  backpressure, autonomy options reworded and reordered (sensible-defaults
  first as the recommended default)
- Test mocks updated to include `note: vi.fn()` required by the new
  `clack.note()` call
@mrsimpson mrsimpson force-pushed the better-in-cli-explanation branch from 86f4fda to 35976d3 Compare March 19, 2026 13:37
@mrsimpson mrsimpson merged commit 1c9b85b into main Mar 19, 2026
1 check passed
@mrsimpson mrsimpson deleted the better-in-cli-explanation branch March 19, 2026 13:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant