Skip to main content
Glama
mcp-github-project-manager

mcp-github-project-manager

by kunwarVivek

Agent Management

agent_manage
Destructive

Manage project agents by listing or deregistering them, tracking activity and work products, setting token budgets, reclaiming stale assignments, and balancing workloads.

Instructions

Agent management: list/deregister agents, activity, work products, budgets (warningFraction), stale reclaim, smart assignment, workload rebalancing, convergence, and registry cleanup. Use the action field to select the operation.

Input Schema

NameRequiredDescriptionDefault
roleNo
actionYes
branchNo
statusNo
taskIdNo
agentIdNo
summaryNo
agentIdsNo
hardStopNo
prNumberNo
subtasksNoSubtasks for decompose_task — PM splits a rejected task into smaller pieces
iterationNo
projectIdNo
commitShasNo
reviewerIdNoReviewer agent to attribute approve/reject lifecycle actions to, when available
roleFilterNo
testsTotalNo
tokensUsedNo
issueNumberNo
resetPeriodNo
testsFailedNo
testsPassedNo
totalTokensNo
filesChangedNo
maxIterationsNo
includeOfflineNo
maxAssignmentsNo
timeoutMinutesNo
warningFractionNoWarning threshold as a 0-1 fraction
staleAfterMinutesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv4.0.0
    • changedInput schema / oneOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "list",
      -        "type": "string"
      -      },
      -      "role": {
      -        "enum": [
      -          "engineer",
      -          "reviewer",
      -          "pm",
      -          "designer",
      -          "qa",
      -          "devops",
      -          "general"
      -        ],
      -        "type": "string"
      -      },
      -      "status": {
      -        "enum": [
      -          "idle",
      -          "working",
      -          "blocked",
      -          "needs_review",
      -          "offline",
      -          "budget_exhausted"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "deregister",
      -        "type": "string"
      -      },
      -      "agentId": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "agentId",
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "get_activity",
      -        "type": "string"
      -      },
      -      "includeOffline": {
      -        "default": false,
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "submit_work_product",
      -        "type": "string"
      -      },
      -      "agentId": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "branch": {
      -        "type": "string"
      -      },
      -      "commitShas": {
      -        "default": [],
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "filesChanged": {
      -        "default": [],
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "issueNumber": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "prNumber": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "summary": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "taskId": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "testsFailed": {
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "testsPassed": {
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "testsTotal": {
      -        "minimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "agentId",
      -      "taskId",
      -      "issueNumber",
      -      "summary",
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "get_budget",
      -        "type": "string"
      -      },
      -      "agentId": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "agentId",
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "set_budget",
      -        "type": "string"
      -      },
      -      "agentId": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "hardStop": {
      -        "default": true,
      -        "type": "boolean"
      -      },
      -      "resetPeriod": {
      -        "enum": [
      -          "daily",
      -          "weekly",
      -          "monthly",
      -          "never"
      -        ],
      -        "type": "string"
      -      },
      -      "totalTokens": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "warningFraction": {
      -        "description": "Warning threshold as a 0-1 fraction",
      -        "maximum": 1,
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "warningThreshold": {
      -        "description": "Compatibility alias for warningFraction (0-1 warning threshold)",
      -        "maximum": 1,
      -        "minimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "agentId",
      -      "totalTokens",
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "reclaim_stale",
      -        "type": "string"
      -      },
      -      "timeoutMinutes": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "record_usage",
      -        "type": "string"
      -      },
      -      "agentId": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "tokensUsed": {
      -        "minimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "agentId",
      -      "tokensUsed",
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "get_metrics",
      -        "type": "string"
      -      },
      -      "staleAfterMinutes": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "setup_fields",
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "projectId",
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "assign_task",
      -        "type": "string"
      -      },
      -      "agentId": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "issueNumber": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "projectId": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "agentId",
      -      "projectId",
      -      "issueNumber"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "get_swarm_status",
      -        "type": "string"
      -      },
      -      "staleAfterMinutes": {
      -        "default": 30,
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "rebalance_workload",
      -        "type": "string"
      -      },
      -      "agentIds": {
      -        "description": "Filter reassignment to specific agent IDs",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "maxAssignments": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "projectId": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "roleFilter": {
      -        "description": "Filter reassignment to agents with this role",
      -        "type": "string"
      -      },
      -      "staleAfterMinutes": {
      -        "default": 30,
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "projectId"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "decompose_task",
      -        "type": "string"
      -      },
      -      "issueNumber": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "projectId": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "subtasks": {
      -        "description": "Subtasks for decompose_task — PM splits a rejected task into smaller pieces",
      -        "items": {
      -          "properties": {
      -            "acceptanceCriteria": {
      -              "type": "string"
      -            },
      -            "description": {
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "title": {
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "title",
      -            "description"
      -          ],
      -          "type": "object"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "projectId",
      -      "issueNumber",
      -      "subtasks"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "smart_assign",
      -        "type": "string"
      -      },
      -      "agentIds": {
      -        "description": "Filter smart_assign to specific agent IDs",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "maxAssignments": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "projectId": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "roleFilter": {
      -        "description": "Filter smart_assign to agents with this role",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "projectId"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "converge_project",
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "reviewerId": {
      -        "description": "Reviewer agent to attribute approve/reject lifecycle actions to, when available",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "projectId"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "converge_until_done",
      -        "type": "string"
      -      },
      -      "iteration": {
      -        "default": 1,
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "maxIterations": {
      -        "default": 10,
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "projectId": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "projectId"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "action": {
      -        "const": "cleanup_registry",
      -        "type": "string"
      -      },
      -      "staleAfterMinutes": {
      -        "default": 60,
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "action"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "list",
      +        "type": "string"
      +      },
      +      "role": {
      +        "enum": [
      +          "engineer",
      +          "reviewer",
      +          "pm",
      +          "designer",
      +          "qa",
      +          "devops",
      +          "general"
      +        ],
      +        "type": "string"
      +      },
      +      "status": {
      +        "enum": [
      +          "idle",
      +          "working",
      +          "blocked",
      +          "needs_review",
      +          "offline",
      +          "budget_exhausted"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "deregister",
      +        "type": "string"
      +      },
      +      "agentId": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "agentId",
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "get_activity",
      +        "type": "string"
      +      },
      +      "includeOffline": {
      +        "default": false,
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "submit_work_product",
      +        "type": "string"
      +      },
      +      "agentId": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "branch": {
      +        "type": "string"
      +      },
      +      "commitShas": {
      +        "default": [],
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "filesChanged": {
      +        "default": [],
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "issueNumber": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "prNumber": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "summary": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "taskId": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "testsFailed": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "testsPassed": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "testsTotal": {
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "agentId",
      +      "taskId",
      +      "issueNumber",
      +      "summary",
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "get_budget",
      +        "type": "string"
      +      },
      +      "agentId": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "agentId",
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "set_budget",
      +        "type": "string"
      +      },
      +      "agentId": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "hardStop": {
      +        "default": true,
      +        "type": "boolean"
      +      },
      +      "resetPeriod": {
      +        "enum": [
      +          "daily",
      +          "weekly",
      +          "monthly",
      +          "never"
      +        ],
      +        "type": "string"
      +      },
      +      "totalTokens": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "warningFraction": {
      +        "description": "Warning threshold as a 0-1 fraction",
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "agentId",
      +      "totalTokens",
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "reclaim_stale",
      +        "type": "string"
      +      },
      +      "timeoutMinutes": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "record_usage",
      +        "type": "string"
      +      },
      +      "agentId": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "tokensUsed": {
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "agentId",
      +      "tokensUsed",
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "get_metrics",
      +        "type": "string"
      +      },
      +      "staleAfterMinutes": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "setup_fields",
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "projectId",
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "assign_task",
      +        "type": "string"
      +      },
      +      "agentId": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "issueNumber": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "projectId": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "agentId",
      +      "projectId",
      +      "issueNumber"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "get_swarm_status",
      +        "type": "string"
      +      },
      +      "staleAfterMinutes": {
      +        "default": 30,
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "rebalance_workload",
      +        "type": "string"
      +      },
      +      "agentIds": {
      +        "description": "Filter reassignment to specific agent IDs",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "maxAssignments": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "projectId": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "roleFilter": {
      +        "description": "Filter reassignment to agents with this role",
      +        "type": "string"
      +      },
      +      "staleAfterMinutes": {
      +        "default": 30,
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "projectId"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "decompose_task",
      +        "type": "string"
      +      },
      +      "issueNumber": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "projectId": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "subtasks": {
      +        "description": "Subtasks for decompose_task — PM splits a rejected task into smaller pieces",
      +        "items": {
      +          "properties": {
      +            "acceptanceCriteria": {
      +              "type": "string"
      +            },
      +            "description": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "title": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "title",
      +            "description"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "projectId",
      +      "issueNumber",
      +      "subtasks"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "smart_assign",
      +        "type": "string"
      +      },
      +      "agentIds": {
      +        "description": "Filter smart_assign to specific agent IDs",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "maxAssignments": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "projectId": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "roleFilter": {
      +        "description": "Filter smart_assign to agents with this role",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "projectId"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "converge_project",
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "reviewerId": {
      +        "description": "Reviewer agent to attribute approve/reject lifecycle actions to, when available",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "projectId"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "converge_until_done",
      +        "type": "string"
      +      },
      +      "iteration": {
      +        "default": 1,
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "maxIterations": {
      +        "default": 10,
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "projectId": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "projectId"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "const": "cleanup_registry",
      +        "type": "string"
      +      },
      +      "staleAfterMinutes": {
      +        "default": 60,
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "action"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / warningThreshold
      Removed value: -{
      -  "description": "Compatibility alias for warningFraction (0-1 warning threshold)",
      -  "maximum": 1,
      -  "minimum": 0,
      -  "type": "number"
      -}
  2. Addedv3.0.0

TDQS

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, openWorldHint=true, and readOnlyHint=false, so the description's burden is to say which of the 18 actions are actually destructive. It does not: `deregister`, `reclaim_stale`, and `cleanup_registry` delete or steal state, while `list`, `get_activity`, `get_budget`, and `get_metrics` are pure reads, and nothing signals that split. Side effects of `converge_until_done` (looping up to maxIterations, mutating issues) are also undisclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, so it is compact for an 18-action tool, and the routing instruction is placed last where it is easy to find. However, the comma-separated keyword dump is unstructured and mixes registers ('list/deregister agents') with vague abstractions ('convergence'), so density comes at the cost of parseability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 18-branch union with 30 parameters, 10% schema coverage, no output schema, and a destructive annotation, this description is far too thin to call correctly without trial and error. It lists the action families but supplies none of the per-action contract (required fields, side effects, return shape, iteration limits) that an agent would need.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 10% across 30 parameters, so the description must compensate, and it does not. The one parameter it names, `warningFraction`, is already documented in the schema, and there is no explanation of `staleAfterMinutes` vs `timeoutMinutes`, `maxAssignments`, `roleFilter`, `hardStop`, `reviewerId`, or the `subtasks` shape for `decompose_task`. At most it clarifies that `action` selects a union branch.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description enumerates the domains covered (agents, activity, work products, budgets, reclaim, assignment, rebalancing, convergence, cleanup), so an agent can tell this is the agent-lifecycle/registry tool. But the enumeration is a bare noun list with verbs missing for most entries, and nothing distinguishes it from sibling `agent_work` (agent-side task operations) or `manage_project` (PM coordination). The scope is discernible but not sharply defined.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The only guidance is 'Use the `action` field to select the operation', which restates the schema's discriminator rather than telling the caller when to pick this tool over `agent_work` or `manage_project`. There is no indication of which actions are read-only inspection versus mutating cleanup, nor any prerequisite or ordering advice (e.g. list before deregister, set_budget before record_usage).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.