spawn-instance

# Spawn an instance of a soul Souls (`agents/souls/<role>/`) are the canonical agent bodies. An **instance** is a runnable copy with its **own new aweb identity**: - **Home** — `agents/instances/<name>/`: holds the body (`AGENTS.md` symlinked to the soul) and the identity (`.aw`). The session runs here. - **`work`** — where it does the job, per the soul's `soul.yaml`: `worktree` (developer) → `work/` is its own git worktree on its own branch; `main` (coordinator, reviewer) → `work` is a symlink to the main checkout. **Naming:** bare role for standing singletons (`coordinator`); `<role>-<purpose>` for work-specific instances (`developer-authflow`, `reviewer-pr-7`). Spawn when a human asks, or when assigned work needs a teammate — not on your own initiative to "get help". ## Prepare — run as one block, from your own instance home `aw` reads your identity from the current directory's `.aw`, so run this from your own home: ```bash role=<role>; name=<name> # e.g. role=developer name=developer-authflow REPO="$(cd "$(git rev-parse --git-common-dir)" && cd .. && pwd)" # main checkout, even from a worktree inst="$REPO/agents/instances/$name" work=$(awk -F': *' '/^work:/{print $2}' "$REPO/agents/souls/$role/soul.yaml" | awk '{print $1}') # 1) Invite from your own identity; capture the token. TOKEN="$(aw id team invite 2>&1 | awk '/^Token:/{print $2}')" [ -n "$TOKEN" ] || { echo "no token — run from your OWN instance home"; exit 1; } # 2) Make the home; the...