/docs (bro)

All mechanics live in the bro CLI. This skill is policy only.

bro's document surface is noun-first, gh-style: bro <noun> <verb> [ref…] [--flags]. Doc types are plugin-registered (task, store); a type's adapter methods are the verb registry — there is no verb list to consult. Verbs live inside their noun's namespace, so plugin doc types may define any custom verbs freely.

Shorthand: task verbs also work verb-first — bro list, bro show <id>, bro close <id> mean bro task …. A bare ref infers the type from its prefix; a bare noun (bro task, bro store) means list.

The doc namespace is guarded, not declared: reserved words = plugin command names ∪ doc nouns/aliases ∪ shorthand verbs. A plugin taking a reserved name, or a doc type colliding on noun/alias/idPrefix, is skipped with a warning — everything else is usable.