bd495be965
All checks were successful
Deploy to Production / Build and Deploy (push) Successful in 12s
- Sidebar: dynamic brand-accent colors, brainstorm section restyled - AI chat general: popup panel with expand/collapse, hides when contextual AI open - AI chat contextual: tabs reordered (Actions first), X close button, height fix - Settings: all tabs restyled, 6 new color presets (sage, terracotta, iron, etc.) - Global color cleanup: emerald/orange hardcoded → brand-accent dynamic - Brainstorm page: orange → brand-accent throughout - PageEntry animation component added to key pages - Floating AI button: bg-brand-accent instead of hardcoded black - i18n: all 15 locales updated with new AI/billing keys - Billing: freemium quota tracking, BYOK, stripe subscription scaffolding - Admin: integrated into new design - AGENTS.md + CLAUDE.md project rules added
Suno Agent — Mac, the Band Manager
An AI-powered music production assistant that helps you create professional Suno-ready song packages through guided creative conversation. Mac orchestrates four specialized skills into a seamless workflow: from initial inspiration to a complete package — style prompt, lyrics, and parameter recommendations — that you can paste directly into Suno.
What It Does
You talk to Mac like you'd talk to a producer. Tell Mac what kind of song you want — a genre, a mood, a poem, a feeling, a reference track — and Mac produces a complete package:
- Style Prompt — Model-specific, optimized for your chosen Suno model (v4.5-all, v5 Pro, etc.)
- Structured Lyrics — With Suno metatags (
[Verse],[Chorus], etc.), rhythmic consistency, and cliché detection - Exclusion Prompt — What Suno should avoid
- Parameter Recommendations — Slider values, vocal gender, persona references (tier-aware)
- Wild Card Variant — An experimental alternative to push creative boundaries
After you try the output on Suno, Mac helps you refine through a structured feedback loop — translating subjective reactions ("it doesn't feel right") into concrete parameter adjustments.
Key Features
- Three Interaction Modes — Demo (quick and scrappy), Studio (deep customization), Jam (experimental)
- Band Profiles — Persistent sonic identity across songs (genre, vocal direction, style baseline, writer voice)
- Writer Voice Preservation — Analyzes your writing samples to maintain your authentic voice when transforming lyrics
- Tier-Aware — Knows what's available on Free, Pro, and Premier plans; never shows features you can't access
- Feedback Loop — Five-type feedback triage with guided elicitation for users who can't articulate what's wrong
- Instrumental Support — Dedicated workflow for instrumental-only tracks
- Non-English Support — Language detection with Suno-specific guidance
- Memory System — Remembers your preferences, musical patterns, and creative history across sessions
Architecture
Mac is an orchestrating agent that coordinates four specialized skills:
┌─────────────────────┐
│ Mac (Band Manager) │
│ Orchestrating Agent │
└──────────┬──────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
┌─────────┴────────┐ ┌────────┴────────┐ ┌─────────┴────────┐
│ Band Profile │ │ Style Prompt │ │ Lyric │
│ Manager │ │ Builder │ │ Transformer │
└──────────────────┘ └─────────────────┘ └──────────────────┘
│
┌─────────┴────────┐
│ Feedback │
│ Elicitor │
└──────────────────┘
| Skill | Purpose | Key Scripts |
|---|---|---|
| Band Profile Manager | CRUD for band identity profiles, writer voice analysis, tier feature awareness | validate-profile.py, list-profiles.py, tier-features.py, diff-profiles.py |
| Style Prompt Builder | Model-aware style prompt generation with creativity modes and wild card variants | validate-prompt.py |
| Lyric Transformer | Poem/text to Suno-ready structured lyrics with metatags and cliché detection | validate-lyrics.py, cliche-detector.py, syllable-counter.py, analyze-input.py, section-length-checker.py, lyrics-diff.py |
| Feedback Elicitor | Post-generation feedback triage and guided refinement with musical vocabulary translation | parse-feedback.py, map-adjustments.py |
Prerequisites
- An LLM CLI with skill support — Claude Code, Gemini CLI, Codex CLI, GitHub Copilot, Windsurf, or OpenCode
- Suno account (free tier works; Pro/Premier unlocks additional features)
- BMad Method (optional) — built with BMad, runs independently without it
Installation
-
Run
link-skills.shfrom the project root to create symlinks in.claude/skills/and.agents/skills/(the portable Agent Skills standard). Or copy skill folders fromsrc/skills/into your tool's skill discovery directory. -
Run the setup skill to configure the module:
/suno-setup
-
The setup skill collects your preferences (Suno tier, default mode, folder paths) and registers all capabilities with the help system.
-
On first activation, Mac will greet you and confirm your setup. All preferences are changeable anytime through conversation.
Updating
To reconfigure after a module update, run /suno-setup again. Existing settings are preserved as defaults.
Quick Start
- Invoke Mac — Use the trigger phrase "talk to Mac," "Band Manager," or "create a song for Suno"
- Tell Mac what you want — "Make me a sad indie folk song" or paste a poem
- Get your package — Mac produces a complete style prompt + lyrics + parameters
- Try it on Suno — Paste into Suno's Custom Mode fields
- Come back and refine — Tell Mac what worked and what didn't
Suno Model Compatibility
| Model | Tier | Style Prompt Limit | Notes |
|---|---|---|---|
| v4.5-all | Free | 1,000 chars | Conversational prompts, best free model |
| v4 Pro | Paid | 200 chars | Simple descriptors |
| v4.5 Pro | Paid | 1,000 chars | Intelligent prompts |
| v4.5+ Pro | Paid | 1,000 chars | Advanced creation |
| v5 Pro | Paid | 1,000 chars | Crisp 5-8 descriptors, natural vocals |
| v5.5 Pro | Paid | 1,000 chars | Most expressive, Voices, Custom Models, My Taste |
File Structure
suno-agent-band-manager/
├── SKILL.md # Lean bootloader — identity seed, Three Laws, activation routing
├── bmad-skill-manifest.yaml # Skill type identifier
├── references/
│ ├── activation.md # Full activation protocol, mode switching, preferences
│ ├── browse-songbook.md # Creative history browsing
│ ├── capabilities.md # External skills, audio analysis, availability
│ ├── creed.md # Principles, package assembly rule, research discipline
│ ├── create-song.md # Main song creation workflow
│ ├── init.md # First Breath — first-run setup
│ ├── memory-system.md # Memory discipline and structure
│ ├── persona.md # Identity, communication style, model awareness
│ ├── README.md # This file
│ ├── refine-song.md # Post-generation refinement loop
│ ├── research-discipline.md # Detailed research rules
│ ├── save-memory.md # Session persistence
│ ├── SUNO-REFERENCE.md # Suno platform reference
│ └── STUDIO-EDITOR-REFERENCE.md
└── scripts/
├── pre-activate.py # First-run detection, scaffolding, menu rendering
├── validate-path.py # Access boundary enforcement
├── check-memory-health.py # Memory file size monitoring
└── tests/
├── test-pre-activate.py
├── test-validate-path.py
└── test-check-memory-health.py
License
MIT — see LICENSE for details.
Credits
Built with the BMad Method — Build More, Architect Dreams.