Help & Documentation

Versitalent OS is a control room for modern releases. It centralizes creator onboarding, release management, distribution, automation, analytics, and the AI layers that keep the entire lifecycle running. Every module is designed so that an internal team can move from onboarding a new creator to delivering measurable momentum without leaving the OS.

The mission: give independent teams major-label grade tooling with a guided, automation-friendly workflow. The OS combines AI-powered copilots, transparent data, and flexible campaign tooling so that new teammates can jump in and understand the entire organism of releases, tasks, and health signals.

• Creators – onboarding, support, payouts, submissions.
• Releases – metadata, artwork, audio, readiness scoring.
• Distribution – provider sync, status tracking, store links.
• Campaigns & Tasks – structured playbooks that become Smart Tasks.
• AI Ops & Strategy – audits, insights, and executable plans.
• Analytics & Intelligence – real-time stats, predictive trends.
• Automation Loop – keeps distribution, AI refreshes, and tasks up to date.
• System Hub – profit, workflows, diagnostics, settings, learning.
• Dashboard – metrics, activity, shortcuts, and recommendations.

Releases flow through the OS in a predictable lifecycle. Creators submit new music, the internal team reviews, a release record is created, distribution jobs keep providers in sync, analytics ingest performance, the intelligence layer forecasts momentum, and Smart Tasks ensure nothing is missed. The control room surfaces everything through the home dashboard and documentation acts as a living manual.

[Creator Upload]
     ↓
[Internal Review]
     ↓
[Release]
     ↓
[Distribution Job]
     ↓
[Store Links & Royalties]
     ↓
[Analytics Engine]
     ↓
[Intelligence & Strategy Engine]
     ↓
[Smart Tasks]
     ↓
[Activity Feed & Dashboard]

Plan mode covers release setup, playbooks, creative identity, and the smart release queue. Start here when you’re deciding what to ship and how to frame it.

• Release Wizard and repurpose selector
• Creators and creative identity
• Strategy templates and playbooks
• Smart release queue (cadence planning)
• Guided onboarding for new operators

Execute mode is where tasks, promo, campaigns, distribution, AI ops, and workflows run. Use it daily to push releases and outreach forward.

• Smart Task Board and campaign tasks
• Promo CRM and social/promo ops
• Campaign studio and templates
• Distribution hub and submissions
• AI Ops, automation console, and workflows

Review mode centralizes measurement: analytics, intelligence, experiments, optimization, catalog insights, profitability, and the activity log.

• Analytics overview and entity search
• Experiments, optimization, and catalog intelligence
• Profitability command center and release queue
• Activity log for automation and system events

The end-to-end flow: ingest audio → plan release → execute campaigns & distribution → review performance → tune profitability. Use this as a checklist for new team members.

1. Plan: release wizard, creative identity, strategy template.
2. Execute: tasks, promo, campaigns, distribution, AI ops.
3. Review: analytics, intelligence, profitability, activity.
4. System: automation hygiene, diagnostics, settings, learn.

Creators enter Versitalent OS through an invite-only flow. Internal teams generate invites, share access links, and track status from the Settings & Invite manager. Each invite carries metadata about the creator role (artist, label partner, collaborator) and can optionally be linked to a participant ID for payouts.

Once a creator accepts the invite they receive a dashboard with release checklists, asset uploads, and distribution readiness indicators. The creator dashboard reflects the same data internal teams see, ensuring copy, artwork, and metadata are aligned before release. The OS enforces required fields, file specs, and displays any compliance issues directly on their panel.

• Invite generation – create invites with role, expiration, and payload.
• Registration – creators confirm profile, contact, banking.
• Submissions – audio, artwork, splits, and marketing approvals.
• Creator lifecycle – active creators sync with releases, campaigns, and payouts.

Every creator record powers analytics, strategy, and automation. Cleaning creator data up front means releases automatically inherit accurate metadata later.

Releases live at the heart of Versitalent OS. They combine metadata, assets, artwork, audio, marketing notes, and readiness scoring. Releases can be created manually by the internal team or converted from creator submissions. Each release is linked to a creator, optional label, and automation profile.

• Metadata – title, ISRC/UPC, genre, release date, DSP requirements.
• Assets – hi-res artwork, lossless masters, stems, promo clips.
• Release intelligence – audits, predicted impact, social context.
• Campaign alignment – releases attach to smart campaigns and tasks inherit release data.

The release detail page highlights readiness issues, outstanding approvals, and AI-suggested actions. It also becomes the anchor for campaign steps, distribution jobs, and analytics.

The Release Playbook is the operating system for taking a song idea all the way through distribution, marketing, and post-launch reflection. It keeps every release on rails so the team can ship faster without skipping critical checkpoints.

Collect assets, metadata, and creative intent. Run quick AI/ops audits to flag missing artwork, stems, or marketing context before moving forward.

Confirm creator + release metadata, providers, target release date, territories, and delivery assets. Generate smart links + cover art variations while the distributor ingests the job.

Choose the right launch template (lean organic vs. ad test), align with campaign goals, and optionally run Strategy Engine to seed recommendations tied to the release.

Auto-generate Smart Tasks mapped to campaign steps. Assign owners, due dates, and automation triggers so every tactic (content, pitching, paid tests) is tracked.

Use Analytics + Intelligence dashboards to monitor traction, creative tests, and channel health. Feed signals back into campaign steps or new automation suggestions.

Close the loop with revenue + engagement snapshots. Document what worked, archive learnings into templates, and prep the next release cycle with better data.

The Distribution Hub orchestrates deliveries to DSP providers. Every delivery is represented by a distribution job that tracks payloads, status, provider response, and store links. Internal teams can trigger syncs, resolve failures, and view aggregated release summaries.

• Providers – configure partner integrations, authentication, and defaults.
• Jobs – each job ties a release to a provider with payload metadata.
• Sync – manual retriggers call provider webhooks to fetch the latest status.
• Store links – once live, store URLs are captured and exposed to artists and marketing.
• Troubleshooting – failed jobs include provider error payloads, audit logs, and fix suggestions.

AI Ops supports distribution by running release audits before delivery, suggesting missing metadata, and recommending follow-up actions when jobs stall. Automation can optionally re-sync stale jobs or refresh store links on a schedule.

Campaign templates are curated playbooks. They define tone, cadence, and the execution rhythm for launches, rollout boosts, or evergreen storytelling. Internal teams duplicate templates into campaign instances, adjust timing, and let Smart Tasks do the heavy lifting.

• Templates – reusable frameworks for pre-save pushes, PR runs, or UGC bursts.
• Steps – sequential or parallel pieces that describe what needs to happen.
• Auto-creation – steps generate Smart Tasks with context pulled from the release.
• Timeline – campaigns visualize start/end dates, lagging tasks, and dependency health.

[Campaign Template]
     ↓
[Campaign Instance]
     ↓
[Campaign Steps]
     ↓
[Smart Tasks]
     ↓
[Execution Timeline]

Editing a template updates future campaigns without touching in-flight work. Each instance logs who executed what, which feeds the audit log and analytics system.

Promo CRM centralizes your outreach log, contact catalog, and follow-ups. Every entry ties back to a release, creator, and contact so you can see instant context before pitching. Log emails, DMs, playlist manager touches, and influencer requests in one place.

• Contacts – store socials, preferred genres, placement history, and notes.
• Outreach log – capture when a pitch was sent, by whom, and the response.
• Templates – reuse high-performing playbooks for similar campaigns.
• Signals – the OS highlights contacts who responded recently or haven’t heard from you.

Use the filters to focus on a release or channel; update the status to keep the team aligned. Promo activity feeds the momentum and challenge engines automatically.

Smart Tasks are the operational outputs of campaigns. Every step in a template can create one or many tasks with full context: who, what platform, due date, dependencies, and links to the release or asset involved. Tasks behave like an agile board that is tightly coupled to releases and automation.

• Task types – content, press, paid, community, operations.
• Auto-generation – steps map to task templates with dynamic variables.
• Dependencies – tasks can wait for distribution, approvals, or assets.
• Completion flow – owners mark done, add notes, and log outcomes.

The tasks board links directly to analytics so teams can see which work streams drive actual lift. Automation can also convert strategy recommendations into tasks with one click.

AI Ops is the Swiss army knife for release audits, social content, and analytics insights. It gives operators one-click assistants that can comb through metadata, build channel-ready copy, or highlight risk across releases and campaigns.

• Release audit – checks metadata, distribution readiness, cover specs, marketing prep.
• Social content generator – builds TikTok, Instagram, YouTube copy tailored to tone.
• Insights – surfaces anomalies, trending signals, and recommended responses.
• Task handoff – output can be converted into strategy items or tasks.

AI Ops is permission gated (AI Operators + Admin). When disabled via settings, buttons and routes disappear so teams can maintain compliance. Output is logged for auditability.

The Strategy Engine translates analytics, intelligence, and manual prompts into structured recommendations. Each run produces categorized ideas (Audience, Paid, Social, Narrative) with clear rationale. Operators can convert any recommendation into Smart Tasks or archive it.

• Generation – filters by release, campaign, timeframe, or KPI.
• Categories – content, community, paid, experiential, or operational.
• Conversion – one-click conversion to tasks with campaign linkage.
• Intelligence link – uses predictive signals to prioritize urgency.

Strategy runs are logged in the audit trail so teams know who approved which plan and when. Disable the module in settings if the OS is acting as data-only mode.

The Manager Agent is an autonomous observer that monitors releases, campaigns, analytics, and automation states. When it finds risk or opportunity it posts recommendations inside the Agent panel and can ping notifications.

• Signals – stalled tasks, slipping release dates, underperforming campaigns, distribution failures.
• Recommendations – action statements with context and links to the impacted entity.
• Acknowledgements – mark items handled to keep the queue clean.
• Automation hooks – certain rules auto-run after each automation loop.

Use Manager Agent when you want an AI observer without touching the full Strategy module. Disable it globally if an org wants manual-only workflows.

Intelligence models predict momentum, flag anomalies, and connect the dots between analytics and action. It analyzes genre clusters, audience velocity, paid media impact, and distribution velocity to provide prioritized insights.

• Trend signals – momentum vs. peers, fan acquisition, save rates.
• Predicted performance – release scorecards with expected outcomes.
• Correlation engine – surfaces genre or content pairings driving spikes.
• Timing recommendations – suggests optimal window for next drop or marketing push.

Intelligence feeds the Strategy Engine, Manager Agent, and automation triggers. Treat it as your forecasting desk inside the OS.

Experiment Intelligence (Phase 79N) compares templates, channels, and content types across your campaigns. It automatically scores what drives ROI so you can double-down on winning patterns.

Use it to answer questions like “Which template leads to fastest ROI?” or “Which content type works for this creator?” and then feed that insight back into the Release Wizard or Repurpose Engine.

• Template performance – ROI, streams, and cadence by template key.
• Channel mix – where promo pushes land (TikTok vs. IG vs. email).
• Content type – which content artifacts create the most lift.
• Recommended defaults – direct feed into Release Wizard + Optimization.

Optimization Intelligence (Phase 79Q) models catalog ROI, recommended cadence, and how releases stack over the next several months. Use the ROI forecast to sanity check budgets, then pull cadence insights per creator.

• ROI forecast – plug in release cadence, streams, and budget to see projected payoff.
• Creator cadence – the OS looks at historical ROI to recommend low / medium / high release schedules.
• Catalog projection – trend last six months of streams and forecast forward revenue.
• Integration – links directly to Experiment Intelligence, Repurpose, and Creative Playbook.

Keep the forecast handy during planning meetings—the assumptions widget makes it simple to iterate on budgets without opening spreadsheets.

The Repurpose Engine (Phase 79R) turns every master release into a full batch of platform-ready clips, hooks, and caption ideas. Feed it the release + creative identity and it outputs TikTok, Reel, Shorts, Threads, and IG Feed variants along with hashtags and suggested post times.

• Generate variants – pick platforms, tone, and clip count.
• Review & save – edit hooks/captions, then commit variants to the release.
• Create tasks – turn a variant into a Task board entry in one click.
• Creative-aware – uses the Creative Playbook profile to keep tone consistent.

Use the saved variants as assets inside Promo CRM or when briefing UGC partners—it keeps every caption and hook consistent with the release strategy.

The Creative Playbook Engine (Phase 79T) defines the creative identity for the label, each creator, and each individual release. It analyzes themes, moods, visual direction, strengths, weaknesses, and experimentation ideas so every campaign feels cohesive.

• Release profiles – mood board, hooks, visual inspiration, thumbnails, and creative do/don'ts.
• Creator profiles – signature pillars, best performing content types, recommended direction.
• Label identity – brand tone, language, and creative opportunities across the catalog.
• Integrations – Repurpose Engine, Promo CRM, Momentum challenges, and Release Wizard all reference the profile.

Refresh the profile whenever a creator pivots genres or a release takes on a new mood. The cached identity keeps every AI-generated deliverable on-brand.

The challenge engine (Phase 79S) keeps the team accountable with weekly goals, streak tracking, and label + creator momentum scores. It reads tasks, releases, promo outreach, notes, and repurpose activity to keep the score fresh.

• Weekly challenges – auto-generated cards for tasks, releases, promo, creator notes, and repurpose batches.
• Momentum scores – label-level and creator-level scores with trend deltas.
• Streak tracker – login, task, promo, and release streaks per user.
• Weekly recap – Sunday summary modal highlighting wins and focus areas.

Keep the dashboard widget in view so everyone knows if the week is on track. Completing challenges feeds back into AI Ops and Intelligence recommendations.

Analytics translates raw events into narratives you can act on. Panels cover creators, releases, campaigns, subscribers, and tasks. Filters allow you to slice by window, entity, or workflow so you always know what is working.

• Creator analytics – subscriber growth, geo, engagement funnels.
• Release analytics – campaign impact, timeline overlays, distribution status.
• Campaign analytics – progress vs. plan, stuck steps, task burn-down.
• Timeline – unified axis of releases, marketing beats, automation events.

Intelligence pulls directly from analytics, so feeding clean releases and tasks here ensures predictive features stay accurate. Search across analytics to jump directly into entity detail pages without leaving the module.

Automation keeps Versitalent OS fresh. The loop runs on a configurable interval and executes a suite of services: distribution syncs, AI insight refresh, campaign step execution, task auto-generation, and optional rule engines. Everything is logged so you can audit behavior.

• Loop interval – configured under System Settings, default 10 minutes.
• Services – distribution sync, AI refresh, Smart Task autogen, campaign step executor.
• Rule engine – triggers automation rules defined in the Automation panel.
• State – automation_state table stores last-run and next-run payloads.
• Logs – automation_log tracks success/failure for every service run.

If automation is paused, features dependent on it (store link sync, AI refresh) should be updated manually via UI buttons or API endpoints.

How automation, AI Ops, and intelligence work together: rules generate tasks, AI audits, and insights feed campaigns and promo. Keep the loop healthy to avoid stale data.

• Automation console & workflows (loop, rules, suggestions)
• AI Ops console (audits, content, insights)
• Intelligence (experiments, optimization, catalog)
• Cross-links: tasks, promo, distribution, activity log

Understand ROI and catalog health: profitability dashboards, smart release queue, creator ROI comparison, and catalog intelligence.

• Profit Command Center (ROI, forecasts, release queue)
• Creator ROI comparison and momentum
• Catalog intelligence and optimization insights
• Links back to tasks, campaigns, and distribution for fixes

Use the Release Playbook Wizard to select manual distribution providers (DistroKid, TuneCore, LANDR). The wizard will create tasks to guide manual uploads. After statements are available, upload CSVs in Review → Performance Importer to see streams and revenue in Analytics.

• Step 2: select providers (Release Everywhere preset).
• Execute: complete external-action tasks for each provider.
• Review: import CSV statements for DistroKid, TuneCore, LANDR.

Use Plan → Release Wizard to pick a radio strategy, then Execute → Radio to log submissions. Start with Jango and Stationhead to test audience response, then grow to AirPlay Direct or college/community lists.

1. Select a radio strategy (test/regional/focused) in the Release Wizard.
2. Complete radio tasks in Execute → Radio (or Tasks filtered by release).
3. Log submissions and spins; paste campaign links in tasks.
4. Review spins in Analytics → Radio and adjust your plan.

The Radio tab in Analytics shows spins over time and by station. Import radio reports or log spins manually from Execute → Radio to populate this view. Correlate spin spikes with streaming to see impact.

• Log spins in Execute → Radio (or via CSV imports when available).
• Open Analytics → Radio to view spins timeline and top stations.
• Compare spin dates against streaming spikes to gauge lift.

The System hub is the home for everything meta-OS: automation, diagnostics, settings, learning, and profitability. Use it as your launch pad when you want to tune how the OS behaves rather than editing individual releases or campaigns.

• Profit Command Center – ROI, forecasts, creator ROI comparison.
• Workflows & Automation – rule engine, automation loop, smart task auto-gen.
• AI Ops & Assistants – run audits, generate tasks and insights.
• Diagnostics & Activity – health checks, errors, activity feed, audit log.
• Settings (core & advanced) – org defaults, AI providers, cleanup tools.
• Learning & Onboarding – guided tour, deep learning mode, tutorials.
• Creator Portal access – open the external portal at /creator.

Navigation: open System in the top bar to reach Profit, Workflows, AI Ops, Automation, Diagnostics, Activity, Audit, Settings, and Learn. Release Wizard and Creator Portal are linked from the System hub for quick access.

The internal home dashboard is the launchpad for the OS. It merges metrics, activity, AI recommendations, and shortcuts into one glanceable canvas. Widgets can be enabled or hidden via settings or personal preferences.

• Metrics – creators, releases, campaigns, tasks, upcoming launches, notification counts.
• Activity feed – normalized log across audit, automation, distribution, and AI events.
• Shortcuts – quick links into distribution, campaigns, AI Ops, analytics, strategy, help.
• Recommendations – optional card showing the latest strategy or agent insights.

The dashboard honors user preferences so each teammate can choose which widgets matter most.

Invites maintain OS hygiene. Only vetted creators, labels, or partners can create content in Versitalent OS. The invite manager in Settings issues unique URLs, tracks acceptance, and expires unused codes automatically.

• Invite creation – specify email, role, expiration, optional participant ID.
• Creator onboarding – share link, creator completes profile, signs agreements.
• Status tracking – see pending, accepted, expired invites from the same panel.
• Security – invite links rotate and can be revoked at any time.

Use the invite system whenever you need to onboard a new creator, label admin, or strategic partner without exposing the OS to public signups.

Versitalent OS includes RBAC, audit logging, HTTPS enforcement (Phase 79B), and session controls. Every high-impact route (distribution approvals, strategy runs, manager agent) now checks role membership and records audit log entries.

• RBAC – roles such as admin, distribution_ops, campaign_manager, ai_operator.
• Audit logging – every approval, strategy run, AI task, or distribution action is persisted.
• Session rules – internal requests require tokens, header overrides identify the acting user.
• Networking – production deploys must terminate TLS either at the proxy or the node process.

Combine RBAC with automation toggles to restrict who can trigger AI or automation loops. Security posture will continue to strengthen in the RBAC/Audit phases, but this guide covers the baseline each teammate should understand.

Save time by following the baked-in workflows. These serve as short playbooks for the most common OS tasks. Expand them, duplicate into Notion, or print for onboarding.

How to launch a release

1. Creator submits release with assets.
2. Internal team reviews submission and metadata.
3. Create or update release record with approvals.
4. Create distribution job and monitor status.
5. Run AI Ops release audit and content generation.
6. Execute Strategy Engine to craft plan.
7. Auto-generate Smart Tasks from campaign steps.
8. Watch distribution & automation dashboards for issues.
9. Review analytics once live.
10. Digest Intelligence report and iterate.

How to build a campaign

1. Select the right campaign template.
2. Attach release or creator target.
3. Adjust timeline and channels.
4. Auto-generate Smart Tasks, assign owners.
5. Track completion in the task board.
6. Review results in Analytics + Strategy.

How to troubleshoot distribution failures

1. Check distribution job status & provider error payload.
2. Re-run metadata validation via AI Ops release audit.
3. Sync job again or requeue with corrected payload.
4. Confirm store links update and audit log entry.
5. Document learnings in the release notes.

How to use Smart Tasks for daily ops

1. Auto-generate tasks from steps or recommendations.
2. Assign owners and due dates.
3. Use filters (campaign, window, status) daily.
4. Complete tasks with context notes.
5. Feed completion data into analytics and automation.

These are the most common questions when new teammates join. Expand the sections for quick answers.

Use this quick reference when things go sideways. Every card lists the fastest diagnostic steps before escalating.

Keep this glossary nearby when onboarding new teammates or AI copilots. Consistent terminology reduces friction across releases and automation.