Amirali YaghoutiSenior Software Engineer

webapp Case study

Internal Team Workflow Bot

Internal work stalls at handoffs. A task is finished by one person and sits until someone notices it is their turn, and the visible symptom is always that management asks where something is.

The business problem

Task tracking existed in a Trello-style board, which records state but does not move work. The transition between one person finishing and the next person starting depended on somebody looking, and that is where the time went. Automating it fully was not right either, since some of those transitions genuinely need a decision.

What I delivered

  • A workflow bot that routes tasks by role, so a completed step reaches the next owner without anybody checking a board.
  • Approval checkpoints on the transitions where a decision is genuinely required, rather than on every transition.
  • Management notification at checkpoints rather than at every state change, so visibility does not turn into noise.
  • Alignment with the existing Trello-style board rather than replacing it, since the team already knew where to look.
  • Error branches, so a routing failure surfaces instead of leaving a task in limbo.

Technical approach

  • Role-based routing rather than named-person routing, so the workflow survives someone being away or changing job.
  • Approval gates are placed selectively. A checkpoint on every step trains people to approve without reading, which removes the control while keeping the friction.
  • The existing board stays as the source of truth for state. Introducing a second place to look would have been the fastest way to have the bot ignored.
  • Management notifications are tied to checkpoints, because the useful signal is that something is waiting for a decision, not that work is happening.

Result and evidence

Tasks move to their next owner instead of waiting to be noticed, and the checkpoints that need a decision are the ones that generate a notification.

Commercial value

Most internal delay is not work, it is waiting. Removing the handoff latency is usually the cheapest available improvement to how fast a team delivers.

implementation-brief.readme

Readable implementation brief

implementation_brief {
  project: "Internal Team Workflow Bot"
  routing: "by role, never by named person"
  gates: "approval only where a decision is genuinely needed"
  visibility: "management notified at checkpoints, not events"
  integration: "existing Trello-style board stays the source
                of truth for state"
  failure: "explicit error branch; no task left in limbo"
}

What this project shows

Routing by role rather than by person is a small modelling decision that determines whether the workflow still works in six months.

Not replacing the board the team already used was deliberate. Adoption beats capability, and a tool people have to remember to check is a tool they will not check.