cli: make bundled help self-describing

2026-03-22 23:37:38 +08:00
parent 5859ff219e
commit 4d8c90eb26
49 changed files with 792 additions and 29 deletions
@@ -6,6 +6,14 @@ func newCouncilCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "council",
 		Short: "Council review workflow commands",
+		Long: helpLong(
+			"Use council commands for the three-reviewer analysis workflow built on top of orch runs, tasks, and inbox threads.",
+			"council is analysis-oriented and is meant for grouped review output rather than direct code-writing execution.",
+		),
+		Example: `  orch --db .agents/coord.db council start --run council_blog_001 --target "Review the current architecture."
+  orch --db .agents/coord.db council wait --run council_blog_001 --timeout-seconds 600
+  orch --db .agents/coord.db council tally --run council_blog_001
+  orch --db .agents/coord.db council report --run council_blog_001`,
 	}

 	cmd.AddCommand(newCouncilStartCmd(root))