Skip to main content
Glama

rigor_plan

Read-onlyIdempotent

Before executing a complex task, get a structured workflow plan with per-step cost estimates. Classifies your task, selects the optimal framework sequence, and returns the full plan without executing anything. The response's allowed_modes tells you whether this plan is eligible for direct execution. Free — no credits charged.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "task_description": "<task_description>"
    },
    "name": "rigor_plan"
  }
}

Input Schema

NameRequiredDescriptionDefault
contextNoAdditional context for the workflow. Persisted with a plan, so an execute by workflow_id inherits it unless it sends its own.
agent_idNoYour own label for the calling agent, at most 200 characters. Recorded on the workflow and its cost rows; never used for routing or authorization.
languageNoBCP 47 language code for the deliverable (for example "fr", "ja", "pt-BR"). Overrides the organization default.
task_typeNoOptional hint to bypass automatic classification. Passing it also removes the slowest classification tiers from the critical path, so send it whenever you know the shape. Multi-step deliverable types: solution_design, requirements_analysis, code_implementation, code_review, bug_fix, root_cause_analysis, incident_response, deployment_execution, competitive_scan, financial_analysis, research_task, documentation, governance_change, compliance_audit, data_security_assessment, performance_optimization, user_story_definition, implementation_prompt_generation. Atomic single-call types, which auto-select direct execution: tag, score, rerank, compose, extract_entities, parse_query, quick_research, quick_classification, quick_extraction, quick_scoring. GET /api/rigor/task-types lists the full vocabulary with each type's shape.
preferencesNoOptional workflow preferences. The same shape on plan and execute; a plan stores them, and an execute by workflow_id inherits them.
context_fieldsNoOptional, with prior_workflow_id: the fields to carry over. Pass ["full_step_results"] for every step output in full.
task_descriptionYesNatural language description of the task, at least 2 words and at most 4,000 characters (200,000 across it and context.additional_context when task_type is compose). Be specific: include what you want produced, constraints, and context. Example: 'Design a caching layer for our API gateway with Redis integration.'
prior_workflow_idNoOptional: the workflow_id (wr_…) of a finished workflow in your workspace to build on. Its results are passed to this run as context. It is charged as a new run at the normal quote.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / preferences / properties / output_contract / description
      Previous value: -"Only read when execution is \"direct\". Declares the JSON shape you want back, so the answer is generated against your schema (Anthropic forced tool-use, or an OpenAI-compatible json_schema response format) and validated against it before return, instead of returned as prose you have to parse. A conforming run also skips the quality-review call, costing 1 LLM call rather than 2. The schema is closed: a record carrying an undeclared key is rejected exactly like one missing a required key. Persists with the plan, so a later execute against the stored workflow_id inherits it. Not the same shape as the inference gateway's output_contract, which carries the items an answer must account for rather than a record schema."New value: +"Only read when execution is \"direct\". Declares the JSON shape you want back, so the answer is generated against your schema (Anthropic forced tool-use, or an OpenAI-compatible json_schema response format) and validated against it before return, instead of returned as prose you have to parse. A conforming run also skips the quality-review call, costing 1 LLM call rather than 2. The schema is closed: a record carrying an undeclared key is rejected exactly like one missing a required key. An answer that breaks the contract is retried once with the violations as feedback; if it still breaks it, the run fails and is refunded, never billed. A contract no answer can meet (an empty enum, a minimum above its maximum, duplicate field names) is refused with 400 before any call, and an organisation with 10 refunded contract failures in 24 hours gets 429 until the oldest leaves the window. Persists with the plan, so a later execute against the stored workflow_id inherits it; that execute may omit the field or repeat it unchanged, and a different contract there is refused with 400 (plan again to change it). Not the same shape as the inference gateway's output_contract, which carries the items an answer must account for rather than a record schema."
  2. Changed24 schema fields changed
    • addedInput schema / properties / agent_id
      Added value: +{
      +  "description": "Your own label for the calling agent, at most 200 characters. Recorded on the workflow and its cost rows; never used for routing or authorization.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
    • addedInput schema / properties / context
      Added value: +{
      +  "description": "Additional context for the workflow. Persisted with a plan, so an execute by workflow_id inherits it unless it sends its own.",
      +  "properties": {
      +    "additional_context": {
      +      "description": "Free-form context the workflow steps can reference, at most 16,000 characters (more for compose, see task_description).",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / language
      Added value: +{
      +  "description": "BCP 47 language code for the deliverable (for example \"fr\", \"ja\", \"pt-BR\"). Overrides the organization default.",
      +  "type": "string"
      +}
    • changedInput schema / properties / preferences / description
      Previous value: -"Optional workflow preferences."New value: +"Optional workflow preferences. The same shape on plan and execute; a plan stores them, and an execute by workflow_id inherits them."
    • changedInput schema / properties / preferences / properties / add_frameworks / description
      Previous value: -"Inject additional frameworks into the plan."New value: +"Frameworks to inject into the sequence: a name, or { name, before_step } to choose the position."
    • addedInput schema / properties / preferences / properties / add_frameworks / items / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "properties": {
      +      "before_step": {
      +        "description": "Zero-based index into the filtered sequence before which to insert it.",
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "name": {
      +        "description": "Framework display name or ID.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "name",
      +      "before_step"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / preferences / properties / add_frameworks / items / type
      Removed value: -"string"
    • addedInput schema / properties / preferences / properties / approval_before_step / items / minimum
      Added value: +0
    • changedInput schema / properties / preferences / properties / approval_before_step / items / type
      Previous value: -"number"New value: +"integer"
    • addedInput schema / properties / preferences / properties / cache_prefix_chars
      Added value: +{
      +  "description": "How many leading characters of task_description stay the same across your calls. Direct execution marks that prefix for the provider's prompt cache, so repeated calls read it from cache. Absent or 0 declares nothing.",
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / properties / preferences / properties / execution / description
      Previous value: -"Set to 'direct' to compose the plan's content frameworks into a single LLM call and route cost-first, using a per-task-type model floor that moves when a cheaper model earns the work. Research steps, process steps (classification-verify, review protocol, synthesis) and the quality review each remain separate calls, so this is not a one-call-per-workflow guarantee: for atomic task types, which have a single content framework, the call count matches standard execution and the saving is the model. Supplying output_contract replaces the quality-review call with deterministic validation, which is one fewer call. No intermediate outputs. Available at every tier. Auto-selected for atomic task types when no execution preference is given. Falls back to standard execution when combined with require_approval or interactive mode, or when the plan exceeds the composition size limit. With attachments or prior_workflow_id, the workflow runs as standard execution instead, so the attachments and the earlier results are applied."New value: +"Set to 'direct' to compose the plan's content frameworks into a single LLM call and route cost-first, using a per-task-type model floor that moves when a cheaper model earns the work. Research steps, process steps (classification-verify, review protocol, synthesis) and the quality review each remain separate calls, so this is not a one-call-per-workflow guarantee: for atomic task types, which have a single content framework, the call count matches standard execution and the saving is the model. Supplying output_contract replaces the quality-review call with deterministic validation, which is one fewer call. No intermediate outputs. Available at every tier. Auto-selected for atomic task types when no execution preference is given. Some atomic task types (for example cluster) run in direct mode only and are refused with 422 direct_mode_unavailable rather than falling back. Others fall back to standard execution when combined with require_approval or interactive mode, or when the plan exceeds the composition size limit. With attachments or prior_workflow_id, the workflow runs as standard execution instead, so the attachments and the earlier results are applied."
    • addedInput schema / properties / preferences / properties / independent_of
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Model creators and model ids that must not receive this workflow's content (for example when it grades output one model family produced). Covers every model call Rigor makes for the workflow: planning (classification, intent extraction, title), every step, research agents, review and quality checks, retrieval over files attached to the workflow, and per-step quality grading after the workflow ends. Not covered: processing when a file is uploaded (text extraction, audio and video transcription, indexing) and POST /api/rigor/enhance. A hard constraint: an excluded model, or one whose creator cannot be confirmed, is skipped; a step with no model left fails the workflow with policy_rule no_independent_model and is refunded; an optional planning or grading call with no model left is skipped. Not relaxed by any workspace policy enforcement mode. Fixed when the workflow is planned: an execute call on a stored plan that sends a different value is refused with 400; entry order does not matter.",
      +  "minProperties": 1,
      +  "properties": {
      +    "families": {
      +      "description": "Model creators: anthropic, deepseek, google, minimax, mistral, moonshot, openai, qwen, xai or zhipu. Case does not matter; any other name is refused with 400.",
      +      "items": {
      +        "maxLength": 64,
      +        "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
      +        "type": "string"
      +      },
      +      "maxItems": 20,
      +      "type": "array"
      +    },
      +    "models": {
      +      "description": "Model ids. A dated version or -latest alias of a listed id is excluded too.",
      +      "items": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "maxItems": 20,
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • changedInput schema / properties / preferences / properties / max_budget_usd / description
      Previous value: -"Spending ceiling in USD. If the plan's quote is still above it after Rigor fits the plan (cheaper models, optional steps dropped), rigor_plan returns a max_budget_exceeded warning and rigor_execute refuses with 402 max_budget_exceeded before anything runs or is charged."New value: +"Spending ceiling in USD. If the plan's quote is still above it after Rigor fits the plan (cheaper models, optional steps dropped), the plan returns a max_budget_exceeded warning and execute refuses with 402 max_budget_exceeded before anything runs or is charged."
    • addedInput schema / properties / preferences / properties / max_budget_usd / exclusiveMinimum
      Added value: +0
    • addedInput schema / properties / preferences / properties / model_preference
      Added value: +{
      +  "description": "LLM model selection bias.",
      +  "enum": [
      +    "quality_first",
      +    "cost_optimized",
      +    "balanced"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / preferences / properties / only_frameworks / description
      Previous value: -"Restrict the plan to these frameworks (display name or ID). Applied before skip_frameworks; unknown names are reported in warnings."New value: +"Restrict the plan to these frameworks (display name or ID). Applied before skip_frameworks; unknown names are reported in warnings, and if none resolves the request is refused with 400 UNKNOWN_FRAMEWORK."
    • changedInput schema / properties / preferences / properties / output_contract / description
      Previous value: -"Only read when execution is \"direct\". Declares the JSON shape you want back, so the answer is generated against your schema and validated against it before return, instead of returned as prose you have to parse. A conforming run also skips the quality-review call, costing 1 LLM call rather than 2. The schema is closed: a record carrying an undeclared key is rejected exactly like one missing a required key."New value: +"Only read when execution is \"direct\". Declares the JSON shape you want back, so the answer is generated against your schema (Anthropic forced tool-use, or an OpenAI-compatible json_schema response format) and validated against it before return, instead of returned as prose you have to parse. A conforming run also skips the quality-review call, costing 1 LLM call rather than 2. The schema is closed: a record carrying an undeclared key is rejected exactly like one missing a required key. Persists with the plan, so a later execute against the stored workflow_id inherits it. Not the same shape as the inference gateway's output_contract, which carries the items an answer must account for rather than a record schema."
    • addedInput schema / properties / preferences / properties / output_contract / properties / fields / items / properties / items
      Added value: +{
      +  "description": "The element schema, a field entry of this same shape. Only read when type is \"array\".",
      +  "type": "object"
      +}
    • addedInput schema / properties / preferences / properties / output_contract / properties / fields / items / properties / properties
      Added value: +{
      +  "description": "The nested field entries, each of this same shape. Only read when type is \"object\".",
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / preferences / properties / rigor_level / description
      Previous value: -"Review depth. Default auto-detected from task complexity."New value: +"Review depth. Default auto-detected from the task type. Controls analysis depth and cost."
    • addedInput schema / properties / preferences / properties / tool_scope
      Added value: +{
      +  "description": "Which framework tiers to include.",
      +  "enum": [
      +    "mandatory",
      +    "recommended",
      +    "all"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / preferences / properties / use_connections
      Added value: +{
      +  "description": "Whether the plan may read your connected sources (a GitHub repository, an MCP server). false attaches none; true attaches all. Omitted, a source is attached only when the task is work on code or names a file, your own code, or the source itself.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / task_description / description
      Previous value: -"Natural language description of the task, at most 4,000 characters. Be specific — include what you want produced, constraints, and context. Example: 'Design a caching layer for our API gateway with Redis integration.'"New value: +"Natural language description of the task, at least 2 words and at most 4,000 characters (200,000 across it and context.additional_context when task_type is compose). Be specific: include what you want produced, constraints, and context. Example: 'Design a caching layer for our API gateway with Redis integration.'"
    • changedInput schema / properties / task_type / description
      Previous value: -"Optional hint to bypass automatic classification. Passing it also removes the slowest classification tiers from the critical path, so send it whenever you know the shape. Multi-step deliverable types: solution_design, requirements_analysis, code_implementation, code_review, bug_fix, root_cause_analysis, incident_response, deployment_execution, competitive_scan, financial_analysis, research_task, documentation, governance_change, compliance_audit, data_security_assessment, performance_optimization, user_story_definition, implementation_prompt_generation. Atomic single-call types, which auto-select direct execution: tag, score, rerank, compose, extract_entities, parse_query, quick_research, quick_classification, quick_extraction, quick_scoring. Call GET /api/rigor/task-types for the full vocabulary with each type's shape."New value: +"Optional hint to bypass automatic classification. Passing it also removes the slowest classification tiers from the critical path, so send it whenever you know the shape. Multi-step deliverable types: solution_design, requirements_analysis, code_implementation, code_review, bug_fix, root_cause_analysis, incident_response, deployment_execution, competitive_scan, financial_analysis, research_task, documentation, governance_change, compliance_audit, data_security_assessment, performance_optimization, user_story_definition, implementation_prompt_generation. Atomic single-call types, which auto-select direct execution: tag, score, rerank, compose, extract_entities, parse_query, quick_research, quick_classification, quick_extraction, quick_scoring. GET /api/rigor/task-types lists the full vocabulary with each type's shape."
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
      -  "properties": {
      -    "generated_title": {
      -      "type": "string"
      -    },
      -    "ok": {
      -      "type": "boolean"
      -    },
      -    "plan": {
      -      "properties": {
      -        "allowed_modes": {
      -          "description": "Execution modes available for this plan beyond the standard multi-call default. Contains 'direct' when the plan is eligible for direct execution; empty array when it is not.",
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        "alternatives": {
      -          "type": "object"
      -        },
      -        "classification": {
      -          "properties": {
      -            "task_type": {
      -              "type": "string"
      -            },
      -            "value_class": {
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "cost": {
      -          "properties": {
      -            "credits": {
      -              "type": "number"
      -            },
      -            "range": {
      -              "type": "object"
      -            },
      -            "usd": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "info": {
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        "rigor_level": {
      -          "type": "string"
      -        },
      -        "sequence": {
      -          "items": {
      -            "properties": {
      -              "estimated_credits": {
      -                "type": "number"
      -              },
      -              "name": {
      -                "type": "string"
      -              },
      -              "step": {
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "warnings": {
      -          "items": {
      -            "properties": {
      -              "code": {
      -                "type": "string"
      -              },
      -              "message": {
      -                "type": "string"
      -              },
      -              "suggestion": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "workflow_id": {
      -          "type": "string"
      -        }
      -      },
      -      "type": "object"
      -    }
      -  },
      -  "type": "object"
      -}New value: +null
  4. Changed3 schema fields changed
    • addedInput schema / properties / context_fields
      Added value: +{
      +  "description": "Optional, with prior_workflow_id: the fields to carry over. Pass [\"full_step_results\"] for every step output in full.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / preferences / properties / execution / description
      Previous value: -"Set to 'direct' to compose the plan's content frameworks into a single LLM call and route cost-first, using a per-task-type model floor that moves when a cheaper model earns the work. Research steps, process steps (classification-verify, review protocol, synthesis) and the quality review each remain separate calls, so this is not a one-call-per-workflow guarantee: for atomic task types, which have a single content framework, the call count matches standard execution and the saving is the model. Supplying output_contract replaces the quality-review call with deterministic validation, which is one fewer call. No intermediate outputs. Available at every tier. Auto-selected for atomic task types when no execution preference is given. Falls back to standard execution when combined with require_approval or interactive mode, or when the plan exceeds the composition size limit. Attachments and prior_workflow_id chaining are NOT applied — use standard execution for those."New value: +"Set to 'direct' to compose the plan's content frameworks into a single LLM call and route cost-first, using a per-task-type model floor that moves when a cheaper model earns the work. Research steps, process steps (classification-verify, review protocol, synthesis) and the quality review each remain separate calls, so this is not a one-call-per-workflow guarantee: for atomic task types, which have a single content framework, the call count matches standard execution and the saving is the model. Supplying output_contract replaces the quality-review call with deterministic validation, which is one fewer call. No intermediate outputs. Available at every tier. Auto-selected for atomic task types when no execution preference is given. Falls back to standard execution when combined with require_approval or interactive mode, or when the plan exceeds the composition size limit. With attachments or prior_workflow_id, the workflow runs as standard execution instead, so the attachments and the earlier results are applied."
    • addedInput schema / properties / prior_workflow_id
      Added value: +{
      +  "description": "Optional: the workflow_id (wr_…) of a finished workflow in your workspace to build on. Its results are passed to this run as context. It is charged as a new run at the normal quote.",
      +  "type": "string"
      +}
  5. Changed3 schema fields changed
    • changedInput schema / properties / preferences / properties / only_frameworks / description
      Previous value: -"Restrict plan to only these frameworks (mutex with skip_frameworks)."New value: +"Restrict the plan to these frameworks (display name or ID). Applied before skip_frameworks; unknown names are reported in warnings."
    • changedInput schema / properties / preferences / properties / skip_frameworks / description
      Previous value: -"Framework names to exclude from the plan."New value: +"Frameworks to exclude, by the display name the plan shows or by ID, any case. Unknown names are reported in warnings."
    • changedInput schema / properties / task_description / description
      Previous value: -"Natural language description of the task. Be specific — include what you want produced, constraints, and context. Example: 'Design a caching layer for our API gateway with Redis integration.'"New value: +"Natural language description of the task, at most 4,000 characters. Be specific — include what you want produced, constraints, and context. Example: 'Design a caching layer for our API gateway with Redis integration.'"
  6. Changed1 schema field changed
    • changedInput schema / properties / preferences / properties / max_budget_usd / description
      Previous value: -"Budget ceiling in USD. Triggers warning if plan exceeds this."New value: +"Spending ceiling in USD. If the plan's quote is still above it after Rigor fits the plan (cheaper models, optional steps dropped), rigor_plan returns a max_budget_exceeded warning and rigor_execute refuses with 402 max_budget_exceeded before anything runs or is charged."
  7. Changed1 schema field changed
    • changedInput schema / properties / task_type / description
      Previous value: -"Optional hint to bypass automatic classification. Passing it also removes the slowest classification tiers from the critical path, so send it whenever you know the shape. Multi-step deliverable types: solution_design, requirements_analysis, code_implementation, code_review, bug_fix, root_cause_analysis, incident_response, deployment_execution, competitive_scan, financial_analysis, research_task, documentation, governance_change, compliance_audit, data_security_assessment, performance_optimization, user_story_definition, implementation_prompt_generation. Atomic single-call types, which auto-select direct execution: tag, score, rerank, extract_entities, parse_query, quick_research, quick_classification, quick_extraction, quick_scoring. Call GET /api/rigor/task-types for the full vocabulary with each type's shape."New value: +"Optional hint to bypass automatic classification. Passing it also removes the slowest classification tiers from the critical path, so send it whenever you know the shape. Multi-step deliverable types: solution_design, requirements_analysis, code_implementation, code_review, bug_fix, root_cause_analysis, incident_response, deployment_execution, competitive_scan, financial_analysis, research_task, documentation, governance_change, compliance_audit, data_security_assessment, performance_optimization, user_story_definition, implementation_prompt_generation. Atomic single-call types, which auto-select direct execution: tag, score, rerank, compose, extract_entities, parse_query, quick_research, quick_classification, quick_extraction, quick_scoring. Call GET /api/rigor/task-types for the full vocabulary with each type's shape."
  8. Changed4 schema fields changed
    • addedInput schema / properties / preferences / properties / execution
      Added value: +{
      +  "description": "Set to 'direct' to compose the plan's content frameworks into a single LLM call and route cost-first, using a per-task-type model floor that moves when a cheaper model earns the work. Research steps, process steps (classification-verify, review protocol, synthesis) and the quality review each remain separate calls, so this is not a one-call-per-workflow guarantee: for atomic task types, which have a single content framework, the call count matches standard execution and the saving is the model. Supplying output_contract replaces the quality-review call with deterministic validation, which is one fewer call. No intermediate outputs. Available at every tier. Auto-selected for atomic task types when no execution preference is given. Falls back to standard execution when combined with require_approval or interactive mode, or when the plan exceeds the composition size limit. Attachments and prior_workflow_id chaining are NOT applied — use standard execution for those.",
      +  "enum": [
      +    "direct"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / preferences / properties / output_contract
      Added value: +{
      +  "description": "Only read when execution is \"direct\". Declares the JSON shape you want back, so the answer is generated against your schema and validated against it before return, instead of returned as prose you have to parse. A conforming run also skips the quality-review call, costing 1 LLM call rather than 2. The schema is closed: a record carrying an undeclared key is rejected exactly like one missing a required key.",
      +  "properties": {
      +    "count": {
      +      "description": "Bounds on the number of entries. Only read when shape is \"array\".",
      +      "properties": {
      +        "max": {
      +          "type": "number"
      +        },
      +        "min": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "fields": {
      +      "description": "The schema for 1 record.",
      +      "items": {
      +        "properties": {
      +          "description": {
      +            "description": "Passed to the model as the field's description.",
      +            "type": "string"
      +          },
      +          "enum": {
      +            "description": "Restricts a string field to a fixed set of values.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "maximum": {
      +            "description": "Upper bound for a numeric field.",
      +            "type": "number"
      +          },
      +          "minimum": {
      +            "description": "Lower bound for a numeric field.",
      +            "type": "number"
      +          },
      +          "name": {
      +            "description": "The JSON key.",
      +            "type": "string"
      +          },
      +          "required": {
      +            "description": "Defaults to true. Set false for a field that may be absent.",
      +            "type": "boolean"
      +          },
      +          "type": {
      +            "description": "The value's type.",
      +            "enum": [
      +              "string",
      +              "number",
      +              "integer",
      +              "boolean",
      +              "array",
      +              "object"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "type"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "selection": {
      +      "description": "Use when you want the model to over-generate candidates and Rigor to sort, threshold, and cap them before the count bounds are checked.",
      +      "properties": {
      +        "maxCount": {
      +          "type": "number"
      +        },
      +        "minCount": {
      +          "type": "number"
      +        },
      +        "minScore": {
      +          "type": "number"
      +        },
      +        "scoreField": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "shape": {
      +      "description": "\"object\" for 1 record, \"array\" for 1 entry per input item.",
      +      "enum": [
      +        "object",
      +        "array"
      +      ],
      +      "type": "string"
      +    },
      +    "task_type": {
      +      "description": "Your own label for the work. Echoed into telemetry. Not read as a framework name and does not change routing.",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "task_type",
      +    "shape",
      +    "fields"
      +  ],
      +  "type": "object"
      +}
    • changedInput schema / properties / task_type / description
      Previous value: -"Optional hint to bypass automatic classification. Values: solution_design, requirements_analysis, code_implementation, code_review, bug_fix, root_cause_analysis, incident_response, deployment_execution, competitive_scan, financial_analysis, research_task, documentation, governance_change, compliance_audit, data_security_assessment, performance_optimization, user_story_definition, implementation_prompt_generation."New value: +"Optional hint to bypass automatic classification. Passing it also removes the slowest classification tiers from the critical path, so send it whenever you know the shape. Multi-step deliverable types: solution_design, requirements_analysis, code_implementation, code_review, bug_fix, root_cause_analysis, incident_response, deployment_execution, competitive_scan, financial_analysis, research_task, documentation, governance_change, compliance_audit, data_security_assessment, performance_optimization, user_story_definition, implementation_prompt_generation. Atomic single-call types, which auto-select direct execution: tag, score, rerank, extract_entities, parse_query, quick_research, quick_classification, quick_extraction, quick_scoring. Call GET /api/rigor/task-types for the full vocabulary with each type's shape."
    • addedOutput schema / properties / plan / properties / allowed_modes
      Added value: +{
      +  "description": "Execution modes available for this plan beyond the standard multi-call default. Contains 'direct' when the plan is eligible for direct execution; empty array when it is not.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  9. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "generated_title": {
      +      "type": "string"
      +    },
      +    "ok": {
      +      "type": "boolean"
      +    },
      +    "plan": {
      +      "properties": {
      +        "alternatives": {
      +          "type": "object"
      +        },
      +        "classification": {
      +          "properties": {
      +            "task_type": {
      +              "type": "string"
      +            },
      +            "value_class": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "cost": {
      +          "properties": {
      +            "credits": {
      +              "type": "number"
      +            },
      +            "range": {
      +              "type": "object"
      +            },
      +            "usd": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "info": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "rigor_level": {
      +          "type": "string"
      +        },
      +        "sequence": {
      +          "items": {
      +            "properties": {
      +              "estimated_credits": {
      +                "type": "number"
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "step": {
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "warnings": {
      +          "items": {
      +            "properties": {
      +              "code": {
      +                "type": "string"
      +              },
      +              "message": {
      +                "type": "string"
      +              },
      +              "suggestion": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "workflow_id": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
  10. Changed8 schema fields changed
    • addedInput schema / properties / preferences / properties / add_frameworks
      Added value: +{
      +  "description": "Inject additional frameworks into the plan.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / preferences / properties / approval_before_step
      Added value: +{
      +  "description": "Zero-based step indices where approval gates are inserted.",
      +  "items": {
      +    "type": "number"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / preferences / properties / max_budget_usd / description
      Previous value: -"Maximum budget in USD. Plan will warn if estimated cost exceeds this."New value: +"Budget ceiling in USD. Triggers warning if plan exceeds this."
    • addedInput schema / properties / preferences / properties / only_frameworks
      Added value: +{
      +  "description": "Restrict plan to only these frameworks (mutex with skip_frameworks).",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / preferences / properties / require_approval
      Added value: +{
      +  "description": "Pause at pending_approval before the final step.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / preferences / properties / rigor_level / description
      Previous value: -"Depth of analysis: quick (fast, lower cost), standard (default, balanced), thorough (deep review, higher cost)."New value: +"Review depth. Default auto-detected from task complexity."
    • addedInput schema / properties / preferences / properties / rigor_level / enum
      Added value: +[
      +  "quick",
      +  "standard",
      +  "thorough"
      +]
    • addedInput schema / properties / preferences / properties / skip_frameworks
      Added value: +{
      +  "description": "Framework names to exclude from the plan.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  11. Changed4 schema fields changed
    • removedInput schema / properties / preferences / properties / quality_level
      Removed value: -{
      -  "description": "minimum | standard | maximum. Default: standard.",
      -  "type": "string"
      -}
    • addedInput schema / properties / preferences / properties / rigor_level
      Added value: +{
      +  "description": "Depth of analysis: quick (fast, lower cost), standard (default, balanced), thorough (deep review, higher cost).",
      +  "type": "string"
      +}
    • removedInput schema / properties / preferences / properties / tool_scope
      Removed value: -{
      -  "description": "mandatory | recommended | all. Default: recommended.",
      -  "type": "string"
      -}
    • changedInput schema / properties / task_type / description
      Previous value: -"Optional hint to bypass automatic classification. Values: solution_design, governance_change, requirements_analysis, incident_response, code_implementation, competitive_scan, financial_analysis, deployment_execution."New value: +"Optional hint to bypass automatic classification. Values: solution_design, requirements_analysis, code_implementation, code_review, bug_fix, root_cause_analysis, incident_response, deployment_execution, competitive_scan, financial_analysis, research_task, documentation, governance_change, compliance_audit, data_security_assessment, performance_optimization, user_story_definition, implementation_prompt_generation."
  12. Added

TDQS

A4.4/5.0
Behavior5/5

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

Annotations already mark the tool as read-only, idempotent, open-world, and non-destructive, but the description adds meaningful behavioral context beyond them: it returns a full plan without executing, includes per-step cost estimates, exposes allowed_modes for direct-execution eligibility, and charges no credits. These details materially help an agent understand the tool's behavior and side-effect profile.

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

Conciseness5/5

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

The description is front-loaded, compact, and free of redundant wording. Each sentence contributes useful information about purpose, output, execution eligibility, and cost.

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

Completeness4/5

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

For a complex planning tool with eight parameters, nested objects, and no output schema, the description does well by explaining that a full plan is returned and that allowed_modes indicates execution eligibility. It still does not describe other likely return fields such as workflow identifiers or warning structures, leaving a small completeness gap.

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

Parameters3/5

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

The input schema has 100% description coverage, so parameter meaning is already handled by the schema. The description adds no specific parameter guidance beyond general references to task classification and allowed_modes, making the baseline 3 appropriate.

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

Purpose5/5

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

The description states a specific verb and resource: get a structured workflow plan with per-step cost estimates, classify the task, select a framework sequence, and return the plan without executing. It clearly distinguishes this planning operation from an execution operation by saying nothing is executed and by referencing allowed_modes for execution eligibility.

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

Usage Guidelines4/5

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

The phrase "Before executing a complex task" gives clear context for when to use this tool. However, it does not explicitly name alternative tools such as rigor_execute or state when not to plan, so it stops short of full when-to-use versus alternatives guidance.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources