reference_class_estimate
Generate data-driven task effort estimates by applying historical actual-vs-estimated ratios; use industry averages when no project history exists.
Instructions
Data-driven estimate using reference class forecasting.
Applies historical correction factors based on actual-vs-estimated ratios. When no historical data exists, uses industry averages (1.3-2.2x for software tasks). Prioritize this over algorithmic models when historical data is available.
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_type": "<task_type>"
},
"name": "reference_class_estimate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Rough size of the task: small=tiny fix/tweak, medium=typical task, large=significant effort, xl=epic-scale. When omitted, inferred from complexity (1-2=small, 3=medium, 4=large, 5=xl). | |
| project | No | Optional project/repo identifier this estimate belongs to, for cross-project analytics. | |
| team_id | No | Optional team identifier to scope historical data to a specific team. | |
| ai_native | No | Degree of AI assistance: 0.0 = fully human, 1.0 = fully AI-native, 0.5 = hybrid. Accepts boolean for backward compatibility (true=1.0, false=0.0). | |
| task_type | Yes | Category of work being estimated for reference-class lookup. | |
| complexity | No | Fine-tuning complexity from 1 (trivial) to 5 (extreme). Adjusts within the scope band: low complexity shortens, high complexity lengthens the estimate. | |
| session_id | No | Optional session identifier (minted by a calling agent/hook) used to deduplicate repeated estimate calls for the same task within a session. | |
| task_label | No | Optional free-text label identifying the task this estimate is for (e.g. an issue key or short title). Surfaced on get_pending_estimates output for triage. |