Skip to main content
Handbook/Automate/Page 82 · Work Board

One List You Both Share

Share

Share this page

Pass it to someone who needs it.

Star on GitHub

Key takeaway: Share one work board with your agents

You now have agents that act on their own and a line between what they may do and what they must ask about. But the work itself still lives in your head, or gets buried at the bottom of a report you skimmed once. This chapter gives every piece of work one home: a shared board that you and your agents both pull from.

9.12.1One board both of you pull from

Keep one work board: a single plain file that lists everything the operation still needs to do, business and technical, in one place. You add to it. Your agents add to it. Both of you read from it.

A report tells you what already happened. The board is the opposite: it is the list of what has not happened yet. When every task lives here, none of it lives in your head, and nothing gets lost between one session and the next.

Real trackers exist and you are skipping them on purpose. GitHub Issues and Projects is the closest call: it already sits in your remote repository, and your agent can reach it. Linear, Trello, and Jira are the heavier options.

A plain file wins for now because an agent reads it with zero setup and it lives beside the code. Move to a real tracker the day a second human joins, or the day the work needs comments and history rather than a status.

You and your agents both file tickets onto one board and both pull work from it.

9.12.2Every piece of work is a ticket

Each item on the board is a ticket: a title, a status, and a who that says whether you or an agent owns it. Nothing heavier. You should read the whole board at a glance, not learn a tool.

# ticket: retry the failed payouts status: ready # idea -> needs-approval -> ready -> doing -> done who: agent note: 3 payouts failed this week; retry them once. # the status ladder idea a rough thought, not ready to work needs-approval waiting on your yes (risky, costs money, hard to undo) ready approved and safe; an agent may pick it up doing claimed and in progress (one owner at a time) done finished and logged

9.12.3Status moves one way, never backward

A ticket walks the ladder in one direction: idea, then optionally needs-approval, then ready, then doing, then done. It never jumps a rung.

The rule that makes this safe is narrow: an agent may only start a ticket that is ready and assigned to an agent. An idea is just a thought. A needs-approval is yours to clear. Only ready is open season, and only for the work you marked as an agent's to take.

A ticket climbs one rung at a time; only a ready ticket is open for an agent.

9.12.4An agent claims a ticket before it works

Before an agent touches a ready ticket, it flips the status to doing and writes its name in who. That claim is what stops two agents from grabbing the same work at once, so a team of agents can share one workspace without clobbering each other.

Then it does the smallest safe thing the ticket asks, and marks it done. If the work turns out to be risky, costly, or hard to undo, it does not push ahead: it flips the ticket to needs-approval and stops. That is the decision queue from the guardrails chapter, now generalized: every escalation, from any agent, surfaces as one ticket on the one board you already watch.

An agent claims a ready ticket, does the smallest safe thing, then marks it done or escalates.

Rule of thumb: if you cannot see all of tomorrow's work on one screen, the board has grown a process it does not need. Cut fields, not tickets.

9.12.5Stand up your shared board

This prompt turns the work in your head into a board you both share:

Ready prompt
Act as a senior engineer setting up a shared work board. Read my planner file for the current focus, my decision log so no ticket reopens a settled call, and my guardrail rules for what an agent may do unattended. Create one plain board file in my _control folder where both I and my agents file work as tickets, each with a title, a status (idea, needs-approval, ready, doing, done), and an owner. Rank the ready work by the planner's focus, not by arrival. Then have an agent take the top ready ticket assigned to it, mark it doing so nothing else grabs it, do the smallest safe thing, and mark it done. Anything my guardrails call risky, flip to needs-approval and stop. Record any real choice it makes as one line in the decision log. If you need the full reasoning behind this step, read https://zalt.me/guides/vibe-coding/ai-os/work-board My operation and the work piling up right now:

Do this now: paste the prompt, stand up your one board, and move every task living in your head onto it as a ticket.

Mahmoud Zalt

Mahmoud Zalt

Software engineer, 16+ yrs · built Sistava.com in 3 months, idea to production, using these methods

Resources
Star on GitHubContribute
Donate

Support my work

A small tip keeps the free work coming.

© 2026 Mahmoud Zalt. Free to read, not to republish.
Copyright & license