Little helper for Waffle.io based Scrum workflows, currently only supports CLI mode.
Features:
- List all Sprints with associated issues and details
- Create new Sprint
- Clone issue (if you decide to move it to the next Sprint)
Waffle.io is an amazing project management tool based on GitHub. It has two-way synchronization with GitHub and shows your issues for a repo as a Kanban board.
It's a bit tricky to use Waffle for Sprints when you connect multiple repos to one board (but this is something you'll end up doing anyway). We developed a set of rules to follow, which enables this app to show the Sprint information we need.
Waffle has its own system for points, but it's a bit weird (points like 1
, 3
, 5
, 8
, 13
...), it doesn't sync with GitHub and all points basically disappear when issue is archived. So instead, every project that participates in a Sprint must contain these 5 labels for story points: 1
, 2
, 3
, 4
, 5
.
Multiple teams can work on the same repo. You must tag issues with a label that identifies your team. This label must be the same for all projects you track. You can define it using project:teamLabel
config option.
Unfortunately you can't really use milestones when you have multiple repos for the same Sprint. Also, sometimes you have to move ticket to the next Sprint, in this case you can't keep the information that ticket was initially assigned to previous Sprint.
But again, you can solve this problem with labels. Have a format like this: [TEAM_NAME] Sprint [SPRINT_COUNTER]
, for example Platform Sprint 10
. You can define the initial part with project:sprintKeywords
config option, for example Platform Sprint
.
npm install -g syrup-cli
Then create ~/.syrup/config.json
file using config.json.example
. You need to configure the following options:
github:token
your GitHub tokenproject:user
GitHub user or organization to use for searchproject:teamLabel
GitHub label for your team. Should be the same for all reposproject:sprintKeywords
Keywords for the GitHub label to mark Sprints. Check Workflow section for more infoproject:sprintLabelColor
Color of the Sprint label, hex code without#
project:teamRepos
Array of repos names for your team (connected repos in the Waffle source settings), without organization/user. For example, specifysyrup
forhttps://github.com/sap1ens/syrup
repo.
All these options can be passed as arguments or environment variables.
syrup setup
Setup all team repos, create all required labels.
syrup list-sprints
List all existing Sprints.
syrup new-sprint -- --id SPRINT_ID
Create new Sprint using unique SPRINT_ID, it'll be used for sorting (so simple incremental number should be fine).
syrup clone-issue -- --repo REPO_NAME --id ISSUE_ID
Clone issue using provided repo name and issue ID.
syrup -h
Help page.
- Make all label colors to be configurable
- Error handling
- Tests