TEMPLATE

Software Development Project Template

A general-purpose board for a software team: a sized backlog, a capacity-limited sprint column, and cards that move themselves when a branch or PR does.

Software dev project
Backlog
Export to CSV · 3pt
Rate-limit login · 2pt
Sprint · 5 max
Search filters · 5pt
feature/oauth-refresh
Review · 3 max
PR #412 open
Done
Merged: pagination fix

Cards move when the branch does. Nobody drags them by hand.

Why most dev boards drift from the sprint

Most teams that adopt a board do it for visibility: a shared answer to "where does this stand" without a status meeting. That only holds if the board keeps up with the repo on its own. The moment it needs a human to manually keep it honest, it starts falling behind, usually within the first sprint or two, and nobody notices until a stakeholder asks about something the board says is still in progress and turns out to have shipped two weeks ago.

A dev board usually starts accurate and stops being accurate within a couple of sprints, for reasons that have nothing to do with the team's discipline. The team didn't get sloppy. The board was never built to survive the gap between what's tracked and what's actually true in the repo, and that gap widens every day nobody closes it by hand.

The board and the repo disagree. A card says "in progress" because someone dragged it there on Monday. By Thursday the branch is merged and the card hasn't moved, because moving it is a second step nobody remembers to do. This template links cards to branches and pull requests directly, so the card's column reflects what the repo actually shows.

Sizing is either absent or theatre. Story points only mean something if they're checked against how long things actually took. Without that feedback loop, planning is a guess dressed up as a number.

The sprint column has no ceiling. Anyone can pull anything into it at any time, so "this sprint" quietly becomes "everything we might do eventually," and forecasts built on it are fiction.

Review becomes an unlisted stage. Work that's technically finished but waiting on a reviewer doesn't show up anywhere obvious, so it's easy to lose track of how much is actually done versus how much just looks done because the branch exists. A board that only has "in progress" and "done" hides the exact stage where most delay actually happens.

This template is deliberately unopinionated about process. It doesn't assume Scrum, Kanban, or anything with a name. What it assumes is that a card should represent one identifiable unit of work, that work in progress should be capped, and that the board should be able to answer "what's actually happening in this repo right now" without anyone opening a status meeting to find out. Connect the repo once and that question stops needing a meeting at all: the branch and PR linkage is what keeps the board honest without anyone dragging a card by hand.

What's inside

The structure, and why each part is there

A sized backlog

Every item carries a rough point value before it's eligible for a sprint. Sizing an item is also a forcing function to actually read it before it's committed to. A card nobody can size is usually a card nobody has thought through.

A capacity-limited sprint column

The sprint column has a point ceiling based on measured velocity, not on optimism. Pulling in more than that is a visible, deliberate override. It shows up on the board rather than happening quietly in a planning doc.

Branch and PR linkage

A card tied to a GitHub branch moves to "in review" when a pull request opens against it, and to "done" when that PR merges. The board follows the repo instead of keeping a second, parallel account of the same work that can drift out of sync with it.

A review column with its own limit

Open pull requests waiting on a reviewer get their own capped column, separate from active development, so a stack of unreviewed PRs is visible rather than buried in a GitHub tab nobody checks daily.

Velocity-based forecasting

Once a few sprints have closed, delivery dates are calculated from the team's measured velocity rather than from how confident the estimate sounded in planning. The forecast gets more accurate every sprint, not less.

Burndown and cycle-time charts

Generated from the same branch and merge activity that moves the cards, so the chart and the board can't quietly tell two different stories. If the burndown looks flat, the board will show exactly why.

How to use it

  1. 01Connect the repo first. Card movement only tracks reality once branches and pull requests are linked, so do this before the first sprint, not after cards have already drifted.
  2. 02Size the backlog before you plan a sprint. An unsized backlog can't produce a real capacity limit, only a guessed one.
  3. 03Let the first two sprints set your velocity. Forecasts before that are informed guesses; after that they're calculated from what the team actually closed.
  4. 04Cap the sprint column at that velocity, not at what the team hopes to do this time.
  5. 05Review the burndown mid-sprint, not at the retro. By the retro it's a history lesson, not a course correction.
  6. 06Keep the review column capped too, not just the sprint column. A team that can start work faster than it can review it just moves the bottleneck one step to the right.

None of this requires a particular methodology. Teams running two-week sprints, teams running continuous flow with no sprint boundary at all, and teams somewhere in between can all use the same four columns. The point ceiling and the branch linkage do the actual work, and the labels around them are just vocabulary.

Time logging sits on this board too, next to whatever card someone just finished. It takes about five seconds and doesn't require switching to a separate timesheet tool. Most teams turn it on after the first sprint or two, once the board itself is trusted enough that logging against it feels worthwhile rather than performative.

If you take three things
  • Link the repo so cards move with branches and PRs, not with someone remembering to drag them
  • A sprint column without a point ceiling isn't a sprint plan, it's a wish list
  • Forecast from measured velocity, not from how the estimate felt in planning
FAQ

Common questions

It's a board that links to branches and pull requests in your GitHub repo; burndown and cycle-time analytics come from that same activity. It isn't a separate issue tracker duplicating what's already in the repo, and it's not trying to be a code review tool either; reviews still happen in GitHub, the board just reflects where each one stands.

Keep reading

Related pages

See it on your own work.

A workspace your whole company will actually use is 60 seconds away. No card, no risk, nothing to install.

14-day full-access trial · sample project included · no card required