cli: make bundled help self-describing

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

@@ -22,6 +22,12 @@ func newReassignCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "reassign",
 		Short: "Reassign a blocked or failed task to another worker",
+		Long: helpLong(
+			"Use reassign to cancel the current active attempt and create a new attempt for another worker.",
+			"Like retry, reassign preserves the prior execution contract: analysis attempts stay analysis-only, and code attempts receive a fresh worktree.",
+			"Use reassign when the worker target should change, not just when the same worker should try again.",
+		),
+		Example: `  orch --db .agents/coord.db reassign --run blog_mvp_001 --task T3 --to worker-b --reason "Worker-a is blocked on a missing dependency."`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()