AI Expert Workflow

by bacoco

3 stars
803 downloads
Not rated
GitHub

About

Facilitates structured product development through specialized AI roles (Product Manager, UX Designer, Software Architect) that generate documentation and convert requirements into actionable tasks.

Details

Author
bacoco
Repository
bacoco/ai-expert-workflow-mcp
GitHub stars
3
Downloads
803
Categories
Productivity, Developer Tools, Design, Workplace, File Management, AI, Communication, Infrastructure, Knowledge Base
Tags
#integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name AI Expert Workflow
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 ai-expert-workflow-mcp
    Environment
    • MAX_TOKENS 8000
    • TEMPERATURE 0.7
    • OPENROUTER_MODEL tngtech/deepseek-r1t-chimera:free
    • OPENROUTER_API_KEY YOUR_OPENROUTER_API_KEY_HERE

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Install AI Expert Workflow globally:

   npm install -g ai-expert-workflow-mcp

2. Get an OpenRouter API key:
- OpenRouter API key for AI Expert Workflow: Get one here

3. Generate a PRD for your project:
```bash

npm install -g ai-expert-workflow-mcp

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ai expert workflow": {
            "env": {
                "MAX_TOKENS": "8000",
                "TEMPERATURE": "0.7",
                "OPENROUTER_MODEL": "tngtech/deepseek-r1t-chimera:free",
                "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY_HERE"
            },
            "args": [
                "-y",
                "ai-expert-workflow-mcp"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "MAX_TOKENS": "8000",
        "TEMPERATURE": "0.7",
        "OPENROUTER_MODEL": "tngtech/deepseek-r1t-chimera:free",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY_HERE"
    },
    "args": [
        "-y",
        "ai-expert-workflow-mcp"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "MAX_TOKENS": "8000",
        "TEMPERATURE": "0.7",
        "OPENROUTER_MODEL": "tngtech/deepseek-r1t-chimera:free",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY_HERE"
    },
    "args": [
        "-y",
        "ai-expert-workflow-mcp"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "MAX_TOKENS": "8000",
        "TEMPERATURE": "0.7",
        "OPENROUTER_MODEL": "tngtech/deepseek-r1t-chimera:free",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY_HERE"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "ai-expert-workflow-mcp"
    ],
    "command": "cmd"
}

AI Expert Workflow MCP

npm version

An MCP (Model Context Protocol) server that implements the AI Expert Workflow using OpenRouter API for AI capabilities. This project allows you to consult with AI experts in product management, UX design, and software architecture to plan and develop your projects. It can be used standalone or with Task Master for task management (optional).

How AI Expert Workflow Interacts With You

The AI Expert Workflow is designed to provide a natural, conversational experience that guides you through the product development process:

Conversation Flow

The system engages in conversation with you until you're ready to generate a document:

1. You Control Document Generation
- The AI will chat with you until you explicitly request document generation with phrases like "generate document" or "create PRD"
- If you request a document before all important topics are covered, the AI will let you know what's missing and continue the conversation
- Only when all necessary topics are covered will the AI generate the document

2. Comprehensive Topic Coverage
- The AI guides you through all important aspects of your product
- Each expert focuses on specific topics (product vision, user personas, technical architecture, etc.)
- The AI doesn't move to the next topic until the current one is thoroughly explored

3. Verification Before Completion
- Before concluding each stage, the AI verifies that all your requirements are accurately captured
- The AI asks for your confirmation before generating any document
- You have full control over when to move forward

Document Storage

When you're ready to generate documents:

- Each expert's document is saved in the main directory (e.g., PRD.md, UX_Design_Document.md)
- The scripts/prd.txt file is continuously updated throughout all phases:
- First, it contains the Product Manager's document
- Then, the UX Designer's content is added with appropriate section headers
- Finally, the Software Architect's content is added to complete the specification
- This ensures that by the end of the workflow, scripts/prd.txt contains a comprehensive specification with input from all three experts
- Individual expert contributions are also saved separately as reference files

Important: The scripts/prd.txt file is continuously improved throughout the workflow, making it ready for Task Master at any point, but it's most valuable after all three expert phases are complete.

🚀 Quick Start for End Users

Standalone Usage (Recommended)

1. Install AI Expert Workflow globally:

   npm install -g ai-expert-workflow-mcp

2. Get an OpenRouter API key:
- OpenRouter API key for AI Expert Workflow: Get one here

3. Generate a PRD for your project:

   # Set your API key
export OPENROUTER_API_KEY=your_key_here

# Generate a PRD
npx ai-expert-workflow-generate "Your detailed project description"

4. Review your PRD in prd.md

Optional: Task Master Integration

If you also want to use Task Master for task management (optional):

1. Install Task Master globally:

   npm install -g task-master-ai

2. Get the additional API keys:
- Anthropic API key for Task Master AI: Get one here
- Perplexity API key (optional) for Task Master AI enhanced research capability: Get one here

3. Configure your Cursor settings with both MCPs:

   {
"mcpServers": {
"ai-expert-workflow": {
"command": "npx",
"args": ["-y", "ai-expert-workflow-mcp"],
"env": {
"OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY_HERE",
"OPENROUTER_MODEL": "tngtech/deepseek-r1t-chimera:free",
"MAX_TOKENS": 8000,
"TEMPERATURE": 0.7
}
},
"taskmaster-ai": {
"command": "npx",
"args": ["-y", "task-master-ai"],
"env": {
"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
"MODEL": "claude-3-sonnet-20240229",
"PERPLEXITY_MODEL": "sonar-pro",
"MAX_TOKENS": 64000,
"TEMPERATURE": 0.2,
"DEFAULT_SUBTASKS": 5,
"DEFAULT_PRIORITY": "medium"
}
}
}
}

Note on models: With OpenRouter, you can choose from many AI models beyond Claude:
- For creative tasks: openai/gpt-4o, anthropic/claude-3-opus-20240229
- For balanced performance: anthropic/claude-3-sonnet-20240229, mistral/mistral-large
- For faster, cost-effective options: openai/gpt-3.5-turbo, anthropic/claude-3-haiku-20240307
- Other options: google/gemini-pro, meta/llama-3-70b, cohere/command-r

See the complete list of OpenRouter models for all available options.

3. Enable the MCPs in your Cursor settings.

Complete Workflow Examples

Option 1: Standalone PRD Generation (Recommended)

```bash
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.