---

id: b9fe153c-d90c-4846-ac03-c41d2d790ae1 title: 'per-verb -h: spec pointers (flag names without docs = trial-error)' state: closed labels: [] assignees: [] milestone: null created: 2026-09-08T07:45:09Z updated: 2026-09-08T08:14:39Z

SOURCE: swarm friction #1 (verified: f0rge issue create -h lists flag NAMES only, no semantics; every agent trial-and-errored). FIX: every f0rge <cmd> -h gains one line pointing at the flag/verb docs: "docs: spec/schema.md §<cmd>" (spec is the frozen flag truth). Must fit per-cmd -h budget (250B/8 lines): byte-count each after adding. Covers issue/pr/task/label/milestone/ci/wiki/release/ merge/init/skill (issue/ci/wiki handled by the behavior agent; same canonical wording). DONE: every -h points at spec; budgets hold.