cli: make bundled help self-describing

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

@@ -23,6 +23,11 @@ func newTaskCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "task",
 		Short: "Task management commands",
+		Long: helpLong(
+			"Use task commands to define schedulable work inside one run.",
+			"Tasks should be small enough to inspect, dispatch, retry, and reconcile independently.",
+		),
+		Example: `  orch --db .agents/coord.db task add --run blog_mvp_001 --task T1 --title "Implement backend" --default-to backend-worker`,
 	}
 
 	cmd.AddCommand(newTaskAddCmd(root))
@@ -35,6 +40,12 @@ func newTaskAddCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "add",
 		Short: "Add a task to a run",
+		Long: helpLong(
+			"Use task add to register one schedulable task inside a run.",
+			"Tasks may include a default worker target, priority, and optional acceptance JSON that downstream tooling can inspect.",
+			"A task must belong to an existing run before it can become ready or be dispatched.",
+		),
+		Example: `  orch --db .agents/coord.db task add --run blog_mvp_001 --task T1 --title "Implement backend" --summary "Ship the first API slice" --default-to backend-worker --priority high`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()