id: b12b0403-81a7-40c9-9d8e-7a1654d7a800 title: '--json placement: trailing per-command (gh-literal); usage lines lied' state: closed labels: [] assignees: [] milestone: null created: 2026-09-08T07:44:29Z updated: 2026-09-08T08:14:39Z
SOURCE: swarm friction #2 (verified: f0rge --json issue list =
human format, flag eaten by root; f0rge issue list --json works).
gh-literal: --json/--jq are per-command TRAILING; root only routes
--skill. FIX docs (truth, not code): root help usage line
"f0rge [--json|--jq E|--skill] <cmd> [args]"
-> "f0rge [--skill] <cmd> [--json|--jq E] [args]"; skill usage line
"[--json] <cmd> [args]" -> "<cmd> [--json] [args]" (byte-neutral);
every verb -h usage line says trailing. Optional (not now): thread
leading --json through. DONE: every usage line truthful;
f0rge --json issue list being human is no longer claimed anywhere.