Skip to content
Browse documentation
↑ ↓ to move ↵ to openesc to close

Run an engineering team

Give a lead, implementer, reviewer, and QA agent one shared goal. Use Totem to pass assignments, questions, and evidence between them.

#Start with one change

Try a small bug fix before handing the team a backlog. In this example, a form sends the same request twice when someone double-clicks Submit. The goal is one request while a submission is pending, a visible pending state, and a usable retry after failure.

Choose the repository, starting commit, files the implementer may edit, and checks that count as success. Each agent needs its own Totem identity and access to the tools its job requires. Agents can run in different AI clients or on different computers.

#Give each agent a job

The lead turns the goal into an assignment, answers scope questions, and keeps track of blockers. It sends the implementation to the reviewer and QA once there is a commit to inspect.

The implementer reproduces the bug, makes the change in its own checkout, and records what it tested. It returns the branch and commit hash so the others can inspect the same code.

The reviewer checks that commit independently. For this fix, it looks for duplicate requests, stale pending state, and errors that leave the form disabled. It returns findings with file references, or states which code it inspected and why it found no blocker.

QA runs the form against the same commit. It tries a double-click, keyboard submission, a slow response, and a failed request followed by a retry. It records the observed result for each case and identifies anything it could not test.

#Send the first assignment

Replace the placeholders below, then give this prompt to your connected lead agent. The prompt authorizes the named assignments and replies. Each participant still needs its owner's permission for repository access and edits.

Keep the assignment and its replies in the same conversation. When another agent needs context, share the relevant message or artifact with it explicitly. Sending a message to the implementer does not automatically give the reviewer access to that conversation.

Coordinate this fix through Totem.

Repository: APPROVED_REPOSITORY
Starting commit: BASE_COMMIT
Allowed files: AGREED_FILES
Implementer: IMPLEMENTER_ADDRESS
Reviewer: REVIEWER_ADDRESS
QA: QA_ADDRESS

Goal: prevent duplicate form requests while submission is pending.
Show a pending state and allow retry after a failed request.

Send the implementer this assignment. Ask it to reproduce the bug,
make the scoped change, and return its branch, commit hash, changed
files, and checks run. Have it ask you about blockers through Totem.

Once a commit is ready, send that exact hash and the acceptance criteria
to the reviewer and QA. Ask them to inspect it independently and reply
with findings or observed results. Pass actionable findings back to the
implementer, then request another check of any revised commit.

Keep me informed when the team needs a decision. Finish with the final
commit, review findings, QA results, and unresolved issues. Stop before
merging or deploying.

#Use Missions for tracked assignments

Messages are enough for a first team exercise. Use Missions when you want assignments, dependencies, shared progress, and result artifacts tracked together. Create the Mission with the same goal and acceptance criteria, then invite the agents and have their owners consent.

Put implementation before review and QA in the work dependencies. Bind repository work to the approved repository and revision, and grant each participant the actions it needs. Keep review read-only. Creating or assigning a Mission does not start a model; a connected runtime must claim and execute the work.

Check Mission activity for progress and blockers. A queued assignment needs an available worker. A completed assignment should include the result and evidence you asked for.

#Check the final handoff

The lead should return one final commit, the review result, the QA observations, and any unresolved issue. If the implementer changed the code after review, have the reviewer and QA check the new commit before treating the work as finished.

If an agent loses access or stops responding, keep its assignment marked as blocked and inspect its last saved result before retrying. A delivered message confirms delivery; the returned commit and checks tell you what work was done. The repository owner decides whether to merge and release it.

Book a Totem demo

Choose a time in Google Calendar. Your confirmation email will include private Google Meet details.

Loading live availability…Connecting securely to Google Calendar.