From 42ffa4cb073405a337a86aa3f7959bda4610820d Mon Sep 17 00:00:00 2001
From: Recoup Agent <agent@recoupable.com>
Date: Sat, 14 Mar 2026 23:12:54 +0000
Subject: [PATCH] agent: @U0AJM7X8FBR @U0AJM7X8FBR become an expert at this
 repo https://github.c

---
 brand-guidelines       |  1 -
 chartmetric            |  1 -
 release-management     |  1 -
 setup-artist           |  1 -
 setup-sandbox          |  1 -
 setup-sandbox/SKILL.md | 67 ++++++++++++++++++++++++++++++++++++++++++
 songwriting            |  1 -
 7 files changed, 67 insertions(+), 6 deletions(-)
 delete mode 160000 brand-guidelines
 delete mode 160000 chartmetric
 delete mode 160000 release-management
 delete mode 160000 setup-artist
 delete mode 160000 setup-sandbox
 create mode 100644 setup-sandbox/SKILL.md
 delete mode 160000 songwriting

diff --git a/brand-guidelines b/brand-guidelines
deleted file mode 160000
index 293f749..0000000
--- a/brand-guidelines
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 293f7495f2e0ce1cc3ec539a3f00e2cb4784f833
diff --git a/chartmetric b/chartmetric
deleted file mode 160000
index 5ce7ec6..0000000
--- a/chartmetric
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 5ce7ec6860d936fac84908e04aef0c211ab9e9c5
diff --git a/release-management b/release-management
deleted file mode 160000
index ab75484..0000000
--- a/release-management
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit ab7548422556fee31c505f429d106f2d80d034d9
diff --git a/setup-artist b/setup-artist
deleted file mode 160000
index ba7270b..0000000
--- a/setup-artist
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit ba7270b2e1648166430794e2bfa791e2fa7e4596
diff --git a/setup-sandbox b/setup-sandbox
deleted file mode 160000
index 2c43957..0000000
--- a/setup-sandbox
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 2c4395733f866ece38628eaa3772913fef48b5ef
diff --git a/setup-sandbox/SKILL.md b/setup-sandbox/SKILL.md
new file mode 100644
index 0000000..b3abd3d
--- /dev/null
+++ b/setup-sandbox/SKILL.md
@@ -0,0 +1,67 @@
+---
+name: setup-sandbox
+description: Set up the initial file system for a new sandbox. Fetches the account's organizations and artists via the Recoup CLI and scaffolds an opinionated folder structure. Use when a sandbox has just been created and has no existing file system. Before running, check if the sandbox already has an orgs/ directory — if it does, this skill is not needed.
+---
+
+# Setup Sandbox
+
+Create the folder structure for the connected account's organizations and artists.
+
+## Environment
+
+- `RECOUP_ACCOUNT_ID` — The account ID to fetch data for. Only needed when using an Org API Key. When using a Personal API Key, omit the `--account` flag and the CLI will use the authenticated account automatically.
+
+## Steps
+
+1. Check if `RECOUP_ACCOUNT_ID` is set. If set, use `--account $RECOUP_ACCOUNT_ID` on all CLI commands below. If not set, omit the `--account` flag.
+2. Run `recoup orgs list --json [--account $RECOUP_ACCOUNT_ID]` to get all organizations
+3. For each organization, run `recoup artists list --org {organization_id} --json [--account $RECOUP_ACCOUNT_ID]` to get its artists
+4. Create the folder structure and a `RECOUP.md` marker in each artist folder:
+   - `mkdir -p orgs/{org}/artists/{artist-slug}` for each org/artist pair
+   - Write a `RECOUP.md` in each artist folder using the template below
+5. Commit and push:
+   - `git add -A && git commit -m "setup: create org and artist folders" && git push origin main`
+
+## `RECOUP.md`
+
+Every artist directory has a `RECOUP.md` at its root. This is the **identity file** — it connects the workspace to the Recoupable platform and tracks setup status. It stays permanently.
+
+Fill it with data from the CLI response:
+
+```markdown
+---
+artistName: {Artist Name}
+artistSlug: {artist-slug}
+artistId: {uuid-from-recoupable}
+status: not-setup
+---
+
+# {Artist Name}
+
+This artist workspace has not been set up yet.
+
+Run the `setup-artist` skill to scaffold it — that will create the full directory structure, context files, memory system, and README files.
+```
+
+**Fields:**
+
+- `artistName` — display name from the CLI (e.g. `Gatsby Grace`)
+- `artistSlug` — lowercase-kebab-case folder name (e.g. `gatsby-grace`)
+- `artistId` — the UUID from Recoup
+- `status` — `not-setup` at creation, updated to `active` by the `setup-artist` skill
+
+## Next Steps
+
+After the sandbox is set up, run the `setup-artist` skill for each artist. If the skill is not installed, install it first:
+
+```bash
+npx skills add recoupable/setup-artist
+```
+
+Find which artists still need setup:
+
+```bash
+grep -rl "status: not-setup" orgs/*/artists/*/RECOUP.md
+```
+
+Any `RECOUP.md` with `status: not-setup` hasn't been scaffolded yet. Run `setup-artist` for each one.
diff --git a/songwriting b/songwriting
deleted file mode 160000
index 0bf6e8b..0000000
--- a/songwriting
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 0bf6e8b2c9e5f4744979452344690a4251534fb5