Development record
The command surface needs another consistency review on three axes. (1) Human verbs versus agent verbs: which commands a person types and which only an agent drives (the plugin pages' user-invocable split), and whether each is named and documented for its real audience. (2) Verbs versus nouns: some commands are actions and some are things, for example abcd drain (a verb) beside abcd lab (a noun), with no stated rule for which form a command takes. (3) Consistent flags: the same idea should be spelt the same way on every command, for example a select-everything flag (drain takes --max for a cap; is there an --all?), --dry-run against a bare read-only form, --apply, --json, --release and --take-over. Raised by the product thinker on 2026-10-23.
The command surface needs another consistency review on three axes. (1) Human verbs versus agent verbs: which commands a person types and which only an agent drives (the plugin pages' user-invocable split), and whether each is named and documented for its real audience. (2) Verbs versus nouns: some commands are actions and some are things, for example abcd drain (a verb) beside abcd lab (a noun), with no stated rule for which form a command takes. (3) Consistent flags: the same idea should be spelt the same way on every command, for example a select-everything flag (drain takes --max for a cap; is there an --all?), --dry-run against a bare read-only form, --apply, --json, --release and --take-over. Raised by the product thinker on 2026-10-23.
Frontmatter
| id | iss-2610230734298145 |
|---|---|
| type | issue |
| lifecycle | open |
| severity | minor |
.abcd/work/issues/open/iss-2610230734298145-the-command-surface-needs-another.md
open on GitHub ↗ · commit history ↗