Debugging flow template

A disciplined loop for hard bugs: reproduce, write a failing test, isolate, hypothesise, fix the root cause.

Use this templateFree, opens in your browser. No sign-up.

Debugging flow template
Bug report
Can you reproduce it?
Add logging, get exact inputs and versions
Write a failing test
Isolate: git bisect, shrink the input
Form one hypothesis
Confirmed?
Fix the root cause, not the symptom
Test passes · ship · share what you learned
Debugging flow
no
yes
no
yes
The debugging flow template as it opens in Kelvo: 9 boxes, 2 decisions among them and 10 links.

What's on the board

  • Bug report
  • Can you reproduce it?
  • Add logging, get exact inputs and versions
  • Write a failing test
  • Isolate: git bisect, shrink the input
  • Form one hypothesis
  • Confirmed?
  • Fix the root cause, not the symptom
  • Test passes · ship · share what you learned

How to use this template

  1. Click Use this template. It opens in the Kelvo app as a new board, saved in your browser.
  2. Double-click any box to change its text. Replace the examples with your own content.
  3. Paste a table. Paste comma- or tab-separated text and it becomes a table. Tab moves to the next cell and adds rows as you go.
  4. Paste code as code. Paste a snippet and it becomes a code block with syntax colouring; Tab indents inside it.
  5. Link by dragging. Hover a box and drag one of its dots onto another box. The whole box is the target, and links stay attached when you move things.

Good for

  • debugging
  • bug
  • troubleshooting
  • engineer
  • process
  • Designing a schema or an API before writing it
  • Explaining a tricky flow in a code review or design doc
  • Agreeing on team conventions such as branching and reviews

Related templates

  • ER diagram (database schema) template previewER diagram (database schema)

    Entities as tables with columns, types and keys, joined by one-to-many relationships — sketch a schema before the migration.

  • UML class diagram template previewUML class diagram

    Classes with fields and methods, associations with multiplicity, and an interface with two implementations.

  • State machine template previewState machine

    Every state an order can be in and the events that move it — the source of truth for status logic and tests.

  • Sequence diagram (request flow) template previewSequence diagram (request flow)

    Numbered steps across Client, API gateway, service, database and a third party — how one checkout request really travels.

  • Basic flowchart template previewBasic flowchart

    Start, steps, a decision with yes/no branches, and an end — the classic shape to build from.

  • Approval workflow template previewApproval workflow

    A request moves through manager and finance approval, with rejection and rework loops.

All software engineering diagram templates · All templates

Use the debugging flow template