A git submodule-based workspace for the Recoup platform, business operations and project builds.
# Clone the workspace, then initialize the repositories you need.
git clone git@github.com:recoupable/mono.git
cd mono
git submodule update --init -- chat api skills
# With access to the private company repositories:
git submodule update --init -- business projects
# With access to the private Recoup Records organization repository:
git submodule update --init -- recordsRead projects/AGENTS.md before initializing a client project's repositories. Each private source
requires its own access; select only what the current task needs.
Start with AGENTS.md, which routes tasks to their owning repository and explains where
to save results. Company direction is in business/strategy/README.md; customer records and product
opportunities remain in Business's existing folders. The standalone strategy submodule is retired.
After initializing Business, use business/strategy/migration-2026-09-16.md for historical paths.
Existing local Strategy checkouts may remain as preserved history; do not create new work there.
| Submodule | Purpose |
|---|---|
chat |
Artist and label web application |
api |
Backend API and new background workflows |
marketing |
Marketing website and landing pages |
docs |
Public API documentation |
cli |
Command-line interface |
skills |
Public reusable agent skills |
open-agents |
Reference application for background coding agents |
admin |
Internal platform administration |
tasks |
Existing Trigger.dev jobs; new jobs belong in API workflows |
database |
Supabase migrations |
gtm |
Internal go-to-market tooling |
blog |
Blog repository |
plugins |
Plugin repository; read its local instructions |
business |
Private company strategy, product opportunities, customers and operations |
projects |
Private technical project maps and client repository links |
records |
Private Recoup Records organization workspace and label operations |
Build the Recoup platform in its application submodules and operate Recoup Records in records/.
Read records/AGENTS.md before label work. Its repository retains independent access and history;
public Mono tracks only its URL and commit reference. Keep private operating material in Records
or its approved private storage. Verify hosted Recoup session readback separately from local Git.
This monorepo is designed for LLM-assisted development. Each submodule contains its own agent context files with project-specific instructions.
AGENTS.md(root): Monorepo-wide guidance, git workflow, cross-project architecture — source of truth for all AI agentsCLAUDE.md(root): Symlink toAGENTS.md— so Claude automatically picks up the same instructions- Each submodule's context files: Project-specific build commands, patterns, and conventions
- API Docs: https://developers.recoupable.com (LLM-readable)
- Start with context: Point your LLM to
AGENTS.md(orCLAUDE.md) at the root for overall guidance - Work in submodules: Each submodule is an independent git repo - cd into the relevant folder
- Branch workflow: Never push directly to
main. Use feature branches and PRs - Release branches: Recoup platform, Business and Projects PRs target
main. Client project repositories follow their own verified release branches.
chat (frontend) → api (backend) → Supabase (database)
↓
tasks (async jobs)
Recoup application repositories use pnpm. For work under projects/, follow the selected project's
own build and package-manager instructions. Common Recoup application commands:
pnpm install # Install dependencies
pnpm dev # Start dev server
pnpm build # Production build
pnpm lint # Fix lint issues
pnpm format # Run prettier