Small teams that work in the same location can use a simple whiteboard to follow a Kanban method. If your team is distributed or just bigger, or if you want to integrate a Kanban board and an issue tracker anyway, consider using a YouTrack Agile board to manage your projects.
The cards on the board represent issues to be processed by your team. Advocates of the Kanban method use terms like work item, but for this tutorial, the terms work item, task, issue and card are all synonymous.
Configure Your Projects
Before you start to configure your Kanban board, take a minute to pick which projects you want to manage on the board and check that they are configured properly.
The Kanban method assumes that you draw columns on the board that reflect the stages of your development process. Your process can include many stages, and all of them are visualized on the board. Most development teams use three to seven columns. This is a reasonable limit, as monitoring the board is essential in Kanban practice. The more columns you have, the harder they are to track.
Columns usually represent the development stage, department name, or anything else that you consider to be a stage in your work. When you create a new card on the Kanban board, the card represents an issue in YouTrack. One of the issue fields stores the stage. By default, the board uses a field that stores this value as a
state type. When you move the card around the board, the field takes the value of the column that it has been moved to.
This example shows a state-type field that represents the development stages for issues in the project. The field cannot be empty, which means that all new issues that are created in this project is displayed in the column that represents this value on the board when it is set.
For best results, edit the set of values for an existing field that uses a state type. If you add a new state-type field to your projects, be sure to remove any additional state-type fields. Projects that use multiple state-type fields can be difficult to work with and require additional setup. For more information, see Custom Field Types.
If you want to use a Kanban board with a new project, you can create the project and the board simultaneously with the Kanban project template. For more information, see Kanban Project Template.
Create the Board
Use the following guidelines to set up your new board:
Choose a Board Behavior Option
The General tab displays the settings that you just defined to create the board. For boards that are created with the Kanban board template, the Sprints option is Disabled by default. The standard Kanban methodology doesn't use sprints. You can always enable sprints and follow a hybrid Scrum/Kanban (Scrumban) methodology, but that's not what this tutorial is about.
Define Columns and Swimlanes
The next step is to configure the settings that identify columns and rows on the board. When the board is created, the custom field that you configured in the first section of this tutorial is used to identify columns by default.
By default, the template for the Kanban board does not use swimlanes. All of the issues are displayed in the same row. You can, however add swimlanes to the board to add another layer of information.
Set Work in Progress Limits
Work in progress (WIP) is an indicator of how many cards can be present in a particular board column simultaneously. This represents the number of tasks that can be managed simultaneously at this development stage. We recommend that your WIP value reflect the actual number of tasks which can be performed at the same time at this work stage.
You can set the minimum and maximum WIP for each column individually.
Customize Card Presentation
If you estimate the amount of time that is required to finish each task, you can display estimations on the board. Use the Estimation Field setting to select which field is used to store estimations in your projects. This lets you show and update estimations directly on each card.
You can also set the color scheme that is used to highlight cards on the board. For Kanban boards, we suggest that you color cards based on the Kanban state. When you create a project with the Kanban template, the Kanban State field is added to your project automatically. This field stores the current state of the issue as either Blocked or Ready to pull. The Kanban State field has a default color scheme. Issues that are blocked are red. Issues that are ready to pull are green. You can update the color scheme for this custom field on the Edit Project page.
These states are critical for following the Kanban method. Members of your team who are responsible for the next stage of development should clearly see which issues they can pull into their column. If you choose not to use this field in your projects, we recommend that you use another method for visibly flagging issues. For example, you can create and attach a Ready to pull tag to issues that can be moved to the next stage of development.
Configure the Chart
For Kanban, the most useful option is the cumulative flow diagram. This report shows the distribution of tasks across different stages of development at any moment in time. The cumulative flow diagram helps you monitor your progress, analyze your development process, and detect bottlenecks.
Working with the Kanban Board
When you have finished configuring the board, you and your team can use the board to manage your work. Here are some of the key components of the board with a few guidelines for using the board with the Kanban method.
Adding Cards to the Board
A common practice in Kanban is to add work items to the board in a column that represents an open state. You can add issues as cards directly on the board. If you have a backlog of issues that you want to manage on this board, you can open the backlog and pull the issues from the backlog to the board.
For the setup that is described in this tutorial, the field that is used to define columns cannot be empty. All issues that are created in the projects that are managed on the board are created directly on the board.
Moving Cards Around the Board
When you move cards around the board, you can exceed the maximum WIP limit for a column. YouTrack alerts you to this condition by changing the background color of the column and indicating that the limit is exceeded. Here you see that there are five cards in a column with a max WIP of four.
Card Size and TV Mode
The slider at the top of the board sets the level of detail for cards on the board. This setting is user-specific and can be set independently for different boards.
Some teams use large monitors or projectors to display the Kanban board at their meetings. TV mode displays the board in full screen and uses a color scheme with a dark background. This visual presentation has been proven to improve visibility from a distance on large monitors.
The progress indicator shows the distribution of cards by stage. Each bar corresponds to a column on the board.
To view the total number of cards in each column, move the pointer over the corresponding column in the progress indicator. The number of cards in each swimlane is displayed on the right side of the swimlane.
If you have enabled the Estimation Field setting, the board displays the total estimation for all of the cards at the top of the board. The presentation varies based on the data type of the custom field that is used to estimate the time that is required to complete a task.
This example shows estimations in ideal days. The total estimation for all of the cards in each swimlane is displayed on the right side of the swimlane.
Tracking Your Progress
You can open the cumulative flow diagram directly on the board. The chart shows the distribution of cards on the board by stage for the last two weeks. Move the pointer over a date on the chart to see the number of cards in each stage on any date that is displayed on the report.
On this graph, the vertical axis shows the number of tasks in each column. The horizontal axis represents time by date.
To see how quickly you're getting things done, look at the region between Open and Done. This area represents all of the intermediate stages of development. Basically, the steeper it decreases, the faster you're completing your workload and nearing the final release date.
Also, the intermediate stages are supposed to shrink over time. If they are expanding, it could indicate a bottleneck. It can also mean that you're adding more work to your system than your current capacity allows.