TFS 2012 Agile Planning Tools Issue – nested tasks makes the parent task disappear



You should use nested PBI’s and never nested Tasks when you are using the Visual Studio 2012 Team Foundation Server Agile Planning Tools and here is why.

At some point you take your “Product Backlog Item” and break it down into sub items as part of your development process. This is part of the creation of a Plan to complete those Backlog Items and that plan reflects the best guess of the Team in what needs to be done to achieve those backlog items.

In Team Foundation Server you can have nested tasks
Figure: In Team Foundation Server you can have nested tasks

In the pursuit of this you may feel that it is a good idea to create nested tasks and using the Work Item Tracking in both Visual Studio and the Web Access you will be able to created these nested tasks.

Agile Planning tools do not support nested tasks the way you think
Figure: Agile Planning tools do not support nested tasks the way you think

However when you view the Sprint Backlog you don’t see the in-between nested tasks, instead you only see a flat list of tasks.

Agile Boards do not support nested tasks
Figure: Agile Boards do not support nested tasks

In addition to the Agile Planning tools the Agile Boards also do not show the intermediary nested tasks.

Applies to

  • Visual Studio 2012 Team Foundation Server
  • Visual Studio 2012 Team Foundation Server Update 1

Steps to Reproduce

You can replicate this fairly easily by following these steps to reproduce:

  1. Add PBI called “PBI 1”
  2. Add child Task to “PBI 1” called “Task 1”
  3. Add child Task to “PBI 1” called ‘Task 2”

    Figure: Result as expected with “Task 1” and “Task 2” visible

  4. Add child Task to “Task 2” called “Task 3”

    Figure: Not expected to see “Task 1” & “Task 3”


This is essentially us hitting up against the ideals of the tool. While the Work Item Tracking and Query system built into TFS is designed to handle and sort of work style the Agile Planning Tools are optimised to work with… well… and “agile” flow.

With almost 80% of companies saying that they “do agile” it only makes sense for Microsoft to concentrate on the biggest chunk of customers. If you are not in that 80% then you should take a look at Requirement management in the modern application lifecycle for solutions that will fit your needs while still maintaining the data integrity and reporting that is the cornerstone of TFS.

Do, or do not…. there is no try!

If however you are really trying this “agile” thing and are running into issues like this with the tool then you may need to change your workflow.


If it needs broken down then it is likely not a Task at all, but a Product Backlog Item masquerading as a Task. The best solution is to ask yourself when you are breaking down your “Product Backlog Items” if the unit you are breaking it down into may need broken down further. If it does then it is probably a “Product Backlog Item” and not a Task.

Now while stack ranking hierarchical work items makes life difficult and does lead to the dark side, it is supported by the Agile Planning tools and the Agile Boards.

You can see nested PBI’s on the Agile Planning tools
Figure: You can see nested PBI’s on the Agile Planning tools

You will find that when you try to drag the parent into a Sprint you will be prevented and you need to drag the individual PBI’s instead.

Figure: You can see correctly the parent is not listed

This is the same behaviour as we saw on the tasks, but it now makes sense as we no longer care about delivering the parent PBI.

If you break down a Product Backlog Item into more granular Product Backlog Items those sub items should reflect the entirety of the work that needs to be done to achieve the parent and thus rendering the parent superfluous for all but upstream reporting. If you break a Product Backlog Item down into Tasks those Tasks should represent the Development Teams best guess at what actions / work needs to be undertaken to complete that Product Backlog Item.

Create a conversation around this article

Share on Facebook
Share on Twitter
Share on Linkdin

Read more

Martin Hinshelwood
In organizational development and team dynamics, Agile (as the Agile Manifesto delineates) and Scrum (as the Scrum Guide outlines) guide teams not by solving their problems but by illuminating the issues that demand attention. These frameworks aim to identify and spotlight the challenges within a team or organization’s processes, effectively …
Martin Hinshelwood
This week, I participated in a Webinar hosted by Sabrina Love ( Product Owner) as well as my colleagues, Joanna Płaskonka, Ph.D. and Alex Ballarin to discuss the state of learning and how immersive learning is the future of training. You can watch the video below to hear what …
Martin Hinshelwood
For a long time now I have been searching for that perfect domain that epitomised the vision, the why, of what I am trying to achieve with my customers and the industry at large. Now I have found it in
Martin Hinshelwood
At the MVP Summit I was appalled by the number of people who asked questions about new features for supporting hierarchical tasks! I shared a disgusted look with Peter Provost and we had a quick (and I mean really quick) conversation that resulted in this post. it really comes down …