Bots

New bot

Instructions

The bot's CLAUDE.md: its job, who it serves, what done looks like, what it does when there is nothing to do. Example: "Each weekday, read main's CI; if it is red, post one brief to my inbox with the failing job and the commit; if it is green, post nothing."

Routines

Work it starts by itself: a schedule in plain words or an event. Example: "morning", schedule "every weekday at 8:30", budget $2 a day. Press Test on it once after Create.

Action rules

What it may do alone (act), what it does when the target matches a standing approval and asks first otherwise (preapproved, with patterns such as swarm-lab/*), what it asks you first (ask, in your inbox), and what it leaves to you (handoff). Example: push to main = handoff, message outside the fleet = ask.

Skills

Procedures it loads when needed: skills/<name>/SKILL.md, with a name and a description that says what and when. Example: name "ci-triage", description "Reads a failed CI run and names the failing step. Use when a run is red."

Your bots and the fleet's

Routines

New routine

A bot's instructions and kit are its config layer, on top of yours in its turns. Make one above (Fill it in, or Interview with Claude), change it with Edit on its card (or ask it in its chat: it drafts the change and you approve it), or push it with fleet home push --bot <name> <dir>; run it with fleet spawn --bot <name> or New chat.