Introduction
I thought I’d write a “Quick guide” to help our SfTS v3 beta 1 customers get their new projects configured correctly to ensure that the shiny new reports work as designed and the SfTS event service can automatically roll up dates and capacities. This guide will no doubt be superseded by the guidance when its available and we are also considering providing a new project configuration tool to make some of the following a little less fiddly.
SfTS v3 is designed to take advantage of the new capabilities of Team System 2010, with much more sophisticated support for larger Scrum programmes where you might see multiple distributed teams working across different time zones. Greater sophistication means that we now have a few more knobs and dials to think about when we set up a new project.
This guide takes you from the point where you have just created a new Team Project using the SfTS v3 Beta 1 template, if you haven’t got this far then please take a look at the installation notes pdf included in the download zip.
We will leave the full description of how this new template supports a comprehensive range of scaled Scrum project models to a later post, but we need to cover just a enough of the conceptual model to set some context for the initial project configuration.
Scrum Project and Planning Hierarchy Concepts
The diagram below illustrates the hierarchy of a Scrum project or program as modelled by SfTS v3 on the Team System 2010 platform. For simplicity, I have not included Team Project Collections in the diagram, a feature of the new Team System platform that allows us to have collections of projects. TPCs provide yet more options for how we choose to scale and structure a program.
A Story (Product Backlog Item) will typically move from left to right on the diagram over time, starting as an idea for a cool new feature that then goes through a process that will look something like this:
- Evaluation of business value
- Addition of Acceptance Tests that help to more tightly define the Story
- Estimation of the effort required to deliver the Story
- Prioritise, frequently
- Plan the target Release for delivery
- A team plans the Tasks (Sprint Backlog Tasks) that will implement the story in a Sprint
- A team works on the tasks until the Acceptance Tests are passed

We track the evolution of stories and tasks with Team System’s Iteration Path and further support this model with three Work Item Types; Release, Sprint and Team Sprint who’s key features are summarised below:
- Release
- Models a Scrum Release composed of one or more Sprints delivered by one or more teams
- Must correlate with a matching Release node within the Iteration Path tree
- Records the planned capacity and dates for the Release
- Provides a read only view of the actual Release dates based on rolled up dates of the planned Team Sprints
- Burned work – automatically shows actual completed work measured in Story Points
- Sprint
- Models a Scrum Sprint delivered by one or more teams
- Must correlate with a matching Sprint node under the appropriate Workstream node within the Iteration Path tree
- Aggregates the capacities and dates of its “Child” teams (read only fields)
- Post beta 1 will require a link to a “Parent” Release work item through an “Implements” Link Type
- Team Sprint
- Models a Scrum Sprint delivered by a specific team
- Must correlate with a matching Team node within the Iteration Path tree
- Must be linked to a “Parent” Sprint work item through an “Implements” Link Type – reports will not function correctly and team capacity and Sprint Start/End dates will not roll up if this link is not in place.
- Sets the Team Sprint Capacity
- Sets the Team Sprint Start Date
- Sets the Team Sprint End Date
The “Workstream” part of the model enables a project to contain Sprints of different cadence (e.g. 1 team on a 2 week Sprint and another using a 4 week Sprint) and is implemented only in the Iteration Path without a matching work item. Even if you use a single cadence (recommended in most situations) it is important that a workstream node is retained, even if you change its name, to ensure that reports run correctly.
New Project Configuration Steps
The following steps assume that you have successfully created a new team Project and selected Scrum for Team System v3 Beta 1 as your template and then take you to the point where you have a new project with a correctly configured Release and Team structure.
Step 1 – Configure the Iteration Path
We create a default Iteration Path (see screenshot below) and some matching work items as part of the Team Project creation wizard process but you will need to modify this to fit your project.

It is important that you keep the same structure but you can change the names of the nodes and add additional workstreams Sprints and Teams. A simple example below which has:
- 2 Releases named Alpha and Beta 1
- Alpha has 2 Sprints of the same cadence within a workstream called WS
- Each of these Sprints is delivered by a single team called the PathFinders

Step 2 – Match work items to the Iteration Path nodes
Use the “Release, Sprint & Team” query to list all the relevant work items so that you can match them to the iteration path, by modifying existing and creating new work items of the appropriate type where required. This query will more than likely be replaced by tree query in SfTS v3 beta 2 which will improve the formatting and make the hierarchical structure much clearer.
Step 3 – Link Team Sprints to their Parent Sprints
When we create a new Team Project it isn’t possible to create template work items that are linked together within the Project Creation Wizard process so you will need to manually set the “Implements” links between each Team Sprint and it’s parent Sprint work item. Any other link type will not function correctly.
This is one of the areas where we see the need for a project configuration tool.
From the “Linked Team Sprints” tab of a Sprint work item, select the Add button – see image above in step 2. This will show the screen below:
Ensure that you select the “Implemented By” Link type and then type in the work items IDs of all the Team Sprints that contributing to this Sprint. Click “OK” and then save the work item changes.
Step 4 – Setup the Releases
The Release work item provides the ability to track whether the Sprints and Team Sprints configured for a given Release match the intended duration of the Release. The “Actual Duration” dates are read only and automatically updated provided that all iteration paths are set correctly and that all Sprints and Team Sprints are correctly related as in Step 3.
Step 5 – Setup the Team Sprints
The Team Sprint work items are the source for Sprint start and and end data which is automatically propagated up through the Sprint and Release work items. As a result the only elements of a Sprint work item requiring configuration are the “Implemented By” links to its Team Sprints, unless you would like to set a joint Sprint goal for multiple teams working together to deliver the Sprint commitments.
