cli: make bundled help self-describing

packages/orch-runtime/internal/cli/orch/root.go

@@ -13,8 +13,19 @@ func NewRootCmd() *cobra.Command {
 	opts := &rootOptions{}
 
 	cmd := &cobra.Command{
-		Use:           "orch",
-		Short:         "Leader-facing scheduler and control plane",
+		Use:   "orch",
+		Short: "Leader-facing scheduler and control plane",
+		Long: helpLong(
+			"Use orch to manage leader-side scheduling for runs, tasks, dependencies, dispatch, retries, reassignment, blocked-task answers, and worktree-backed code attempts.",
+			"orch is the control plane; it creates durable handoff state in inbox but does not launch workers by itself.",
+			"After dispatch, a separate worker runtime or worker agent should claim the assigned inbox thread.",
+			"Use execution-mode analysis for thread-only work and execution-mode code for worktree-backed repository changes.",
+		),
+		Example: `  orch --db .agents/coord.db run init --run blog_mvp_001 --goal "Build blog MVP"
+  orch --db .agents/coord.db task add --run blog_mvp_001 --task T1 --title "Summarize flaky tests" --default-to qa-worker
+  orch --db .agents/coord.db ready --run blog_mvp_001
+  orch --db .agents/coord.db dispatch --run blog_mvp_001 --task T1 --execution-mode analysis --to qa-worker --body "Read the latest failures."
+  orch --db .agents/coord.db status --run blog_mvp_001`,
 		SilenceErrors: true,
 		SilenceUsage:  true,
 	}