3.6 KiB
Estimate Issue Time in YouTrack
Sprint planning time estimator. Issue ID or empty for full current sprint: $ARGUMENTS
Step 1 — Determine Scope
Single-issue mode ($ARGUMENTS set):
- Call
mcp__youtrack__get_issueon$ARGUMENTS. - Proceed with that issue only.
Sprint mode ($ARGUMENTS empty):
- Call
mcp__youtrack__search_issueswith queryproject: NCS Sprints: {current sprint} #Unresolved. - If query returns 0 results, use
AskUserQuestionto ask for the sprint name, then retry withproject: NCS Sprints: {name}. - Collect all returned issues.
Step 2 — Build Issue Tree
For each top-level issue from Step 1:
- Fetch full details via
mcp__youtrack__get_issue: summary, description, acceptance criteria, Type, existingZeitschätzung, linked issues. - Identify subtasks from links with relation
subtask of(i.e. issues where the fetched issue is the parent). - Recursively fetch subtasks until all leaves are known.
- Group into tree: Epic → Story → Task/Subtask.
Leaf node = issue with no subtask children. Parent node = issue that has at least one subtask child.
Step 3 — Estimate Leaf Nodes
For each leaf node:
- Read: summary, description, acceptance criteria, implementation notes.
- If scope is unclear, search codebase (
Grep/Bash) for related files to gauge complexity. - Assign estimate using this scale:
| Size | Criteria | Estimate |
|---|---|---|
| Trivial | Config change, rename, 1-file tweak | 30m |
| Small | 1–3 files, clear scope, no unknowns | 1h–2h |
| Medium | 3–6 files, some design needed | 3h–5h |
| Large | 6+ files, cross-module, non-trivial design | 1d–2d |
| XL | New subsystem, research spike, major refactor | 3d–5d |
- Record: estimate + one-line reasoning.
- Skip leaf if it already has
Zeitschätzungset — note it as pre-estimated.
Step 4 — Roll Up for Display
YouTrack auto-sums Zeitschätzung from subtasks up to parents — do not write estimates to parent nodes.
Compute display-only rolled-up totals:
- Parent total = sum of all descendant leaf estimates (including pre-estimated ones).
- Flag any branch where some leaves are missing estimates (partial roll-up).
Step 5 — Show Summary + Confirm
Display full tree with estimates. Format:
Epic NCS-10: Castling overhaul [4h 30m] ← rolled up
Story NCS-11: Validate castling rights [2h 30m] ← rolled up
Task NCS-12: Fix RuleSet check 1h 30m ← leaf (new)
Task NCS-13: Add regression tests 1h ← leaf (new)
Story NCS-14: UI feedback for castling [2h] ← rolled up
Task NCS-15: Highlight invalid squares 2h ← leaf (pre-set, skipped)
Legend: [X] = display-only roll-up (not written). Plain = will be written to YouTrack.
If sprint mode, show grand total at bottom:
Sprint total: Xd Yh Zm (N issues, M leaves to update)
Use AskUserQuestion tool:
- Does the breakdown look right?
- Any estimates to adjust before writing to YouTrack?
Incorporate all feedback before proceeding.
Step 6 — Write Estimates
On user approval, write estimates only to leaf nodes (bottom-up order):
- For each leaf with a new estimate, call
mcp__youtrack__update_issuewith fieldZeitschätzung= approved estimate. - YouTrack period format:
"30m","1h 30m","1d","2d 4h". - Skip leaves already pre-estimated.
Step 7 — Report
List all updated issues with set estimates.
Show final rolled-up totals per Epic/Story (read back from YouTrack via mcp__youtrack__get_issue if needed).
In sprint mode, show total sprint estimate.