⚙️ Open Source · github.com/rdcahalane/ai-skills

Agent Advisory Board

A multi-agent system that debates your ideas, stress-tests assumptions with a built-in adversary, and surfaces a verdict you can act on.

Runs locally. Uses subscription CLI tools — Claude, Gemini, Codex — so there are no per-query API costs. Works in Discord or as a simple local markdown file.

No API key. No install. Runs on Groq free tier.

The problem with asking one AI

🪞

Echo chamber

A single model reflects your framing back at you. It agrees with the premise, fills in your blind spots with optimism, and rarely surfaces the strongest objection.

💸

API costs add up

Running multiple models via API for every question gets expensive fast. Most people end up asking one model anyway — or paying for subscriptions they barely use.

🔀

Context switching

Switching between Claude, Gemini, and ChatGPT for different questions is friction. Most people just stick with one — even when another would be better.

Agent Advisory Board routes your question to the right advisors automatically, forces one to argue against the consensus, then synthesizes — so the output already reflects the best case and the worst case. You get a verdict, not a draft.

How a debate works

Every debate automatically assigns one agent as Red Team — an adversarial role that attacks the dominant view, not to be contrarian for its own sake, but to surface real weaknesses before you act.

You askAgent A opensAgent B 🔴 Red TeamAgent A respondsAgent B pushes back🔮 Synthesis✅ / ❌ You decide
🔴 Red Team role

One agent is told: attack the dominant view, find the worst-case scenario, refuse easy consensus. It's explicitly adversarial — stress-testing the position before you commit to it.

🔮 Synthesis

Claude synthesizes the full transcript — noting which Red Team objections were valid vs. weak. Points of agreement reached under adversarial pressure are flagged as stronger signal.

Your board of advisors

Type !board: topic and the system picks which advisors are relevant based on the topic. Or force specific ones: !board cfo cmo: topic

Advisors also work in debates: !debate cfo vs cmo: Should we raise prices?

Professional
💰
CFO!cfo

Unit economics, burn rate, ROI timelines. Skeptical of optimistic projections.

📣
CMO!cmo

Who's the customer and why do they buy? GTM sequencing, competitive position.

⚙️
CTO!cto

Build vs buy, feasibility, what breaks at 10x scale.

🗂️
COO!coo

Who owns this? By when? What's blocking us?

🎯
CPO!cpo

Are we solving a real pain? For whom? How do we know?

⚖️
General Counsel!gc

What's the legal exposure? What's missing from the contracts?

🖱️
UX Expert!ux

Has anyone watched a real user try this? Where do they hesitate? What do they read first?

Just for fun
👵
Grandma!grandma

Warm, practical, completely unimpressed by buzzwords. Will real people actually use this?

🙄
Teenage Daughter!teenager

Brutally honest Gen Z radar for cringe. Is this actually cool or are you trying too hard?

😤
Cranky Neighbor!neighbor

Seen every scheme fail for 30 years. What's the obvious way this goes wrong?

🚀
The Intern!intern

Maximum enthusiasm, zero cynicism. What if we just automated the whole thing?

🦈
Shark Tank Investor!shark

What are your numbers? No patience for vanity metrics or TAM hallucinations.

Add your own via ADVISORS_JSON in .env — any persona, any lens, any voice.

Three ways to use it

Same engine, same agents, same debates. Pick whichever interface fits how you work.

Web UI

No install. No API key. Open your browser and start a debate. Runs on Groq free tier — fast, free, and shareable.

  • ✓ No setup required
  • ✓ Works on any device
  • ✓ Full advisor board
  • ✓ Free forever
Open Web UI →
💬

Discord bot

Best for teams or if you want a persistent shared log. Bot joins your server, listens to a channel. Results appear as rich embeds with Approve / Reject / Ask Claude buttons.

  • ✓ Shared with teammates
  • ✓ Rich embeds + interactive buttons
  • ✓ Works from phone
  • ✓ Webhook notifications per round
📝

Local markdown file

No Discord account needed. Two files: inbox.md (you type here) and conversation.md (growing log). Open side-by-side in VS Code or Obsidian.

  • ✓ Zero account setup
  • ✓ Works offline
  • ✓ Searchable conversation history
  • ✓ !approve / !reject in the file
Set TRANSPORT=both in your .env to run Discord bot + local markdown simultaneously.

Agents — no API key costs

Agent Advisory Board uses CLI tools that authenticate with your existing subscriptions. Configure only what you have — unconfigured agents are skipped automatically.

🧠
Claude CLIMax sub

Anthropic's Claude via CLI. Uses your existing Max subscription — no per-query cost.

Gemini CLIFree

Google Gemini via CLI. Authenticates with your Google account. No API key needed.

💻
OllamaLocal

Any local model (llama3.2, mistral, etc.) running on your machine. Free and private.

🤖
Codex CLIOAI sub

OpenAI Codex via desktop app. Requires an OpenAI subscription — no token charges.

Also supports: Ollama remote nodes (another machine on Tailscale), any llama.cpp server via BEAST_URL.

Commands

CommandWhat it does
What is X?Auto-routed to best available agent
!claude: promptForce Claude CLI
!gemini: promptForce Gemini CLI
!board: topicAuto-select relevant advisors by topic
!board cfo cmo: topicForce specific advisors
!board grandma shark: topicMix professional + fun advisors
!debate: topic2-agent debate, default agents
!debate cfo vs cmo: topicAdvisor debate — CFO vs CMO personas
!debate claude vs gemini --red gemini: topicGemini plays Red Team
!debate claude vs gemini --socratic cfo: topicCFO plays Socratic Examiner
!approve (file) / ✅ button (Discord)Execute the proposed action
!reject (file) / ❌ button (Discord)Dismiss — no action
!ask (file) / 🔍 button (Discord)Ask Claude to elaborate

Get started

01

Clone + configure

Clone the repo, copy .env.example, set which agents you have. Takes 2 min.

02

Choose your interface

Discord bot for shared team use. Local markdown file if you just want a fast personal setup.

03

npm start

One command. The coordinator starts polling. Bot comes online or inbox.md appears, ready.

04

Ask anything

Type in Discord or inbox.md. Agents respond, debate, synthesize. Click Approve or type !approve.

Interactive setup via Claude Code

After cloning the repo, open Claude Code in the agent-factory/ directory and run the setup skill. Claude will ask which agents you have, which interface you want, walk through Discord bot creation step-by-step, set up your database, write your .env, and run the first test.

git clone https://github.com/rdcahalane/ai-skills.git
cd ai-skills/agent-factory
claude          # opens Claude Code
# then type:  /setup-agent-factory