Ideation Agent

Ideation Agent

An interactive CLI application that guides you through a structured ideation process to generate innovative solutions for customer opportunities.

Overview

The Ideation Agent is a Python-based CLI tool that uses AI (Claude or GPT-4) to generate creative solution ideas based on:

• Customer opportunity/problem definition
• Product context and strategy
• Evaluation criteria
• Competitive insights
• Example ideas for calibration

Features

• 7-Phase Structured Process: Guides you through opportunity discovery, context gathering, criteria setup, competitive analysis, example collection, AI-powered idea generation, and output formatting
• Flexible Input Methods: Type directly, load from files/folders, or skip optional sections
• AI-Powered Generation: Uses Anthropic Claude or OpenAI GPT-4 to generate 7-10 innovative ideas
• Smart Evaluation: Force-ranks top 3 ideas based on your custom criteria
• Markdown Output: Saves ideas to well-formatted markdown files

Installation

1. **Navigate to the ideation-agent directory:**

   cd "subagents/ideation-agent"

2. **Install dependencies:**

   pip3 install -r requirements.txt

3. **Set up API key**:

   **Recommended: Use .env file**

   # Copy the example file
   cp .env.example .env
   
   # Edit .env and add your API key
   # MY_API_KEY=sk-ant-api03-your-actual-key-here

   **Alternative: Environment variable**

   export ANTHROPIC_API_KEY="your-api-key-here"
   # or
   export OPENAI_API_KEY="your-api-key-here"

Usage

Run the ideation agent:

python3 ideation_agent.py

The agent will guide you through 7 phases:

Phase 1: Opportunity Discovery

• Describe the customer pain point, wish, or desire
• Answer clarifying questions about who, context, frequency, impact

Phase 2: Context Gathering

For each context item, choose to:

• Type directly
• Load from file/folder path
• Skip (optional items)

C