cli: make bundled help self-describing

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

@@ -20,6 +20,12 @@ func newReadyCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "ready",
 		Short: "List tasks that are ready for dispatch",
+		Long: helpLong(
+			"Use ready to list tasks whose dependencies are already satisfied and can be dispatched now.",
+			"ready is a queue-inspection command only; it does not create attempts or threads.",
+		),
+		Example: `  orch --db .agents/coord.db ready --run blog_mvp_001
+  orch --db .agents/coord.db ready --run blog_mvp_001 --limit 5`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()