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 token
• project:user GitHub user or organization to use for search
• project:teamLabel GitHub label for your team. Should be the same for all repos
• project:sprintKeywords Keywords for the GitHub label to mark Sprints. Check Workflow section for more info
• project: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, specify syrup for https://github.com/sap1ens/syrup repo.

All these options can be passed as arguments or environment variables.

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.

• Create a way to enable this workflow for a list of repos (create all required labels)