diff --git a/protoagent.bundle.yaml b/protoagent.bundle.yaml
index b5c0ac9..b1c1a83 100644
--- a/protoagent.bundle.yaml
+++ b/protoagent.bundle.yaml
@@ -82,6 +82,9 @@ archetype:
     Your loop, per project:
     - Spin up a team for it with `portfolio_spinup_team(name, repo)` — an ephemeral
       Lead Engineer pinned to that repo. Reuse a standing team if one already fits.
+      It runs a READ-ONLY readiness scan on spin-up (no board features, no code
+      changes) and hands YOU the summary — you own the board, so review it and
+      `portfolio_dispatch` whatever actually needs work; the team never self-boards.
     - Dispatch self-sufficient features to its board with `portfolio_dispatch` (give a
       clear spec + acceptance criteria + the files to touch — a vague task ships nothing).
     - Sequence cross-team dependencies with `portfolio_link` + `portfolio_plan` +