If you’re a founder, product manager, scrum manager, or technical lead working with a team of developers, you know it’s not always easy to add Agile methodology to their GitHub workflow. This is especially true if you try to get developers to use software they don’t understand, think they need, or want to use.
We’ll let you in on a little secret: developers hate being forced into a project management approach. In a perfect, pristine world, developers could focus just on writing code and nothing else. They get that there are other people involved; designers who create digital assets for us, writers who spin words that capture the work we’ve done. Even marketers, we suppose, need to be kept in the Agile loop.
But we hate having to use an entirely different system on top of coding, git commits, and pull requests.
If the developers on your team feel the same way, don’t try to herd cats; instead let them use one of the tools they know and love: GitHub.
So how can you add Agile methodology to your source control tool and keep your developers happy?
Use GitHub’s agile projects
Since October 2016, GitHub has offered a way to track GitHub Issues, Pull Requests, and Notes, with Projects. GitHub Projects let you have kanban-style boards for managing work, and cut across separate code repositories. This lets you round up, say, all the tasks for your next sprint and list them in one place.
You can create a GitHub project from any repository, like this one.
Start by clicking on the Projects tab.
Click on the green Link project dropdown.
If you already had a project created, you could just link it through this menu. For now, you’ll want to hit New project.
Here, you can choose to use a pre-built template or just start with a blank project. If you want to use Agile methodology with GitHub, you probably want to use a board rather than a table. Once you’ve picked the project you want to create, you’ll be taken back to the Projects tab.
Now that your project’s been created, you can add any issue from your repository. Just go open up an issue…
See the Projects tab on the right? Hit the blue gear.
This will show you every project you can add this issue to. Just choose your project and a checkmark will appear. Then, if you go to that project…
Your issue will show up there! You can then use this board to track progress for your repositories using your agile methodology of choice.
Make GitHub projects more agile with ZenHub
As nice as GitHub Projects are, they’re missing one really important Agile methodology ingredient: Epics.
In Agile methodology, Epics are bigger than single user stories, sometimes bigger than any one sprint or iteration. For product managers, founders, and executives, they’re the things that matter most.
Unfortunately, GitHub doesn’t have Epics (neither does Trello, out of the box). But there’s a neat service for GitHub called ZenHub, that adds Epics, enhances Projects, and adds a number of very useful reports to GitHub.
With ZenHub Epics, you can organize a bunch of User Stories in the form of Issues into a single coherent whole; scheduling it, tracking it, and measuring its progress.
Not having Epics as part of your Agile toolbox can hurt your team. If you use Trello, but not Epics, each sprint will fill up with small issues and improvements. Meanwhile, the big things, the things that matter most and that would normally have been captured as Epics, will not be addressed fast enough.
ZenHub does more than Epics for its approximate $5/month per seat price tag. It can actually predict delivery dates so you don’t have to do the math, and delivers management-ready release reports.
And for your developers, ZenHub offers burndown charts to show progress made towards completing a Milestone.
Zenhub also has a host of other features that can help you introduce Agile methodology to your GitHub projects, including:
- Planning poker: A technique used to gamify the estimation of effort and size of development goals. Often, you need to use a separate app to do this, but ZenHub has built-in features to allow this.
- Automated sprint planning: Don’t want to spend hours in sprint planning meetings? With ZenHub, you can automate that work so you can focus on hitting development milestones as you de-clutter your calendar.
- Automated workflows: Few things are as frustrating as having to duplicate recurring tasks and projects. In ZenHub, you can leverage automation to take that frustration out of your daily work.
Use Trello instead
GitHub and ZenHub are great solutions when your Agile team is mostly developers. But what if they’re not? What if most of your cross-functional team are people who don’t think like developers? Or you don’t want to complicate the software development process with issues from other teams, that have nothing to do with software development?
Trello makes for an excellent Agile management tool for teams more interested in results and process than management reports. With it, and a consensus around how your team will use this tool, you can orchestrate both simple and robust Agile projects.
Trello straps rockets to a kanban board: you can have as many boards, lists and cards as you need. You can add information, links, and integrations to cards, and move cards from list to list and board to board as needed. Here’s a great Agile starter board you can use as a template.
Most Agile project management tools have a product backlog list for defined tasks, a sprint backlog for the tasks enumerated for this sprint, and a current sprint for tasks in progress. But if this structure doesn’t work for your style of Agile management, Trello lets you set up your own lists as you see fit.
Your team members are free to create and edit cards, adding comments, checklists, due dates, tags, and notes — essentially having all the conversation that’s needed about a specific task. Trello will make sure everyone is up to date, log comments, and alert team members when they are mentioned in any card. Three things make Trello particularly well-suited for Agile management:
- Chrome browser extensions: Such extensions can add specific features to Trello. For example, they can create functionality for creating task points, tracking time spent on tasks, generating Gantt charts, and exporting cards.
- Power-Ups: There’s a wide variety of powerful integrations available for Trello, including integrations with GitHub. Everything from adding calendar views, to including custom fields that connect to Google Drive documents. The Power-Ups are great for your developers, who may be feeling a bit left out.
- Agile features: Trello Agile documentation, examples, blog postings, and use cases demonstrate why Trello is an excellent platform for Agile management.
But what if you want both?
Trello is a great Kanban tool, but what if you really don’t want to give up GitHub’s robust version control features? Well, it turns out there’s a way you can get the best of both worlds. Developers who want to stay agile in GitHub can do so, and leaders who want to use Trello to track a project’s progress can do it. How?
By using Unito. Unito is a workflow management platform that gives you the ability to use the tools you need while streamlining your workflow. All it takes is a few clicks:
Add a block of work for Trello and GitHub
Use flows to connect your blocks.
Customize your flow.
And you’re done! Now pull requests, issues, and comments can be pulled from GitHub and added to your Trello board automatically. Additionally, any comments or updates made in Trello will be carried over to GitHub. With just a couple minutes, you’ve made it possible for everyone to use the tool they need. Want to know more about what Unito can do for your workflow? Check it out here.
Case study: handling development work across GitHub and Asana
Amanda Martinez and the team at Chromatic had a problem. A big, tough tool silo. See, not only is the team responsible for their own platform, but they also maintain Storybook, an open-source tool for streamlining the development of UI components. That means a lot of moving pieces and potential security concerns. While the development work happens in GitHub, Chromatic’s managers use Asana to plan their projects and track milestones.
Before they started using Unito, the people at Chromatic had to jump back and forth between Asana and GitHub constantly. Developers were using GitHub projects to track their work, but no one else was. That meant every update in GitHub had to be copied over to Asana, and vice-versa.
Now that they use Unito, the team at Chromatic can stay aligned across tools. They can get back to the work that actually matters instead of wearing down the C and V keys on their keyboards.
Want to know more about how Chromatic made open-source GitHub project management work? See the full case study here.
Want to see how it's done?
Get the full case study to see how Chromatic transformed their workflows.