Aduma Help

How Aduma Works

A step-by-step walkthrough of your AI marketing department — from first login to fully automated campaigns. No experience needed.

15 minute read
What's in this guide
🧠
Before you start

The big picture

What Aduma is and why it works differently

Think of Aduma as hiring a full marketing department — except every person is an AI specialist who never sleeps, never forgets your brand strategy, and gets smarter the more context you give them.

🏗️ The three layers of Aduma
  • Layer 1 — Intelligence Foundation: Your Business Brain. This is where you describe your company, your ideal customer, and your competitive position. Every agent reads this before acting.
  • Layer 2 — Scotty (your AI CMO): The orchestrator. Scotty reads your Business Brain and coordinates all 13 agents to execute campaigns, strategy, and tasks on your behalf.
  • Layer 3 — Specialist Agents: 13 individual AI experts (SEO, content, email, ads, sales, social, analytics, and more) that execute specific tasks and report back.
📐 The golden rule

The more you fill in your Business Brain, the smarter every agent becomes. A half-filled Brain produces generic output. A fully filled Brain produces output that sounds like it knows your company inside and out.

💡

Key insight: You don't need to use every tool. Start with the Business Brain, then talk to Scotty. Scotty will direct you to the right agents for your specific goals.

🔐
Step 1

Sign up & log in

Getting into the platform for the first time
1
Go to /auth.html and create your account with an email and password.
2
After signing in, you'll land on the Hub — the central control panel that shows all your agents and tools.
3
You'll notice an Intelligence Score of 0% at the top of the Hub. That's your goal — fill in the Business Brain to raise it above 60% before doing anything else.
💡

Tip: If you don't have a Supabase backend set up, the platform still works fully using your browser's local storage. Your data saves automatically.

⚙️
Step 2

Set up your project

The Project Wizard connects your website to the platform
📋 What the wizard does

The Project Wizard tells the platform what website to monitor, analyse, and optimise. It runs a background check on your site and imports your competitor list automatically.

🪜 The 6 wizard steps
1
Basic Info — Your project name, website URL, industry, target country, and language.
2
Website Analysis Settings — How deeply to crawl your site (sitemap URL, crawl depth, which page types to scan).
3
Competitors — Add up to 5 competitor URLs. The platform will track them and alert you when they change.
4
Keywords — Seed keywords you want to rank for, plus brand keywords and how often to check rankings.
5
Integrations — Connect Google Analytics, Search Console, Ahrefs, or SEMrush if you have them (all optional).
6
Goals & Alerts — Set traffic targets, keyword ranking goals, and how often you want email reports.
⚠️

Don't skip this step. The SEO dashboard, health score, and several agents depend on your project URL to function. It only takes 5 minutes.

🧬
Step 3 — Most important

Build your Business Brain

The intelligence foundation that every agent reads before acting

The Business Brain is a strategic document about your company — who you serve, what problem you solve, how you're different, and what your goals are. Fill it in once. Every agent uses it forever.

✨ Auto-fill from your website

At the top of the Business Brain page, click "Auto-fill from your website & socials". Enter your website URL and click Analyze Website. Within 20–30 seconds, the platform will pre-populate your company name, description, industry, ICP, competitors, and social profiles by scanning your website and LinkedIn.

  • Review what was found in the preview panel
  • Click "Apply to empty fields" to fill in only blank fields (safe)
  • Or "Overwrite all fields" if you want to start fresh
📂 The 6 Brain sections
1
Company Basics — Name, tagline, what you do, industry, stage, team size, revenue model, website & social links.
2
Your Customer (ICP) — Who your ideal customer is. Their job title, company size, the industry they're in, their 3 biggest pain points, and the language they use when describing their problem.
3
Positioning & Voice — Your unique value proposition, 3 differentiators from competitors, your brand voice/tone (select chips), and phrases you never say.
4
Competitive Landscape — Up to 5 competitors with their positioning, strengths, weaknesses, and a gap opportunity only you can fill.
5
Strategic Objectives — Your #1 focus this quarter, 12-month goal, biggest marketing challenge, and which channels drive your best leads.
6
Traction & Proof — Revenue, growth rate, customer count, key client names, and testimonials. Used in sales decks and outreach.
💡

Aim for 60% or above. Watch the ring score in the top-left as you type — at 60% Scotty gains enough context to make real strategic decisions. At 80%+ every output becomes noticeably sharper.

🤖
Step 4

Meet Scotty — your AI CMO

The orchestrator who coordinates all 13 agents on your behalf
🎯 What Scotty does

Scotty is the main conversational AI you talk to. Unlike a simple chatbot, Scotty reads your entire Business Brain before every conversation, then decides which specialist agents to call and in what order to achieve your goal.

💬 How to use Scotty
1
Open Scotty from the Hub. You'll see a terminal-style boot sequence as Scotty loads your Business Brain intelligence.
2
Type your goal naturally. Examples: "I want to get 50 demo calls this quarter" or "Write me a cold email sequence for SaaS founders" or "What should I focus on this week?"
3
For complex goals, Scotty will build a Mission Plan — a list of tasks it will execute across multiple agents, shown as a live checklist.
4
Each task completes and the results appear in the Returned Work panel — ready to copy, edit, or send.
📁 Conversation history

All your conversations are saved in the left sidebar, sorted by most recent. Click any past conversation to reload it. Scotty never forgets what you talked about.

💡

Start here. If you're unsure what to do first, just tell Scotty your biggest current marketing challenge. It will tell you exactly which tools to use and in what order.

Step 5

Your 13 specialist agents

Each one is an expert in their domain, available from the Hub
📍 Finding your agents

Go to Hub — the large grid of agent cards is your team. Click any agent to open their workspace. Every workspace has its own tools, settings, and AI chat interface.

🤖 SCOTTY
AI CMO / Orchestrator
Coordinates all other agents. Start here for any strategic goal.
✍️ INK
Content Studio
Writes blog posts, landing pages, social copy, and any content asset.
🔍 REX
SEO Intelligence
Keyword research, on-page optimisation, and technical SEO fixes.
📧 NOVA
Email Engine
Email sequences, newsletters, drip campaigns, and A/B copy.
💼 CHASE
Sales Intelligence
Lead discovery, pipeline management, cold outreach, and follow-ups.
🔥 BLAZE
Ad Creative Lab
Google Ads, Meta ads, LinkedIn ads copy, and creative briefs.
📱 PULSE
Social Studio
Social media posts, captions, hashtags, and content calendars.
📊 VERA
Analytics Brain
Interprets your data, spots trends, and recommends what to do next.
🕵️ SCOUT
Competitive Intelligence
Tracks competitor moves, messaging changes, and market gaps.
🎬 REEL
Video Studio
Video scripts, YouTube descriptions, thumbnails briefs, and storyboards.
🎯 LIFT
CRO Lab
Conversion optimisation — landing pages, CTAs, and A/B test ideas.
🛡️ SHIELD
Compliance Guard
Reviews content for legal and regulatory compliance before publishing.
📊 SLATE
Deck Maker
Creates pitch decks, investor decks, and sales presentations.
💡

You don't need to use all 13. Start with Scotty, CHASE (sales), and INK (content). Add more agents as your needs grow.

🎯
Step 6

Finding & enriching leads

How to build a prospect list and get rich contact profiles
Find prospects
Verify emails
Enrich profiles
Add to pipeline
📥 Where to find leads

Go to Marketing → Lead Generation. This workspace has multiple tabs:

  • Inbox — Warm leads already showing interest signals
  • Signals — Intent data: who is actively researching solutions like yours
  • Campaigns — Trigger-based sequences that activate when a lead does something
  • Prospects — Your full prospect list with status, score, and enriched profiles
  • Channels — Which lead sources are performing best
🔍 What happens when you add a prospect
1
You add a name, email, and company. The platform automatically verifies the email via Hunter.io (valid / risky / invalid badge appears instantly).
2
Within seconds, Perplexity AI enriches the profile — pulling their LinkedIn URL, seniority level, company size, industry, tech stack, and funding stage.
3
A Decision Maker badge appears if the contact holds a senior enough title. This helps you prioritise who to contact first.
4
Click the send email icon to draft a cold email directly from the prospect's profile. The AI writes it using your Business Brain context.
💡

Tip: Use SCOUT (Competitive Intelligence agent) to find prospects that your competitors are targeting but you aren't. This is often the fastest source of high-quality leads.

💼
Step 7

The sales pipeline (CHASE)

Moving prospects from cold contact to closed deal
📊 The 5 pipeline stages
🆕 New
📨 Contacted
✅ Qualified
📋 Proposal
🏆 Won
⚡ What each pipeline row shows
  • Stage progress bar — visual indicator of where the prospect is in the journey
  • Next action box — tells you exactly what to do next to advance this deal (e.g. "Send intro email", "Send proposal")
  • Quick Send — click to generate and send a stage-appropriate email in one click
  • Activity log — a timeline of every interaction: emails sent, stage changes, notes
  • AI score — a 0–100 lead quality score based on enrichment data
🛠️ Pipeline tools
  • Sort — Sort prospects by name, status, score, or date added (click sort buttons at top)
  • Multi-select — Tick checkboxes on multiple rows to bulk-move stage, export CSV, or delete
  • Bulk export — Export your entire selected prospect list as a CSV at any time
💡

Quick win: When a prospect moves from New → Contacted automatically after you send an intro email. The platform tracks this so you always know who has and hasn't heard from you.

📈
Step 8

SEO & website health

Monitoring and improving your organic search performance
🖥️ The SEO Dashboard

Your main dashboard shows a live overview of your website's health: organic traffic, keyword rankings, backlink count, and Core Web Vitals scores. Red = urgent, amber = needs attention, green = good.

🔧 SEO tools available
  • Automated Audits — Full technical scan: broken links, missing meta tags, duplicate content, speed issues
  • Core Web Vitals — Google's speed and UX scores (LCP, CLS, FID) for mobile and desktop
  • Keyword Tracking — Daily ranking updates for your tracked keywords
  • Backlink Analysis — Who links to you, new links gained, links lost
  • Broken Links — 404 errors on your site that are damaging rankings
  • Indexing Status — Which pages Google has indexed and which it hasn't
  • Mobile Friendliness — How well your site performs on phones
  • Competitor Analysis — Side-by-side comparison with your tracked competitors
🛠️ Quick fix tools
  • Meta Tag Generator — Creates optimised title tags and descriptions for any page
  • Schema Markup Generator — Adds structured data that Google can read
  • Robots.txt Generator — Controls what Google crawls on your site
  • Redirect Mapper — Manages 301 redirects when you move pages
💡

Ask REX first. Before manually investigating SEO issues, open the REX agent and describe what you want to improve. REX will run the relevant analysis and tell you exactly what to fix in priority order.

✍️
Step 9

Content & marketing tools

Creating assets, campaigns, and strategies at scale
📝 Content creation
  • INK (Content Studio Agent) — Ask it to write anything: blog posts, landing page copy, email sequences, social posts. It reads your Business Brain so everything matches your brand voice.
  • AI Content Writer — Standalone tool for quick one-off content pieces with saved history
  • Content Strategy — Build a 3, 6, or 12-month content calendar aligned with your keywords and ICP
📣 Campaign management
  • Email Marketing — Design sequences, set triggers, and send campaigns via Resend (all tracked)
  • Social Media — Schedule posts across LinkedIn, Twitter, Instagram, and more
  • Paid Media — Brief ad creatives, write ad copy, and track campaign performance
  • LinkedIn Prospecting — Personalised LinkedIn outreach sequences for B2B sales
📊 Strategy tools
  • CMO Dashboard — Executive overview of all marketing activity in one view
  • Product Marketing — Go-to-market planning, positioning, and launch playbooks
  • Brand & Positioning — Manage your brand guidelines and messaging hierarchy
  • Marketing Overview — Channel performance summary across all campaigns
💡

Workflow tip: Use Content Strategy to plan what to create, then hand the brief to INK to write it. The two tools are designed to work together.

📡
Step 10

Monitoring & analytics

Keeping a pulse on everything, getting alerted when things change
🔔 Alerts system

The Alerts page notifies you when something important changes: a keyword drops 5+ positions, a backlink is lost, a competitor changes their homepage messaging, or your health score falls. You can configure what triggers an alert in the Project Wizard (Step 6).

📊 VERA (Analytics Agent)

VERA is your data interpreter. Rather than staring at charts yourself, ask VERA a question: "Why did traffic drop last week?" or "Which pages are converting best?". VERA analyses your data and gives you a plain English answer with a recommendation.

🌐 Intelligence layer monitoring
  • Market Pulse — Live signals from your market: what's trending, what buyers are searching for, what messaging is resonating
  • Competitive Radar — Real-time tracking of competitor website changes, new content, and pricing moves
  • Competitive Command — Full battlecard builder and gap analysis tool
  • SEO Pulse — Real-time view of your most important SEO metrics updated daily
🔧 System Diagnostics

Visit Settings → Diagnostics at any time to check that all integrations are connected and working. Each service (Claude AI, Resend, Hunter.io, Perplexity, Google PageSpeed, Supabase) gets a green / amber / red status badge with a plain-English explanation of any issues.


Pro tips

Getting the most out of Aduma

The habits that separate power users from casual users
1. Fill the Brain first, always

Before running any campaign or asking any agent for content, make sure your Business Brain is above 60%. It takes 15 minutes and multiplies the quality of every output you get afterward.

2. Talk to Scotty like a person, not a command line

Say "I need 20 qualified leads by end of month — what's my best play?" not "generate leads". The more context you give, the better the mission plan Scotty builds.

3. The pipeline is your north star

Revenue comes from deals in the pipeline. Check the CHASE pipeline every morning. Look at the "Next Action" box on each prospect — do those things before anything else.

4. Let auto-fill do the heavy lifting

When adding new prospects to the lead list, let the platform auto-enrich them first. The enriched profiles (LinkedIn, seniority, tech stack) tell you whether they're worth pursuing before you spend time on outreach.

5. Review the Alerts page weekly

Monday morning, open Alerts. Fix any red issues before starting new work. A broken page or dropped keyword costs you every day you ignore it.

6. Use Diagnostics when things feel off

If an agent gives poor results or something stops working, go to Diagnostics first. It'll tell you if an API key is missing or a service is down — saves 20 minutes of guessing.

Ready to get started?

Follow the steps in order — Business Brain first, then Scotty, then the agents. You'll have your first campaign running within an hour.