feat(delegate-job): support --role parameter in submit and update commands to resolve role suitability mismatches

.agents/skills/multi-agent-mux-delegate-job/SKILL.md

@@ -33,6 +33,7 @@ multi-agent-mux-delegate-job submit \
   --agent <claude-code|hermes-agent|agy-agent|cline-agent|human> \
   --agent-session tmux:<session_name> \
   --prompt "Task description or instructions here" \
+  --role <Worker|Planner|Reviewer> \
   --timeout 3600 --idle-timeout 120
 
 # 2) Submit a job with a feedback loop (Worker-Reviewer Loop)

.agents/skills/multi-agent-mux-delegate-job/multi-agent-mux-delegate-job

@@ -52,7 +52,7 @@ multi-agent-mux-delegate-job <command> [options]
 
   submit  --agent <name> --prompt <text> [--workdir <dir>] [--agent-session <label>]
           [--timeout <sec>] [--idle-timeout <sec>] [--validate <script>]
-          [--registry-dir <dir>] [--dry-run]
+          [--registry-dir <dir>] [--dry-run] [--role <role_name>]
           [--type <direct|loop|discuss>] [--reviewer <reviewer_agent>]
           [--reviewer-session <reviewer_session>] [--max-iterations <count>]
           # The skill is tmux-interactive only; --mode print was removed.
@@ -67,7 +67,7 @@ EOF
 # ---- arg parsing helpers --------------------------------------------------
 AGENT="claude-code"; PROMPT=""; WORKDIR="$(pwd)"; AGENT_SESSION="tmux:claude"
 TIMEOUT=3600; IDLE_TIMEOUT=120; VALIDATE=""; DRY_RUN=0
-JOB_ID=""; REGISTRY_DIR="$REGISTRY_DIR_DEFAULT"
+JOB_ID=""; REGISTRY_DIR="$REGISTRY_DIR_DEFAULT"; DELEGATE_ROLE="Worker"
 TYPE="direct"; REVIEWER="hermes"; REVIEWER_SESSION="tmux:hermes"; MAX_ITERATIONS=5
 
 parse_opts() {
@@ -83,6 +83,7 @@ parse_opts() {
       --job) JOB_ID="$2"; shift 2;;
       --registry-dir) REGISTRY_DIR="$2"; shift 2;;
       --dry-run) DRY_RUN=1; shift;;
+      --role) DELEGATE_ROLE="$2"; shift 2;;
       --type) TYPE="$2"; shift 2;;
       --reviewer) REVIEWER="$2"; shift 2;;
       --reviewer-session) REVIEWER_SESSION="$2"; shift 2;;
@@ -101,7 +102,7 @@ cmd_submit() {
 
   # 1) register job (prints the new job id)
   JOB_ID="$("$PY" "$SCRIPT_DIR/scripts/registry.py" --registry-dir "$REGISTRY_DIR" register \
-      --prompt "$PROMPT" --agent "$AGENT" --agent-session "$AGENT_SESSION" \
+      --prompt "$PROMPT" --agent "$AGENT" --agent-session "$AGENT_SESSION" --role "$DELEGATE_ROLE" \
       --timeout "$TIMEOUT" --idle-timeout "$IDLE_TIMEOUT" \
       --job-type "$TYPE" --reviewer "$REVIEWER" --reviewer-session "$REVIEWER_SESSION" \
       --max-iterations "$MAX_ITERATIONS")"
@@ -116,7 +117,7 @@ cmd_submit() {
 
 - **Job ID**: $JOB_ID
 - **Target Agent**: $AGENT (session: $AGENT_SESSION)
-- **Role**: Worker
+- **Role**: $DELEGATE_ROLE
 - **Timeout**: $TIMEOUT s (Idle: $IDLE_TIMEOUT s)
 - **Output Report Path**: .mam/jobs/$JOB_ID/$AGENT-reports/report-final.md
 
@@ -238,6 +239,7 @@ EOF
           --agent-session "$current_session" \
           --prompt "$current_prompt" \
           --iteration "$iteration" \
+          --role "$current_role" \
           --status "pending"
 
       # Start subscriber

.agents/skills/multi-agent-mux-delegate-job/scripts/registry.py

@@ -51,6 +51,7 @@ def register_job(
     prompt: str,
     agent: str = "claude-code",
     agent_session: str = "tmux:claude",
+    role: str = "Worker",
     broker: Optional[Dict[str, Any]] = None,
     timeout_sec: int = 3600,
     idle_timeout_sec: int = 120,
@@ -87,6 +88,7 @@ def register_job(
         "prompt": prompt,
         "agent": agent,
         "agent_session": agent_session,
+        "role": role,
         "broker": broker,
         "topic_prefix": topic_prefix_for(job_id),
         "timeout_sec": int(timeout_sec),
@@ -239,6 +241,7 @@ def _build_parser() -> argparse.ArgumentParser:
     p_reg.add_argument("--prompt", required=True)
     p_reg.add_argument("--agent", default="claude-code")
     p_reg.add_argument("--agent-session", default="tmux:claude")
+    p_reg.add_argument("--role", default="Worker", help="logical role for the delegated agent (e.g. Worker, Planner, Reviewer)")
     p_reg.add_argument("--timeout", type=int, default=3600)
     p_reg.add_argument("--idle-timeout", type=int, default=120)
     p_reg.add_argument("--bits", type=int, default=32, help="32 (PoC) or 128 (prod)")
@@ -266,6 +269,7 @@ def _build_parser() -> argparse.ArgumentParser:
     p_update.add_argument("--agent-session", default=None)
     p_update.add_argument("--prompt", default=None)
     p_update.add_argument("--iteration", type=int, default=None)
+    p_update.add_argument("--role", default=None)
 
     p_feedback = sub.add_parser("get-feedback", help="get the last feedback detail (completed/error) for a job")
     p_feedback.add_argument("--job", required=True)
@@ -302,6 +306,7 @@ def main(argv: Optional[List[str]] = None) -> int:
             prompt=args.prompt,
             agent=args.agent,
             agent_session=args.agent_session,
+            role=args.role,
             timeout_sec=args.timeout,
             idle_timeout_sec=args.idle_timeout,
             registry_dir=rd,
@@ -354,6 +359,8 @@ def main(argv: Optional[List[str]] = None) -> int:
             fields["prompt"] = args.prompt
         if args.iteration is not None:
             fields["iteration"] = args.iteration
+        if args.role is not None:
+            fields["role"] = args.role
         try:
             mqtt_common.update_job_status(args.job, rd, **fields)
         except FileNotFoundError as exc: