AI Expert Workflow
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
Jump to
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
AI Expert WorkflowCommand (node, npx, python, etc.)npxArguments-
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.
-
Argument 1
- 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
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)
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





