cli: make bundled help self-describing

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

@@ -23,6 +23,13 @@ func newAnswerCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "answer",
 		Short: "Answer the active blocked question for a task",
+		Long: helpLong(
+			"Use answer to write one response back into the active blocked attempt thread for a task.",
+			"Use body for human-readable guidance, payload-json for structured decisions, or both when workers need a stable machine-readable contract.",
+			"answer targets the current active blocked attempt for the task; it is not a generic freeform message append.",
+		),
+		Example: `  orch --db .agents/coord.db answer --run blog_mvp_001 --task T2 --body "Use stdout for MVP."
+  orch --db .agents/coord.db answer --run blog_mvp_001 --task T2 --payload-json '{"decision":"stdout","source":"leader"}'`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			body, err := resolveBodyValue(opts.body, opts.bodyFile)
 			if err != nil {