id: 65a43d67-b32d-42bb-9957-25d259d40818 title: 'per-verb -h: verb-depth help with real flags/positionals (currently generic block)' state: closed labels: [] assignees: [] milestone: null created: 2026-09-08T09:42:24.503621660Z updated: 2026-09-08T10:11:04.967793303Z
SOURCE: swarm friction #2 (verified: f0rge issue create -h prints
the SAME block as f0rge issue -h — no per-verb flags; agents
trial-error --title/--body/positionals). FIX: verb-depth help:
f0rge <cmd> <verb> -h prints that verb's actual flags +
positionals (small consts declared next to each parser arm;
hand-maintained; needle tests pin them so they don't drift).
Domain f0rge <cmd> -h keeps the verb map + spec pointer. Be
truthful about positionals: label create <name>, wiki put <path>
[stdin | -], release create <ver> --notes <file|-> [--title S],
pr create --base B --head H --issue <uuid>, task create --title S
[--body S --column C], issue create --title S [--body S --label L
--assignee A --milestone M]. Each -h stays <=250B/8 lines
(byte-count all). DONE: every task/create-level -h shows its real
surface; a fresh agent can create anything first-try.