Daily workflow
A normal Exosuit day starts by asking the project where it is. Do that before you ask an agent to write code. The point is to work from the project’s current state, not from whatever the chat happens to remember.
Start with status
Section titled “Start with status”Run:
exo statusThis tells you the active phase, goals, tasks, and git state. If you are coming back cold, read this before doing anything else.
Then ask for the map:
exo mapexo map is the practical steering surface. It shows the active work and
suggests next actions. If you want one answer instead of the whole map:
exo map --nextIf a suggested command looks surprising, ask why:
exo map --why "exo task start <task-id>"Pick one unit of work
Section titled “Pick one unit of work”Use the hierarchy to keep the day small enough to reason about:
exo goal listexo task listPick the task that belongs to the current goal. Start it before making changes:
exo task start <task-id>As you work, log concrete progress:
exo task log <task-id> --log "What changed and what you learned"The log is not a diary. It is the breadcrumb that lets the next session recover the thread.
Use SOAR for the day
Section titled “Use SOAR for the day”The daily loop is SOAR: Status → Orient → Act → Review.
- Status:
exo status - Orient:
exo map - Act: edit files, run commands, log progress
- Review: run checks and record the outcome
You do not need to make this ceremonial. Just keep returning to the loop instead of letting the chat drift.
Use PER for a real change
Section titled “Use PER for a real change”When the task is more than a quick edit, switch to Prepare → Execute → Review:
- Prepare: audit the plan against the codebase.
- Execute: make the bounded change.
- Review: compare the result to what Prepare predicted.
PER is heavier than SOAR. Use it when the work has enough uncertainty that you want an explicit gate before execution.
Verify and close
Section titled “Verify and close”Before closing a task or goal:
exo verifyThen record the result:
exo task complete <task-id> --log "What is now true"For a completed goal:
exo goal complete <goal-id> --log "What shipped and how it was verified"Completion pauses for outcome review. That is where the human decision belongs: the agent can claim the work is done, but the user records that it is done.
Coming back cold
Section titled “Coming back cold”If you come back after a break, do not ask the agent to remember. Ask the project:
exo statusexo mapgit status --shortIf the working tree is dirty, inspect before acting:
git diffThen either continue the active task, commit the finished work, or ask Exosuit to orient you again. The project should carry the thread, not the previous chat.