Skip to content

// Automation Basics

Automate the right things, in the right order.

Not everything should be automated. The teams that get the most value from automation start with high-frequency, low-judgment tasks and expand methodically. This guide covers how to identify those tasks, calculate whether automation is worth the investment, and implement the most common patterns.

What should you automate first?

You should automate tasks that are high-frequency, follow predictable steps, and create problems when done inconsistently. The best automation targets are not the most complex workflows - they are the boring, repetitive ones that someone on your team does multiple times per week without thinking. Creating a card from a bug report, moving a task to Done when a PR merges, sending a Slack notification when a due date approaches. These are the tasks where automation delivers immediate, measurable time savings with minimal implementation risk.

The mistake most teams make is automating the wrong things first. They build a complex multi-step workflow that orchestrates four tools and handles twelve edge cases before they have automated the simple card-creation step that happens twenty times per week. Complex automation is fragile, hard to debug, and often solves a problem that affects three people once a month. Simple automation is robust, easy to maintain, and saves the entire team time every day.

To find your best automation targets, audit your team's manual work for one week. Every time someone creates a card by hand, moves a card based on an external event, sends a status message, or copies data between systems, note it. At the end of the week, rank the tasks by frequency multiplied by time-per-execution. The top three are your first automation candidates.

How do you calculate the ROI of automation?

Automation ROI is straightforward arithmetic, but most teams skip the calculation and either automate everything (wasting engineering time on low-value automations) or automate nothing (leaving high-value time savings on the table). A simple framework prevents both mistakes.

The formula

For any manual task, calculate its annual time cost: time per execution x frequency per week x 50 weeks. Then estimate the automation cost: implementation time + (annual maintenance, roughly 15% of implementation time). If the annual time saved exceeds the first-year automation cost, it is worth doing.

Task Time per execution Frequency per week Annual time cost Estimated automation time Payback period
Create card from support ticket 2 minutes 15 25 hours 3 hours 6 weeks
Move card on PR merge 30 seconds 20 8.3 hours 2 hours 12 weeks
Post weekly status report 30 minutes 1 25 hours 4 hours 8 weeks
Archive stale cards 10 minutes 1 8.3 hours 2 hours 12 weeks
Notify team on due date approach 1 minute 10 8.3 hours 2 hours 12 weeks

Notice that every task in the table pays back within its first quarter. This is typical for high-frequency automation targets. Tasks that happen less than once a week rarely justify the setup cost unless they are particularly time-consuming or error-prone.

Hidden benefits the formula misses

The ROI formula captures time savings but not consistency benefits. When a human creates cards from support tickets, the quality varies - some cards have full reproduction steps, others are one-liners. Automated card creation is identical every time: same structure, same fields, same labels. This consistency makes the board more useful for everyone, not just the person who would have created the card manually.

There is also the cognitive load benefit. Knowing that the card will be created automatically means no one has to remember to do it. Freed mental bandwidth is real even if it does not appear in a time-tracking spreadsheet.

What are the most common automation patterns?

Five patterns cover 90% of project management automation. Each one follows the same three-step structure: detect trigger (something happened), transform data (map the event to your card format), and execute action (call the API). Master these five and you can automate almost any workflow.

Pattern 1: Card creation from external events

The most common pattern. An event happens outside your project management tool - a support ticket is filed, a GitHub issue is opened, a monitoring alert fires - and a card is automatically created on your kanban board with the relevant details.

Implementation: a webhook handler or no-code trigger watches for the external event. When it fires, the handler maps the event data (title, description, priority, source URL) to the Flux card format and calls POST /api/cards. Include an idempotency key derived from the source event ID (e.g., the GitHub issue number) to prevent duplicate cards if the webhook fires twice.

This pattern works with Zapier for simple cases (Google Form to card, email to card) or as a custom script for sources that need data transformation (parsing structured fields from a support ticket, extracting severity from a monitoring alert).

Pattern 2: Card movement on pipeline events

When code ships, the board should reflect it automatically. The most common trigger is a PR merge: a GitHub Action parses the card ID from the branch name or commit message, then calls the Flux API to move the card to the Review or Done column. A more complete version also handles deploy events - moving the card to Done only after the deploy succeeds, not just after the merge.

The key implementation detail is card ID extraction. Establish a convention: branch names like feat/PL-42-add-search or commit messages containing [PL-42]. Your automation script parses the human-readable card ID and uses it to look up the card via the API. Consistent naming conventions make this pattern reliable; inconsistent conventions make it fragile.

Pattern 3: Notification dispatch

When a card changes status, the right people should know about it. A polling script checks the board state every few minutes via the API, compares it to the previous snapshot, and fires notifications for changes: card moved to Review (notify reviewers), card moved to Done (notify stakeholders), due date within 24 hours (notify assignee). See the notification automation guide for Slack, Discord, and email implementation details.

Pattern 4: Scheduled cleanup

Boards accumulate clutter: cards in Done for weeks, stale cards in Backlog that will never be prioritized, cards with past due dates that no one updated. A weekly cron job can archive cards that have been in Done for more than 14 days, flag cards in Backlog with no activity for 30 days, and post a summary of aging cards that might need attention.

Pattern 5: Reporting aggregation

A weekly script queries the board API, computes throughput (cards completed this week), average cycle time, cards by label, and cards by assignee, then posts a formatted summary to Slack or email. This replaces the manual status report and gives leadership consistent metrics without anyone compiling them by hand.

When should you not automate?

Not every task benefits from automation. Automating the wrong things wastes engineering time and creates maintenance burden that outweighs the savings. Avoid automating tasks that:

  • Require judgment. Triaging a bug report by severity requires reading the description and understanding the impact. An AI agent can assist, but a deterministic script will get it wrong. If the task requires understanding context, automate the mechanical parts (card creation) but leave the judgment parts (priority assignment) to humans.
  • Happen rarely. A task that happens once a month and takes five minutes costs one hour per year. Automating it takes three hours. You will never break even, and you will spend time maintaining a script that runs twelve times a year.
  • Change frequently. If the process itself is still evolving - you are experimenting with new columns, changing label schemas, or reorganizing workflows - hardcoding automation against the current structure means rewriting it every time the process changes. Wait until the process stabilizes.
  • Have complex error states. If the automation can fail in ways that are hard to detect and costly to recover from (creating duplicate cards across workspaces, moving cards to wrong columns, overwriting card data), the risk outweighs the convenience. Start with read-only automations (notifications, reports) before graduating to write automations (card creation, movement).

The principle is: automate the mechanical, leave the strategic. Your team should spend zero time on data entry and 100% of their time on decisions about what to build and how to build it. Automation should remove the first category without attempting to replace the second.

What does an implementation checklist look like?

Use this checklist when setting up any new automation. It applies whether you are using a no-code platform or writing a custom script.

  • Identify the trigger. What event starts the automation? Be specific: "a PR with a card ID in the branch name is merged to main," not "code ships."
  • Define the action. What exactly should happen? "Create a card in the Backlog column of board X with the issue title as the card title and the issue body as the description."
  • Map the data. Which fields from the trigger event map to which fields in the API call? Write down the mapping before you code it.
  • Add idempotency. Derive an idempotency key from the source event ID. This prevents duplicate actions on retry.
  • Handle errors. What happens when the API returns a 404 (board deleted), 403 (key revoked), or 500 (server error)? At minimum: log the failure and alert the team. Do not silently drop events.
  • Test with real data. Create a test board, run the automation against it with real trigger events, and verify the output. Synthetic test data misses edge cases in field mapping.
  • Monitor for a week. Watch for unexpected behavior: duplicate cards, missing fields, timing issues. Fix issues before expanding to more boards or workflows.

For the next step beyond basics - connecting your kanban board directly to your CI/CD pipeline - continue with the CI/CD workflows guide. For connecting tools without writing code, see the no-code automation guide covering Zapier, Make, and n8n.

// FAQ
03 questions
01

What tasks should you automate first?

+

Start with tasks that are high-frequency (happen more than twice per week), low-judgment (follow the same steps every time), and error-prone when done manually. The top three candidates for most teams are: creating cards from external sources like bug reports or support tickets, moving cards when CI/CD events fire (PR merge, deploy success), and sending notifications when card status changes. These deliver the highest time savings with the simplest implementation.

02

How do you calculate ROI for workflow automation?

+

Multiply the time per manual execution by the number of times you do it per week, then multiply by 50 weeks. That gives you annual time cost. Compare it against estimated setup time plus ongoing maintenance (usually 10-20% of setup time per year). For example, a task that takes 2 minutes and happens 15 times per week costs 25 hours per year. If automating it takes 3 hours to build, the payback period is about 6 weeks.

03

What are the most common automation patterns for kanban boards?

+

The five most common patterns are: card creation from external events (support ticket, GitHub issue, form submission), card movement based on pipeline events (PR merged, build passed, deploy succeeded), notification dispatch on status changes (Slack message, email alert), scheduled cleanup (archive stale cards, flag aging work), and reporting aggregation (weekly throughput, cycle time summaries posted to a channel). Each pattern follows the same structure: detect trigger, transform data, call API.

// Start automating

Automate the busywork. Free to start.

REST API with scoped keys. Automate card creation, status updates, and notifications - no credit card required.