spec-workflow-mcp

🥇Gold

The spec-workflow-mcp is a powerful Model Context Protocol server designed for AI-assisted software development, offering structured spec-driven workflows. It features a real-time web dashboard and a VSCode extension to seamlessly monitor and manage project progress within your development environment.

3,9683100Updated Today

Intermediate15 minutes to implementdevelopment

Saves ~300 min per use

Quick InstallView Source

claude install Pimzino/spec-workflow-mcp

Works with:

VS Code

Overview

About This Skill

https://github.com/Pimzino/spec-workflow-mcp

How to Use

["1. **Define Your Project Scope**: Clearly outline the project name, goals, and tech stack before starting. This will help the AI generate a relevant workflow.","2. **Specify Key Stages**: Determine the number of stages you want in your workflow. The AI can help suggest stages if needed.","3. **Integrate with Tools**: Ensure your team is familiar with the real-time dashboard and VSCode extension. The AI can provide tips on how to best use these tools.","4. **Review and Refine**: The AI-generated workflow is a starting point. Review it with your team and refine as necessary.","5. **Monitor Progress**: Use the real-time dashboard to track progress and the VSCode extension for real-time collaboration and updates."]

Use Cases

Monitor project progress in real-time through a dedicated web dashboard.

Integrate AI assistance into your development workflows for enhanced efficiency.

Manage and create specifications directly from the VSCode extension.

Visualize project metrics and track task completion with interactive dashboards.

Setup & Installation

Quick Install

Terminal

claude install Pimzino/spec-workflow-mcp

Alternative Install (Git Clone)

git clone https://github.com/Pimzino/spec-workflow-mcp

Requirements

Claude Code or compatible AI agent
Works with: VS Code

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Create a detailed software development workflow using the spec-workflow-mcp tool for [PROJECT_NAME]. The workflow should include [NUMBER] key stages, each with specific tasks and deliverables. Ensure the workflow integrates with our existing [TECH_STACK] and aligns with [PROJECT_GOALS]. Provide a timeline for each stage and suggest how to use the real-time dashboard and VSCode extension to monitor progress.

Example Output

Here's a detailed software development workflow for the 'E-Commerce Platform Upgrade' project using the spec-workflow-mcp tool:

1. **Requirements Gathering and Analysis**
   - *Tasks*: Conduct stakeholder interviews, document functional and non-functional requirements, create user stories.
   - *Deliverables*: Requirements specification document, user story map.
   - *Timeline*: 2 weeks
   - *MCP Tools*: Use the real-time dashboard to track interview progress and document updates.

2. **System Design**
   - *Tasks*: Create architecture diagrams, database schema, API specifications.
   - *Deliverables*: System design document, wireframes, API contracts.
   - *Timeline*: 3 weeks
   - *MCP Tools*: Integrate with VSCode extension to version control design artifacts and collaborate in real-time.

3. **Development**
   - *Tasks*: Implement features according to user stories, write unit tests, conduct code reviews.
   - *Deliverables*: Working software increments, test suites, code review feedback.
   - *Timeline*: 12 weeks
   - *MCP Tools*: Monitor development progress through the dashboard, use VSCode extension for real-time collaboration.

4. **Testing**
   - *Tasks*: Execute test cases, perform integration testing, conduct UAT.
   - *Deliverables*: Test reports, defect logs, UAT sign-off.
   - *Timeline*: 4 weeks
   - *MCP Tools*: Track testing progress and defect resolution through the dashboard.

5. **Deployment and Monitoring**
   - *Tasks*: Deploy to staging and production, set up monitoring, gather user feedback.
   - *Deliverables*: Deployment plan, monitoring setup, feedback report.
   - *Timeline*: 3 weeks
   - *MCP Tools*: Use the dashboard to monitor deployment progress and post-deployment metrics.