This project provides a Model Context Protocol (MCP) server and a real-time web dashboard designed to structure AI-assisted software development workflows. It targets developers and teams looking to manage AI-generated specifications, track progress, and implement approval systems, offering a centralized hub for project documentation and task management.

How It Works

The system operates as an MCP server, integrating with various AI coding assistants. It enforces a sequential spec creation process (Requirements → Design → Tasks) and provides a separate, mandatory web dashboard for real-time monitoring. This dashboard offers visual progress tracking, document navigation, and facilitates an approval system for spec documents, aiming to streamline the development lifecycle.

Quick Start & Requirements

• Install/Run: npx -y @pimzino/spec-workflow-mcp@latest /path/to/your/project --dashboard
• Prerequisites: Node.js, npm. The dashboard must be run separately from the MCP server.
• Setup: Requires configuring the MCP client in your AI tool and starting the dashboard service.
• Docs: Workflow Guides

Highlighted Details

• Structured workflow: Requirements → Design → Tasks.
• Real-time web dashboard with live updates.
• Integrated approval system for documents.
• Template system for various document types.
• Cross-platform compatibility (Windows, macOS, Linux).

Maintenance & Community

The project is maintained by Pimzino. Further community engagement details are not explicitly provided in the README.

Licensing & Compatibility

• License: GPL-3.0.
• Compatibility: The GPL-3.0 license is copyleft, meaning derivative works must also be open-sourced under the same license. This may impose restrictions on linking with closed-source commercial software.

Limitations & Caveats

The web dashboard is mandatory for core features like approvals and task tracking to function. The GPL-3.0 license may present compatibility challenges for commercial, closed-source applications.