Artist Workspace

Every artist has a workspace — a directory that holds context, songs, and reference material. The RECOUP.md file at the root connects it to the Recoupable platform.

Artist directories live inside the sandbox at orgs/{org}/artists/{artist-slug}/.

Entering an Artist Workspace

When starting work in an artist directory:

1. Read RECOUP.md to confirm you're in an artist workspace and get the artist's name, slug, and ID.
2. Check what exists — ls the directory to see which files and folders are already there.
3. Read context/artist.md if it exists — this is the source of truth for who the artist is. Everything you do should be consistent with it.
4. Check recent git history for this artist — from the repo root, git log --oneline -10 -- artists/{artist-slug}/ shows only commits that touched this artist's files. If you're already inside the artist directory, use git log --oneline -10 -- . instead. Read the commit messages to understand recent changes before making your own.

Working in an Artist Directory