$ the-wire · showcase
Shopify CLI ships public design guidance for contributors
By RepoJournal · Filed · About Shopify · Composed from the cited sources · methodology
Shopify CLI moved its internal design article into public contributor documentation and tightened the rules for option values, help summaries, and boolean toggles, giving contributors and coding agents one published source for command design.
Document CLI design guidance for contributors Shopify/cli
The internal CLI design article is now public contributor guidance, and coding agents are routed to its design, syntax, and UI rules. Command outcomes and flows are kept separate from the existing syntax and UI content, so new commands and flows have a documented standard instead of one held in internal design files.
Use hyphens only in multi-word option values Shopify/cli
Hyphens are now reserved for multi-word option values, a change to how options are named and parsed. Anyone authoring flag and value names should check existing usage against the new rule.
Clarify help summaries and boolean feature toggles Shopify/cli
Help summaries and boolean feature toggles got clarification in the guidance, spelling out how toggles should read in help output.
Address CLI design guidance review feedback Shopify/cli
Review feedback on the design guidance was folded back in, along with the merge of the documentation branch, so the published rules reflect the reviewed version rather than the first draft.