Recoup — Onboard Roster
Bootstrap a brand-new/empty org: turn a list of artist names into a fully created + enriched roster by
fanning recoup-roster-add-artist out across parallel subagents. The empty-org entry point that
recoup-platform-build-os hands off to.
Procedure
- Confirm the roster is actually empty. Via
recoup-platform-api-access, roster-discover (GET /accounts/id->GET /organizations->GET /artists?org_id=…). If any artists already exist, stop — that'srecoup-roster-add-artist(one more) orrecoup-platform-build-os(scaffold) territory, not a bootstrap. Never run on a populated roster. - Refuse throwaway accounts. If
/accounts/idresolves to anagent+…@recoupable.comemail, stop and ask for a real-account credential — artists created under a throwaway key get orphaned. - Get the roster to create. Either:
- the user supplies names (or a pasted / CSV list) — use those; or
- they want A&R help — run
recoup-research-find-talentto propose candidates, then confirm the final list with the user before creating anything (creation is a real, billable mutation on the live account).
- Fan out (parallel subagents). For each confirmed artist, dispatch a subagent that runs
recoup-roster-add-artistfor that one name (the create -> Spotify -> research -> catalog -> socials -> knowledge-base chain; writesartists/{slug}/RECOUP.md). Run them in parallel, but keep the batch to a sane width (≈5–8 at a time); pass each subagent only its one artist plus the org/auth context. Skip any name already on the roster. - Reconcile. When the subagents finish, run
recoup-roster-list-artiststo verify every intended artist now exists; retry the ones that failed (never fabricate a success). - Hand back. Return to
recoup-platform-build-osto scaffold / refresh the workspace around the now-populated roster.
Guardrails
- API-first — never
mkdira roster. Each artist is created throughrecoup-roster-add-artist(which goes through the Recoup API); folders follow from the API result. - Confirm names before creating. Creating artists costs credits and writes to the live account — no silent bulk-create.
- Idempotent. Skip artists that already exist; safe to re-run after a partial failure.
- One artist per subagent. Keeps each chain resumable and isolates failures.