The Map
Know what each part does and the order to set it up.
A playbook pack for AI agent teams
Bots plan, build, and review each other's work. You say "yes" only at the gates that matter: merge, deploy, release, and every message that leaves your team.
The pack is not available yet.
Proof with every result: a passing test, a preview link, or a screenshot.
What changes
Without clear roles, one AI agent can get every job. Then nobody owns the result, and nothing stops a bad change.
Every rule comes from a setup that the author runs every day.
How it works
The bots check each other's work before you see it.
Nine bot roles. Each role has one job, one lane, and hard stops.
Build agents write the code. Review agents check it. A gate post tells you what is still open.
Every result comes with a passing test, a preview link, or a screenshot.
Seven points where a bot must stop and wait for a human "yes".
A human only at key gates
No change goes into main without your "yes".
No deploy goes to production without your "yes".
No build goes to a store without your "yes".
Bots draft messages to people outside the team. You push Send.
The pack has seven gates. The full gate table is inside.
Fit check
Inside the pack
Know what each part does and the order to set it up.
Give every agent a job spec with a fixed shape and hard stops.
Nine roles, clear lanes, and seven points where only you can say yes.
Match build work and thinking work to the right class of AI model.
Get small pull requests with tests and proof, not direct edits on your machine.
Every handoff happens in the open, and a rule keeps each project's context apart.
Review agents check the work, and every result arrives with proof.
Simple code, small changes, tests, and proof before "done".
Turn a job that works once into a job that runs on a schedule.
One bot ships the builds and keeps an exact record of what is out.
Bot replies in simple English, and a rule to clean up secrets after each job.
Before you buy
Read this list first. The pack does not work without these items.
The setup steps are written for one specific AI agent platform. You can adapt the rules to other tools. The setup steps may not work as written on other tools.
FAQ
No. The bots stop at the gates. You approve merge to main, production deploy, store release, and outside messages.
No. You must read and approve pull requests.
You get the full stack list inside. It uses commercial AI agent tools that need their own paid plans.
Yes. The AI agent tools need their own paid plans. You also need a code repo.
Maybe. The rules and role cards work as text in most AI agent tools. The setup steps are for one specific platform.
This page makes no result claims.
Madson Cardoso, a senior software engineer and fractional CTO in Lisbon, Portugal. Read the full bio in the author section.
Bots plan, build, and review. You approve at the gates.
The pack is not available yet.