If you've ever used Claude Code for marketing content, you've probably hit
the same wall I did: every new session starts from zero. No memory of your
brand voice, no idea who your audience is, no clue about your competitors.
You end up copy-pasting the same context over and over, and the output
still feels… generic.
That's the problem Mario was built to solve, and v2 takes it a lot further.
What Mario does
Mario is a Ruby gem that turns Claude Code into a brand-aware content
engine. You run it once to build your brand foundations — identity, voice,
audience personas, competitive landscape, messaging framework — and those
foundations persist across every session after that.
The workflow is straightforward: you run /mario:new-project to set up your
brand, then /mario:create whenever you need content. Mario loads your brand
context automatically, runs topic research in the background, and routes
the work to specialised marketing agents depending on what you're creating
— whether that's web copy, email campaigns, social posts, or SEO content.
No more re-explaining who you are every time you open a new session.
The brand foundations
When you initialise a project, Mario generates 8 documents through a
structured interview process: Brand identity, Voice & tone, Audience
personas, Competitive landscape, Messaging framework, Product/service
details, Channels & distribution, and a synthesised Brand bible for quick
reference.
These aren't throwaway files. They're the persistent context that every
piece of content draws from, which is what keeps your output consistent
whether you're writing a blog post on Monday or an ad campaign on Friday.
Specialised agents
One thing I'm particularly happy with in v2 is the agent architecture.
Instead of dumping everything into a single prompt, Mario uses
orchestrators that spawn domain-specific executors — strategy, web copy,
email, social, SEO, paid ads — each loaded with its own marketing
frameworks and best practices.
There are also research agents that run in parallel to analyze competing
content before you even start writing, and audit agents that can score a
website across six dimensions. The orchestrators themselves stay
lightweight, using roughly 10-15% of context, so the specialised agents
have room to actually do their work.
Audits and competitor analysis
Two features that have been really useful in practice: /mario:audit runs a
comprehensive scoring analysis of any website with five parallel agents
evaluating content, conversion, SEO, positioning, and brand consistency. If
you just need a quick read, /mario:quick-audit gives you a 60-second
snapshot.
And /mario:competitors lets you run a side-by-side comparison of competitor
sites against your own positioning. It's a solid starting point for
figuring out where you stand and where the gaps are.
Getting started
Installation is simple:
bash
gem install marketing_mario
mario install --global
You'll need Ruby 3.1+ and Claude Code access. From there, run
/mario:new-project to build your foundations and you're ready to go. The
whole thing is MIT licensed and the source is on GitHub
https://github.com/jorgegorka/mario.
What's next
I'm already working on improvements based on how people are using it in the
real world. If you give it a try, I'd genuinely appreciate feedback — open
an issue, send a PR, or just let me know what works and what doesn't.
