Runs

Runs in Timeline

Sprints are a common tool in the development process. Runs allow you to model your sprints by allowing to set up recurring milestones of a certain length in weeks.

Set up Runs

First ensure Runs are enabled via the Organization Settings > Features section. (They are enabled by default though.)

Open the Timeline tab in the header or press Shift + 3 on your keyboard.

Look for the ➕ icon at the top right. A Calendar Opens which includes a Set up Runs in the header.

"Set up Runs" button

Set up a Run Configuration

Run Config Menu

  • Short Name: Up to 5 letters. Helpful to differntiate runs in case there exist parallel Run Configurations.
  • Color: The color in which the Runs are shown throughout the app.
  • Project-specific: If left unchecked the generated Runs will be global ones, that can contain cards from any proejct. If you make it project-specific, it will only be shown on the timeline if the associated project is currently visible as well. This mechanism can also be used to hide certain Runs from team members that don’t have access to the respective project.
  • Run duration: How many weeks a Run is active
  • Run start day: This option differes between the creation and update options. When creating a Run Config, you can pick a start date from a calendar. When editing, you can change the weekday the run starts.
  • Number of upcoming Runs to create: This number also includes the currently active run. Once a Run has been finished, a new one is automatically created.
  • Finish Sprint At: Define the time and time zone at which the Run shall end. Note that 0:00 defines the start of the end day and 24:00 the very end.
  • Finish Behaviour: Here you can configure which cards should be automatically moved to the next run once a Run is finished.

All settings can be changed later on. Updating the Run duration will only impact the currently running or future Runs. Updating the start day will only impact future runs and prolong (or shorten the current one).

Run Description, Statistics & User Capacity

Once a Run is opened, you can click on the i button below the Add Card button on the left. This will show you the description box as well as statistics about the run including a burndown chart. The description area allows you to update the description and upload a cover image. This image will also be used for the run’s tooltip.

The shown velocity is accumulating done cards from the full Run Configuration.

Stats of a Run

This view also includes Capacity Tracking. It shows how work is distributed across your team mates. You can set the individual capacity of each team member to see who might be overbooked or out of work. Look for the ⚙️ icon at the top right to set and modify the capacity for each user.

If a user is overbooked, the line chart will show striped overlay. If a member still has capacity left, it will be represented with dots. Users are sorted by the percentage of work done (based on work assigned, not capacity). Note that when editing Capacities, the tooltip shows the Historical Workload for a user helping to identify a good value for future workfloads.=

The Run header also shows your personal capacity vs work load at a quick glance.

Capacity Tracking Widget

Deleting Runs

You cannot directly delete a Run Configuration. You can delete Runs that are active or in the future. Deleting a Run sets an implicit stop date for that Run Configuration beyond which no new Run is started even if you change e.g. the Run duration. You can remove the Stop date to resume the run by opening the Run Configuration via the cog icon ⚙️ on an opened Run.

Adding Cards to a Run

There are various ways to do so:

  • Open the card properties by clicking the properties button on the top right side of an opened card, you can find the Run picker below the priority and effort properties. Click the “Pick” button to select either upcoming or past Runs.
  • Select multiple cards and use the bulk action milestone button to add multiple cards to the same Run.
  • Order your cards by Run to drag cards between different Run lanes.
  • Click on the Run icon on any card to open the Quick Settings.

There can only be one Run assigned to a card. To distribute a task over multiple Runs you can consider using hero cards.

Beast Mode

Card with Beast token

Beast Mode tracks Cards that get pushed from one Run to the next, keeping you aware of what’s slipping through the cracks. The more a Card moves, the stronger its Beast level grows.

A card within a Run with active Beast mode may be in two states:

  1. Pending: Cards entering the Run will start out in the Pending state. Cards can be moved to different Runs without increasing their Beast level. Cards in the Pending state have a NEW label at the bottom.
  2. Locked in: After the grace period has passed, Cards will be locked in. Once locked in, Cards won’t be able to move out of this Run without increasing their Beast level.

When opening a Run, you will find the Beast icon in the Run’sheader bar. Codecks offers multiple options to configure Beast Mode.

Beast Config View

  • Manually start Beast mode: hitting this button will lock all cards within the Run that have been in the Run for longer than the grace period. This button is available even if you’ve set up the “Auto Activate” option below. Once Beast Mode is active, the Beast icon will turn red.

  • Auto-activate Beast Mode: Allows you to set up the number of days after which Beast Mode is activated. This setting affects all Runs within this Run Configuration. Once scheduled, the Beast icon will turn yellow.

  • Beast Grace Period: The grace period determines how long a card might be in a Run with activated Beast Mode before being locked in. If a Card has been added to a Run before the Run has started, the Run’s start time will be considered for the grace period.

Beast Mode is a feature available in the Pro plan.

Working with Runs

Run Icons

Cards with a Run will show a small circular-ish arrow icon. Hover over the icon to see more information about the current state of the Run.

Cards with a past Run will show an empty Icon. The current one will be filled whereas future ones are also filled but show a dashed outline.

Pinned Runs

The header area of the Card inspector includes a pin icon 📌. Pinning a Run allow you to quickly access this Run from your hand. This allows you to move Cards between a Run and your hand without having to leave the hand view. The Pin overlay also allows you to set that all started Cards will automatically be associated with the Run if the card is not yet in another Run. This setting is ignored if the Card’s project is not part of the Run’s projects.

Once a pinned Run is finished, the next Run of the Run Configuration will automatically be pinned.

Opening the Timeline tab will also always open the pinned Run (or Milestone). You can only have a single element pinned at the same time. I.e. either a Milestone or a Run.