adversarial-spec

A Claude Code plugin that iteratively refines product specifications through multi-model debate until consensus is reached.

Key insight: A single LLM reviewing a spec will miss things. Multiple LLMs debating a spec will catch gaps, challenge assumptions, and surface edge cases that any one model would overlook. The result is a document that has survived rigorous adversarial review.

Claude is an active participant, not just an orchestrator. Claude provides independent critiques, challenges opponent models, and contributes substantive improvements alongside external models.

Quick Start

# 1. Add the marketplace and install the plugin
claude plugin marketplace add zscole/adversarial-spec
claude plugin install adversarial-spec

# 2. Set at least one API key
export OPENAI_API_KEY="sk-..."
# Or use OpenRouter for access to multiple providers with one key
export OPENROUTER_API_KEY="sk-or-..."

# 3. Run it
/adversarial-spec "Build a rate limiter service with Redis backend"

How It Works

You describe product --> Claude drafts spec --> Multiple LLMs critique in parallel
        |                                              |
        |                                              v
        |                              Claude synthesizes + adds own critique
        |                                              |
        |                                              v
        |                              Revise and repeat until ALL agree
        |                                              |
        +--------------------------------------------->|
                                                       v
                                            User review period
                                                       |
                                                       v
                                            Final document output

1. Describe your product concept or provide an existing document
2. (Optional) Start with an in-depth interview to capture requirements
3. Claude drafts the initial document (PRD or tech spec)
4. Document is sent to opponent models (GPT, Gemini, Grok, etc.) for parallel critique
5. Claude provides independent critique alongside opponent feedback
6. Claude synthesizes all feedback and revises
7. Loop continues until ALL models AND Claude agree
8. User review period: request changes or run additional cycles
9. Final converged document is output

Requirements

• Python 3.10+
• litellm package: pip install litellm
• API key for at least one LLM provider

Supported Models

Provider	Env Var	Example Models
OpenAI	OPENAI_API_KEY	gpt-4o, gpt-4-turbo, o1
Anthropic	ANTHROPIC_API_KEY	claude-sonnet-4-20250514, claude-opus-4-20250514
Google	GEMINI_API_KEY	gemini/gemini-2.0-flash, gemini/gemini-pro
xAI	XAI_API_KEY	xai/grok-3, xai/grok-beta
Mistral	MISTRAL_API_KEY	mistral/mistral-large, mistral/codestral
Groq	GROQ_API_KEY	groq/llama-3.3-70b-versatile
OpenRouter	OPENROUTER_API_KEY	openrouter/openai/gpt-4o, openrouter/anthropic/claude-3.5-sonnet
Codex CLI	ChatGPT subscription	codex/gpt-5.2-codex, codex/gpt-5.1-codex-max
Gemini CLI	Google account	gemini-cli/gemini-3-pro-preview, gemini-cli/gemini-3-flash-preview
Deepseek	DEEPSEEK_API_KEY	deepseek/deepseek-chat
Zhipu	ZHIPUAI_API_KEY	zhipu/glm-4, zhipu/glm-4-plus

Check which keys are configured:

python3 "$(find ~/.claude -name debate.py -path '*adversarial-spec*' 2>/dev/null | head -1)" providers

AWS Bedrock Support

For enterprise users who need to route all model calls through AWS Bedrock (e.g., for security compliance or inference gateway requirements):

# Enable Bedrock mode
python3 "$(find ~/.claude -name debate.py -path '*adversarial-spec*' 2>/dev/null | head -1)" bedrock enable --region us-east-1

# Add models enabled in your Bedrock account
python3 "$(find ~/.claude -name debate.py -path '*adversarial-spec*' 2>/dev/null | head -1)" bedrock add-model claude-3-sonnet
python3 "$(find ~/.claude -name debate.py -path '*adversarial-spec*' 2>/dev/null | head -1)" bedrock add-model claude-3-haiku

# Check configuration
python3 "$(find ~/.claude -name debate.py -path '*adversarial-spec*' 2>/dev/null | head -1)" bedrock status

# Disable Bedrock mode
python3 "$(find ~/.claude -name debate.py -path '*adversarial-spec*' 2>/dev/null | head -1)" bedrock disable

When Bedrock is enabled, all model calls route through Bedrock - no direct API calls are made. Use friendly names like claude-3-sonnet which are automatically mapped to Bedrock model IDs.

Configuration is stored at ~/.claude/adversarial-spec/config.json.

OpenRouter Support

OpenRouter provides unified access to multiple LLM providers through a single API. This is useful for:

• Accessing models from multiple providers with one API key
• Comparing models across different providers
• Automatic fallback and load balancing
• Cost optimization across providers

Setup:

# Get your API key from https://openrouter.ai/keys
export OPENROUTER_API_KEY="sk-or-..."

# Use OpenRouter models (prefix with openrouter/)
python3 debate.py critique --models openrouter/openai/gpt-4o,openrouter/anthropic/claude-3.5-sonnet < spec.md

Popular OpenRouter models:

• openrouter/openai/gpt-4o - GPT-4o via OpenRouter
• openrouter/anthropic/claude-3.5-sonnet - Claude 3.5 Sonnet
• openrouter/google/gemini-2.0-flash - Gemini 2.0 Flash
• openrouter/meta-llama/llama-3.3-70b-instruct - Llama 3.3 70B