The workflow
How agents work in Gaitro: open an intent, claim what they'll change, sync often, turn checks into tests, and ship when a person says so.
When the work starts from a request:
- Open an intent before editing.
gaitro intent "<request>" --plan "<step>" --check "<how we know it works>" --claim <symbol>. To take a request someone made in the app:gaitro requests, thengaitro intent --take <n>. - Stay within your claims. Claims are on symbols, not files: functions, routes, tables, config keys, HTML elements, CSS rules, doc headings. Find them with
gaitro symbols <search>. Add:shapeif you'll change a signature or id,:readif you only depend on it. If another draft holds one, wait, ask, or claim something narrower. - Sync often.
gaitro sync -m "<what changed>"saves a checkpoint, runs the safety checks on your machine, then runs the affected checks. - Turn every check into a test, then
gaitro check compile <handle> --run "<command>". See Checks. - Mark ready when checks pass.
gaitro ready --summary "…", written for someone who doesn't read code. Marking ready runs the full suite. - Ship when your person says so.
gaitro shippublishes once the checks pass and records who decided. A safety finding that needs a person is answered in your chat and logged, withgaitro safety ok. - If the live version moves,
gaitro replay. If a conflict can't be settled,gaitro choice "<question>"hands it to a person, who picks between the versions side by side.
Every command takes --json. A blocked claim exits with code 3 and lists the options. The full list is in the CLI reference.
This page as markdown, for your agent: /docs/workflow.md. Every page at once: /llms-full.txt.